注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 架海金梁业务样例文档

合单发货

更新时间:2019/07/24 访问次数:348

taobao.qimen.deliveryorder.confirm 合单发货

合单1:只有同属于一个仓库的订单才能进行合单操作,订单A和订单B属于同一个仓库的订单,可进行合单操作

期望ERP:一个物流单可能包含多个交易的子交易,ERP需要根据发货明细里对应的主交易号和子交易号进行相关订单的发货匹配,菜鸟回传发货出库确认信息后,订单A和订单B都要能变成已发货并扣减对应货品的库存。

请求报文

<request>
  <deliveryOrder>
    <extendProps>isOwnerForceControl:1;isCompleted:true;</extendProps>
    <warehouseCode>STB</warehouseCode>
    <deliveryOrderCode>45484128-BMC20190716500285486429</deliveryOrderCode>
    <deliveryOrderId>LBX0323933416287105</deliveryOrderId>
    <orderType>JYCK</orderType>
    <outBizCode>45484128-BMC20190716500285486429</outBizCode>
    <confirmType>0</confirmType>
    <shopNick>b商家测试帐号157</shopNick>
    <orderConfirmTime>2019-07-16 17:29:04</orderConfirmTime>
  </deliveryOrder>
  <packages>
    <package>
      <logisticsCode>TANGYU-1002</logisticsCode>
      <expressCode>test7333580654</expressCode>
      <packageCode>test7333580654</packageCode>
      <width>666.1</width>
      <height>571.1</height>
      <weight>6.383</weight>
      <packageMaterialList>
        <packageMaterial>
          <type>TM_001108</type>
          <quantity>1</quantity>
        </packageMaterial>
      </packageMaterialList>
      <items>
        <item>
          <itemCode>JHJL002</itemCode>
          <itemId>598314149195</itemId>
          <quantity>1</quantity>
        </item>
        <item>
          <itemCode>JHJL001</itemCode>
          <itemId>598079064379</itemId>
          <quantity>1</quantity>
        </item>
      </items>
    </package>
  </packages>
  <orderLines>
    <orderLine>
      <extendProps>subOrderType:1;extOrderItemId:196667416960;subEventType:0;itemGiftType:4;</extendProps>
      <orderSourceCode>291302759712214687</orderSourceCode>
      <subSourceCode>291302759712214687</subSourceCode>
      <itemCode>JHJL002</itemCode>
      <itemId>598314149195</itemId>
      <ownerCode>3705360393</ownerCode>
      <actualQty>1</actualQty>
      <produceCode>sdfdsfdfd</produceCode>
      <expireDate>2019-07-16 22:29:04</expireDate>
    </orderLine>
    <orderLine>
      <extendProps>subOrderType:1;extOrderItemId:196667416961;subEventType:0;itemGiftType:4;</extendProps>
      <orderSourceCode>290873060983214687</orderSourceCode>
      <subSourceCode>290873060983214687</subSourceCode>
      <itemCode>JHJL001</itemCode>
      <itemId>598079064379</itemId>
      <ownerCode>3705360393</ownerCode>
      <actualQty>1</actualQty>
      <produceCode>sdfdsfdfd</produceCode>
      <expireDate>2019-07-16 22:29:04</expireDate>
    </orderLine>
  </orderLines>
</request>

合单2:订单A先拆成A1,A2两个子订单,其中A2和订单B属于同一个仓库,那A2和B可以合单,另一个A1则单独发货

期望ERP:一个物流单可能包含多个交易的子交易,ERP需要根据发货明细里对应的主交易号和子交易号进行相关订单的发货匹配,订单A在ERP系统中存在2条明细,A2和B合单发货之后,子订单A2和订单B的订单状态变成已发货,且成功扣减对应库存。

请求报文

