1. 库存

API URL

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

1.1. 库存列表查询接口(已废弃，请使用v2版本的接口)

1.1.1. SERVICE_TYPE

QUERY_SIMPLE_LIST_INVENTORY

1.1.2. 请求参数

1.1.3. 返回参数

SkuInventory(商品库存)

1.2. 库存列表查询接口(V2)

1.2.1. SERVICE_TYPE

QUERY_SIMPLE_LIST_INVENTORY_V2

1.2.2. 请求参数

1.2.3. 返回参数

SkuInventory(商品库存)

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/inventory' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_SIMPLE_LIST_INVENTORY_V2"' \
--form 'bizParam="{\"page\":1,\"pageSize\":3,\"warehouse\":\"best warehouse（测试用）\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="26fff7cae9e2f3420f1aae8a1677be19"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"allocated\":0,\"assemblyAllocated\":0,\"assemblyShippingQuantity\":0,\"available\":1,\"firstLegAllocated\":0,\"firstLegShippingQuantity\":0,\"manualShippingQuantity\":0,\"orderAllocated\":0,\"purchaseShippingQuantity\":0,\"returnShippingQuantity\":0,\"shippingQuantity\":0,\"sku\":\"hmsku090901-1\",\"skuName\":\"黑咪测展示商品-1\",\"total\":1,\"transferAllocated\":0,\"transferShippingQuantity\":0,\"unavailable\":0,\"warehouse\":\"best warehouse（测试用）\",\"warehouseCode\":\"CA OFC\"},{\"allocated\":0,\"assemblyAllocated\":0,\"assemblyShippingQuantity\":0,\"available\":0,\"firstLegAllocated\":0,\"firstLegShippingQuantity\":0,\"manualShippingQuantity\":111,\"orderAllocated\":0,\"purchaseShippingQuantity\":0,\"returnShippingQuantity\":0,\"shippingQuantity\":111,\"sku\":\"0878\",\"skuName\":\"yhx实物商品002 blue\",\"total\":0,\"transferAllocated\":0,\"transferShippingQuantity\":0,\"unavailable\":0,\"warehouse\":\"best warehouse（测试用）\",\"warehouseCode\":\"CA OFC\"},{\"allocated\":0,\"assemblyAllocated\":0,\"assemblyShippingQuantity\":0,\"available\":0,\"firstLegAllocated\":0,\"firstLegShippingQuantity\":0,\"manualShippingQuantity\":1,\"orderAllocated\":0,\"purchaseShippingQuantity\":0,\"returnShippingQuantity\":0,\"shippingQuantity\":1,\"sku\":\"testgg01\",\"skuName\":\"Uji nama bahasa Cina\",\"total\":0,\"transferAllocated\":0,\"transferShippingQuantity\":0,\"unavailable\":0,\"warehouse\":\"best warehouse（测试用）\",\"warehouseCode\":\"CA OFC\"}],\"state\":\"success\",\"total\":726}",
    "requestId": "5a3cf6a8-f761-4c66-a537-0869b0c1ba21"
}

1.3. 库存日志查询接口

1.3.1. SERVICE_TYPE

QUERY_INVENTORY_LOG_LIST

1.3.2. 请求参数

1.3.3. 返回参数

