1. Introduction

2. Inbound Order Module API

2.1. Create Inbound Order API

2.1.1. SERVICE_TYPE

GLINK_CREATE_ASN_NOTIFY

2.1.2. Request Parameters

Create inbound order request

Parameter Type List Required Description
partnerId string N Y Partner ID, used for customer routing and validation
customerCode string N Y Customer code
warehouseCode string N Y Warehouse code
asnNumber string N Y Inbound order number
extAsnNumber string N N External inbound order number
extUserId string N N External user ID
asnType string N N Inbound order type; when empty, defaults to SUPPLIER_RECEIPT. optional values: SUPPLIER_RECEIPT (purchase receipt), RETURN (return receipt), OTHER_INBOUND (other inbound), PURCHASE (purchase/ERP requires shipping marks), MANUAL (manual/other inbound), FIRST_LEG (first-leg inbound), TRANSFER_PLAN (transfer plan inbound), TRANSFER_AVAILABLE (available inventory transfer inbound)
trackingNumber string N N Tracking number
referenceNumber string N N Reference number
containerNumber string N N Container number
sealNumber string N N Seal number
expectedReceiptDate date N N Expected receipt date
warehouseNotes string N N Warehouse notes, emoji are filtered before saving
carrier string N N Carrier
supplier string N N Supplier
capacityType string N N Arrival method/container type; common values: LTL (LTL freight), PARCEL (parcel), 40HQ (40-foot high-cube container), 20GP (20-foot general-purpose container), etc.
isSpecifyBatch boolean N N Whether the specified-batch flag is enabled
snUrl string N N SN list file URL
udf5 string N N User-defined field 5
udf6 string N N User-defined field 6
udf7 string N N User-defined field 7
udf8 string N N User-defined field 8
udf9 string N N User-defined field 9
udf10 string N N User-defined field 10
udf11 string N N User-defined field 11
udf12 string N N User-defined field 12
asnTagList long Y N Inbound order tag list
asnLineItems object Y Y Inbound order item information
└ sku string N Y Item code
└ quantity int N Y Item quantity, must be greater than 0
└ lineNo string N N Line number; the system generates it automatically when empty
└ skuStatus string N N Stock status; when empty, defaults to GOOD. GOOD (good), DAMAGE (damaged)
└ poNumber string N N PO number
└ poLineNo string N N PO line number
└ markCode string N N Shipping mark code
└ barCodeEA string N N EA unit barcode
└ mfgDate string N N Manufacturing date
└ expDate string N N Expiration date
└ batchNo string N N Batch number
└ originCountry string N N Country of origin
└ udf1 string N N User-defined field 1
└ udf2 string N N User-defined field 2
└ udf3 string N N User-defined field 3
└ udf4 string N N User-defined field 4
└ udf5 string N N User-defined field 5
└ udf6 string N N User-defined field 6
└ udf7 string N N User-defined field 7
└ udf8 string N N User-defined field 8
└ udf9 string N N User-defined field 9
└ udf10 string N N User-defined field 10
└ udf11 string N N User-defined field 11
└ udf12 string N N User-defined field 12
markList object Y N Shipping mark information
└ markCode string N Y Shipping mark code
└ weight decimal N N Carton weight
└ length decimal N N Carton length
└ width decimal N N Carton width
└ height decimal N N Carton height
└ lengthUnit string N N Length unit; cm: centimeter, In: inch, m: meter
└ weightUnit string N N Weight unit; KG: kilogram, LBS: pound, GRAM: gram

