API Docs
Home
Home
Developer GuideAPI
StatusWebhooks
Developer GuideAPI
StatusWebhooks
  1. Product Inventory
  • Config
    • List Pickup Address
      GET
    • List Box Dimension
      GET
    • List vendor
      GET
    • List store
      GET
    • List category
      GET
    • List brand
      GET
    • List Outbound Strategy
      GET
    • List Product Type
      GET
    • List Material
      GET
    • List Storage Method
      GET
    • List Unit
      GET
    • Upload File
      POST
  • Online Product
    • Create Single Product
      POST
    • Create Product From Product Inventory
      POST
    • List product
      GET
    • Product detail
      GET
  • Product Inventory
    • Create single inventory product
      POST
    • List product inventory
      GET
    • Product inventory detail
      GET
    • Get Product Inventory in Warehouse
      GET
  • Order
    • Shipping Service
      • Preview shipping prices
        • List shipping service
        • List available courier
      • List available courier from order
      • List shipping service of courier
    • Create order B2C
      POST
    • Create order B2B
      POST
    • List order
      GET
    • Order detail
      GET
    • Cancel order
      PATCH
  • Shipment
    • Create shipment auto
    • [Retail][Ship by self] Create shipment with item
    • Cancel shipment
    • List shipment
    • Shipment detail
    • List shipment of order
  • Shipment Inbound
    • Create shipment inbound
    • Cancel shipment inbound
    • List shipment inbound
    • Shipment inbound detail
    • Shipment inbound items
    • List addtional services
  • Order Return
    • List return order
    • Return order detail
    • Create return order
    • Cancel Return Order
  • Courier
    • List courier service integrated
    • List courier operate
    • List courier integrated
  • Address Directory
    • Province
    • District
    • Ward
  1. Product Inventory

Create single inventory product

POST
/api/v1/public/products/inventory/create
This API creates a new inventory product in the system. The request includes product details such as name, SKU, brand, category, packaging specifications,...

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/public/products/inventory/create' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "sku": "ABL098899",
  "name": "Hộp bánh trung thu",
  "cost": 2190000,
  "sale_price": 2690000,
  "weight": "987",
  "package_length": "30",
  "package_width": "12",
  "package_height": "5",
  "product_brand": {{brand_id}},
  "product_category": {{category_id}},
  "info": {
    "description": "bánh xịn"
  },
  "images": [
    {
      "is_default": true,
      "image_url": "https://nhl.sgp1.cdn.digitaloceanspaces.com/ts/shopping_1760460685.webp"
    }
  ],
  "is_serial_number": 1,
  "is_batch_control": 1,
  "is_bubble_wrap": 1,
  "is_nozzle_reinforcement": 1,
  "is_kraft_paper": 0,
  "is_fragile": 1,
  "is_high_value": 1,
  "is_expiration_control": 0,
  "min_shelf_life_inbound": 60,
  "min_shelf_life_outbound": 45,
  "shelf_life": "365",
  "material": "3PF-BOX",
  "packaging_tape": "3PF-TAPE",
  "product_type": "NORMAL",
  "storage_method": "normal",
  "outbound_strategy": "fefo",
  "unit": {{unit_id}},
  "packing_note": "cần kiểm tra kỹ",
  "documents": [
    {
      "url": "https://nhl.sgp1.cdn.digitaloceanspaces.com/ts/report_inv_by_serial_10_14_2025_1760460887.xlsx",
      "name": "report_inv_by_serial_10_14_2025_1760460887.xlsx",
      "doc_type": 3
    }
  ],
  "barcode_list": [
    {
      "barcode": "ABL098899"
    }
  ],
  "min_stock_warning": 10,
  "config": {
    "validate_all_fields": true,
    "create_inventory_stock": true
  }
}'
Response Response Example
{
    "status_code": 200,
    "data": {
        "product_inventory_id": 43494
    },
    "error": false,
    "error_code": null,
    "log_id": null,
    "messages": "",
    "total": 1,
    "version": "1.0.13"
}
Previous
Product detail
Next
List product inventory
Built with