1.1. 入库单查询接口

post {HTTP(S)地址}/api/{version}/asn

1.1.1. SERVICE_TYPE

QUERY_ASN_LIST

1.1.2. 请求参数

AsnTag(入库单下发状态)

1.1.3. 返回参数

Asn(入库单)

SkuCustomFieldValueVO(自定义栏位信息)

AsnSku(入库单商品)

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/asn' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_ASN_LIST"' \
--form 'bizParam="{\"page\":1,\"pageSize\":3}"' \
--form 'timestamp="1756865700001"' \
--form 'sign="72309a741bb0b39db6a8a1144bf1c9d9"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"asnNumber\":\"A250903149242\",\"asnSkuVOList\":[{\"damageNum\":0,\"expectBadQuantity\":0,\"expectQuantity\":30,\"firstLegPrice\":10.00,\"goodNum\":0,\"isDeleted\":0,\"perBoxQuantity \":1,\"purchasePrice\":100.0000,\"receiveQuantity\":0,\"sku\":\"sea002\",\"title\":\"海仓测试商品\",\"transferPrice\":10.0000}],\"containerNumber\":\"12112\",\"createTime\":\"2025-09-03 14:12:52\",\"customNumber\":\"111\",\"firstLegPriceCurrency\":\"CNY\",\"isDeleted\":0,\"logisticsName\":\"0724-BEST_ChannelName\",\"purchasePriceCurrency\":\"CNY\",\"remark\":\"111\",\"status\":\"SHIPPING\",\"tag\":{\"boxedNeedSend\":0,\"comparedTagValue\":63,\"fullTagValue\":2,\"overcharge\":0,\"receiveException\":0,\"relation\":0,\"sendFailed\":1,\"sendWms\":0,\"waitBoxing\":0},\"trackNumber\":\"1121211\",\"transferPriceCurrency\":\"CNY\",\"type\":\"MANUAL\",\"updateTime\":\"2025-09-03 14:18:38\",\"warehouseName\":\"泰国演示1仓\"},{\"asnNumber\":\"A250903149241\",\"asnSkuVOList\":[{\"damageNum\":0,\"expectBadQuantity\":0,\"expectQuantity\":1,\"firstLegPrice\":1.00,\"goodNum\":0,\"isDeleted\":0,\"purchasePrice\":1.0000,\"receiveQuantity\":0,\"sku\":\"testgg01\",\"title\":\"Uji nama bahasa Cina\",\"transferPrice\":1.0000}],\"createTime\":\"2025-09-03 13:43:29\",\"customNumber\":\"1\",\"firstLegPriceCurrency\":\"CNY\",\"isDeleted\":0,\"logisticsName\":\"-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1-1\",\"purchasePriceCurrency\":\"CNY\",\"remark\":\"\",\"status\":\"SHIPPING\",\"tag\":{\"boxedNeedSend\":0,\"comparedTagValue\":63,\"fullTagValue\":2,\"overcharge\":0,\"receiveException\":0,\"relation\":0,\"sendFailed\":1,\"sendWms\":0,\"waitBoxing\":0},\"transferPriceCurrency\":\"CNY\",\"type\":\"MANUAL\",\"updateTime\":\"2025-09-03 13:43:37\",\"warehouseName\":\"best warehouse（测试用）\"},{\"asnNumber\":\"A250903149240\",\"asnSkuVOList\":[{\"damageNum\":0,\"expectBadQuantity\":0,\"expectQuantity\":200,\"goodNum\":200,\"isDeleted\":0,\"purchasePrice\":0.0100,\"receiveQuantity\":200,\"sku\":\"hmsku0903-02\",\"title\":\"黑咪sku0903-02\"},{\"damageNum\":0,\"expectBadQuantity\":0,\"expectQuantity\":200,\"goodNum\":200,\"isDeleted\":0,\"purchasePrice\":8.0000,\"receiveQuantity\":200,\"sku\":\"hmsku0903-01\",\"title\":\"黑咪sku0903-01\"}],\"createTime\":\"2025-09-03 13:35:59\",\"finishTime\":\"2025-09-03 13:36:16\",\"firstLegPriceCurrency\":\"CNY\",\"isDeleted\":0,\"purchasePriceCurrency\":\"CNY\",\"status\":\"FINISHED\",\"stockInTime\":\"2025-09-03 13:36:16\",\"tag\":{\"boxedNeedSend\":0,\"comparedTagValue\":63,\"fullTagValue\":0,\"overcharge\":0,\"receiveException\":0,\"relation\":0,\"sendFailed\":0,\"sendWms\":0,\"waitBoxing\":0},\"transferPriceCurrency\":\"CNY\",\"type\":\"MANUAL\",\"updateTime\":\"2025-09-03 13:36:16\",\"warehouseName\":\"自定义仓库1\"}],\"state\":\"success\",\"total\":10009}",
    "requestId": "690772b1-4306-4bae-97a5-0c33db24ee68"
}