2.1.3. Request Example

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "asnNumber": "ASN202606050001",
  "extAsnNumber": "EXTASN202606050001",
  "extUserId": "EXT_USER_001",
  "asnType": "SUPPLIER_RECEIPT",
  "trackingNumber": "TRK202606050001",
  "referenceNumber": "REF202606050001",
  "containerNumber": "CONT202606050001",
  "sealNumber": "SEAL202606050001",
  "expectedReceiptDate": "2026-06-06 09:00:00",
  "warehouseNotes": "到货前请提前预约",
  "carrier": "BEST",
  "supplier": "SUPPLIER001",
  "capacityType": "LTL",
  "isSpecifyBatch": false,
  "snUrl": "https://example.com/files/asn-sn.xlsx",
  "udf5": "自定义字段5",
  "udf6": "自定义字段6",
  "udf7": "自定义字段7",
  "udf8": "自定义字段8",
  "udf9": "自定义字段9",
  "udf10": "自定义字段10",
  "udf11": "自定义字段11",
  "udf12": "自定义字段12",
  "asnTagList": [1001],
  "asnLineItems": [
    {
      "sku": "SKU001",
      "quantity": 10,
      "lineNo": "1",
      "skuStatus": "GOOD",
      "poNumber": "PO202606050001",
      "poLineNo": "10",
      "markCode": "MARK001",
      "barCodeEA": "690000000001",
      "mfgDate": "2026-05-01",
      "expDate": "2027-05-01",
      "batchNo": "BATCH20260501",
      "originCountry": "CN",
      "udf1": "自定义字段1",
      "udf2": "自定义字段2",
      "udf3": "自定义字段3",
      "udf4": "自定义字段4",
      "udf5": "自定义字段5",
      "udf6": "自定义字段6",
      "udf7": "自定义字段7",
      "udf8": "自定义字段8",
      "udf9": "自定义字段9",
      "udf10": "自定义字段10",
      "udf11": "自定义字段11",
      "udf12": "自定义字段12"
    }
  ],
  "markList": [
    {
      "markCode": "MARK001",
      "weight": 12.5,
      "length": 40.0,
      "width": 30.0,
      "height": 20.0,
      "lengthUnit": "cm",
      "weightUnit": "KG"
    }
  ]
}

2.1.4. Response Parameters

Parameter Type List Required Description
success boolean N Y Operation result, true means processed successfully, false means processing failed
code string N N Operation status code
message string N N Message

2.1.5. Response Example

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "success"
}

2.2. Cancel Inbound Order API

2.2.1. SERVICE_TYPE

GLINK_CANCEL_ASN_NOTIFY

2.2.2. Request Parameters

Cancel inbound order request

Parameter Type List Required Description
partnerId string N Y Partner ID, used for customer routing and validation
customerCode string N Y Customer code
asnNumbers string Y Y Inbound order number list; the API processes only the first inbound order in the list per call
extUserId string N N External user ID

2.2.3. Request Example

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "asnNumbers": [
    "ASN202606050001"
  ],
  "extUserId": "EXT_USER_001"
}

2.2.4. Response Parameters

Parameter Type List Required Description
success boolean N Y Operation result, true means processed successfully, false means processing failed
code string N N Operation status code
message string N N Message

2.2.5. Response Example

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "success"
}

2.3. Query Inbound Order API

2.3.1. SERVICE_TYPE

GLINK_QUERY_ASN_NOTIFY

2.3.2. Request Parameters

Query inbound order request

Parameter Type List Required Description
partnerId string N Y Partner ID, used for customer routing
customerCode string N Y Customer code
asnNumbers string Y Y Inbound order number list, maximum 100, must not be an empty string
extUserId string N N External user ID

2.3.3. Request Example

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "asnNumbers": [
    "ASN202606050001"
  ],
  "extUserId": "EXT_USER_001"
}

2.3.4. Response Parameters

Parameter Type List Required Description
success boolean N Y Success flag
code string N N Response code
message string N N Response message
asnInfoList object Y N Inbound order information list
└ customerCode string N Y Customer code
└ warehouseCode string N N Warehouse code
└ warehouseNotes string N N Warehouse notes
└ asnNumber string N Y Inbound order number
└ extAsnNumber string N N External inbound order number
└ extUserId string N N External user ID
└ wmsAsnNumber string N N WMS inbound order number
└ carrier string N N Carrier
└ poNumber string N N PO number
└ receiveTime string N N Receipt time
└ remark string N N Description
└ status string N N Inbound order status; SendingToWMS (sending to warehouse), Received (received/accepted by warehouse), Error (exception), Voided (voided), Fulfilled (fulfilled)
└ asnType string N N Inbound order type; SUPPLIER_RECEIPT (purchase receipt), RETURN (return receipt), OTHER_INBOUND (other inbound), PURCHASE (purchase/ERP requires shipping marks), MANUAL (manual/other inbound), FIRST_LEG (first-leg inbound), TRANSFER_PLAN (transfer plan inbound), TRANSFER_AVAILABLE (available inventory transfer inbound)
└ trackingNumber string N N Tracking number
└ referenceNumber string N N Reference number
└ containerNumber string N N Container number
└ sealNumber string N N Seal number
└ snUrl string N N SN list file URL
└ asnLineItems object Y N Inbound order item information
  └ sku string N N Item code
  └ quantity int N N Received quantity
  └ putawayedQuantity int N N Putaway quantity
  └ lineNo string N N Line number
  └ expectedQuantity int N N Expected quantity
  └ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
  └ mfgDate string N N Manufacturing date
  └ expDate string N N Expiration date
  └ originCountry string N N Country of origin
  └ batchNo string N N Batch number