SkuInventory(商品库存)

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/inventory' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_INVENTORY_LOG_LIST"' \
--form 'bizParam="{\"pageSize\":3,\"page\":1,\"warehouse\":\"best warehouse（测试用）\",\"skuList\":[\"DP001\"],\"operateTimeFrom\":\"2025-01-18 00:00:00\",\"operateTimeTo\":\"2025-02-18 00:00:00\",\"createTimeFrom\":\"2025-01-18 00:00:00\",\"createTimeTo\":\"2025-02-18 00:00:00\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="bffb9fd7788091d977b35b112beddc60"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"billNumber\":\"TF250107141083\",\"billType\":\"ASN\",\"bizType\":\"S_AVAILABLE\",\"createOptTime\":\"2025-01-18 20:27:45\",\"createTime\":\"2025-01-18 20:27:45\",\"inTransitAfter\":200,\"inTransitBefore\":127,\"inTransitDiff\":73,\"inventoryAfter\":0,\"inventoryBefore\":0,\"inventoryDiff\":0,\"isDeleted\":0,\"operateTime\":\"2025-01-18 20:27:45\",\"operateType\":\"SHIPPING\",\"operator\":\"11111111111\",\"sku\":\"ceshisun_008\",\"uniqueId\":158063,\"warehouseName\":\"best warehouse（测试用）\"},{\"billNumber\":\"TF250107141083\",\"billType\":\"ASN\",\"bizType\":\"S_AVAILABLE\",\"createOptTime\":\"2025-01-18 20:27:45\",\"createTime\":\"2025-01-18 20:27:45\",\"inTransitAfter\":127,\"inTransitBefore\":126,\"inTransitDiff\":1,\"inventoryAfter\":0,\"inventoryBefore\":0,\"inventoryDiff\":0,\"isDeleted\":0,\"operateTime\":\"2025-01-18 20:27:45\",\"operateType\":\"SHIPPING\",\"operator\":\"11111111111\",\"sku\":\"ceshisun_008\",\"uniqueId\":158062,\"warehouseName\":\"best warehouse（测试用）\"},{\"billNumber\":\"TF250107141083\",\"billType\":\"ASN\",\"bizType\":\"S_AVAILABLE\",\"createOptTime\":\"2025-01-18 20:27:45\",\"createTime\":\"2025-01-18 20:27:45\",\"inTransitAfter\":126,\"inTransitBefore\":106,\"inTransitDiff\":20,\"inventoryAfter\":0,\"inventoryBefore\":0,\"inventoryDiff\":0,\"isDeleted\":0,\"operateTime\":\"2025-01-18 20:27:45\",\"operateType\":\"SHIPPING\",\"operator\":\"11111111111\",\"sku\":\"ceshisun_008\",\"uniqueId\":158061,\"warehouseName\":\"best warehouse（测试用）\"}],\"state\":\"success\",\"total\":32}",
    "requestId": "21253330-8233-4270-ad8c-3e21ec65e566"
}

1.4. 加工单查询接口

1.4.1. SERVICE_TYPE

QUERY_INVENTORY_ASSEMBLY_LIST

1.4.2. 请求参数

1.4.3. 返回参数

ASSEMBLYInfo

Assembly

Part

Worker

assemblyStatus

assemblySkuStatus

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/inventory' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_INVENTORY_ASSEMBLY_LIST"' \
--form 'bizParam="{\"assemblyNumber\":\"AP250627145996\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="9e0a3727c6629beef9bd9e7e3f77f3e1"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"assemblyList\":[{\"expectQuantity\":1,\"parts\":[{\"expectQuantity\":1,\"quantity\":0,\"sku\":\"S215480756\"},{\"expectQuantity\":1,\"quantity\":0,\"sku\":\"S006022868\"},{\"expectQuantity\":1,\"quantity\":0,\"sku\":\"i5-3470/8G+256G-19inchZ2\"}],\"processedQuantity\":0,\"sku\":\"SL059-03\",\"status\":\"UN_PROCESSED\"}],\"assemblyNumber\":\"AP250627145996\",\"createTime\":1751023870000,\"isDeleted\":0,\"status\":\"NEW\",\"warehouseName\":\"best warehouse（测试用）\"}],\"state\":\"success\",\"total\":1}",
    "requestId": "014ad538-c054-4637-962f-a6ba123e57e8"
}

1.5. 调拨单(可用调拨)创建接口

1.5.1. SERVICE_TYPE

CREATE_TRANSFER_AVAILABLE_ORDER

1.5.2. 请求参数

Sku

1.6. 调拨单查询接口

1.6.1. SERVICE_TYPE

QUERY_INVENTORY_TRANSFER_LIST

1.6.2. 请求参数

1.6.3. 返回参数

TransferVO

SkuVO

FeeVO

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/inventory' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_INVENTORY_TRANSFER_LIST"' \
--form 'bizParam="{\"numberParam\":\"TF250908149420\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="e4ff5947df01094eef7733115281cd75"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"createTime\":1757318666000,\"destWarehouseName\":\"best warehouse（测试用）\",\"destWarehouseType\":\"BEST\",\"isDeleted\":0,\"logisticsName\":\"111\",\"preReceiveTime\":1757548800000,\"skuVOList\":[{\"cartonDimensionUnit\":\"m\",\"cartonHeight\":0.0100,\"cartonLength\":0.0100,\"cartonWidth\":0.1100,\"cdNetWeight\":1.0000,\"cdWeight\":1.0000,\"cdWeightUnit\":\"KG\",\"expectedQuantity\":5,\"id\":52611,\"packingRate\":5,\"receiveQuantity\":5,\"sku\":\"TDTEST2\"}],\"status\":\"FINISHED\",\"transferNumber\":\"TF250908149420\",\"type\":\"AVAILABLE\",\"updateTime\":1757318749000,\"warehouseName\":\"customer\"}],\"state\":\"success\",\"total\":1}",
    "requestId": "472c91ab-e02f-4d97-aedd-7b13fa2aa6fb"
}

