1. B2C Shipment
Onflow Open API
  • Getting Started
  • Overall logic
  • Error code
  • API
    • Config
      • Get Warehouse
      • Get Brand
      • Get Province
      • Get District
      • Get Ward
      • Upload file
    • Product
      • Create Product
      • Assign Product
      • Get Product List
      • Get Product Detail
      • Get Stock
      • Deactivate Product
    • PO
      • Create PO
      • Get PO List
      • Get PO Bill
      • Get PO Detail
      • Get PO Inspection Detail
      • Cancel PO
    • Shipment
      • B2C Shipment
        • Create B2C Shipment
          POST
        • Get B2C Shipment List
          GET
        • Get B2C Shipment Detail
          GET
        • Cancel B2C Shipment
          PUT
      • B2C Return shipment
        • Create Return B2C Shipment
        • Get Return B2C Shipment List
        • Get Return B2C Shipment Detail
        • Cancel Return B2C Shipment
  • Webhook
    • Shipment
      • Updated Shipment Status
    • Return
      • Updated Return Status
    • PO
      • Updated PO Status
    • Stock
      • Updated Stock
  1. B2C Shipment

Create B2C Shipment

POST
api/v1/shipments/b2c/create
This API is used to create B2C shipments. At this stage, shipment status = NEW.
Please note that we currently only support orders from platforms such as Shopee, Lazada, TikTok, and Tiki. The retail flow will be released later, expected in late April or early May 2026.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'api/v1/shipments/b2c/create' \
--header 'Authorization: {{token}}' \
--header 'Accept-Language: vi' \
--header 'Content-Type: application/json' \
--data-raw '{
    "warehouse_code": "ONF_WH_HN_LB",
    "platform": "lazada",
    "merchant_tracking_code_reference": "{{merchant_tracking_code_reference}}",
    "partner_tracking_code": "{{partner_tracking_code}}",
    "courier_tracking_code": "{{courier_tracking_code}}",
    "fulfill_type": "NORMAL",
    "is_bulky": "TRUE",
    "items": [
        {
            "oasin": "OASIN2200579",
            "product_quantity": 1,
            "stock_level": "A"
        }
    ],
    "sla_handover_marketplace_time": {
        {three_days_later
        }
    },
    "sla_cancel_marketplace_time": {
        {three_days_later
        }
    },
    "carrier_code": "GHTK",
    "shipment_value": 0,
    "awb_url": "https://nhl.sgp1.cdn.digitaloceanspaces.com/ts/cade9c0a4f714414ab2f9cccdaa957e2.pdf"
}'
Response Response Example
{
    "data": {
        "tracking_code": "OASC85697101",
        "status_info": {
            "value": 100,
            "label": "Mới tạo",
            "updated_time": 1774426772
        },
        "created_time": 1774426772
    },
    "error": false,
    "error_code": null,
    "log_id": null,
    "messages": "OK",
    "total": 1,
    "version": "1.0.3",
    "error_detail": null
}
Modified at 2026-04-29 07:15:25
Previous
Cancel PO
Next
Get B2C Shipment List
Built with