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
    • Xóa khuyến mãi
      POST
  • Đăng ký tài khoản PosApp
    • Danh sách mô hình kinh doanh
      GET
    • Đăng ký tài khoản
      POST
  1. Sản phẩm

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

Developing
Test Env
https://retail-api.posapp.vn/
Test Env
https://retail-api.posapp.vn/
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