PosApp Open APIs
  1. Sản phẩm
PosApp Open APIs
  • Tổng quan
  • Thẻ PosApp
    • Mã lỗi (error code)
    • API Idempotency
    • Nạp tiền vào thẻ
      POST
    • Kiểm tra trạng thái giao dịch
      POST
  • Thông tin khác
    • Digital Signature
  • Webhook
    • Tổng quan
    • Order Schema
    • Warehouse import Schema
  • Sản phẩm
    • Tạo mới sản phẩm
      POST
    • Sửa một sản phẩm
      PATCH
    • Tồn kho sản phẩm
      POST
  • Khuyến mãi
    • Đồng giá
      • Tạo khuyến mãi
      • Sửa khuyến mãi
  1. Sản phẩm

Sửa một sản phẩm

Developing
Test Env
Test Env
PATCH
api/public/product-masters/{product_master_id}
API này dùng để sửa một sản phẩm với phương thức PATCH

Request

Path Params
product_master_id
string 
required
Header Params
X-API-Key
string 
optional
Api key dùng để xác thực
Body Params multipart/form-data
product_name
string 
required
Tên sản phẩm
Example:
Sản phẩm 1
short_name
string 
optional
Tên ngắn gọn
product_code
string 
optional
Mã sản phẩm ( nếu không có hệ thống sẽ tự động tạo ra mã)
product_barcode
string 
optional
Mã barcode sản phẩm
description
string 
optional
Mô tả
Example:
Tạo mới SP1
available
integer 
required
Trạng thái sản phẩm 0: tắt, 1: Hoạt động
Example:
1
product_tax
number 
optional
Thuế sản phẩm
Example:
0
product_category_id
string 
required
ID nhóm sản phẩm
allow_overselling
boolean 
required
Cho phép bán khi sản phẩm hết hàng
Example:
true
product_price
number 
required
Giá sản phẩm
Example:
20000
product_type
integer 
required
Mặc định truyền lên 1
Example:
1
automatically_create_inventory_items
boolean 
optional
Cờ tự động tạo mặt hàng tồn kho: 1: có, 0: không
Lưu ý: Không cần gửi lên nếu không dùng kho
Example:
true
inventory_management_flg
boolean 
optional
Cờ có quản lý kho hay không cũng là cờ nguyên vật liệu: 1: có, 0: không
Lưu ý: Không cần gửi lên nếu không dùng kho
Lưu ý 2: Nếu đã gửi lên cờ automatically_create_inventory_items = 1 thì không cần gửi cờ này nữa vì hệ thống sẽ tự động tích cờ inventory_management_flg này
Example:
true
alert_flg
boolean 
optional
Cờ bật cảnh báo tồn kho: 1 là bật, 0: tắt (Nếu bạn dùng với kho có thể bật hoặc tắt mặc định là sẽ tắt)
Lưu ý: Không cần gửi lên nếu không dùng kho
Example:
false
alert_minval
number 
optional
Cờ cảnh báo tồn kho dưới mức ( Nếu bạn bật alert_flg thì có thể gửi lên cở này)
Lưu ý: Không cần gửi lên nếu không dùng kho
alert_maxval
number 
optional
Cờ cảnh báo tồn kho trên mức ( Nếu bạn bật alert_flg thì có thể gửi lên cở này)
Lưu ý: Không cần gửi lên nếu không dùng kho
reseller_flg
boolean 
required
Cờ cho phép bán lẻ mặc định 1 ( Hiển thị trên màn hình bán hàng)
Example:
true
allow_online_sale
boolean 
required
Cờ cho phép bán hàng online mặc định 0
Lưu ý: Hiển thị mặt hàng trên web order thì hãy gửi lên 1
Example:
false
last_input_price
number 
optional
Giá nhập sản phẩm
Example:
0
cost_price
number 
optional
Giá vốn sản phẩm
Example:
0
unit_list
array [object {11}] 
required
Chứa các đơn vị tính gửi lên dạng mảng
Lưu ý: Trong mảng thì luôn phải tồn tại 1 phần tử mảng với key is_primary = 1 để hệ thống có thể xác định xem đơn vị tính nào bán mặc định
Example:
[""]
shop_id
number 
optional
unit_name
string 
optional
unit_exchange
number 
optional
price
number 
optional
is_primary
number 
optional
1: mặc định đơn vị tính, 0: Khác
sell_flg
number 
optional
1: có, 0: ko
old_price
number 
optional
invalid
number 
optional
1: đã xóa, 0: Hoạt động
product_material
array[string]
optional
product_barcode
string 
optional
unit_id
string 
optional
thumbnails
array[string]
optional
Hình ảnh sản phẩm (Gửi lên nếu sản phẩm có hỉnh ảnh)

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://retail-api.posapp.vn/api/public/product-masters/' \
--header 'X-API-Key;' \
--form 'product_name="Sản phẩm 1"' \
--form 'short_name=""' \
--form 'product_code=""' \
--form 'product_barcode=""' \
--form 'description="Tạo mới SP1"' \
--form 'available="1"' \
--form 'product_tax="0"' \
--form 'product_category_id=""' \
--form 'allow_overselling="true"' \
--form 'product_price="20000"' \
--form 'product_type="1"' \
--form 'automatically_create_inventory_items="true"' \
--form 'inventory_management_flg="true"' \
--form 'alert_flg="false"' \
--form 'alert_minval=""' \
--form 'alert_maxval=""' \
--form 'reseller_flg="true"' \
--form 'allow_online_sale="false"' \
--form 'last_input_price="0"' \
--form 'cost_price="0"' \
--form 'unit_list=""' \
--form 'thumbnails=""'

