文档中心 > API类目 > 奇门仓储API

taobao.qimen.deliveryorder.query (发货单查询接口)

ERP调用奇门的发货单查询接口,查询发货单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request DeliveryOrderQueryRequest 可选
  • └ ownerCode
  • String
  • 可选
  • Owner1234
  • 货主编码
  • └ warehouseCode
  • String
  • 可选
  • Warhouse1234
  • 仓库编码
  • └ orderCode
  • String
  • 必须
  • D1234
  • 发库单号
  • └ orderId
  • String
  • 可选
  • DE1234
  • 仓储系统发库单号
  • └ orderSourceCode
  • String
  • 可选
  • JY1234
  • 交易单号
  • └ page
  • Number
  • 必须
  • 1
  • 当前页
  • └ pageSize
  • Number
  • 必须
  • 10
  • 每页orderLine条数(最多100条)
  • └ extendProps
  • Map
  • 可选
  • 扩展属性
  • └ remark
  • String
  • 可选
  • 备注
  • 备注

响应参数

名称 类型 示例值 描述
response DeliveryOrderQueryResponse
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • └ totalLines
  • Number
  • 100
  • orderLines总条数
  • deliveryOrder
  • DeliveryOrder
  • 发货单信息
  • └ deliveryOrderCode
  • String
  • T1234
  • 出库单号
  • └ deliveryOrderId
  • String
  • C1234
  • 仓储系统出库单号
  • └ warehouseCode
  • String
  • W1234
  • 仓库编码
  • └ orderType
  • String
  • JYCK
  • 出库单类型(JYCK=一般交易出库;HHCK=换货出库;BFCK=补发出库;QTCK=其他出库单)
  • └ status
  • String
  • NEW
  • 出库单状态(NEW-未开始处理;ACCEPT-仓库接单;PARTDELIVERED-部分发货完成;DELIVERED-发货完成;EXCEPTION-异 常;CANCELED-取消;CLOSED-关闭;REJECT-拒单;CANCELEDFAIL-取消失败;只传英文编码)
  • └ outBizCode
  • String
  • WB1234
  • 外部业务编码(消息ID;用于去重;ISV对于同一请求;分配一个唯一性的编码。用来保证因为网络等原因导致重复传输;请 求 不会被重复处理;条件必填;条件为一单需要多次确认时)
  • └ confirmType
  • Number
  • 0
  • 支持出库单多次发货(多次发货后确认时;0表示发货单最终状态确认;1表示发货单中间状态确 认)
  • └ orderConfirmTime
  • String
  • 2016-09-08 12:00:00
  • 订单完成时间(YYYY-MM-DD HH:MM:SS)
  • └ operatorCode
  • String
  • O23
  • 当前状态操作员编码
  • └ operatorName
  • String
  • 老王
  • 当前状态操作员姓名
  • └ operateTime
  • String
  • 2016-09-09 12:00:00
  • 当前状态操作时间(YYYY-MM-DD HH:MM:SS)
  • └ storageFee
  • String
  • 12.0
  • 仓储费用
  • invoices
  • Invoice []
  • 发票信息
  • └ header
  • String
  • XXX公司
  • 发票抬头
  • └ amount
  • String
  • 12.0
  • 发票金额
  • └ content
  • String
  • XXX公司报销XX元
  • 发票内容
  • detail
  • Detail
  • 发货详情
  • items
  • Item []
  • 商品列表
  • └ itemName
  • String
  • 淘公仔
  • 商品名称
  • └ unit
  • String
  • 商品单位
  • └ price
  • String
  • 12.0
  • 商品单价
  • └ quantity
  • Number
  • 12
  • 数量
  • └ amount
  • String
  • 12.0
  • 金额
  • └ code
  • String
  • CODE123
  • 发票代码(纳税企业的标识)
  • └ number
  • String
  • NUM123
  • 发票号码(纳税企业内部的发票号)
  • packages
  • Package []
  • 包裹信息
  • └ logisticsCode
  • String
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通 (ZTO)、HTKY=百世汇 通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅 配、 AMAZON=亚马逊物流、OTHER=其他;只传英文编码)
  • └ logisticsName
  • String
  • 顺丰
  • 物流公司名称
  • └ expressCode
  • String
  • Y1234
  • 运单号
  • └ packageCode
  • String
  • LG1234
  • 包裹编号
  • └ length
  • String
  • 12.0
  • 包裹长度(单位:厘米)
  • └ width
  • String
  • 12.0
  • 包裹宽度(单位:厘米)
  • └ height
  • String
  • 12.0
  • 包裹高度(单位:厘米)
  • └ theoreticalWeight
  • String
  • 12.0
  • 包裹理论重量(单位:千克)
  • └ weight
  • String
  • 12.0
  • 包裹重量(单位:千克)
  • └ volume
  • String
  • 12.0
  • 包裹体积(单位:升)
  • └ invoiceNo
  • String
  • IN1234
  • 发票号
  • packageMaterialList
  • PackageMaterial []
  • 包材信息
  • └ type
  • String
  • XLL
  • 包材型号
  • └ quantity
  • Number
  • 12
  • 包材的数量
  • items
  • Item []
  • 商品列表
  • └ itemCode
  • String
  • I1234
  • 商品编码
  • └ itemId
  • String
  • WI1234
  • 商品仓储系统编码
  • └ quantity
  • Number
  • 11
  • 包裹内该商品的数量
  • orderLines
  • OrderLine []
  • 单据列表
  • └ orderLineNo
  • String
  • 1
  • 单据行号
  • └ orderSourceCode
  • String
  • P1234
  • 平台交易订单编码
  • └ subSourceCode
  • String
  • J1234
  • 平台交易子订单编码
  • └ itemCode
  • String
  • I1234
  • 商品编码
  • └ itemId
  • String
  • WI1234
  • 商品仓储系统编码
  • └ inventoryType
  • String
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;默认为查所有类型的库存)
  • └ ownerCode
  • String
  • OW1234
  • 货主编码
  • └ itemName
  • String
  • 淘公仔
  • 商品名称
  • └ extCode
  • String
  • PL1234
  • 交易平台商品编码
  • └ planQty
  • Number
  • 12
  • 应发商品数量
  • └ actualQty
  • Number
  • 12
  • 实发商品数量
  • └ batchCode
  • String
  • P1234
  • 批次编号
  • └ productDate
  • String
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 2017-09-09
  • 过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • P2345
  • 生产批号
  • batchs
  • Batch []
  • 批次列表
  • └ batchCode
  • String
  • PC1234
  • 批次编号
  • └ productDate
  • String
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 2017-09-09
  • 过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • PH1234
  • 生产批号
  • └ inventoryType
  • String
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存;默认为查所有类型的库存)
  • └ actualQty
  • Number
  • 12
  • 实发数量(要求batchs节点下所有的实发数量之和等于orderline中的实发数量)
  • └ qrCode
  • String
  • one;two
  • 商品的二维码(类似电子产品的SN码;用来进行商品的溯源;多个二维码之间用分号;隔开)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
