同步发货信息
接口名:/go/packageOpenApiWeb/OpenApiV2/SyncPlatformShip
Section titled “接口名:/go/packageOpenApiWeb/OpenApiV2/SyncPlatformShip”电商平台同步发货信息给 Xcotton。
完整字段说明见 API 接口文档 · SyncPlatformShip。
注意:
shipOtherInfo是扁平ShipAddress(country/province/city/postalCode/linkName等),没有shipToAddress一层。- 每条发货信息必须传
shipId、actualShipSendTime、shipTrackNumber,并至少传一个shipCompany/shipCompanyCode;actualShipSendTime使用 RFC 3339 时间。 itemList:邮包险非必传(不传视为整单发货);延保要传。精确到某一延保方案时传ppVariant(Plan ID必传)。- 出参 JSON 键是
orderId(不是OrderId)。 - 出参同时保留单数、复数兼容键:
shipId/shipIds、disXmhShopOrderShipId/disXmhShopOrderShipIds,这些字段的值都是数组。
接口入参示例:
Section titled “接口入参示例:”{ "orderId": "1744082334", "subOrderId": "", "shipInfoList": [ { "shipId": "1744613515", "shipPrice": "6.00", "actualShipSendTime": "2025-04-07T05:37:10.000Z", "shipCompany": "SF", "shipCompanyCode": "SF", "shipTrackNumber": "1744613515", "shipStateString": "已发货", "shipOtherInfo": { "country": "中国", "countryCode": "CN", "province": "浙江省", "provinceCode": "", "city": "杭州市", "cityCode": "", "district": "", "street": "", "address": "", "postalCode": "", "name": "", "firstName": "", "lastName": "", "companyName": "", "mobile": "", "cert": "", "email": "", "linkName": "", "linkMobile": "" }, "itemList": [ { "itemId": "97760109-16ad-40c9-9385-caba381a26aa", "variantId": "", "skuId": "SKU001", "orderGoodsId": "", "productId": "", "itemName": "Durable Concrete Shirt", "itemDesc": "", "itemState": 0, "itemTag": "", "itemType": "", "itemOtherInfoJson": "", "ItemPicInfoMain": null, "ItemPicInfoOther": null, "currency": "USD", "unitNum": "2", "isPackageItem": false, "isPPItem": false, "unitPrice": "100.00", "preferentialPrice": "50.00", "subTotalPrice": "", "subTotalTaxPrice": "", "taxPrice": "", "totalPrice": "200.00", "totalPayPrice": "150.00", "Properties": null, "ppVariant": null, "serviceOrderIds": null } ] } ]}接口出参示例:
Section titled “接口出参示例:”{ "errCode": 0, "errMsg": "success", "data": { "orderId": "1744082334", "shipId": ["1744613515"], "shipIds": ["1744613515"], "disXmhShopOrderId": "xsorder-00222280000000009372657428", "disXmhShopOrderShipId": ["xsship-00222280000000009372657428"], "disXmhShopOrderShipIds": ["xsship-00222280000000009372657428"] } }