<request>
  <deliveryOrder>
    <extendProps>isOwnerForceControl:1;isCompleted:true;</extendProps>
    <warehouseCode>STB</warehouseCode>
    <deliveryOrderCode>45484128-BMC20190717500285660709</deliveryOrderCode>
    <deliveryOrderId>LBX0323933418276934</deliveryOrderId>
    <orderType>JYCK</orderType>
    <outBizCode>45484128-BMC20190717500285660709</outBizCode>
    <confirmType>0</confirmType>
    <shopNick>b商家测试帐号157</shopNick>
    <orderConfirmTime>2019-07-17 10:18:12</orderConfirmTime>
  </deliveryOrder>
  <packages>
    <package>
      <logisticsCode>TANGYU-1002</logisticsCode>
      <expressCode>test6565578959</expressCode>
      <packageCode>test6565578959</packageCode>
      <width>501.9</width>
      <height>450.3</height>
      <weight>7.1</weight>
      <packageMaterialList>
        <packageMaterial>
          <type>TM_001108</type>
          <quantity>1</quantity>
        </packageMaterial>
      </packageMaterialList>
      <items>
        <item>
          <itemCode>JHJL002</itemCode>
          <itemId>598314149195</itemId>
          <quantity>1</quantity>
        </item>
        <item>
          <itemCode>JHJL001</itemCode>
          <itemId>598079064379</itemId>
          <quantity>1</quantity>
        </item>
      </items>
    </package>
  </packages>
  <orderLines>
    <orderLine>
      <extendProps>subOrderType:1;extOrderItemId:197417178246;subEventType:0;itemGiftType:4;</extendProps>
      <orderSourceCode>291291302542214687</orderSourceCode>
      <subSourceCode>291291302542214687</subSourceCode>
      <itemCode>JHJL002</itemCode>
      <itemId>598314149195</itemId>
      <ownerCode>3705360393</ownerCode>
      <actualQty>1</actualQty>
      <produceCode>sdfdsfdfd</produceCode>
      <expireDate>2019-07-17 15:18:12</expireDate>
    </orderLine>
    <orderLine>
      <extendProps>subOrderType:1;extOrderItemId:197417178247;subEventType:0;itemGiftType:4;</extendProps>
      <orderSourceCode>291129125701214687</orderSourceCode>
      <subSourceCode>291129125702214687</subSourceCode>
      <itemCode>JHJL001</itemCode>
      <itemId>598079064379</itemId>
      <ownerCode>3705360393</ownerCode>
      <actualQty>1</actualQty>
      <produceCode>sdfdsfdfd</produceCode>
      <expireDate>2019-07-17 15:18:12</expireDate>
    </orderLine>
  </orderLines>
</request>

合单3:补发单和普通交易单合单

期望ERP:合单之后,订单明细中的subOrderType不同,ERP需根据该字段的值来判断单据类型,并更新对应单据状态,扣减对应货品库存

请求报文

<request>
  <deliveryOrder>
    <extendProps>isOwnerForceControl:1;isCompleted:true;</extendProps>
    <warehouseCode>STB</warehouseCode>
    <deliveryOrderCode>45484128-BMC20190717500285660709</deliveryOrderCode>
    <deliveryOrderId>LBX0323933418276934</deliveryOrderId>
    <orderType>JYCK</orderType>
    <outBizCode>45484128-BMC20190717500285660709</outBizCode>
    <confirmType>0</confirmType>
    <shopNick>b商家测试帐号157</shopNick>
    <orderConfirmTime>2019-07-17 10:18:12</orderConfirmTime>
  </deliveryOrder>
  <packages>
    <package>
      <logisticsCode>TANGYU-1002</logisticsCode>
      <expressCode>test6565578959</expressCode>
      <packageCode>test6565578959</packageCode>
      <width>501.9</width>
      <height>450.3</height>
      <weight>7.1</weight>
      <packageMaterialList>
        <packageMaterial>
          <type>TM_001108</type>
          <quantity>1</quantity>
        </packageMaterial>
      </packageMaterialList>
      <items>
        <item>
          <itemCode>JHJL002</itemCode>
          <itemId>598314149195</itemId>
          <quantity>1</quantity>
        </item>
        <item>
          <itemCode>JHJL001</itemCode>
          <itemId>598079064379</itemId>
          <quantity>1</quantity>
        </item>
      </items>
    </package>
  </packages>
  <orderLines>
    <orderLine>
      <extendProps>subOrderType:1;extOrderItemId:197417178246;subEventType:0;itemGiftType:4;</extendProps>
      <orderSourceCode>291291302542204687</orderSourceCode>
      <subSourceCode>291291302542204687</subSourceCode>
      <itemCode>JHJL002</itemCode>
      <itemId>598314149195</itemId>
      <ownerCode>3705360393</ownerCode>
      <actualQty>1</actualQty>
      <produceCode>sdfdsfdfd</produceCode>
      <expireDate>2019-07-17 15:18:12</expireDate>
    </orderLine>
    <orderLine>
      <extendProps>subOrderType:3;extOrderItemId:197417178247;subEventType:0;itemGiftType:4;</extendProps>
      <orderSourceCode>291129125701214687</orderSourceCode>
      <subSourceCode>291129125701214687</subSourceCode>
      <itemCode>JHJL001</itemCode>
      <itemId>598079064379</itemId>
      <ownerCode>3705360393</ownerCode>
      <actualQty>1</actualQty>
      <produceCode>sdfdsfdfd</produceCode>
      <expireDate>2019-07-17 15:18:12</expireDate>
    </orderLine>
  </orderLines>
</request>

响应成功报文

<response>
  <flag>success</flag>
  <code/>
  <message>发货单确认成功,单号:BMC20190716500286934115</message>
</response>

响应失败报文

<response>
  <flag>failure</flag>
  <code/>
  <message>发货单确认失败,单号:BMC20190716500286934115</message>
</response>

FAQ

关于此文档暂时还没有FAQ
返回
顶部