DeliveryorderQueryRequest req = new DeliveryorderQueryRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setDeliveryOrderCode("奇门仓储字段,说明,string(50),,");
req.setStatus("奇门仓储字段,说明,string(50),,");
req.setDeliveryOrderId("奇门仓储字段,说明,string(50),,");
req.setOwnerCode("Owner1234");
req.setWarehouseCode("Warhouse1234");
req.setOrderCode("D1234");
req.setOrderId("DE1234");
req.setOrderSourceCode("JY1234");
req.setPage(1L);
req.setPageSize(10L);
req.setRemark("备注");
DeliveryorderQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <totalLines>100</totalLines>
    <deliveryOrder>
        <deliveryOrderCode>T1234</deliveryOrderCode>
        <deliveryOrderId>C1234</deliveryOrderId>
        <warehouseCode>W1234</warehouseCode>
        <orderType>JYCK</orderType>
        <status>NEW</status>
        <outBizCode>WB1234</outBizCode>
        <confirmType>0</confirmType>
        <orderConfirmTime>2016-09-08 12:00:00</orderConfirmTime>
        <operatorCode>O23</operatorCode>
        <operatorName>老王</operatorName>
        <operateTime>2016-09-09 12:00:00</operateTime>
        <storageFee>12.0</storageFee>
        <invoices>
            <invoice>
                <header>XXX公司</header>
                <amount>12.0</amount>
                <content>XXX公司报销XX元</content>
                <detail>
                    <items>
                        <item>
                            <itemName>淘公仔</itemName>
                            <unit>个</unit>
                            <price>12.0</price>
                            <quantity>12</quantity>
                            <amount>12.0</amount>
                        </item>
                    </items>
                </detail>
                <code>CODE123</code>
                <number>NUM123</number>
            </invoice>
        </invoices>
    </deliveryOrder>
    <packages>
        <package>
            <logisticsCode>SF</logisticsCode>
            <logisticsName>顺丰</logisticsName>
            <expressCode>Y1234</expressCode>
            <packageCode>LG1234</packageCode>
            <length>12.0</length>
            <width>12.0</width>
            <height>12.0</height>
            <theoreticalWeight>12.0</theoreticalWeight>
            <weight>12.0</weight>
            <volume>12.0</volume>
            <invoiceNo>IN1234</invoiceNo>
            <packageMaterialList>
                <packageMaterial>
                    <type>XLL</type>
                    <quantity>12</quantity>
                </packageMaterial>
            </packageMaterialList>
            <items>
                <item>
                    <itemCode>I1234</itemCode>
                    <itemId>WI1234</itemId>
                    <quantity>11</quantity>
                </item>
            </items>
        </package>
    </packages>
    <orderLines>
        <orderLine>
            <orderLineNo>1</orderLineNo>
            <orderSourceCode>P1234</orderSourceCode>
            <subSourceCode>J1234</subSourceCode>
            <itemCode>I1234</itemCode>
            <itemId>WI1234</itemId>
            <inventoryType>ZP</inventoryType>
            <ownerCode>OW1234</ownerCode>
            <itemName>淘公仔</itemName>
            <extCode>PL1234</extCode>
            <planQty>12</planQty>
            <actualQty>12</actualQty>
            <batchCode>P1234</batchCode>
            <productDate>2016-09-09</productDate>
            <expireDate>2017-09-09</expireDate>
            <produceCode>P2345</produceCode>
            <batchs>
                <batch>
                    <batchCode>PC1234</batchCode>
                    <productDate>2016-09-09</productDate>
                    <expireDate>2017-09-09</expireDate>
                    <produceCode>PH1234</produceCode>
                    <inventoryType>ZP</inventoryType>
                    <actualQty>12</actualQty>
                </batch>
            </batchs>
            <qrCode>one;two</qrCode>
        </orderLine>
    </orderLines>
</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

返回
顶部