2.3.5. Response Example

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "asnInfoList": [
    {
      "customerCode": "CUSTOMER001",
      "warehouseCode": "WH001",
      "warehouseNotes": "到货前请提前预约",
      "asnNumber": "ASN202606050001",
      "extAsnNumber": "EXTASN202606050001",
      "extUserId": "EXT_USER_001",
      "wmsAsnNumber": "WMSASN202606050001",
      "carrier": "BEST",
      "poNumber": "PO202606050001",
      "receiveTime": "2026-06-05 10:30:00",
      "remark": "",
      "status": "Received",
      "asnType": "SUPPLIER_RECEIPT",
      "trackingNumber": "TRK202606050001",
      "referenceNumber": "REF202606050001",
      "containerNumber": "CONT202606050001",
      "sealNumber": "SEAL202606050001",
      "snUrl": "https://example.com/files/asn-sn.xlsx",
      "asnLineItems": [
        {
          "sku": "SKU001",
          "quantity": 10,
          "putawayedQuantity": 8,
          "lineNo": "1",
          "expectedQuantity": 10,
          "skuStatus": "GOOD",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "originCountry": "CN",
          "batchNo": "BATCH20260501"
        }
      ]
    }
  ]
}

2.4. Query Inbound Order API (V2)

2.4.1. SERVICE_TYPE

GLINK_BATCH_QUERY_ASN_NOTIFY

2.4.2. Request Parameters

Query inbound order request

Parameter Type List Required Description
partnerId string N N Partner ID
customerCode string N Y Customer code
warehouseCode string N Y Warehouse code
asnNumbers string Y N Inbound order number list, maximum 100
refNumbers string Y N Reference number list
asnType string N N Inbound order type; SUPPLIER_RECEIPT (purchase receipt), RETURN (return receipt), OTHER_INBOUND (other inbound), PURCHASE (purchase/ERP requires shipping marks), MANUAL (manual/other inbound), FIRST_LEG (first-leg inbound), TRANSFER_PLAN (transfer plan inbound), TRANSFER_AVAILABLE (available inventory transfer inbound)
extUserId string N N External user ID
receiveTimeFrom string N N Receipt time from, format yyyy-MM-dd HH:mm:ss
receiveTimeTo string N N Receipt time to, format yyyy-MM-dd HH:mm:ss
putawayCompletedTimeFrom string N N Putaway completion time from, format yyyy-MM-dd HH:mm:ss
putawayCompletedTimeTo string N N Putaway completion time to, format yyyy-MM-dd HH:mm:ss
createdTimeFrom string N N Creation time from, format yyyy-MM-dd HH:mm:ss
createdTimeTo string N N Creation time to, format yyyy-MM-dd HH:mm:ss
lastUpdatedTimeFrom string N N Last update time from, format yyyy-MM-dd HH:mm:ss
lastUpdatedTimeTo string N N Last update time to, format yyyy-MM-dd HH:mm:ss
stage string N N Inbound stage; common values: DUE_IN (due in), ARRIVED (arrived), INSPECTING (under inspection), INSPECTED (inspected), RECEIVING (receiving), RECEIVED (received), CLOSED (closed), VOID (voided)
ifNeedBatchInfo boolean N N Whether to return batch information; defaults to false
page int N N Page number; empty, defaults to 1
pageSize int N N Records per page; empty, defaults to 100, maximum 200

When both asnNumbers and refNumbers are empty, creation time, last update time, receipt time, at least one complete start/end time range must be provided.

2.4.3. Request Example

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "asnNumbers": [
    "ASN202606050001"
  ],
  "refNumbers": [
    "REF202606050001"
  ],
  "asnType": "SUPPLIER_RECEIPT",
  "extUserId": "EXT_USER_001",
  "receiveTimeFrom": "2026-06-05 00:00:00",
  "receiveTimeTo": "2026-06-05 23:59:59",
  "stage": "CLOSED",
  "ifNeedBatchInfo": true,
  "page": 1,
  "pageSize": 50
}

