京东快递服务-B2C

京东物流向企业及个人客户提供安全可靠、时效领先、专业贴心的快递API服务，以及在此基础上的多种增值服务。

B2C：电商平台的商家发给C端用户的快递/快运服务；或者企业发C端、B端快递/快运的业务

1. 下单前校验：电商平台的商家发给C端用户的快递/快运服务；或者企业发C端、B端快递/快运的业务
2. 下单接口：京东物流接单接口，客户系统向京东物流下发订单，为订单分配运单号，客户初步获取时效、费用信息
3. 云打印：打印面单时需要对接京东物流云打印，使用下单后生成的运单号和商家编码作为入参，接口返回打印数据
4. 订单修改：下单成功后，若要修改下单信息，可通过此接口可以修改下单信息，例如修改收件人信息、包裹数等。。
5. 订单取消：下单后由于各种原因不寄件，则可调用此接口取消或者发起拦截；快递员揽收前可以取消，取消后运单号不可重复使用；揽收后则发起拦截。
6. 物流轨迹订阅：当商家需要接收京东物流主动推送的运单的物流信息时，需要先通过此接口进行订阅，订阅成功后，若运单产生物流信息，则通过推送接口回调商家在开放平台配置的回调接口，完成推送。
7. 物流轨迹推送：运单状态发生变化时，京东快递便通过调用回调接口将运单的跟踪信息推送给客户。
8. 订单轨迹查询：查询订单轨迹，获取订单正逆向订单关联的所有轨迹节点。
9. 订单状态查询：查询订单状态，获取订单当前最新的状态编码及名称。
10. 订单费用查询：查询订单的费用，包括运费及增值服务费，只支持现结费用查询，不支持查询月结运单的费用。

C2B：C端客户寄件给商家，例如：图书回收、洗护业务、电商平台客户退货发起的逆向业务等业务场景

1. 下单前校验：下单前使用此接口来判断收、派地址是否属于京东物流的收派范围，校验通过后出参返回揽收时间范围、支持的产品、预计送达时间以及预估运费。
2. 下单接口：京东物流接单接口，客户系统向京东物流下发订单，为订单分配运单号，客户初步获取时效、费用信息
3. 物流轨迹订阅：当商家需要接收京东物流主动推送的运单的物流信息时，需要先通过此接口进行订阅，订阅成功后，若运单产生物流信息，则通过推送接口回调商家在开放平台配置的回调接口，完成推送。
4. 物流轨迹推送：运单状态发生变化时，京东快递便通过调用回调接口将运单的跟踪信息推送给客户。
5. 订单轨迹查询：查询订单轨迹，获取订单正逆向订单关联的所有轨迹节点，订单的节点说明参照文档。
6. 订单修改：通过此接口可以修改下单信息，例如收件人信息、包裹数等。
7. 订单取消：下单后由于各种原因不寄件，则可调用此接口取消或者发起拦截；快递员揽收前可以取消，取消后运单号不可重复使用；揽收后则发起拦截。
8. 订单状态查询：查询订单状态，获取订单当前最新的状态编码及名称，订单的节点说明参照文档。
9. 订单费用查询：查询订单的费用，包括运费及增值服务费，只支持现结费用查询，不支持查询月结运单的费用。

接入前准备

自研商家

1. 与京东物流签约，获取到客户编码
   客户编码通常也叫月结编码、青龙业主号、配送编码，编码有固定的格式，签约后生成。若不知道本公司的商家编码，请咨询贵公司的商务或者联系京东物流的销售获取。
   若没有签约，签约途径如下：
   1、登录京东物流官网,提交合作申请
   2、联系贵公司附近的京东物流配送站点签约
2. 开通账号
   签约完成后，联系京东物流的销售开通账号权限，此账号用于登录京东物流商家工作台、授权获取access_token
   注意：授权获取access_token的京东账号必须是京东物流的销售开通过权限的才行，如果使用其他京东账号授权，在调用接口时会报错，错误信息：用户身份编码(PIN)与商家编码(CUSTOMERCODE)不符

使用限制

• 必须有软件著作权
• 在联调前找一个签约京东物流的商家，使用此商家的配送编码在生产环境做联调测试（京东快递无沙箱环境、无联调用的商家编码）
  注意：商家给ISV应用授权获取access_token的京东账号必须是京东物流的销售开通过权限的才行，否则在调用接口时会报错，错误信息：用户身份编码(PIN)与商家编码(CUSTOMERCODE)不符

1. 支持电商平台的商家（即京东物流的签约商家）发给C端用户的快递服务，以及企业内部的寄件服务，以下的文档和API描述简称快递B2C
2. 支持逆向物流，C端客户寄件给商家，例如：图书回收、洗护业务、电商平台客户退货发起的逆向业务等业务场景，以下的文档和API描述简称快递C2B
3. 为合作伙伴提供基础API，合作伙伴通过小程序/APP/H5/PC-Web开放京东物流个人消费者寄快递服务，以下的文档和API文档简称快递C2C
4. 支持电商平台的商家（即京东物流的签约商家）发给C端用户的快运服务，以及企业内部的寄件服务，以下的文档和API描述简称快运B2C
5. 为合作伙伴提供基础API，合作伙伴通过小程序/APP/H5/PC-Web开放京东物流个人消费者寄快运服务，以下的文档和API文档简称快运C2C