1.2. 入库单创建接口

1.2.1. SERVICE_TYPE

CREATE_ASN_ORDER

1.2.2. 请求参数

AsnSku(入库单商品)

SkuCustomFieldValueVO(自定义栏位)

SNInfo(SN信息)

1.2.3. 返回参数

bizContent 若存在，其结构为：{"result":{"asnNumber":"A250710162682"}}。 创建入库单失败时，result 或 asnNumber 字段会缺失，请调用方注意兼容处理。

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/asn' \
--form 'appId="TEST"' \
--form 'serviceType="CREATE_ASN_ORDER"' \
--form 'bizParam="{\"warehouseName\":\"台湾（名字不要瞎改）\",\"purchasePriceCurrency\":\"CNY\",\"firstLegPriceCurrency\":\"CNY\",\"transferPriceCurrency\":\"CNY\",\"asnSkuVOList\":[{
\"sku\":\"SKU0425007\",
\"purchasePrice\":10,
\"firstLegPrice\":0,
\"transferPrice\":0,
\"expectQuantity\":2,
\"skuStatus\":\"GOOD\"
},
{
\"sku\":\"SKU0425007\",
\"purchasePrice\":20,
\"firstLegPrice\":0,
\"transferPrice\":0,
\"expectQuantity\":3,
\"skuStatus\":\"GOOD\",
\"batchNo\":\"12345678911\",
\"mfgDate\":\"2025-05-31\",
\"expDate\":\"2025-06-31\",
\"originCountry\":\"CN\"
}]}"' \
--form 'timestamp="1731742317"' \
--form 'sign="14fbbedea8cb29fe3142d6853b257367"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":{\"arrivalStatus\":\"ARRIVED\",\"arrivedSkuQuantity\":0,\"arrivedTotalQuantity\":0,\"asnExtraJsonVO\":{},
    \"asnNumber\":\"A250623145669\",\"asnSkuVOList\":[{\"arrived\":false,\"arrivedQuantity\":0,\"asnId\":44917,\"customFieldValueVOList\":[],\"customerId\":3,
    \"customerIdForUser\":3,\"dimensionUnit\":\"cm\",\"dltQuantity\":0,\"expectBadQuantity\":0,\"expectGoodQuantity\":5,\"expectQuantity\":5,\"firstLegPrice\":0,
    \"firstLegQuantity\":0,\"height\":9.0,\"id\":194757,\"isDeleted\":0,\"itemInfoVO\":{\"bizItemId\":194757,\"bizType\":\"ASN\",\"cartonDimensionUnit\":\"cm\",
    \"cartonHeight\":9.0,\"cartonLength\":1.0,\"cartonWidth\":2.0,\"ccPriceUnit\":\"USD\",\"cdNetWeight\":1.0,\"cdPriceUnit\":\"USD\",\"cdWeight\":2.0,
    \"cdWeightUnit\":\"KG\",\"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3},\"length\":1.0,\"needQualityInspection\":false,\"purchasePrice\":10,
    \"receiveBoxQuantity\":0,\"receiveQuantity\":0,\"serialEnable\":0,\"sku\":\"SKU0425007\",\"skuId\":10007387,\"status\":\"RECEIVING\",\"title\":\"SKU0425007\",
    \"transferPrice\":0,\"version\":1,\"weight\":2.0,\"weightUnit\":\"KG\",\"width\":2.0,\"wmsSkuCode\":\"SKU0425007\"}],\"asnTypeFlag\":false,\"autoCommit\":false,
    \"businessRemarkVOList\":[],\"closeWms\":false,\"customerId\":3,\"customerIdForUser\":3,\"extraJson\":\"{}\",\"firstLegPriceCurrency\":\"CNY\",\"firstLegTotal\":0,
    \"firstLegUnit\":\"CNY\",\"firstLegWithdrawShipped\":false,\"flashId\":1,\"fromApi\":true,\"id\":44917,\"purchasePriceCurrency\":\"CNY\",\"receiveGoods\":true,
    \"receivedSkuQuantity\":0,\"receivedTotalQuantity\":0,\"skuQuantity\":1,\"status\":\"NEW\",\"tag\":{\"comparedTagValue\":0,\"fullTagValue\":0,\"overcharge\":0,
    \"receiveException\":0,\"relation\":0,\"sendFailed\":0,\"sendWms\":0,\"waitBoxing\":0},\"tags\":0,\"timezoneId\":\"Asia/Shanghai\",\"totalPurchasePrice\":50,
    \"totalQuantity\":5,\"transferPriceCurrency\":\"CNY\",\"type\":\"MANUAL\",\"useNewBestNumber\":false,\"version\":0,\"warehouseId\":12565,
    \"warehouseName\":\"台湾（名字不要瞎改）\",\"warehouseVO\":{\"address\":\"华星C\",\"address2\":\"XXX\",\"addressName\":\"华星现代产业园1\",\"asnEnable\":false,
    \"autoAdjStorage\":true,\"autoAdjustment\":false,\"autoCreateProduct\":1,\"autoSendOnReturnCreate\":0,\"autoSendWmsSku\":0,\"autoSynStorage\":false,
    \"city\":\"杭州\",\"code\":\"TOPMART\",\"configFileId\":\"\",\"contacts\":\"ZZ\",\"countTag\":0,\"country\":\"CN\",\"creatSource\":\"NORMAL\",
    \"cusAsnMark\":0,\"customCacheKey\":\"3\",\"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3,\"district\":\"西湖1\",\"email\":\"123456@qq.com\",
    \"extraType\":\"TOPMART\",\"forceRefreshSkuMapping\":false,\"fromOpenApi\":false,\"id\":12565,\"isDeleted\":0,\"kind\":\"COMPLEX\",\"locationConfigIds\":\"\",
    \"name\":\"台湾（名字不要瞎改）\",\"phone\":\"18368093711\",\"postCode\":\"317500\",\"providerId\":4247,\"province\":\"浙江1\",\"selfSupport\":false,
    \"sendAttachment\":0,\"sendBigstockAsDraft\":false,\"sendItemAsDraft\":true,\"sendItemImageFlag\":false,\"sendOdoAsDraft\":false,\"sendPlatformInfo\":false,
    \"sendReferenceNoFlag\":0,\"splitGrade\":1,\"status\":\"UNLOCK\",\"supportLazadaJit\":false,\"syncSkuInfo\":1,\"timezoneId\":\"Asia/Shanghai\",\"type\":\"BEST_GO\",
    \"typeName\":\"综合仓\",\"useBestWarehouseType\":false,\"useNewApiAndMethodForQianCangV1\":false}},\"state\":\"success\"}",
    "requestId": "6167c819-a604-465c-a7a7-8c838574c113"
}

