文档中心 > API类目 > 银泰开放平台

alibaba.mos.order.delivery.confirm (发货确认)

场景:商家发货后,回告包裹与物流信息。 请求参数参考: {"deliveryOrder":{"deliveryOrderCode":"银泰发货单号","deliveryOrderId":"供应商出库单号","operateTime":"2021-10-22 17:40:15","orderType":"JYCK","outBizCode":"唯一编码","warehouseCode":"仓库"},"packages":[{"expressCode":"物流单号","items":[{"actualQty":"1.0000","itemCode":"SKU","outBizCode":"唯一编码","quantity":1}],"logisticsCode":"SF","logisticsName":"顺丰","packageCode":"包裹号"}]}

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_delivery_confirm OrderDeliveryConfirmRequestDTO 必须 请求参数
  • └ extend_props
  • String
  • 可选
  • {}
  • 扩展信息
  • delivery_order
  • DeliveryOrder
  • 必须
  • {}
  • 发货信息
  • └ order_type
  • String
  • 必须
  • JYCK
  • 出库单类型, 一般选择JYCK. (JYCK=一般交易出库单;HHCK=换货出库单;BFCK=补发出库单;QTCK=其他出库单)
  • └ source_order_code
  • String
  • 可选
  • XXXX
  • 交易平台-订单查询-渠道订单号
  • └ operate_time
  • String
  • 必须
  • 2016-07-06 12:00:00
  • 操作(审核)时间(YYYY-MM-DD HH:MM:SS)(对应系统发货时间)
  • └ delivery_order_code
  • String
  • 必须
  • TB1234
  • 银泰发货单号(回传发货通知单的对应字段)
  • └ operator_code
  • String
  • 可选
  • XXX
  • 操作人编码
  • └ operator_name
  • String
  • 可选
  • XXX
  • 操作人名称
  • └ out_biz_code
  • String
  • 可选
  • XXX
  • 业务唯一健
  • packages
  • Package []
  • 必须
  • []
  • 包裹信息
  • └ package_code
  • String
  • 必须
  • XXXXXXXXXX
  • 包裹号(供应商包裹号)
  • └ express_code
  • String
  • 必须
  • SFXXXXXXX
  • 物流运单号
  • └ logistics_code
  • String
  • 必须
  • SF
  • 物流公司编码,圆通速递(YTO),德邦快递(DBKD),天天快递(TTKDEX),邮政快递包裹(POSTB),优速快递(UC),中通快递(ZTO),韵达快递(YUNDA),百世快递(HTKY),宅急送(ZJS),顺丰速运(SF),申通快递(STO),EMS经济快递(EYB),EMS(EMS),中国邮政(POST)
  • items
  • PackageItem []
  • 可选
  • []
  • 包裹内商品信息
  • └ quantity
  • Number
  • 必须
  • 1
  • 数量
  • └ out_biz_code
  • String
  • 可选
  • xxxx
  • 供应商内业务唯一编码
  • └ item_code
  • String
  • 必须
  • 123456789
  • 商品编码(银泰SKU)
  • └ actual_qty
  • String
  • 可选
  • 1
  • 实发数量
  • └ logistics_name
  • String
  • 可选
  • 顺丰
  • 物流公司

响应参数

名称 类型 示例值 描述
result Result {} 返回参数
  • └ success
  • Boolean
  • true
  • 是否请求成功
  • └ error_code
  • String
  • 10000
  • 错误编码
  • └ error_msg
  • String
  • 错误信息
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosOrderDeliveryConfirmRequest req = new AlibabaMosOrderDeliveryConfirmRequest();
AlibabaMosOrderDeliveryConfirmRequest.OrderDeliveryConfirmRequestDTO obj1 = new AlibabaMosOrderDeliveryConfirmRequest.OrderDeliveryConfirmRequestDTO();
obj1.setExtendProps("{}");
AlibabaMosOrderDeliveryConfirmRequest.DeliveryOrder obj2 = new AlibabaMosOrderDeliveryConfirmRequest.DeliveryOrder();
obj2.setOrderType("JYCK");
obj2.setSourceOrderCode("XXXX");
obj2.setOperateTime("2016-07-06 12:00:00");
obj2.setDeliveryOrderCode("TB1234");
obj2.setOperatorCode("XXX");
obj2.setOperatorName("XXX");
obj2.setOutBizCode("XXX");
obj1.setDeliveryOrder(obj2);
List<AlibabaMosOrderDeliveryConfirmRequest.Package> list4 = new ArrayList<AlibabaMosOrderDeliveryConfirmRequest.Package>();
AlibabaMosOrderDeliveryConfirmRequest.Package obj5 = new AlibabaMosOrderDeliveryConfirmRequest.Package();
list4.add(obj5);
obj5.setPackageCode("XXXXXXXXXX");
obj5.setExpressCode("SFXXXXXXX");
obj5.setLogisticsCode("SF");
List<AlibabaMosOrderDeliveryConfirmRequest.PackageItem> list8 = new ArrayList<AlibabaMosOrderDeliveryConfirmRequest.PackageItem>();
AlibabaMosOrderDeliveryConfirmRequest.PackageItem obj9 = new AlibabaMosOrderDeliveryConfirmRequest.PackageItem();
list8.add(obj9);
obj9.setQuantity(1L);
obj9.setOutBizCode("xxxx");
obj9.setItemCode("123456789");
obj9.setActualQty("1");
list6.setItems(list8);
obj5.setLogisticsName("顺丰");
obj1.setPackages(list4);
req.setOrderDeliveryConfirm(obj1);
AlibabaMosOrderDeliveryConfirmResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_order_delivery_confirm_response>
    <result>
        <success>true</success>
        <error_code>10000</error_code>
        <error_msg>错误信息</error_msg>
    </result>
</alibaba_mos_order_delivery_confirm_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部