2.4.4. Response Parameters

Parameter Type List Required Description
success boolean N Y Success flag
code string N N Response code
message string N N Response message
total long N N Total record count
asnInfoList object Y N Inbound order information on the current page
└ partnerId string N N Partner ID
└ customerCode string N Y Customer code
└ warehouseCode string N Y Warehouse code
└ warehouseNotes string N N Warehouse notes
└ asnNumber string N Y Inbound order number
└ extAsnNumber string N N External inbound order number
└ wmsAsnNumber string N N WMS inbound order number
└ extUserId string N N External user ID
└ carrier string N N Carrier
└ receiveTime string N N Receipt time
└ remark string N N Description
└ status string N N Inbound order status; SendingToWMS (sending to warehouse), Received (received/accepted by warehouse), Error (exception), Voided (voided), Fulfilled (fulfilled)
└ wmsStatus string N N WMS inbound order status; common values: DUE_IN (due in), ARRIVED (arrived), INSPECTING (under inspection), INSPECTED (inspected), RECEIVING (receiving), RECEIVED (received), CLOSED (closed), VOID (voided)
└ stage string N N Inbound stage; common values: DUE_IN (due in), ARRIVED (arrived), INSPECTING (under inspection), INSPECTED (inspected), RECEIVING (receiving), RECEIVED (received), CLOSED (closed), VOID (voided)
└ putawayStage string N N Putaway stage; PENDING (pending putaway), IN PROGRESS (putaway in progress), COMPLETED (putaway completed)
└ asnType string N N Inbound order type; SUPPLIER_RECEIPT (purchase receipt), RETURN (return receipt), OTHER_INBOUND (other inbound), PURCHASE (purchase/ERP requires shipping marks), MANUAL (manual/other inbound), FIRST_LEG (first-leg inbound), TRANSFER_PLAN (transfer plan inbound), TRANSFER_AVAILABLE (available inventory transfer inbound)
└ trackingNumber string N N Tracking number
└ referenceNumber string N N Reference number
└ containerNumber string N N Container number
└ sealNumber string N N Seal number
└ expectedReceiptDate string N N Expected receipt date
└ wmsDocSource string N N Warehouse document source; common values: ENTRY (back-office entry), API (created by API), PO (generated from purchase order), AUTO_GWMS (automatically generated by warehouse)
└ orderNumber string N N Related outbound order number
└ itemLineQty int N N Number of inbound order item lines
└ supplier string N N Supplier
└ putawayTime string N N Putaway completion time
└ arrivalTime string N N Arrival time
└ udf5 string N N User-defined field 5
└ udf6 string N N User-defined field 6
└ udf7 string N N User-defined field 7
└ udf8 string N N User-defined field 8
└ udf9 string N N User-defined field 9
└ udf10 string N N User-defined field 10
└ udf11 string N N User-defined field 11
└ udf12 string N N User-defined field 12
└ snUrl string N N SN list file URL
└ asnLineItems object Y N Inbound order item information
  └ sku string N N Item code
  └ quantity int N N Quantity
  └ lineNo string N N Line number
  └ putawayedQuantity int N N Putaway quantity
  └ expectedQuantity int N N Expected quantity
  └ poLineNo string N N PO line number
  └ poNumber string N N PO number
  └ skuLength double N N SKU length
  └ skuWidth double N N SKU width
  └ skuHeight double N N SKU height
  └ dimensionUnit string N N Dimension unit; cm: centimeter, inch: inch
  └ skuWeight double N N SKU weight
  └ weightUnit string N N Weight unit; KG: kilogram, LBS: pound, GRAM: gram
  └ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
  └ mfgDate string N N Manufacturing date
  └ expDate string N N Expiration date
  └ batchNo string N N Batch number
  └ originCountry string N N Country of origin
  └ udf1 string N N User-defined field 1
  └ udf2 string N N User-defined field 2
  └ udf3 string N N User-defined field 3
  └ udf4 string N N User-defined field 4
  └ udf5 string N N User-defined field 5
  └ udf6 string N N User-defined field 6
  └ udf7 string N N User-defined field 7
  └ udf8 string N N User-defined field 8
  └ udf9 string N N User-defined field 9
  └ udf10 string N N User-defined field 10
  └ udf11 string N N User-defined field 11
  └ udf12 string N N User-defined field 12
