返回订单API

  • 功能描述:商家可以将正在配货或者等待发货部分发货的订单修改为已发货或者部分发货,商家可以批量处理多张发货订单。本接口支持自发订单(包括COD和非COD订单),暂时不支持当当代发订单(包括COD和非COD订单)。

    a)发货只能以订单的包件为单位发货,即一个包件要么都发货,要么包件中的品全不发。

    b)如果发货前有多个包件信息,则支持多次发货,如果没有多个包件信息,则只能一次性发货。包件信息查看dangdang.order.details.package.get

    支持最大订单量:50

    支持的数据格式:json

    HTTP请求方式:POST 

    版本:1.0

      物流公司名称代码匹配表:

    物流公司名称

    物流公司id

    物流公司电话

    快递公司名称缩写

    中通快递

    102

    400-827-0270

    ZTO

    韵达快递

    103

    400-821-6789

    YUNDA

    申通快递

    104

    400-889-5543

    STO

    圆通快递

    101

    95554

    YTO

    顺丰快递

    105

    400-811-1111

    SF

    全峰快递

    106

    400-100-0001

    QFKD

    百世汇通快递

    107

    400-956-5656

    BEST

    天天快递

    108

    4001-888-888

    TTKDEX

    宅急送快递

    109

    400-6789-000

    ZJS

    国通快递

    110

    400-111-1123

    GTO

    龙邦快递

    111

    021-59218889

    LB

    安能快递

    112

    400-104-0088

    ANE56

    优速快递

    113

    400-111-1119 

    UC

    EMS

    114

    11185

    EMS

    快捷快递

    115

    400-830-4888

    FAST

    中铁物流

    116

    400-000-5566

    CRE

     德邦物流

    117

    400-830-5555

    DBWL

    邮政

    118

    11183

    YZ

    跨越速运

    119

    4008-098-098

    KYSY

    极兔速递

    120
    400-820-1666
    JT

     


  • 接口调用时传递的v为大版本号,如对于1.1,调用时为v=1.0

    时间:2019-10-14

    版本:v1.0

  • 变量名称

    变量命名

    变量类型

    是否必填

    示例

    说明

    发货json文件

    sendGoodParamDTO

    file


    发货json字符串,具体内容请参考以下表格

     

    变量名称

    变量命名

    变量类型

    是否必填

    示例

    说明

    订单批量发货请求列表

    ordersDTOList

    List


    订单列表信息含多张订单信息

    订单编号

    orderId

    Long

    123456789


    虚拟品发货信息

    virtualInfoDTO

    Object

     

    如果订单属于网络课程才能填写此字段

    虚拟品不能拆分包件,也不能多次发货,只能一次发货

    包含:

    网络课程密码

    网络课程有效期

    网络课程密码

    onlineCoursePassword

    String

     

    网络课程密码(网络课程必填)

    网络课程有效期

    onlineCourseValidityDate

    Date

     

    网络课程有效期(网络课程必填)

    包件信息列表

    packageSendDTOList

    List

     

    该订单对应拣货拆分的包件信息,包含:

    包裹id

    快递公司名称

    快递公司Id

    快递公司名称缩写

    快递公司电话

    快递单号

    Id列表

    其中快递公司名称,快递公司id至少填写一个,其中快递公司名称模糊匹配,快递公司id精确匹配。如果模糊匹配不到精确的物流,将可能影响物流信息的展示。所以建议填写快递公司id,可参照接口概述中的表格

    Id信息列表

     

    itemDTOList

    List

     

         包件中的品id

    id

    itemId

    Long

     

     

    包件id

    packageId

    Int

     

    对应dangdang.order.details.package.get中的包件id

    快递公司名称

    expressCompany

    String



     



    快递公司Id

    expressCompanyId

    String

     

    快递公司名称缩写,快递公司id至少填写一个,二者均为精确匹配。匹配成功,将改写正确的物流公司名称。如果匹配不到推荐物流,将可能影响物流信息的展示。所以建议填写快递公司id,可参照接口概述中的表格,非推荐物流(即表格中不存在的物流可以填写99999)

    快递公司名称缩写

    expressCompanyCode

    String

     

     快递公司名称缩写,快递公司id至少填写一个,二者均为精确匹配。匹配成功,将改写正确的物流公司名称。如果匹配不到推荐物流,将可能影响物流信息的展示。所以建议填写快递公司id,可参照接口概述中的表格,非推荐物流(即表格中不存在的物流可以填写99999)

    快递公司电话

    expressCompanyTel

    String

     

     

    快递单号

    expressNo

    String

     

     

  • 变量名称

    变量命名

    变量类型

    说明

    接口操作码

    code

    Int

    0表示接口调用成功,其他表示失败

    接口操作码解析

    message

    string

    对于接口操作码的中文或英文解释

    操作数据

    data

     

     

    订单拣货操作结果列表

    ordersList

    List

    订单号

    对应订单拣货操作码

    对应订单拣货操作码解析

    订单号

    orderId

    Long

     

    订单拣货操作码

    orderOperCode

    Int

    对应订单拣货操作码

    订单拣货操作码解析

    orderOperation

    string

    对于订单操作码的中文或英文解释

  • {
        
    "ordersDTOList":[
            {
                
    "orderId":1013037877787,
                
    "packageSendDTOList":[
                    {
                        
    "expressCompany":"红帽子快递",
                        
    "expressCompanyCode":"",
                        
    "expressCompanyId":"201",
                        
    "expressCompanyTel":"01057999999",
                        
    "expressNo":"jk1013037877787",
                    
                        
    "itemDTOList":[
                            {
                                
    "itemId":1013037877787001
                            }
                        ],
                        
    "packageId":21096613
                    },
                    {
                        
    "expressCompany":"中通快递",
                        
    "expressCompanyCode":"",
                        
    "expressCompanyId":"102",
                        
    "expressCompanyTel":"01057999999",
                        
    "expressNo":"jk10130378777872",
                  
                        
    "itemDTOList":[
                            {
                                
    "itemId":1013037877787002
                            }
                        ],
                        
    "packageId":21096614
                   
                    }
                ]
            }
        ]


    }

  • {
        
    "code":0,
        
    "message":"success",
        
    "data":{
            
    "orderInfoDTOList":[
                {
                    
    "orderId":123456789,
                    
    "orderOperCode":0,
                    
    "orderOperation":"操作成功"
                }
            ]
        }

    }