1.3. 入库单取消接口

1.3.1. SERVICE_TYPE

1.3.2. CANCEL_ASN_ORDER

1.3.3. 请求参数

1.3.4. 返回参数

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/asn' \
--form 'appId="TEST"' \
--form 'serviceType="CANCEL_ASN_ORDER"' \
--form 'bizParam="{    \"asnNumber\":\"A250910149553\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="d44fcd6f24ef97c0178a402d99ee22eb"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"state\":\"success\"}",
    "requestId": "60525b5b-577e-4342-840b-f3c2a2d01f2a"
}

1.4. 入库单批次收货接口(开发中)

1.4.1. SERVICE_TYPE

1.4.2. BATCH_RECEIVE_ASN_ORDER

1.4.3. 请求参数

ReceiveAsnSku

1.4.4. 返回参数

1.5. 入库反馈推送接口

1.5.1. SERVICE_TYPE

PUSH_ASN_ORDER

1.5.2. 推送消息内容

Sku

SNInfo(SN信息)

推送示例（默认form-data格式）：

JSON格式：
{"appId":"TEST","bizParam":"{\"asnNumber\":\"A250619145545\",\"customNumber\":\"2025061900007\",\"status\":\"RECEIVING\",\"trackNumber\":\"CGDD0000787\",\"skuList\":[{\"sku\":\"LIP005\",\"quantity\":1},{\"quantity\":1,\"sku\":\"LIP005\"}]}","serviceType":"PUSH_ASN_ORDER","timestamp":"1754016113505","sign":"77fd745547a99d46cf5d2f17697a7c6e"}

FORM-DATA格式：
{appId=1111-3, bizParam={"asnNumber":"A250731147584","customNumber":"1000832922","finishedTime":1753942939000,"skuList":[{"damageNum":0,"goodNum":9,"quantity":9,"sku":"PPB24700027"}],"status":"FINISHED","trackNumber":"4700041511"}, serviceType=PUSH_ASN_ORDER, timestamp=1753942939728, sign=8f40f3de6778c990bc7b762314b182ac}