上传运单号至 CGF lite 订单，将订单状态变为待配送状态。
运单上传仅适用于处于商品准备中状态的CGF lite 订单。
允许将同一个运单号上传至同一个店铺下的不同 CGF lite 订单.
<注意！>此接口只能上传 CGF LITE 订单的物流运单号。自发货订单物流运单号上传请转到此页面对接。
路径
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/orders/global/invoices
示例
请求参数
|
Name |
Required |
Type |
Description |
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. C00012345 |
请求体参数
|
Name |
Required |
Type |
Description |
|
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. C00012345 |
|
|
orderSheetInvoiceApplyDtos |
O |
Array |
要变更为待配送状态的信息列表 |
|
|
|
shipmentBoxId |
O |
Number |
配送号码(合并配送号码) |
|
|
orderId |
O |
Number |
订单号 |
|
|
deliveryCompanyCode |
O |
String |
快递公司代码 请务必注意输入正确的公司代码，此参数为空或格式错误均会引起报错！ |
|
|
invoiceNumber |
O |
String |
物流运单号 卖家直接配送(DIRECT)时可输入任意数字，因其不支持物流跟踪。 |
请求体示例
{
"vendorId": "C00012345",
"orderSheetInvoiceApplyDtos": [
{
"shipmentBoxId": 4037219645,
"orderId": 11000154200196,
"deliveryCompanyCode": "sf_express",
"invoiceNumber": "SF1152738062699"
},
{
"shipmentBoxId": 4037004312,
"orderId": 11000154200196,
"deliveryCompanyCode": "sf_express",
"invoiceNumber": "SF1152738062699"
}
]
}返回消息
| 名称 | 数据类型 | 描述 | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
服务器返回代码
|
||||||||||||||||||||||||||||||||||
| message | String |
服务器返回消息
|
||||||||||||||||||||||||||||||||||
| data | Object |
|
||||||||||||||||||||||||||||||||||
| responseCode | Number |
请求结果状态码
|
||||||||||||||||||||||||||||||||||
| responseMessage | String |
请求结果状态消息
|
||||||||||||||||||||||||||||||||||
| responseList | Array |
单个上传结果集
|
||||||||||||||||||||||||||||||||||
| shipmentBoxId | Number |
合并配送号码
|
||||||||||||||||||||||||||||||||||
| data | String |
Result code
|
||||||||||||||||||||||||||||||||||
| comment | String |
错误信息
|
||||||||||||||||||||||||||||||||||
返回消息示例
{
"code": 200,
"message": "OK",
"data": {
"responseCode": 1,
"responseMessage": "SUCCESS",
"responseList": [
{
"shipmentBoxId": 4037219645,
"data": "OK",
"comment": null
},
{
"shipmentBoxId": 4037004312,
"data": "OK",
"comment": null
}
]
}
}错误代码
|
HTTP 状态码 (错误类型) |
错误消息 |
解决方法 |
|
400 (check request variable) |
无效物流公司代码: |
查看是否输入了正确的物流公司代码(deliveryCompanyCode). |
URL API Name
GLOBAL_UPDATE_ORDER_SHIPPING_INFO