└ adjustInfos object Y N Inbound adjustment information
  └ sku string N N Item code
  └ adjustQty int N N Adjustment quantity
  └ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
  └ mfgDate string N N Manufacturing date
  └ expDate string N N Expiration date
  └ batchNo string N N Batch number
  └ originCountry string N N Country of origin
└ asnItemReceiveDetails object Y N Inbound item receipt/putaway details
  └ lineNo string N N Line number
  └ detailId string N N Voucher detail ID
  └ sku string N N Item code
  └ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
  └ receiveQty int N N Received quantity
  └ receiveTime string N N Receipt time
  └ putawayQty int N N Putaway quantity
  └ putawayTime string N N Putaway time
  └ originCountry string N N Country of origin
  └ batchNo string N N Batch number
  └ expDate string N N Expiration date
  └ mfgDate string N N Manufacturing date
└ batchInfo object Y N Batch information, assembled only when ifNeedBatchInfo=true
  └ lineNo string N N Line number
  └ sku string N N Item code
  └ quantity double N N Batch quantity
  └ stockStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
  └ batchNumber string N N Batch number
  └ mfgDate string N N Manufacturing date
  └ expDate string N N Expiration date
  └ originCountry string N N Country of origin
└ additionalInfoList object Y N Additional information
  └ infoType string N N Additional information type name
  └ infoTypeCode string N N Additional information type code; common values: NO_EXCEPTION (no exception), WRONG_SKU (wrong SKU), DAMAGED_SKU (damaged goods), OTHER (other), etc.
  └ content string N N Information content
  └ note string N N Information description
  └ uploadedTime string N N Upload time
  └ asnAdditionalFiles object Y N File list
    └ fileName string N N Attachment name
    └ fileUrl string N N Attachment URL
    └ fileType string N N Attachment type; common values: BILL_OF_LADING (bill of lading), PACKING_LIST (packing list), OTHER (other)
    └ fileFormat string N N Attachment format
    └ isUpdate boolean N N Whether to update the attachment
    └ fileBase64 string N N Base64 file content

2.4.5. Response Example

JSON

{
  "success": true,
  "code": null,
  "message": null,
  "total": 1,
  "asnInfoList": [
    {
      "partnerId": "GLINK",
      "customerCode": "CUSTOMER001",
      "warehouseCode": "WH001",
      "warehouseNotes": "到货外箱完好",
      "asnNumber": "ASN202606050001",
      "extAsnNumber": "ASN202606050001",
      "wmsAsnNumber": "WMSASN202606050001",
      "extUserId": "EXT_USER_001",
      "carrier": "BEST",
      "receiveTime": "2026-06-05 10:30:00",
      "remark": "",
      "status": "Received",
      "wmsStatus": "CLOSED",
      "stage": "CLOSED",
      "putawayStage": "COMPLETED",
      "asnType": "SUPPLIER_RECEIPT",
      "trackingNumber": "TRK202606050001",
      "referenceNumber": "REF202606050001",
      "containerNumber": "CONT202606050001",
      "sealNumber": "SEAL202606050001",
      "expectedReceiptDate": "2026-06-06 09:00:00",
      "wmsDocSource": "API",
      "orderNumber": "SO202606050001",
      "itemLineQty": 1,
      "supplier": "SUPPLIER001",
      "putawayTime": "2026-06-05 11:20:00",
      "arrivalTime": "2026-06-05 09:20:00",
      "udf5": "自定义字段5",
      "udf6": "自定义字段6",
      "udf7": "自定义字段7",
      "udf8": "自定义字段8",
      "udf9": "自定义字段9",
      "udf10": "自定义字段10",
      "udf11": "自定义字段11",
      "udf12": "自定义字段12",
      "snUrl": "https://example.com/files/asn-sn.xlsx",
      "asnLineItems": [
        {
          "sku": "SKU001",
          "quantity": 10,
          "lineNo": "1",
          "putawayedQuantity": 8,
          "expectedQuantity": 10,
          "poLineNo": "10",
          "poNumber": "PO202606050001",
          "skuLength": 10.0,
          "skuWidth": 8.0,
          "skuHeight": 5.0,
          "dimensionUnit": "cm",
          "skuWeight": 0.5,
          "weightUnit": "KG",
          "skuStatus": "GOOD",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "batchNo": "BATCH20260501",
          "originCountry": "CN",
          "udf1": "自定义字段1",
          "udf2": "自定义字段2",
          "udf3": "自定义字段3",
          "udf4": "自定义字段4",
          "udf5": "自定义字段5",
          "udf6": "自定义字段6",
          "udf7": "自定义字段7",
          "udf8": "自定义字段8",
          "udf9": "自定义字段9",
          "udf10": "自定义字段10",
          "udf11": "自定义字段11",
          "udf12": "自定义字段12"
        }
      ],
      "adjustInfos": [
        {
          "sku": "SKU001",
          "adjustQty": -1,
          "skuStatus": "GOOD",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "batchNo": "BATCH20260501",
          "originCountry": "CN"
        }
      ],
      "asnItemReceiveDetails": [
        {
          "lineNo": "1",
          "detailId": "RV202606050001",
          "sku": "SKU001",
          "skuStatus": "GOOD",
          "receiveQty": 10,
          "receiveTime": "2026-06-05 10:30:00",
          "putawayQty": 8,
          "putawayTime": "2026-06-05 11:20:00",
          "originCountry": "CN",
          "batchNo": "BATCH20260501",
          "expDate": "2027-05-01",
          "mfgDate": "2026-05-01"
        }
      ],
      "batchInfo": [
        {
          "lineNo": "1",
          "sku": "SKU001",
          "quantity": 10.0,
          "stockStatus": "GOOD",
          "batchNumber": "BATCH20260501",
          "mfgDate": "2026-05-01",
          "expDate": "2027-05-01",
          "originCountry": "CN"
        }
      ],
      "additionalInfoList": [
        {
          "infoType": "无异常",
          "infoTypeCode": "NO_EXCEPTION",
          "content": "到货照片",
          "note": "外箱照片",
          "uploadedTime": "2026-06-05 10:40:00",
          "asnAdditionalFiles": [
            {
              "fileName": "receipt-photo.jpg",
              "fileUrl": "https://example.com/files/receipt-photo.jpg",
              "fileType": "OTHER",
              "fileFormat": "JPG",
              "isUpdate": false,
              "fileBase64": ""
            }
          ]
        }
      ]
    }
  ]
}