Responses

🟢200Success
application/json
Body
msg
string 
required
data
object 
required
angular_build_version
string 
required
Example
{
  "data": {
    "product_master_id": 1120397,
    "shop_id": 1570685368,
    "product_name": "Sản phẩm 1",
    "product_code": "SP05999",
    "product_barcode": null,
    "feature": "",
    "rack_info": null,
    "info1": null,
    "info2": null,
    "info3": null,
    "info4": null,
    "info5": null,
    "info6": null,
    "description": "Tạo mới SP1",
    "short_name": null,
    "available": 1,
    "receiptflg": null,
    "product_category_id": 19908,
    "default_price": null,
    "product_tax": 0,
    "primary_unit_id": 115674,
    "primary_unit_name": "cái",
    "product_unit_type": null,
    "product_price": 1000,
    "eng_name": null,
    "product_thumbnail1": null,
    "product_thumbnail2": null,
    "product_thumbnail3": null,
    "product_thumbnail4": null,
    "product_desc": null,
    "status_in_day": 1,
    "status": 1,
    "lang": null,
    "rate": null,
    "rate_times": null,
    "top_flg": 0,
    "direct_sell_flg": null,
    "point_get_flg": null,
    "online_sell_flg": null,
    "reseller_flg": 0,
    "product_type": 1,
    "materials_flg": 0,
    "price_extra": null,
    "product_material": null,
    "combo": null,
    "batch_flg": false,
    "last_update": "2025-03-17 16:12:47",
    "invalid": 0,
    "nameSortproduct": "San_pham_1",
    "orderIndexproduct": 0,
    "place_tag": null,
    "supplier_id": null,
    "supplier_name": null,
    "last_input_price": 0,
    "product_master_root_id": 1120397,
    "extend_infos": null,
    "modules": null,
    "parent_id": 0,
    "billing_block_time": null,
    "service_hourly_flag": null,
    "open_price": null,
    "open_pricing_on_time": null,
    "products": [
      {
        "product_id": 1121723,
        "shop_id": 1570685368,
        "product_master_id": 1120397,
        "product_name": "Sản phẩm 1",
        "variant_name": "",
        "product_code": "SP05999",
        "product_price": 1000,
        "product_tax": 0,
        "product_type": 1,
        "product_barcode": null,
        "product_category_id": 19908,
        "allow_overselling": 0,
        "inventory_management_flg": 1,
        "product_manufacturing_flg": 0,
        "automatically_create_inventory_items": 0,
        "alert_flg": 0,
        "alert_maxval": null,
        "alert_minval": null,
        "price_editable_flg": 1,
        "quantity_editable_flg": 0,
        "place1": 0,
        "place2": 0,
        "place3": 0,
        "place4": 0,
        "place5": 0,
        "place6": 0,
        "regdate": "2025-03-17 15:20:19",
        "last_update": "2025-03-17 16:12:47",
        "owner_product_id": null,
        "owner_shop_id": 1570685368,
        "product_master_code": "SP05999",
        "info1": null,
        "info2": null,
        "info3": null,
        "info4": null,
        "info5": null,
        "info6": null,
        "short_name": null,
        "receiptflg": null,
        "multiple_product_category_ids": null,
        "unit_id": 115674,
        "unit_name": "cái",
        "product_unit_type": null,
        "service_unit_value": null,
        "service_promotion": null,
        "promotion_unit": 3,
        "in_price": null,
        "buy_price": null,
        "product_material": null,
        "combo": null,
        "eng_name": null,
        "top_flg": 0,
        "direct_sell_flg": null,
        "point_get_flg": null,
        "online_sell_flg": null,
        "reseller_flg": 0,
        "invalid": 0,
        "nameSortproduct": "San_pham_1",
        "verify_otp_flg": 0,
        "group_price_id": null,
        "manage_type": null,
        "serialnum": null,
        "place_tag": null,
        "supplier_id": null,
        "supplier_name": null,
        "product_root_id": 1121723,
        "extend_infos": "[]",
        "product_top_flg": 0,
        "order_index_product": 14,
        "modules": null,
        "product_price_online": 0,
        "software_renewal_does_not_apply": 0,
        "max_number_staff": 1,
        "expiration": null,
        "card_type": 0,
        "card_amount": 0,
        "card_discount_percent": 0,
        "card_decrease_commission_flg": 0,
        "card_limit_use_per_time_flg": 0,
        "card_limit_use_per_time": 0,
        "card_limit_use_per_time_type": 1,
        "target_type": 0,
        "target_detailtype": null,
        "default_product_ids": null,
        "device_slot": null,
        "parent_id": 0,
        "topup_flg": 0,
        "warning_debt_alert": null,
        "default_customer_treatment_card_flg": 0,
        "default_customer_topup_flg": 0,
        "top_sale_reporting": 1,
        "auto_calc_cost_price": false,
        "topping_flg": 0,
        "batch_id": 0,
        "batch_no": "",
        "quantity_in_stock": null,
        "readonly": 0,
        "product_name_translations": null,
        "available": 1,
        "cost_price": "0",
        "last_input_price": 0,
        "allow_online_sale": 1,
        "allow_electronic_scales": 0,
        "extra_topping_flg": "0",
        "inventory_norm": null,
        "allows_enter_amount_at_purchasing": "0",
        "like_flg": "0",
        "allow_change_materials_during_production": "0",
        "units": [
          {
            "id": 1331214,
            "shop_id": 1570685368,
            "product_master_id": 1120397,
            "product_id": 1121723,
            "unit_id": 115674,
            "unit_name": "cái",
            "unit_exchange": 1,
            "price": 1000,
            "cost_price": 0,
            "alert_flg": null,
            "is_primary": 1,
            "sell_flg": 1,
            "default_inventory_management_flg": false,
            "regdate": "2025-03-17 15:20:20",
            "last_price": null,
            "last_pricedate": null,
            "product_material": null,
            "product_barcode": null,
            "old_price": null,
            "available": 1
          }
        ]
      }
    ]
  },
  "msg": "",
  "angular_build_version": "82933025dee6ad6ea4d8"
}
Modified at 2025-04-11 08:35:22
Previous
Tạo mới sản phẩm
Next
Tồn kho sản phẩm
Built with