文档中心 > API类目 > 天猫供应链

alibaba.dchain.isv.wms.orderprocess.report (仓作业信息同步)

仓作业信息同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_process_report_request WmsOrderProcessReportRequest 必须 请求入参
  • └ request_id
  • String
  • 必须
  • xxxxx
  • 业务请求ID,用于做幂等
  • └ request_time
  • Number
  • 必须
  • 1663814266066
  • ERP调翱象接口创建货品的时间戳
  • order
  • Order
  • 必须
  • 单据信息
  • └ order_code
  • String
  • 必须
  • ERP01
  • ERP单号,sellerId下唯一单号
  • └ order_id
  • String
  • 可选
  • orderId01
  • WMS单号
  • └ erp_warehouse_code
  • String
  • 必须
  • CK001
  • ERP仓库编码,sellerId下唯一
  • └ create_time
  • Number
  • 必须
  • 1663814266066
  • 创建时间(时间戳-毫秒)Long,必填
  • └ order_type
  • String
  • 可选
  • JYCK
  • 单据类型(JYCK=一般交易出库;HHCK=换货出库;BFCK=补发出库;QTCK=其他出库单)
  • └ pre_order_code
  • String
  • 可选
  • 1111111
  • 原ERP发货单,条件必填(换货出库/补发出库必须有);
  • process
  • Process
  • 必须
  • 单据作业信息
  • └ process_status
  • String
  • 必须
  • ACCEPT
  • 作业状态,ACCEPT(仓库接单)、PRINT(打印)、PICK(拣货)、CHECK(复核)、PACKAGE(打包)、CONFIRM(确认出库)", ACCEPT(仓库接单) \CONFIRM(确认出库) 必填;其他条件必填;
  • └ operate_time
  • Number
  • 必须
  • 1663814266066
  • 操作时间(时间戳-毫秒),必填
  • └ confirm_type
  • Number
  • 可选
  • 1
  • 条件必填,如果多批次出库,则必填 多次发货后确认时;0表示发货单最终状态确认;1表示发货单中间状态确认
  • └ logistics_type
  • String
  • 可选
  • 2
  • 物流方式,默认2:自己联系物流发货; 2: 自己联系物流 3: 无需物流
  • order_lines
  • OrderLine []
  • 可选
  • (创建发货单)条件必填
  • └ source_order_code
  • String
  • 可选
  • sourceOrderCode001
  • 交易主单号,必填
  • └ sub_source_order_code
  • String
  • 可选
  • subSourceOrderCode001
  • 交易子单号,必填
  • └ sc_item_id
  • String
  • 可选
  • scItemId001
  • 货品编码id,必填
  • └ plan_qty
  • Number
  • 可选
  • 100
  • 应发货品数量,必填
  • └ order_line_no
  • String
  • 可选
  • 111111
  • ERP发货单的单据行号
  • └ order_flag
  • String
  • 可选
  • COD
  • 订单标记 ,用字符串格式来表示订单标记列表
  • confirm_order_lines
  • ConfirmOrderLines []
  • 可选
  • 仓库出库,必接; 一个交易子单如果分批次发货,可以拆分多个发货单进行对接。 一个发货单如果分批次发货,分批次回传
  • └ source_order_code
  • String
  • 可选
  • 111111
  • 交易主单号
  • └ sub_source_order_code
  • String
  • 可选
  • 11111112
  • 交易子单号
  • └ order_line_no
  • String
  • 可选
  • 1111222
  • 单据行号,与order_lines中的order_line_no需要对应
  • └ sc_item_id
  • String
  • 可选
  • SC0001
  • ERP子货品编码(可以跟接单时不一致)
  • └ actual_qty
  • Number
  • 可选
  • 1
  • 实发数量
  • confirm_packages
  • ConfirmPackages []
  • 可选
  • 出库包裹
  • └ logistics_code
  • String
  • 可选
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通 (ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHERS=其他;只传英文编码)
  • └ express_code
  • String
  • 可选
  • SF00000001
  • 运单号
  • sc_items
  • ScItems []
  • 可选
  • 运单内所包含的所有货品(与翱象对接的货品编码)
  • └ order_line_no
  • String
  • 可选
  • 1111222
  • 单据行号,与order_lines中的order_line_no需要对应
  • └ sub_express_code
  • String
  • 可选
  • 11112223
  • 子件运单号,如果有子母件可填
  • └ sc_item_id
  • String
  • 可选
  • SC0001
  • 包裹内ERP子货品编码
  • └ quantity
  • Number
  • 可选
  • 1
  • 包裹内实发货品数量