2.5. Inbound Order Feedback API

2.5.1. SERVICE_TYPE

GLINK_UPDATE_ASN_STATUS

2.5.2. API Description

When the inbound order status changes, the platform pushes inbound order information to the customer system according to configuration. The customer system must return the processing result.

2.5.3. Request Parameters

Inbound order feedback information

Parameter Type List Required Description
partnerId string N Y Partner ID
asnNumber string N Y Inbound order number
wmsAsnNumber string N Y WMS inbound order number
status string N Y Inbound order feedback status. when the inbound order is closed (stage=CLOSED) and putaway is not completed, returns RECEIVED (received); otherwise returns the inbound stage. common values: DUE_IN (due in), ARRIVED (arrived), INSPECTING (under inspection), INSPECTED (inspected), RECEIVING (receiving), RECEIVED (received), CLOSED (closed/completed), VOID (voided)
customerCode string N Y Customer code
warehouseCode string N N Warehouse code
receiveTime string N N Receipt time, format yyyy-MM-dd HH:mm:ss
remark string N N Description, currently fixed as an empty string
asnType string N N Inbound order type; SUPPLIER_RECEIPT (purchase receipt), RETURN (return receipt), OTHER_INBOUND (other inbound), PURCHASE (purchase/ERP requires shipping marks), MANUAL (manual/other inbound), FIRST_LEG (first-leg inbound), TRANSFER_PLAN (transfer plan inbound), TRANSFER_AVAILABLE (available inventory transfer inbound)
expectedReceiptDate string N N Expected receipt date
wmsDocSource string N N Warehouse document source; common values: ENTRY (back-office entry), API (created by API), PO (generated from purchase order), AUTO_GWMS (automatically generated by warehouse)
trackingNumber string N N Tracking number
warehouseNotes string N N Warehouse notes
referenceNumber string N N Reference number
orderNumber string N N Related outbound order number
carrier string N N Carrier
extUserId string N N External user ID
stage string N N Inbound stage; common values: DUE_IN (due in), ARRIVED (arrived), INSPECTING (under inspection), INSPECTED (inspected), RECEIVING (receiving), RECEIVED (received), CLOSED (closed), VOID (voided)
putawayStage string N N Putaway stage; PENDING (pending putaway), IN PROGRESS (putaway in progress), COMPLETED (putaway completed)
handlings object N N Inbound order handling/billing information
└ arrivalDate string N N Arrival time
└ capacityType string N N Arrival method/container type; common values: LTL (LTL freight), PARCEL (parcel), 40HQ (40-foot high-cube container), 20GP (20-foot general-purpose container), etc.
└ preBuilt boolean N N Whether pallets are pre-built
└ palletQty int N N Pallet quantity
└ cartonQty int N N Carton quantity
└ volume float N N Volume
└ lengthUnit string N N Length unit; cm: centimeter, In: inch, m: meter
└ weight float N N Weight
└ weightUnit string N N Weight unit; KG: kilogram, LBS: pound, GRAM: gram
└ note string N N Description
└ handlingDetailList object Y N Handling detail list
  └ chargeType string N N Handling/billing activity type; common values: INBOUND (inbound handling), OUTBOUND (outbound handling), etc., specific values depend on warehouse configuration
  └ chargeUnit string N N Handling/billing activity unit; common values: PIECE (piece), COUNT (count), MANHOUR (man-hour), etc.
  └ chargeQty float N N Activity quantity
  └ chargeManHour float N N Total activity duration
  └ chargeNote string N N Description