1.7. 拆分单查询接口

1.7.1. SERVICE_TYPE

QUERY_INVENTORY_RESTORE_LIST

1.7.2. 请求参数

1.7.3. 返回参数

RestoreOrder

RestoreOrderStatus

RestoreOrderSku

RestoreOrderSkuPart

Worker

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/inventory' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_INVENTORY_RESTORE_LIST"' \
--form 'bizParam="{\"orderNumber\":\"RO250605145023\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="4f61c05231e9e671558a87449a932b4d"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"notSuccess\":false,\"result\":[{\"asnId\":44714,\"asnNumber\":\"A250605145025\",\"isDeleted\":0,\"orderNumber\":\"RO250605145023\",\"orderTime\":1749114490000,\"partQty\":2,\"receivedPartQty\":0,\"remarkList\":[],\"restoreOrderStartTime\":1749114686000,\"skuList\":[{\"completedQty\":0,\"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3,\"expectedQty\":1,\"id\":65,\"isDeleted\":0,\"orderId\":41,\"partList\":[{\"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3,\"id\":97,\"isDeleted\":0,\"orderId\":41,\"orderSkuId\":65,\"partRate\":1,\"purchasePrice\":1.0000,\"sku\":\"Hsiun-A\",\"skuId\":10001570,\"title\":\"2019 รองเท้าผ้าใบขนาดใหญ่ปากตื้นรองเท้าลำลองขี้เกียจแบน [964206010]\",\"totalCost\":0.0000,\"totalReceivedQty\":0},{\"customFieldValueVOList\":[],\"customerId\":3,\"customerIdForUser\":3,\"id\":98,\"isDeleted\":0,\"orderId\":41,\"orderSkuId\":65,\"partRate\":1,\"purchasePrice\":1.0000,\"sku\":\"Hsiun-B\",\"skuId\":10001571,\"title\":\"Molisa รองเท้า รองเท้าแฟชั่น รองเท้าทรงผ้าใบ หนังแท้100% Leather flat shoes sneakers shoes [1098646369]\",\"totalCost\":0.0000,\"totalReceivedQty\":0}],\"sku\":\"Hsiun-X\",\"skuId\":10001578,\"splitFeeInCost\":0.0000,\"title\":\"9C-泊泉雅蓝莓美肌精华液原液 补水保湿控油收缩毛孔提亮肤色\",\"totalExpectPartQty\":2,\"totalReceivePartCost\":0.00,\"totalReceivedPartQty\":0}],\"status\":\"DOING\",\"totalCost\":0,\"totalExpectPartQty\":2,\"totalFee\":0,\"totalReceivedPartQty\":0,\"warehouseId\":12496,\"warehouseName\":\"Hs海外仓\",\"workerBizType\":\"RESTORE_ORDER\"}],\"state\":\"success\",\"total\":1}",
    "requestId": "4f384479-322b-4e79-8b6c-660a691ab2b3"
}

1.8. 库位库存列表查询接口

1.8.1. SERVICE_TYPE

QUERY_STORAGE_LOCATION_INVENTORY_LIST

1.8.2. 请求参数

1.8.3. 返回参数

StorageLocationSkuInventory(商品库存)

请求示例:

curl --location --request POST 'https://gerp-test1.800best.com/api/v1/inventory' \
--form 'appId="TEST"' \
--form 'serviceType="QUERY_STORAGE_LOCATION_INVENTORY_LIST"' \
--form 'bizParam="{\"skuList\":[\"abc\",\"SKU002\"],\"warehouses\":[\"Amazon\",\"FBA美国\"],\"page\":1,\"pageSize\":50,\"showEmpty\":true,\"storageLocationCode\":\"SYS LOC\"}"' \
--form 'timestamp="1731742317"' \
--form 'sign="26fff7cae9e2f3420f1aae8a1677be19"'

返回示例:

{
    "state": "success",
    "errorCode": "",
    "errorMsg": "",
    "bizContent": "{\"errorCode\":\"\",\"errorMsg\":\"\",\"state\":\"success\",\"total\":100,\"result\":[{\"sku\":\"abc\",\"skuName\":\"测试商品\",\"warehouse\":\"FBA美国\",\"warehouseCode\":\"18991\",\"total\":13,\"available\":5,\"locationCode\":\"SYS LOC\"},{\"sku\":\"SKU002\",\"skuName\":\"测试商品B\",\"warehouse\":\"FBA加拿大\",\"warehouseCode\":\"18992\",\"total\":20,\"available\":20,\"locationCode\":\"SYS LOC\"}]}",
    "requestId": "5a3cf6a8-f761-4c66-a537-0869b0c1ba21"
}