响应参数

名称 类型 示例值 描述
order_process_report_response WmsOrderProcessReportResponse 请求出参
  • └ code
  • String
  • xxxxxx
  • 返回码
  • └ success
  • Boolean
  • true
  • 成功或者失败
  • └ message
  • String
  • xxxxxx
  • 返回信息
  • └ trace_id
  • String
  • xxxxxx
  • traceId,类似于requestId

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDchainIsvWmsOrderprocessReportRequest req = new AlibabaDchainIsvWmsOrderprocessReportRequest();
AlibabaDchainIsvWmsOrderprocessReportRequest.WmsOrderProcessReportRequest obj1 = new AlibabaDchainIsvWmsOrderprocessReportRequest.WmsOrderProcessReportRequest();
obj1.setRequestId("xxxxx");
obj1.setRequestTime(1663814266066L);
AlibabaDchainIsvWmsOrderprocessReportRequest.Order obj2 = new AlibabaDchainIsvWmsOrderprocessReportRequest.Order();
obj2.setOrderCode("ERP01");
obj2.setOrderId("orderId01");
obj2.setErpWarehouseCode("CK001");
obj2.setCreateTime(1663814266066L);
obj2.setOrderType("JYCK");
obj2.setPreOrderCode("1111111");
obj1.setOrder(obj2);
AlibabaDchainIsvWmsOrderprocessReportRequest.Process obj3 = new AlibabaDchainIsvWmsOrderprocessReportRequest.Process();
obj3.setProcessStatus("ACCEPT");
obj3.setOperateTime(1663814266066L);
obj3.setConfirmType(1L);
obj3.setLogisticsType("2");
obj1.setProcess(obj3);
List<AlibabaDchainIsvWmsOrderprocessReportRequest.OrderLine> list5 = new ArrayList<AlibabaDchainIsvWmsOrderprocessReportRequest.OrderLine>();
AlibabaDchainIsvWmsOrderprocessReportRequest.OrderLine obj6 = new AlibabaDchainIsvWmsOrderprocessReportRequest.OrderLine();
list5.add(obj6);
obj6.setSourceOrderCode("sourceOrderCode001");
obj6.setSubSourceOrderCode("subSourceOrderCode001");
obj6.setScItemId("scItemId001");
obj6.setPlanQty(100L);
obj6.setOrderLineNo("111111");
obj1.setOrderLines(list5);
obj1.setOrderFlag("COD");
List<AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmOrderLines> list8 = new ArrayList<AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmOrderLines>();
AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmOrderLines obj9 = new AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmOrderLines();
list8.add(obj9);
obj9.setSourceOrderCode("111111");
obj9.setSubSourceOrderCode("11111112");
obj9.setOrderLineNo("1111222");
obj9.setScItemId("SC0001");
obj9.setActualQty(1L);
obj1.setConfirmOrderLines(list8);
List<AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmPackages> list11 = new ArrayList<AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmPackages>();
AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmPackages obj12 = new AlibabaDchainIsvWmsOrderprocessReportRequest.ConfirmPackages();
list11.add(obj12);
obj12.setLogisticsCode("SF");
obj12.setExpressCode("SF00000001");
List<AlibabaDchainIsvWmsOrderprocessReportRequest.ScItems> list15 = new ArrayList<AlibabaDchainIsvWmsOrderprocessReportRequest.ScItems>();
AlibabaDchainIsvWmsOrderprocessReportRequest.ScItems obj16 = new AlibabaDchainIsvWmsOrderprocessReportRequest.ScItems();
list15.add(obj16);
obj16.setOrderLineNo("1111222");
obj16.setSubExpressCode("11112223");
obj16.setScItemId("SC0001");
obj16.setQuantity(1L);
list13.setScItems(list15);
obj1.setConfirmPackages(list11);
req.setOrderProcessReportRequest(obj1);
AlibabaDchainIsvWmsOrderprocessReportResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_dchain_isv_wms_orderprocess_report_response>
    <order_process_report_response>
        <code>xxxxxx</code>
        <success>true</success>
        <message>xxxxxx</message>
        <trace_id>xxxxxx</trace_id>
    </order_process_report_response>
</alibaba_dchain_isv_wms_orderprocess_report_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

返回
顶部