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

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

仓作业信息批量同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_process_batch_report_request WmsOrderProcessBatchReportRequest 必须 入参
  • └ request_id
  • String
  • 必须
  • xxxxxxxxx
  • 业务请求ID,用于做幂等
  • └ request_time
  • Number
  • 必须
  • 1663814266066
  • ERP调翱象接口创建货品的时间戳
  • order_process_reports
  • OrderProcessReports []
  • 必须
  • 回告详情列表
  • 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
  • 可选
  • 22222
  • 交易子单号
  • └ order_line_no
  • String
  • 可选
  • 33333
  • 单据行号,与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
  • 可选
  • 22222
  • 子件运单号,如果有子母件可填
  • └ sc_item_id
  • String
  • 可选
  • SC0001
  • 包裹内ERP子货品编码
  • └ quantity
  • Number
  • 可选
  • 1
  • 包裹内实发货品数量
  • └ order_process_report_id
  • String
  • 必须
  • report001
  • 记录行ID 随意填,请求内唯一即可,仅在返回时做结果匹配

响应参数

名称 类型 示例值 描述
order_process_batch_report_response WmsOrderProcessBatchReportResponse 请求出参
  • └ code
  • String
  • 200
  • 响应码
  • └ success
  • Boolean
  • true
  • 系统成功失败 true|false
  • └ message
  • String
  • SUCCESS
  • 响应信息
  • data
  • DataDetails []
  • 详细信息
  • └ order_process_report_id
  • String
  • report001
  • 记录行ID
  • └ success
  • Boolean
  • true
  • 记录行同步结果 true|false
  • └ message
  • String
  • SUCCESS
  • 记录行详细描述
  • └ trace_id
  • String
  • xxxxxx
  • traceId,用于排查问题

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDchainIsvWmsOrderprocessBatchReportRequest req = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest();
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.WmsOrderProcessBatchReportRequest obj1 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.WmsOrderProcessBatchReportRequest();
obj1.setRequestId("xxxxxxxxx");
obj1.setRequestTime(1663814266066L);
List<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderProcessReports> list3 = new ArrayList<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderProcessReports>();
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderProcessReports obj4 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderProcessReports();
list3.add(obj4);
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.Order obj6 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.Order();
obj6.setOrderCode("ERP01");
obj6.setOrderId("orderId01");
obj6.setErpWarehouseCode("CK001");
obj6.setCreateTime(1663814266066L);
obj6.setOrderType("JYCK");
obj6.setPreOrderCode("1111111");
list5.setOrder(obj6);
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.Process obj8 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.Process();
obj8.setProcessStatus("ACCEPT");
obj8.setOperateTime(1663814266066L);
obj8.setConfirmType(1L);
obj8.setLogisticsType("2");
list7.setProcess(obj8);
List<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderLine> list11 = new ArrayList<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderLine>();
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderLine obj12 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.OrderLine();
list11.add(obj12);
obj12.setSourceOrderCode("sourceOrderCode001");
obj12.setSubSourceOrderCode("subSourceOrderCode001");
obj12.setScItemId("scItemId001");
obj12.setPlanQty(100L);
obj12.setOrderLineNo("111111");
list9.setOrderLines(list11);
obj4.setOrderFlag("COD");
List<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmOrderLines> list15 = new ArrayList<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmOrderLines>();
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmOrderLines obj16 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmOrderLines();
list15.add(obj16);
obj16.setSourceOrderCode("111111");
obj16.setSubSourceOrderCode("22222");
obj16.setOrderLineNo("33333");
obj16.setScItemId("SC0001");
obj16.setActualQty(1L);
list13.setConfirmOrderLines(list15);
List<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmPackages> list19 = new ArrayList<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmPackages>();
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmPackages obj20 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ConfirmPackages();
list19.add(obj20);
obj20.setLogisticsCode("SF");
obj20.setExpressCode("SF00000001");
List<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ScItems> list23 = new ArrayList<AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ScItems>();
AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ScItems obj24 = new AlibabaDchainIsvWmsOrderprocessBatchReportRequest.ScItems();
list23.add(obj24);
obj24.setOrderLineNo("1111222");
obj24.setSubExpressCode("22222");
obj24.setScItemId("SC0001");
obj24.setQuantity(1L);
list21.setScItems(list23);
list17.setConfirmPackages(list19);
obj4.setOrderProcessReportId("report001");
obj1.setOrderProcessReports(list3);
req.setOrderProcessBatchReportRequest(obj1);
AlibabaDchainIsvWmsOrderprocessBatchReportResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_dchain_isv_wms_orderprocess_batch_report_response>
    <order_process_batch_report_response>
        <code>200</code>
        <success>true</success>
        <message>SUCCESS</message>
        <data>
            <data_details>
                <order_process_report_id>report001</order_process_report_id>
                <success>true</success>
                <message>SUCCESS</message>
            </data_details>
        </data>
        <trace_id>xxxxxx</trace_id>
    </order_process_batch_report_response>
</alibaba_dchain_isv_wms_orderprocess_batch_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

返回
顶部