asnLineItems object Y N Item feedback information
└ lineNo string N N Line number
└ sku string N N Item code
└ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
└ mfgDate string N N Manufacturing date
└ expDate string N N Expiration date
└ batchNo string N N Batch number
└ originCountry string N N Country of origin
└ expectedQuantity int N N Expected quantity
└ poLineNo string N N PO line number
└ poNumber string N N PO number
└ quantity int N N Available quantity, based on received or putaway quantity depending on the salable timing
└ putawayedQuantity int N N Putaway quantity
└ skuHeight double N N SKU height
└ skuWidth double N N SKU width
└ skuLength double N N SKU length
└ dimensionUnit string N N Dimension unit; cm: centimeter, inch: inch
└ skuWeight double N N SKU weight
└ weightUnit string N N Weight unit; KG: kilogram, LBS: pound, GRAM: gram
└ udf1 string N N User-defined field 1
└ udf2 string N N User-defined field 2
└ udf3 string N N User-defined field 3
└ udf4 string N N User-defined field 4
└ udf5 string N N User-defined field 5
└ udf6 string N N User-defined field 6
└ udf7 string N N User-defined field 7
└ udf8 string N N User-defined field 8
└ udf9 string N N User-defined field 9
└ udf10 string N N User-defined field 10
└ udf11 string N N User-defined field 11
└ udf12 string N N User-defined field 12
adjustInfos object Y N Inbound adjustment information
└ sku string N N Item code
└ adjustQty int N N Adjustment quantity
└ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
└ mfgDate string N N Manufacturing date
└ expDate string N N Expiration date
└ batchNo string N N Batch number
└ originCountry string N N Country of origin
asnItemReceiveDetails object Y N Inbound item receipt/putaway details
└ lineNo string N N Line number
└ detailId string N N Detail ID
└ sku string N N Item code
└ skuStatus string N N Stock status; GOOD (good), DAMAGE (damaged)
└ receiveQty int N N Received quantity
└ receiveTime string N N Receipt time
└ putawayQty int N N Putaway quantity
└ putawayTime string N N Putaway time
└ originCountry string N N Country of origin
└ batchNo string N N Batch number
└ expDate string N N Expiration date
└ mfgDate string N N Manufacturing date
additionalInfoList object Y N Additional information
└ infoType string N N Additional information type name
└ infoTypeCode string N N Additional information type code; common values: NO_EXCEPTION (no exception), WRONG_SKU (wrong SKU), DAMAGED_SKU (damaged goods), OTHER (other), etc.
└ content string N N Information content
└ note string N N Information description
└ uploadedTime string N N Upload time
└ asnAdditionalFiles object Y N File list
  └ fileName string N N Attachment name
  └ fileUrl string N N Attachment URL
  └ fileType string N N Attachment type; common values: BILL_OF_LADING (bill of lading), PACKING_LIST (packing list), OTHER (other)
  └ fileFormat string N N Attachment format
  └ isUpdate boolean N N Whether to update the attachment
  └ fileBase64 string N N Base64 file content
snUrl string N N SN list file URL

