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 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 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

Cancel PO

Get B2C Shipment List