1. 出库单模块API

API URL

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

1.1. 出库单查询接口

1.1.1. SERVICE_TYPE

QUERY_ODO_LIST

1.1.2. 请求参数

1.1.3. 返回参数

Odo(出库单)

SkuCustomFieldValueVO(自定义栏位信息)

OdoSku(出库单商品)

OdoPackage(包裹信息)

OdoPackageContent(包裹信息)

请求示例

curl --location --request POST 'http://gerp-test1.800best.com/api/v1/odo' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_ODO_LIST"' \
--form 'bizParam="{\"page\":1,\"pageSize\":2}"' \
--form 'timestamp="1741593077529"' \
--form 'sign="02115b923d11d12736d711fbebc69f3e"'

返回示例

{
"state": "success",
"errorCode": "",
"errorMsg": "",
"bizContent": "{\"notSuccess\":false,\"result\":[{\"createTime\":\"2025-03-06 16:33:22\",\"number\":
\"TF250306161898\",\"odoCustomFieldValueVOList\":[{\"candidateValue\":[],\"columCode\":3,\"columName\":
\"自定义日期栏位\",\"columType\":\"DATE\",\"customFieldId\":41,\"customFieldValueVOList\":[],\"customerId\":
3,\"customerIdForUser\":3,\"defaultValue\":\"\",\"id\":41,\"isQuery\":0,\"isShow\":0,\"required\":0}]
,\"odoSkuVOList\":[{\"quantity\":2,\"receiveNumber\":\"A240329156179_1\",\"sku\":\"mcdull-s12\",\"skuId\":10003366,\"storageLocationCode\":\"SYS LOC\",\"title\":\"mcdull-s12\"}]
,\"status\":\"WAIT_OUTBOUND\",\"type\":\"TRANSFER\",\"warehouseId\":106,\"warehouseName\":\"customer\"},{\"createTime\":
\"2025-03-06 16:28:04\",\"number\":\"TF250306161897\",\"odoCustomFieldValueVOList\":[{\"candidateValue\":[],\"columCode\":
3,\"columName\":\"自定义日期栏位\",\"columType\":\"DATE\",\"customFieldId\":41,\"customFieldValueVOList\":[],\"customerId\":
3,\"customerIdForUser\":3,\"defaultValue\":\"\",\"id\":41,\"isQuery\":0,\"isShow\":0,\"required\":0}]
,\"odoSkuVOList\":[{\"quantity\":10,\"unavailableQuantity\":10,\"receiveNumber\":\"A240329156179_1\",\"sku\":\"mcdull-s12\",\"skuId\":10003366,\"storageLocationCode\":\"SYS LOC\",\"title\":\"mcdull-s12\"}]
,\"status\":\"WAIT_OUTBOUND\",\"type\":\"TRANSFER\",\"warehouseId\":106,\"warehouseName\":\"customer\"}],\"state\":
\"success\",\"total\":1812}",
"requestId": "50e85d2d-09e1-452e-9459-b8485dc136b7"
}

1.2. 出库单创建接口

1.2.1. SERVICE_TYPE

1.2.2. CREATE_ODO_ORDER

1.2.3. 请求参数

receiverVO

odoSkuVO

SkuCustomFieldValueVO(自定义栏位)

SNInfo(SN信息)

FileInfoVO(附件信息)

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/odo' \
--form 'appId="TEST"' \
--form 'serviceType="CREATE_ODO_ORDER"' \
--form 'bizParam="{
\"warehouseName\": \"台湾（名字不要瞎改）\",
\"customNumber\": \"S13232417\",
\"carrier\": \"FedEx\",
\"carrierService\": \"FedEx\",
\"trackingNumber\": \"1234446\",
\"isSpecifyBatch\": true,
\"customerType\": \"SHIPPER\",
\"remark\":\"bugfix2\",
\"receiver\": {
\"name\": \"ceshi\",
\"streetLine1\": \"124124\",
\"postalCode\": \"600514\",
\"countryCode\": \"CN\",
\"city\": \"yuenna\",
\"mobileNumber\": \"1111\",
\"state\": \"1111\"
},
\"odoSkuVOList\": [
{
\"sku\": \"SKU0425007\",
\"quantity\": 2,
\"unavailableQuantity\": 0
},
{
\"sku\": \"SKU0425007\",
\"quantity\": 0,
\"unavailableQuantity\": 2
},
{
\"sku\": \"SKU0425007\",
\"quantity\": 0,
\"unavailableQuantity\": 2
}
]
}"' \
--form 'timestamp="1731742317"' \
--form 'sign="1ed2fa62dce18742b899be7f74bba322"'

返回示例:

{
    "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_ODO_ORDER

1.3.3. 请求参数

1.3.4. 返回参数

请求示例

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/odo' \
--form 'appId="TEST"' \
--form 'serviceType="CANCEL_ODO_ORDER"' \
--form 'bizParam="{
\"customNumber\": \"S13232417\"
}"' \
--form 'timestamp="1731742317"' \
--form 'sign="cee42989a6ffaa2bb63d9ac9325a1cf3"'

返回示例

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"errorCode\":\"odo.status.can.not.operate\",\"errorMsg\":\"该状态出库单不支持操作\",\"notSuccess\":true,\"state\":\"failure\"}",
    "requestId": "81c4d623-4eec-420a-9741-8751d5741144"
}

1.4. 出库单销售单查询接口

1.4.1. SERVICE_TYPE

QUERY_SALES_ODO_LIST

1.4.2. 请求参数

1.4.3. 返回参数

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/odo' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_SALES_ODO_LIST"' \
--form 'bizParam="{\"page\":1,\"pageSize\":3, \"createTimeFrom\":\"2025-09-02\",\"createTimeTo\":\"2025-09-05\",\"numberParam\":\"W250903149235\"}"' \
--form 'timestamp="1756865700001"' \
--form 'sign="d302e01ee0f7f7c0a4dc9c2b8f3e4530"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"createTime\":\"2025-09-03 11:42:43\",\"number\":\"W250903149235\",
    \"odoCustomFieldValueVOList\":[{\"candidateValue\":[],\"columCode\":1,\"columName\":\"测试栏位1\",\"columType\":\"STRING\",\"customFieldId\":35,
    \"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3,\"defaultValue\":\"\",\"id\":35,\"isQuery\":0,\"isShow\":0,\"required\":0},
    {\"candidateValue\":[],\"columCode\":3,\"columName\":\"自定义栏3\",\"columType\":\"NUMBER\",\"customFieldId\":37,\"customFieldValueVOList\":[],
    \"customerId\":3,\"customerIdForUser\":3,\"defaultValue\":\"\",\"id\":37,\"isQuery\":0,\"isShow\":0,\"required\":0},{\"candidateValue\":[],
    \"columCode\":5,\"columName\":\"XXX的测试\",\"columType\":\"DATE\",\"customFieldId\":14,\"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3,
    \"defaultValue\":\"2024-06-19\",\"id\":14,\"isQuery\":0,\"isShow\":0,\"remark\":\"为啥没有显示\",\"required\":0,\"value\":\"2024/06/19\"},
    {\"candidateValue\":[],\"columCode\":7,\"columName\":\"出库人\",\"columType\":\"STRING\",\"customFieldId\":41,\"customFieldValueVOList\":[],
    \"customerId\":3,\"customerIdForUser\":3,\"defaultValue\":\"\",\"id\":41,\"isQuery\":0,\"isShow\":0,\"required\":0},{\"candidateValue\":[\"自定栏是否出库\"],
    \"columCode\":8,\"columName\":\"测试栏4\",\"columType\":\"SELECT\",\"customFieldId\":36,\"customFieldValueVOList\":[],\"customerId\":3,
    \"customerIdForUser\":3,\"defaultValue\":\"\",\"id\":36,\"isQuery\":0,\"isShow\":0,\"required\":0}],\"odoPackageVOList\":[],
    \"odoSkuVOList\":[{\"quantity\":1,\"receiveNumber\":\"A250903149222_1\",\"sku\":\"ABSAR078205440\",\"skuId\":10008317,\"storageLocationCode\":\"SYS LOC\",
    \"title\":\"BBCOOL Popok Bayi Tipe Perekat – Lembut Daya Serap Tinggi Desain Pull-Up yang Nyaman untuk Bayi & Balita. M*34pcs\",
    \"unavailableQuantity\":0}],\"status\":\"WAIT_OUTBOUND\",\"type\":\"MANUAL\",\"warehouseId\":13275,\"warehouseName\":\"yqn_uat_001\",\"yunluFlag\":false}],
    \"state\":\"success\",\"total\":1}",
    "requestId": "d142863d-1b0a-4ce9-972c-b1d03c9039af"
}

1.5. 出库单接收出库信息接口（开发中）

1.5.1. SERVICE_TYPE

RECEIVE_ODO_ORDER

1.5.2. 请求参数

OdoReceiveSku

1.5.3. 返回参数

1.6. 出库反馈推送接口

1.6.1. SERVICE_TYPE

PUSH_ODO_ORDER

1.6.2. 请求参数

Sku

SNInfo(SN信息)

推送示例：

JSON格式：
{"number":"A20220905","customNumber":"C20220905","trackNumber":"T20220905","warehouseName":"马来仓库","type":"MANUAL","status":"WAIT_OUTBOUND","skuList":[{"sku":"S90","title":"商品标题","storageLocationCode":"SYS LOC","receiveNumber":"A20220905","quantity":100,"unavailableQuantity":50}],"snInfo":{"snUrl":"https://oss.com"}}