2.5.4. Request Example

JSON

{
  "partnerId": "GLINK",
  "asnNumber": "ASN202606050001",
  "wmsAsnNumber": "WMSASN202606050001",
  "status": "RECEIVED",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "receiveTime": "2026-06-05 10:30:00",
  "remark": "",
  "asnType": "SUPPLIER_RECEIPT",
  "expectedReceiptDate": "2026-06-06 09:00:00",
  "wmsDocSource": "API",
  "trackingNumber": "TRK202606050001",
  "warehouseNotes": "到货外箱完好",
  "referenceNumber": "REF202606050001",
  "orderNumber": "SO202606050001",
  "carrier": "BEST",
  "extUserId": "EXT_USER_001",
  "stage": "CLOSED",
  "putawayStage": "IN PROGRESS",
  "handlings": {
    "arrivalDate": "2026-06-05 09:20:00",
    "capacityType": "LTL",
    "preBuilt": false,
    "palletQty": 2,
    "cartonQty": 20,
    "volume": 1.5,
    "lengthUnit": "cm",
    "weight": 120.5,
    "weightUnit": "KG",
    "note": "正常卸货",
    "handlingDetailList": [
      {
        "chargeType": "INBOUND",
        "chargeUnit": "MANHOUR",
        "chargeQty": 2.0,
        "chargeManHour": 1.5,
        "chargeNote": "卸货服务"
      }
    ]
  },
  "asnLineItems": [
    {
      "lineNo": "1",
      "sku": "SKU001",
      "skuStatus": "GOOD",
      "mfgDate": "2026-05-01",
      "expDate": "2027-05-01",
      "batchNo": "BATCH20260501",
      "originCountry": "CN",
      "expectedQuantity": 10,
      "poLineNo": "10",
      "poNumber": "PO202606050001",
      "quantity": 10,
      "putawayedQuantity": 8,
      "skuHeight": 5.0,
      "skuWidth": 8.0,
      "skuLength": 10.0,
      "dimensionUnit": "cm",
      "skuWeight": 0.5,
      "weightUnit": "KG",
      "udf1": "自定义字段1",
      "udf2": "自定义字段2",
      "udf3": "自定义字段3",
      "udf4": "自定义字段4",
      "udf5": "自定义字段5",
      "udf6": "自定义字段6",
      "udf7": "自定义字段7",
      "udf8": "自定义字段8",
      "udf9": "自定义字段9",
      "udf10": "自定义字段10",
      "udf11": "自定义字段11",
      "udf12": "自定义字段12"
    }
  ],
  "adjustInfos": [
    {
      "sku": "SKU001",
      "adjustQty": -1,
      "skuStatus": "GOOD",
      "mfgDate": "2026-05-01",
      "expDate": "2027-05-01",
      "batchNo": "BATCH20260501",
      "originCountry": "CN"
    }
  ],
  "asnItemReceiveDetails": [
    {
      "lineNo": "1",
      "detailId": "D202606050001",
      "sku": "SKU001",
      "skuStatus": "GOOD",
      "receiveQty": 10,
      "receiveTime": "2026-06-05 10:30:00",
      "putawayQty": 8,
      "putawayTime": "2026-06-05 11:20:00",
      "originCountry": "CN",
      "batchNo": "BATCH20260501",
      "expDate": "2027-05-01",
      "mfgDate": "2026-05-01"
    }
  ],
  "additionalInfoList": [
    {
      "infoType": "无异常",
      "infoTypeCode": "NO_EXCEPTION",
      "content": "到货照片",
      "note": "外箱照片",
      "uploadedTime": "2026-06-05 10:40:00",
      "asnAdditionalFiles": [
        {
          "fileName": "receipt-photo.jpg",
          "fileUrl": "https://example.com/files/receipt-photo.jpg",
          "fileType": "PHOTO",
          "fileFormat": "JPG",
          "isUpdate": false,
          "fileBase64": ""
        }
      ]
    }
  ],
  "snUrl": "https://example.com/files/asn-sn.xlsx"
}

2.5.5. Response Parameters

Parameter Type List Required Description
success boolean N Y External system processing result, true means processed successfully, false means processing failed
code string N N Operation status code
message string N N Message

2.5.6. Response Example

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": ""
}
© Copyright QianYi Team 2025 All Rights Reserved            Updated 2026-06-23 11:32:33

results matching ""

    No results matching ""