接口签名
com.alibaba.trade:alibaba.ascp.logistics.offline.send-1
入参
主订单号 | sourceId | 主单号 |
---|---|---|
订单明细列表 | sendGoodEntries | 订单明细也叫商品明细的单号列表 |
包裹信息 | ascpSendPackages | 运单cpCode和运单号的列表 |
传参方式简要描述,支持明细维度拆包裹,但每个订单明细(商品)只支持成功发货一次,且每次请求中的每个包裹都会包含本次请求中的所有商品明细,详细场景见下。
以一主多子订单声明发货为例(比如一个订单包含 A商品5个,B商品5个)
场景一(一个包裹发完所有商品)
一次请求
{
“orderCode”:”主订单号”,
“ascpSendPackages”:[{“cpCode”:”STO”,”mailNo”:”包裹1运单号”}],
“sendGoodEntries”:[{“sourceEntryId”:”商品a的明细单号”},
{"sourceEntryId":"商品b的明细单号"}]
}
场景二 (包裹1[A商品] 包裹2[B商品])
分为两次请求,当请勿同时并发请求
请求1参数
{ “orderCode”:”主订单号”, “ascpSendPackages”:[{“cpCode”:”STO”,”mailNo”:”包裹1运单号”}], “sendGoodEntries”:[{“sourceEntryId”:”商品a的明细单号”}] }
请求2参数
{ “orderCode”:”主订单号”, “ascpSendPackages”:[{“cpCode”:”STO”,”mailNo”:”包裹2运单号”}], “sendGoodEntries”:[{“sourceEntryId”:”商品B的明细单号”}] }
场景三 (包裹1[A商品] 包裹2[B商品] 包裹3[B商品])
分为两次请求,当请勿同时并发请求
请求1参数
{ “orderCode”:”主订单号”, “ascpSendPackages”:[{“cpCode”:”XXX”,”mailNo”:”包裹1运单号”}], “sendGoodEntries”:[{“sourceEntryId”:”商品a的明细单号”}] }
请求2参数
{ “orderCode”:”主订单号”, “ascpSendPackages”:[{“cpCode”:”XXX”,”mailNo”:”包裹2运单号”}, {“cpCode”:”XXX”,”mailNo”:”包裹3运单号”}], “sendGoodEntries”:[{“sourceEntryId”:”商品B的明细单号”}] }
场景四 (包裹1[A商品 B商品] 包裹2[A商品 B商品])
只能一次发货请求
请求参数
{ “ascpSendPackages”:[{“cpCode”:”XXX”,”mailNo”:”包裹1运单号”} ,{“cpCode”:”XXX”,”mailNo”:”包裹2运单号”}], “orderCode”:”主订单号”, “sendGoodEntries”:[{“sourceEntryId”:”商品a的明细单号”}, {“sourceEntryId”:”商品b的明细单号”},] }