Jingdong Logistics Open Platform

The logistics service providers docking Handbook V2.7

Contents
1 Platform introduction 4
2 Common parameters and invocation examples 5
3 The Whole Process and Detailed Description of Interface in Export of Small Parcels 12
3.1 Draw the Waybill 14
3.1.1 Business Description 14
3.1.2 Subscribe to [package delivery] messaging services 14
3.1.3 Invoking [pull the waybill] API 16
3.1.4 Invoking the API of[Waybill’s Feedback] 32
3.2 Bulk Withdrawal of Waybill 34
3.2.1 Service Description 34
3.2.2 Subscribe to [package bulk delivery] message service 34
3.2.3 Invoking the API of[Bulk Withdrawal of Waybill] 36
3.2.4 Invoking the API of [Batch Bill Feedback] 52
3.3 Cancellation of Waybill 54
3.3.1 Business Description 54
3.3.2 Subscribe to [Freight Order Cancellation] Message Service 54
3.4 Feedback waybill number 56
3.4.1 Business Description 56
3.4.2 Invoking the API of [Batch Bill Feedback] 56
3.5 Printing Express Sheet 58
3.5.1 Business Description 58
3.5.2 Subscribe to [Printing express sheet] messaging service（This subscription is
not required if the shipper feeds back the express sheet independently.） 59
3.5.3 Invoking the API of [Feedback’s waybill] 60
3.6 Weight’s Charges 62
3.6.1 Business Description 62
3.6.2 Invoking the API of [Weight’s Charges] 62
3.7 Waybill’s Tracking 65
3.7.1 Business Description 65
3.7.2 Invoking the API of[Waybill’s Tracking] 65
3.8 Receive Collecting Tasks 70
3.8.1 Business Description 70
3.8.2 Subscribe to[Receive and Issue Tasks] Message Service 71
3.8.3 Invoking the API of [Solicit and Collect Tasks] 72
3.8.4 Invoking the API of[Collect tasks’ feedback] 74
3.9 Tracking the Collection status 75
3.9.1 Business Description 75
3.9.2 Invoking the API of [Collection status’ track] 75
3.10 The Pediction of Collection and delivery 78
3.10.1 Business Description 78
3.10.2 Invoking the API of[Collect’s Prediction] 78

version
Revision
numbe Reviser Revised contents
date
r

V1.0 JD 2017-11-20

Modified the message of "pull out waybill" and added

V1.1 JD 2018-06-08
some fields
Invoke parameter unification adds user field. Increase
the state table tracking waybill. The returnee field is
V2.0 JD 2018-06-28
changed from return to retreat. ReferenceNo updated
to DDL
Increased by 3.2 [bulk pick up waybill]. 3.6 [Weight Fee]
V2.2 JD 2018-07-18 adds a large package number, and the volume is not
required when the large package is fed back.
[3.6 weight fee] and [3.7 waybill tracking] increase the
feedback dimension (type), which requires the service
provider to specify whether to feedback the weight and
tracking trajectory according to the dimension of big
V2.3 JD 2018-07-26 package or small package. The main part of the whole
article is the Beijing-East Transport Bill, which is
replaced by the "Beijing-East Transport Bill" which is no
longer called the "Beijing-East Order", adding DDL in
3.1,3.2. Added [3.3 Cancel waybill Interface].
[3.1.4] and [3.2.4] add a new type field to distinguish
V2.4 JD 2018-08-13 between feedback by big package dimension and small
package dimension.
3.1.3 Increased BigBag ParcelQty to record the number
of small packages under a large package, so that the
V2.5 JD 2018-09-03
recipient can determine the information collection of
small packages under a large package.
Declare spelling error correction (wrong written
delcare). [3.1.3] to add the amount of cash on delivery
V2.6 JD 2018-10-01 codValue[3.7.2] EventTime type changed from
Datetime to String, length 19, format yyyy-MM-dd HH:
mm: ss. [3.7.2] Add logistics node hub-out
 Chapter 3 adds the overall flow chart.
Increased the number of "3.8" to receive tasks.
V2.7 JD 2018-12-06
ncreased [3.9] Tracking of Receiving Nodes.
Increased [3.10] delivery forecast.
1 Platform introduction

Jingdong Logistics Open Platform (hereinafter referred to as JDWL) is a

unified access for external users to call the internal system interface of Jingdong
Logistics. All APIs are based on HTTP protocol (meanwhile supporting HTTPS).
Developers need to encapsulate HTTP requests for invocation voluntarily.
Service providers need to apply for ISV first to use the platform. The
introduction guide and application methods are detailed in the following sections:
http://open.jdwl.com/docu/viewDefault/1.html

The service URL address for invoking the API:

Calling
Service address (HTTP) Service address (HTTPS)
circumstances
UAT
http://uat-api.jdwl.com/routerjson https://uat-api.jdwl.com/routerjson
environment
Formal
http://api.jdwl.com/routerjson https://api.jdwl.com/routerjson
environment

Formal environment: ISV software on-line use environment, the entry of this
environment is consistent with the formal test environment, but after the
application on-line, traffic restrictions will be opened, the specific traffic related to
the application category, such as the application of service market category,
restrict API calls to 1 million times per day.
2 Common parameters and invocation

examples

Parameters that must be passed in to invoke any API,the common parameters

currently supported are:
Parameter name Parameter type Whether must Parameter
description
Method String Yes API interface name
app_key String Yes Appkey assigned to
application
access_token String Yes Dynamic token
issued by Oauth2
timestamp String Yes Timestamp, format
is yyyy-MM-dd
HH:mm:ss, time
zone is GMT+8,for
example:2016-01-
01 12:00:00
v String Yes API Protocol
Version, Optional
value:2.0
sign String Yes API input parameter
signature results,
the signature
algorithm is
described below.

signature algorithm
Sign is the signature value generated by the request string and the secret key
according to a certain signature method, which is used to prevent the parameters
from being tampered with in the transmission process. The specific signature
method is as follows:
Step 1 ： Sort all request parameters according to ASCII code list of parameter
names.
Such as: Sort access_token,app_key,method,timestamp,v into
access_token,app_key,method,timestamp,v

Step 2: Splice all parameter names and values (no cross-lines are allowed during
splicing, no spaces are allowed in other places except in the middle of date and
time, and the order of parameters in param_json should be consistent with the
order of incoming data when requesting)
Such as:access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvx
Step 3:Place appSecret at both ends of the string
Such as:appSecret+ access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvx
+appSecret

Step 4: Encrypt with MD5, and convert summary results into capitals using
hexadecimal representation,Such as：
md5(appSecret+ access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvx
+appSecret)
JAVA Signature Sample Code

private String buildSign(String timestamp, String version, String method ,

String paramJson , String accessToken ,
String appKey, String appSecret) throws Exception {
// The first step is to fill in the parameters in order
Map<String, String> map = new TreeMap();
map.put("timestamp", timestamp);
map.put("v", version);
map.put("method", method);
map.put("param_json", paramJson);
map.put("access_token", accessToken);
map.put("app_key", appKey);
StringBuilder sb = new StringBuilder(appSecret);
// According to the rules Spelling string
for (Map.Entry entry : map.entrySet()) {
String name = (String) entry.getKey();
String value = (String) entry.getValue();
sb.append(name).append(value);
}
sb.append(appSecret);
//MD5
return md5(sb.toString());
}

public static String md5(String source) throws Exception {

MessageDigest md = MessageDigest.getInstance("MD5");
byte[] bytes = md.digest(source.getBytes("utf-8"));
return byte2hex(bytes);
}

private static String byte2hex(byte[] bytes) {

StringBuilder sign = new StringBuilder();
for (int i = 0; i < bytes.length; i++) {
String hex = Integer.toHexString(bytes[i] & 0xFF);
if (hex.length() == 1) {
sign.append("0");
}
sign.append(hex.toUpperCase());
 }
return sign.toString();
}

API call instance

Assuming that API is invoked jd.order.search
app_key： yourappkey
appSecret： yourappSecret
access_token： yourtoken

1) Setting parameters
access_token=yourtoken
app_key=yourappkey
method=jd.order.search
timestamp=2017-04-20 11:10:04
v=2.0
param_json=["test"]

2) Sort by ASCII code list order

access_token=yourtoken
app_key=yourappkey
method=jd.order.search

param_json=["test"]

timestamp=2017-04-20 11:10:04
v=2.0

3) Stitching parameter name and parameter value

Authorization Interface: (Example)
yourappSecretaccess_tokenyourtokenapp_keyyourappkeymethodjd.order.search
param_json{"end_date":null,"optional_fields":null,"order_state":"WAIT_SELLER_STO
CK_OUT","page":"1","page_size":"200","start_date":null}timestamp2017-04-
2116:28:02v2.0yourappSecret

Unauthorized interfaces: (example)

yourappSecretapp_keyyourappkeymethodjd.order.searchparam_json{"end_date":n
ull,"optional_fields":null,"order_state":"WAIT_SELLER_STOCK_OUT","page":"1","pag
e_size":"200","start_date":null}timestamp2017-04-21 16:28:02v2.0yourappSecret

4) Generate signature
Assume appsecret of app is yourappSecret，The signature result is:
hex(md5(yourappSecret + Parameter names and values spliced sequentially+
yourappSecret)) = “91DEBBFBAA3245A88445F99E55FC214D”

5) Assemble HTTP requests

All parameter names and values are encoded in UTF-8 URLs (the order of
parameters is optional, but the signature parameters must be included), and then
requests are initiated through GET or POST,such as：
https://rest.jd.com/routerjosn?
sign=91DEBBFBAA3245A88445F99E55FC214D&timestamp=2017-04-
1920%3A15%3A07&v=1.0&
app_key= yourappkey &method=biz.stock.fivestockbyid.get&access_token=
yourtoken &param_json=["test"]

Matters needing attention：

1) All request and response data are encoded in utf-8, and all parameter names
and values in the URL are encoded in the URL.
2) When the length of the URL assembled by parameter name and parameter
value is less than 1024 characters, GET can be used to initiate the request; when
the parameter type contains byte [] type or the assembled request URL is too
long, POST must be used to initiate the request. All APIs can initiate requests
using POST.
3 The Whole Process and Detailed

Description of Interface in Export of Small

Parcels

【Overall flow chart】

3.1Draw the Waybill

3.1.1 Business Description

Jingdong Logistics Platform receives the order information from the order system,
transforms the order into Jingdong waybill, and generates the internal waybill
number (ddl). Logistics service provider subscribes to the [package delivery]
message service, after receiving the message, calls the [pull the waybill] interface
to pull the waybill information and package information from JD. Logistics service
providers check the information received by the waybill, call the interface of
"waybill feedback" to inform whether the Beijing-East waybill has been
successfully received or not, if fail, to give the abnormal information. If the service
provider's Logistics Bill Number can be feedback immediately after receiving the
bill of lading(Tracking No is also called waybillNo), the service provider's Bill
Number trackingNo will also be returned to JD.

3.1.2 Subscribe to [package delivery] messaging services

【message ID】
pushdown-channel
【Message trigger condition】
Jingdong receives the order information from the order system, converts the
order into an internal order, and triggers the push pushdown-channel message.
【Message structure】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
Waybill No.
orderSource Order 20 N Used to
source differentiate
different order
sources. For
example, JD.com,
joybuy.com, etc.
orderNumber Jingdong 80 N JD internal order
Order No. number in order
system
orderType Document int Y 0: Feedback by
type big package. 1:
Feedback by small
package. Default 0
orderCreateTime Create DateTime N
order time
【Example of message】
{
“ddl”: “57140102278”,
"orderSource":"JD.com",
"orderNumber":"57140102278",
"orderType":"0",
"orderCreateTime":"2018-03-15 11:20:32"
}
【SDK Download】
It is suggested that Logistics providers use the SDK provided by JDWL to receive
messages, SDK Download Link：

3.1.3 Invoking [pull the waybill] API

【API】
jingdong.isc.magellan.createOrder
【Sservice request parameters】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y 57140102278
waybill
No.
user Service 20 Y
provider
registers
JDWL
account
【Request example】
{
“ddl”: “57140102278”,
“user”:”isvAccount”
}
【Response content】
Field name Meaning Type Whether Notes
(length) must (examples)
ddl Jingdong Waybill 64 M
No.
orderSource Waybill source 20 M 01-jd.com
02-
joybuy.com
03-JD.id
04-JD.th
05-其他
serviceCode Service Provider 20 M
Channel Number
serviceName Service Provider 100 M
Channel Name
serviceSubCode Channel sub- 20 O
option id
serviceSubName Channel 100 O
Suboption Name
incoterm Trade terms 10 O
customerAccount Customer 20 M
Number in Service
Provider System
of Jingdong
sellerAccount Businessmen'own 20 O
accounts
trackingNo Service Provider 40 O
Waybill No.
facility Consignor site 20 O/M
code
transInstruction Send instructions 255 O
ifDiscard If unable to 10 M Default is
deliver properly, yes
whether to
destroy
isCOD Whether cash on 10 M Y/N default
delivery is N
codValue The amount of double O/M If isCOD =
cash on delivery Y,this one is
must fill
currentCarrierCode Present Carrier 20 M
nextCarrierCode Downstream 20 O
Carrier
msgType Message type 4 M 01-Add 02-
Update 03-
Delete
bigBagParcelQty Number of small long O
packages under
large packages
parcel.parcelNumber Package number 64 M
parcel.weight Package weight double M
parcel.weightUnit Package weight 2 O
unit
parcel.volume Package volume double O/M
parcel.length Package length double O/M
parcel.width Package width double O/M
parcel.height Package height double O/M
parcel.dimensionUnit Length unit 3 O/M
parcel.declareValue Customs double M
declaration value
parcel.declareCurrency Currency of 3 M
Customs
Declaration Value
parcel.bigBagId Large package ID 64 O
parcel.hawbOrAwb Master bill 64 O
number/ Odd
number
receiver.name Odd number 50 M
receiver.cyrillicName Name of the 60 O
receiver's ID Card
receiver.taxId Receiver's Tax 20 O
Number
receiver.nationalNumber Receiver's ID 10 O
number
receiver.nationalIssueDate Date of issuance date O
of receiver's
identity card
receiver.passportNumber Passport No. 64
receiver.passportIssueDate Date of issuance date
of passport
receiver.postcode Receiver's 16 O
postcode
receiver.phone Receiver's phone 20 O
receiver.mobile Receiver's mobile 20 M
receiver.email Receiver's email 50 O
receiver.country Receiver's country 10 M
receiver.province Receiver's 10 M
province/state
receiver.city Receiver's city 10 M
receiver.district Receiver's district 10 O
receiver.street1 Receiver's street1 100 M
receiver.street2 Receiver's street2 100 O
receiver.street3 Receiver's street3 100 O
receiver.company Receiver's 100 O
company
sender.name Sender's name 50 O
sender.postcode Sender's postcode 16 O
sender.phone Sender's phone 20 O
sender.mobile Sender's mobile 20 O
sender.email Sender's email 50 O
sender.country Sender's country 10 O
sender.province Sender's 10 O
province/state
sender.city Sender's city 10 O
sender.district Sender's district 10 O
sender.street1 Sender's street1 100 O
sender.street2 Sender's street2 100 O
sender.street3 Sender's street3 100 O
sender.company Sender's company 100 O
collect.name Collect's name 50 O
collect.postcode Collect's postcode 16 O
collect.phone Collect's phone 20 O
collect.mobile Collect's mobile 20 O
collect.email Collect's email 50 O
collect.country Collect's country 10 O
collect.province Collect's province 10 O
collect.city Collect's city 10 O
collect.district Collect's district 10 O
collect.street1 Collect's street1 100 O
collect.street2 Collect's street2 100 O
collect.street3 Collect's street3 100 O
collect.company Collect's company 100 O
retreat.name Retreat's name 50 O
retreat.postcode Retreat's 16 O
postcode
retreat.phone Retreat's phone 20 O
retreat.mobile Retreat's mobile 20 O
retreat.email Retreat's email 50 O
retreat.country Retreat's country 10 O
retreat.province Retreat's province 10 O
retreat.city Retreat's city 10 O
retreat.district Retreat's district 10 O
retreat.street1 Retreat's street1 100 O
retreat.street2 Retreat's street2 100 O
retreat.street3 Retreat's street3 100 O
retreat.company Retreat's 100 O
company
goodsList.goodsDto.itemNo Item number 20 O/M
goodsList.goodsDto.sku Items SKU 30 O/M
number
goodsList.goodsDto.htsCode HS CODE 64 O/M
goodsList.goodsDto.description Goods description 50 O/M
goodsList.goodsDto.chnDescription Chinese 50 O/M
Description of
Goods
goodsList.goodsDto.cnName Chinese Name of 50 O/M
goods
goodsList.goodsDto.enName English Name of 50 O/M
goods
goodsList.goodsDto.count Quantity of goods int O/M
goodsList.goodsDto.weight Unit weight of double O/M
goods
goodsList.goodsDto.weightUnit Unit of weight for 3 O/M
goods
goodsList.goodsDto.declareValue Customs double O/M
clearance price
goodsList.goodsDto.declareCurrency The currency of 3 O/M
customs clearance
price
goodsList.goodsDto.origin Origin of goods 50 O/M
goodsList.goodsDto.batteryType Type of charge 4 M 0-
Commodity
 non-live
(default) 1-
live 2-pure
electricity
goodsList.goodsDto.ifHazmat Whether 4 M
dangerous goods
goodsList.goodsDto.ifFluid Whether liquid 4 M
goodsList.goodsDto.isCellphone Whether Mobile 4 M
Phone Products
goodsList.goodsDto.imei Mobile IMEI 32 O
number
goodsList.goodsDto.warehouseNo The number of 32 O
outgoing
warehouse
goodsList.goodsDto.platform The electronic 64 O
business platform
where purchasing
goodsList.goodsDto.url Purchase link 100 O/M

【Example of the response】

{
"data": {
"ddl": "J0320180529000000001",
"orderSource": "02",
"serviceCode": "UBI.CN2AU.AUPOST",
"serviceName": "China-Australia STI",
"serviceSubCode": "Non-Tracking",
"serviceSubName": "",
"incoterm": "",
"customerAccount": "8700843423",
"sellerAccount": "abs132114339",
"trackingNo": "ABC123456789001",
"facility": "230031",
"transInstruction": "keep up",
"ifDiscard": "Y",
"isCOD":"Y",
"codValue": "18.32",
"currentCarrierCode": "CEVA",
"nextCarrierCode": "CEVA",
"msgType": "01",
“bigBagParcelQty”: “210”,
"parcel": {
"parcelNumber": "57291195170-1-1",
"weight": "20.9",
"weightUnit": "kg",
"volume": "30",
"length": "10",
"width": "10",
"height": "10",
 "dimensionUnit": "cm",
"declareValue": "18.32",
"declareCurrency": "USD",
"bigBagId":"3242231",
"hawbOrAwb": "sde223e1"
},
"receiver": {
"name": "Tom.k",
"cyrillicName":"Bob",
"taxId": "10003535248989",
"nationalNumber": "110103199129923232",
"nationalIssueDate": "1993-02-02",
"passportNumber": "CN11010319880505714124",
"passportIssueDate": "1995-08-02",
"postcode": "10005",
"phone": "1111111",
"mobile": "212-222-0111",
"email": "bin@team.com",
"country": "UNITED STATES OF AMERICA",
"province": "LA",
"city": "San Francisco",
"district": "St.",
"street1": "200 Bumborah Point Rd",
"street2": "St. Peters",
"street3": "Lotus Street",
"company": "apple corperation"
},
"sender": {
"name": "Wang Lin",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "wanglin@team.com",
"country": "CN",
"province": "441402",
"city": "beijing",
"district": "dongcheng",
"street1": "qianmen street",
"street2": "qiananmen street",
"street3": "",
"company": "Teamsun"
},
"collect": {
"name": "zhang min",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "zhangmin@team.com",
"country": "CN",
"province": "441402",
 "city": "beijing",
"district": "dongcheng",
"street1": " No. 6 Lianhuachi East Road ",
"street2": "",
"street3": "",
"company": ""
},
"retreat": {
"name": "huohuo",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "huohuo@team.com",
"country": "US",
"province": "441402",
"city": "new york",
"district": "",
"street1": "",
"street2": "",
"street3": "",
"company": ""
},
"goodsList": {
"goodsDto": [
{
"itemNo": "00001",
"sku": "6474114",
"htsCode":"88000000",
"description": "PHONE",
"nativeDescription":" Mobile phone (must contain local characters)",
"cnName": "Iphone",
"enName": "iPhone",
"count": "1",
"weight": "0.1",
"weightUnit": "kg",
"declareValue": "400",
"declareCurrency": "USD",
"origin": "CN",
"batteryType": "1",
"ifHazmat": "N",
"ifFluid": "N",
"isCellphone":"Y",
"imei":"322A342432B32",
"warehouseNo": "",
"platform": "www.jd.com",
"url": "https://item.jd.com/?cateId=12260&itemId=1130389"
},
{
"itemNo": "00002",
"sku": "6474120",
 "htsCode":"88000001",
"description": "TOY",
"nativeDescription":" Toys (must contain local characters)",
"cnName": "Lego",
"enName": "lego architecture",
"count": "2",
"weight": "0.4",
"weightUnit": "kg",
"declareValue": "200",
"declareCurrency": "USD",
"origin": "US",
"batteryType": "0",
"ifHazmat": "N",
"ifFluid": "N",
"isCellphone":"N",
"imei":"",
"warehouseNo": "",
"platform": "www.jd.com",
"url": "https://item.jd.com/?cateId=12260&itemId=1130129"
}
]
}
},
"status":"SUCCESS",
"exception":””
}

3.1.4 Invoking the API of [Waybill’s Feedback]

【API】
jingdong.isc.magellan.orderStatus
【Business Request Parameters】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill No.
user Service 20 Y
provider
registers JDWL
account
validation Verification int Y 0 Failure 1
result Success
type Distinguishing int Y 0: Feedback by
big packet big package. 1:
feedback from Feedback by small
ssmall packet package. Default
feedback 0
trackingNo Waybill No. 40 N
message Supplementary 255 N
information
【Example of request】
{
“ddl”: “57140102278”,
“user”:”isvAccount”
“validation”: “0”,
“type”:”0”,
“trackingNo”: “”,
“message”: ” Postal Codes Can't Be Empty”
}
【Response's content】
Field name Meaning Type Whether Notes (examples)
(length) must
status status 10 Y SUCCESS
exception Abnormal 255 N
informatio
n

3.2Bulk Withdrawal of Waybill

3.2.1 Service Description

Batch operation of 3.1..

3.2.2 Subscribe to [package bulk delivery] message service

【message ID】
batch-pushdown-channel
【Triggering message’s condition】
Jingdong receives the order information from the order system and converts the
order into an internal transport order in Jingdong ，and trigger batch-pushdown-
channel message.

【The structure of messages】

Field name Meaning Type Whether Notes (examples)
(length) must
ddlList The list of 500 Y Multiple numbers
Jingdong’s are separated by
Waybill No. English commas
orderSource Waybill 20 N It is used to
 source distinguish
different sources
of waybill.Such as
JD.com ， joybuy.c
om etc.
orderNumberList Jingdong 500 N Multiple numbers
Order are separated by
Number English commas
(Multiple)
orderType Document 20 N 0: Feedback by
type big package. 1:
Feedback by
small package.
Default 0
orderCreateTime The creation DateTime N
time of
waybill

【Example of message】
{
“ddlList”:“{[57140102278, 57140102279, 57140102280, 57140102281,
57140102282]}”,
"orderSource":"JD.com",
"orderNumberList":{[57140102278, 57140102279, 57140102280, 57140102281,
57140102282]},
"orderType":"sales order",
"orderCreateTime":"2018-03-15 11:20:32"
}
【Download of SDK】
It is suggested that Logistics providers use the SDK provided by JDWL to receive
messages, SDK Download Link：

3.2.3 Invoking the API of[Bulk Withdrawal of Waybill]

【API】
jingdong.isc.magellan.createOrders
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddlList Jingdong 80 Y Separation of
waybill multiple numbers
number by English commas
(multiple)
user Service 20 Y
provider
registers
 JDWL
account
【Example of Request】
{
“ddlList”: {[57140102278, 57140102279, 57140102280, 57140102281,
57140102282]},
“user”:”isvAccount”
}
【Content of Response】
Message format is the same as Content of Response,which in 3.1.3.The
outermost layer returns list. See the example for details.

【Example of Response】
{
"dataList": [
{
"ddl": "J0320180529000000001",
"orderSource": "02",
"serviceCode": "UBI.CN2AU.AUPOST",
"serviceName": "China-Australia STI",
"serviceSubCode": "Non-Tracking",
"serviceSubName": "",
"incoterm": "",
"customerAccount": "8700843423",
"sellerAccount": "abs132114339",
"trackingNo": "ABC123456789001",
"facility": "230031",
"transInstruction": "keep up",
"ifDiscard": "Y",
"isCOD":"Y",
"codValue": "18.32",
"currentCarrierCode": "CEVA",
"nextCarrierCode": "CEVA",
"msgType": "01",
"parcel": {
"parcelNumber": "57291195170-1-1",
"weight": "20.9",
"weightUnit": "kg",
"volume": "30",
"length": "10",
"width": "10",
"height": "10",
"dimensionUnit": "cm",
"declareValue": "18.32",
"declareCurrency": "USD",
"bigBagId":"3242231",
"hawbOrAwb": "sde223e1"
},
"receiver": {
"name": "Tom.k",
"cyrillicName":"Bob",
"taxId": "10003535248989",
"nationalNumber": "110103199129923232",
 "nationalIssueDate": "1993-02-02",
"passportNumber": "CN11010319880505714124",
"passportIssueDate": "1995-08-02",
"postcode": "10005",
"phone": "1111111",
"mobile": "212-222-0111",
"email": "bin@team.com",
"country": "UNITED STATES OF AMERICA",
"province": "LA",
"city": "San Francisco",
"district": "St.",
"street1": "200 Bumborah Point Rd",
"street2": "St. Peters",
"street3": "Lotus Street",
"company": "apple corperation"
},
"sender": {
"name": "Wang Lin",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "wanglin@team.com",
"country": "CN",
"province": "441402",
"city": "beijing",
"district": "dongcheng",
"street1": "qianmen street",
"street2": "qiananmen street",
"street3": "",
"company": "Teamsun"
},
"collect": {
"name": "zhang min",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "zhangmin@team.com",
"country": "CN",
"province": "441402",
"city": "beijing",
"district": "dongcheng",
"street1": " No. 6 Lianhuachi East Road",
"street2": "",
"street3": "",
"company": ""
},
"retreat": {
"name": "huohuo",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "huohuo@team.com",
"country": "US",
"province": "441402",
"city": "new york",
"district": "",
 "street1": "",
"street2": "",
"street3": "",
"company": ""
},
"goodsList": {
"goodsDto": [
{
"itemNo": "00001",
"sku": "6474114",
"htsCode":"88000000",
"description": "PHONE",
"nativeDescription":" Mobile phone (must contain local characters) ",
"cnName": " IPhone",
"enName": "iPhone",
"count": "1",
"weight": "0.1",
"weightUnit": "kg",
"declareValue": "400",
"declareCurrency": "USD",
"origin": "CN",
"batteryType": "1",
"ifHazmat": "N",
"ifFluid": "N",
"isCellphone":"Y",
"imei":"322A342432B32",
"warehouseNo": "",
"platform": "www.jd.com",
"url": "https://item.jd.com/?cateId=12260&itemId=1130389"
},
{
"itemNo": "00002",
"sku": "6474120",
"htsCode":"88000001",
"description": "TOY",
"nativeDescription":" Toys (must contain local characters) ",
"cnName": " LEGO ",
"enName": "lego architecture",
"count": "2",
"weight": "0.4",
"weightUnit": "kg",
"declareValue": "200",
"declareCurrency": "USD",
"origin": "US",
"batteryType": "0",
"ifHazmat": "N",
"ifFluid": "N",
"isCellphone":"N",
"imei":"",
"warehouseNo": "",
"platform": "www.jd.com",
"url": "https://item.jd.com/?cateId=12260&itemId=1130129"
}
]
}
},
{
"ddl": "J0320180529000000002",
"orderSource": "02",
"serviceCode": "UBI.CN2AU.AUPOST",
"serviceName": "China-Australia STI",
"serviceSubCode": "Non-Tracking",
"serviceSubName": "",
"incoterm": "",
"customerAccount": "8700843423",
"sellerAccount": "abs132114339",
"trackingNo": "ABC123456789001",
"facility": "230031",
"transInstruction": "keep up",
"ifDiscard": "Y",
"isCOD":"Y",
"codValue": "18.32",
"currentCarrierCode": "CEVA",
"nextCarrierCode": "CEVA",
"msgType": "01",
"parcel": {
"parcelNumber": "57291195170-1-1",
"weight": "20.9",
"weightUnit": "kg",
"volume": "30",
"length": "10",
"width": "10",
"height": "10",
"dimensionUnit": "cm",
"declareValue": "18.32",
"declareCurrency": "USD",
"bigBagId":"3242231",
"hawbOrAwb": "sde223e1"
},
"receiver": {
"name": "Tom.k",
"cyrillicName":"Bob",
"taxId": "10003535248989",
"nationalNumber": "110103199129923232",
"nationalIssueDate": "1993-02-02",
"passportNumber": "CN11010319880505714124",
"passportIssueDate": "1995-08-02",
"postcode": "10005",
"phone": "1111111",
"mobile": "212-222-0111",
"email": "bin@team.com",
"country": "UNITED STATES OF AMERICA",
"province": "LA",
"city": "San Francisco",
"district": "St.",
"street1": "200 Bumborah Point Rd",
"street2": "St. Peters",
"street3": "Lotus Street",
"company": "apple corperation"
},
"sender": {
"name": "Wang Lin",
 "postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "wanglin@team.com",
"country": "CN",
"province": "441402",
"city": "beijing",
"district": "dongcheng",
"street1": "qianmen street",
"street2": "qiananmen street",
"street3": "",
"company": "Teamsun"
},
"collect": {
"name": "zhang min",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "zhangmin@team.com",
"country": "CN",
"province": "441402",
"city": "beijing",
"district": "dongcheng",
"street1": " No. 6 Lianhuachi East Road",
"street2": "",
"street3": "",
"company": ""
},
"retreat": {
"name": "huohuo",
"postcode": "100055",
"phone": "2131231",
"mobile": "1123333333313",
"email": "huohuo@team.com",
"country": "US",
"province": "441402",
"city": "new york",
"district": "",
"street1": "",
"street2": "",
"street3": "",
"company": ""
},
"goodsList": {
"goodsDto": [
{
"itemNo": "00001",
"sku": "6474114",
"htsCode":"88000000",
"description": "PHONE",
"nativeDescription":" Mobile phone (must contain local characters)",
"cnName": "IPhone",
"enName": "iPhone",
"count": "1",
"weight": "0.1",
"weightUnit": "kg",
 "declareValue": "400",
"declareCurrency": "USD",
"origin": "CN",
"batteryType": "1",
"ifHazmat": "N",
"ifFluid": "N",
"isCellphone":"Y",
"imei":"322A342432B32",
"warehouseNo": "",
"platform": "www.jd.com",
"url": "https://item.jd.com/?cateId=12260&itemId=1130389"
},
{
"itemNo": "00002",
"sku": "6474120",
"htsCode":"88000001",
"description": "TOY",
"nativeDescription":" Toys (must contain local characters)",
"cnName": " LEGO",
"enName": "lego architecture",
"count": "2",
"weight": "0.4",
"weightUnit": "kg",
"declareValue": "200",
"declareCurrency": "USD",
"origin": "US",
"batteryType": "0",
"ifHazmat": "N",
"ifFluid": "N",
"isCellphone":"N",
"imei":"",
"warehouseNo": "",
"platform": "www.jd.com",
"url": "https://item.jd.com/?cateId=12260&itemId=1130129"
}
]
}
}],
"message":" Success",
"success":true
}

3.2.4 Invoking the API of [Batch Bill Feedback]

【API】
jingdong.isc.magellan.orderListStatus
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill No.
user Service 20 Y
provider
registers JDWL
account
validation Verify Result int Y 0 Failure 1
Success
type Distinguishing int Y 0: Feedback by
Big Packet’s big package. 1:
Feedback from Feedback by small
Small package. Default
Packet’s 0
Feedback
trackingNo Waybill No. 40 N
message Supplementary 255 N
information
【Example of Request】
{
[{
“ddl”: “57140102278”,
“user”:”isvAccount”
“validation”: “0”,
“type”:”0”,
“trackingNo”: “”,
“message”: ” postcodes can't be empty”
},{
“ddl”: “57140102279”,
“user”:”isvAccount”
“validation”: “0”,
“type”:”0”,
“trackingNo”: “”,
“message”: ” The name of the addressee shall not be less than two
characters”
}]
}

3.3 Cancellation of Waybill

3.3.1 Business Description

Because of some business reasons, customer/merchant orders trigger

cancellation operation. After JD logistics platform judges the current status of
orders to allow cancellation, the cancellation of orders is transformed into the
cancellation message of Beijing-East freight orders and sent to service
providers.

3.3.2 Subscribe to [Freight Order Cancellation] Message Service

【Message ID】
batch-cancel-channel

【Message structure】（The outer layer is list）

Field name Meaning Type Whether Notes (examples)
(length) must
ddl The list of 500 Y
Jingdong
waybill
No.
reason 取消原因描 500 N
述

【Example of message】
{
[{
“ddl”: “57140102278”,
“reason”: ” User cancelled”
},{
“ddl”: “57140102279”,
“reason”: ” Error in order information entry”
}]
}
【SDK Download】
It is suggested that logistics business use the SDK provided by JDWL to receive
messages and download links for SDK:

3.4 Feedback waybill number

3.4.1 Business Description

Logistics service providers receive JD's waybill information, if they can't return to
the service providers' waybill number immediately, then after confirming the
waybill number, in subsequent links (e.g. after receiving and weighing), they call
the interface of "feedback waybill number" to feedback the service providers'
waybill number to JD.
3.4.2 Invoking the API of [Batch Bill Feedback]

【API】
jingdong.isc.magellan.createTrackingNumber
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill
No.
trackingNo Service 40 Y
Provider
Transport
Bill No.
user Service 20 Y
provider
registers
JDWL
account

【Example of Request】
{
“ddl”: “57140102278”,
“trackingNo”: “ABC213345454”,
“user”:”isvAccount”
}

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
informatio
n

3.5 Printing Express Sheet

3.5.1 Business Description

 After negotiation between the two sides, if the package uses the last
kilometer form provided by the logistics service provider and needs to be
changed by the EC warehouse operator in Jingdong, then this link needs to be
used.
What time to inform the logistics provider´s warehouse in JD needs to make a
form, if triggered by JD, then the logistics service provider needs to subscribe to
the [printing the express sheet] message, JD triggers the message, the service
provider receives the message, invokes the API of [feedback´s express sheet], and
returns the form file (or stream) to JD; If it is not necessary for JD to notify the
service provider feedback the API of express sheet , then the service provider
should call the API of feedback express sheet and return the express sheet file (or
stream) to JD independently after receiving the information of Beijing-East waybill
and when the express sheet is ready.

3.5.2 Subscribe to [Printing express sheet] messaging

service （ This subscription is not required if the shipper

feeds back the express sheet independently.）

【Message ID】
jd_ept_print_label
【Conditions for message triggering】
JD EC warehouse operator clicks the "Download Form" button to trigger the
jd_ept_print_label message.

【Message structure】
Field name Meaning Type Whether Notes (examples)
(length) must
trackingNo waybill 40 Y
No.
pageSize express int Y
sheet size
fileType file type 5 Y
【Message sample】
{
"trackingNo":"ABF139199231312",
"pageSize":"1 ",
"fileType":"PDF"
}
【SDK Download】
It is suggested that logistics business use the SDK provided by JDWL to receive
messages and download links for SDK:

3.5.3 Invoking the API of [Feedback’s waybill]

【API】
jingdong.isc.magellan.labelFile
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill
No.
trackingNo Service 40 Y
Provider
Transport
Bill No.
user Service 20 Y
provider
registers
JDWL
account
resource File stream base64 Y
type file type 10 Y Currently only PDF
is supported

【Example of Request】
{
“ddl”:”56567832123,
“trackingNo”: “ABC213345454”,
“user”:”isvAccount”,
“resource”:
“iVBORw0KGgoAAAANSUhEUgAAAkAAAAMTCAIAAADGlT+MAAAAAXNSR0I
Ars4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAAEnQAABJ0Ad5mH3gAA
P+lSURBVHhe7H0FYFzH0f97x6hDMTMzWRaZ2THHiR1qkjZUSJu0X/lLv6T9p03
SJg0zGmNmW2wxMzNLp7vTMd+7/5zOdhxbtmVLsiXrbV3nfLdv3+xvZnd2Z2d
nUIvFguAFRwBHAEcARwBHYL4hQJhvBOP04gjgCOAI4AjgCFgRwBUYLgc4AjgC
OAI4AvMSAfR6E2JfX19+fj6NRpuXHcKJxhHAEcARwBGYMwjo9XpPT8/k5OTZo
GgSBVZWVlZTUxMcHGw0GmfjlXibOAI4AjgCOAILAQEURcfHx3U63a5du2ajv5
MosMrKyo6OjrCwMIPBMBuvxNvEEcARwBHAEVgICBAIBFBgEolk27Zts9HfyRVY
e3t7aGgorsBmA3G8TRwBHAEcgQWCgE2BQZklBYY7cSw “,
“type”:”pdf”
}

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
information

3.6 Weight’s Charges

3.6.1 Business Description

Logistics service providers collect parcels and carry out warehousing and
weighing. Invoking [Weight Fee] interface to feed back the package weighing
information to JD.

3.6.2 Invoking the API of [Weight’s Charges]

【API】
jingdong.isc.magellan.weigh
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y/N This must be filled
waybill No. in when type = 1
user Service 20 Y
provider
registers
JDWL
account
type the int Y 0: Feedback by big
dimension package. 1:
of Feedback by small
feedback package. Default 0
trackingNo Service 40 Y
Provider’
s waybill
No.
bigBagId Large 40 Y/N This must be filled
package’ in when type = 0
s number
weight Weight double Y
weightUnit Unit of 3 Y
weight
length length double Y/N This is not required
when type = 0
width width double Y/N This is not required
when type = 0
height height double Y/N This is not required
when type = 0
dimensionUnit Unit of 3 Y/N This is not required
length when type = 0
amount Freight double N
currency Currency 3 N/Y If amount is not
empty, then current
must be filled in
 【Example of Request】
{
“ddl”: “SO4235231111”,
“user”:”isvAccount”,
“type”: “1”,
“trackingNo”: “ABC213345454”,
“bigBagId” : “”,
“weight”: “8.67”,
“weightUnit”: “kg”,
“length”: “12.00”,
“width”: “20.21”,
“height”: “8.09”,
“dimensionUnit”: “cm”,
“amount”: “”,
“currency”: “”
}

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
informatio
n

3.7Waybill’s Tracking

3.7.1 Business Description

When the logistics service provider receives the update status of the
package ， invoking the [Waybill Tracking] Interface ， Feedback to JD for
package’s tracking information。

3.7.2 Invoking the API of[Waybill’s Tracking]

【API】
jingdong.isc.magellan.tracking
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y/N This item must
waybill No. be filled in when
type = 1
user Service 20 Y
provider
 registers JDWL
account
type The dimension int Y 0: Feedback by
of feedback big package. 1:
Feedback by
small package.
Default 0
trackingNo Service 40 Y
Provider’s
waybill No.
exchangeNo Transfer of 40 N
application
forms no.
eventCode Event code 5 Y
eventDescription Event 255 N
description
eventTime Event time 19 Y yyyy-MM-dd HH:
mm:ss
eventTimeZone Time zone of 10 Y
event
occurrence
destCountry Country of 3 N
destination
reasonCode Special Cause 3 N
Code
bigBagId Large 40 Y/N This must be
package’s filled in when
number type = 0
flightNum Flight number 40 N
vesselNum Ship number 40 N
containerNum Container 40 N
number
hawbOrMawb Odd 40 N
number/Maste
r bill number

【Example of Request】
{
“ddl”:”565678743”,
“user”:”isvAccount”,
“type”: “1”,
“trackingNo”: “ABC213345454”,
“exchangeNo”: “”,
“eventCode”: “DP”,
“eventDescription”: “departure from origin port”,
“eventTime”: “2018-03-22 14:33:20”,
“eventTimeZone”: “UTC+8”,
“destCountry”: “CN”,
“reasonCode”: “”,
 “bigBagId”: “”,
“flightNum”: “CA7321”,
“vesselNum”: “BYd1213”,
“containerNum”: “hd321432152”,
“hawbOrMawb”: “31312”
}

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
informatio
n

Pay attention to：eventCode and eventDescription. Please the service provider to

define its internal status ， correspond to the state required by the following
JDs，feedback on it：
Status code English description of Chinese description of status
eventCode status
eventDescription
PK pickup Success in collection and
warehousing
HO hub-out Depart from the CFS
DP departure from origin Depart from the sending country
port
IT line haul in-transit line haul in-transit
AP arrive at destination port Arrive at port of destination
CC customs clearance Customs declaration of destination
country
CR customs released Completion of Customs Clearance
in Destination Country
HL handover to last mile The last kilometer handover is
completed
LW received at local Arrive at terminal warehouse
warehouse
LD local dispatch End Warehouse Sorting
LS local shipped End Warehouse Delivery
AT arrived at delivery Arrive at dispatching station
terminal
OP on process Distributor is dispatching
DL delivered Successful delivery
DF deliver failed Delivery failed
EX have exception Exception occurred

3.8Receive Collecting Tasks

3.8.1 Business Description

Receiving carrier subscribes [Receiving Task Delivery] message service, Once the
export channels of Jingdong have been allocated to receiving carrier, this
subscription message will be posted ， then the receiving carrier will invoke
[Receive Collecting Tasks] to receive the collecting tasks ，and return the result of
receiving task to Jingdong through [receiving task feedback].

3.8.2 Subscribe to[Receive and Issue Tasks] Message Service

【Message ID】
collect_task_channel
【Conditions for message triggering】
Jingdong receives the order information from the order system. When the channel
has the first kilometer to collect, it sends this message.

【Message structure】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill
No.
orderCreateTime Order DateTime N
creatie
time

【Example of message】
【SDK Download】
It is suggested that logistics business receive messages use the SDK provided by
JDWL and download links for SDK:

3.8.3 Invoking the API of [Solicit and Collect Tasks]

【API】
jingdong.isc.magellan.createCollectTask
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill
No.
user Service 20 Y
provider
 registers
JDWL
account
【Example of Request】
{
“ddl”: “57140102278”,
“user”:”isvAccount”
}
【Content of Response】
Field Mus Remarks
t
inpu
t
Message type Y Create/Cancel
Magellan waybill Y
number
Business Parcel Y JD.th POP Order ， Merchant package number= Thailand
Number Qinglong order no.；
JD.id POP Order, Merchant package number = Indonesia
Qinglong order no.；
Whether with Y If this channel can only take ordinary goods, then in this
electric channels field to send ‘N’ to the carrier, others cases send ’Y’.
Package weight N
Unit of package N
weight
Receiving channel Y
coding
Name of sender N Before the POP transformation, the sender's address
company information was taken from the address in Magellanic
Shop ID Y merchant's master data, allowing Chinese addresses.
Sender’s name Y
Sender’s Y
telephone
Sender’s country Y
Sender’s province Y
Sender’s city Y
Sender’s area N
Sender’s street Y
Sender’s Y
postcodes
Warehouse Y Within the system, a receiving address is maintained for
number each EC distribution center, allowing Chinese input.
Recipient’s name Y
Recipient’s Y
telephone
Recipient’s Y
country
Recipient’s Y
province
Recipient’s city Y
Recipient’s area N
Recipient’s street Y
Recipient’s Y
postcode

【Response example】

3.8.4 Invoking the API of [Collect tasks’ feedback]

【API】
jingdong.isc.magellan.orderListStatus
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill No.
user Service 20 Y
provider
registers JDWL
account
validation Verification int Y 0 Failure 1
result Success
message Supplementary 255 N
information
【Example of Request】

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
informatio
n

3.9 Tracking the Collection status

3.9.1 Business Description

When the logistics service provider receives the update status of the
package ， invoking the [Waybill Tracking] Interface ， Feedback to JD for
package’s tracking information。

3.9.2 Invoking the API of [Collection status’ track]

【API】
jingdong.isc.magellan.tracking
【The Parameters of Service Request】
Field name Meaning Type Whether Notes (examples)
(length) must
ddl Jingdong 64 Y
waybill No.
user Service 20 Y
provider
registers
JDWL
account
eventCode Event code 5 Y
eventDescription Event 255 N
descriptio
n
eventTime Time of 19 Y yyyy-MM-dd HH:m
Incident m:ss
eventTimeZone Time zone 10 Y example UTC+08
of event
occurrence
reasonCode Special 3 N
Cause
Code

【Enumerating collection status‘s event code】

Status code English description of Chinese description of status
eventCode status
eventDescription
FMPK First mile pickup Success of Carrier Receiving
Revenue Storage in first mile
FMEX First mile pickup Abnormal Warehouse
exception
FMEC First mile exception Cancel abnormity
cancelled
FMRT First mile package retreat Return the package to the
merchant
FMSP First mile package Package shipment
shipped

【Example of Request】

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
informatio
n

3.10 The Pediction of Collection and delivery

3.10.1 Business Description

Logistics service providers collect parcels and carry out warehousing and
weighing. Invoking the [Weighting charges] interface to feed back the package
weighing information to JD.

3.10.2 Invoking the API of[Collect’s Prediction]

【API】
jingdong.isc.magellan.weigh
【The Parameters of Service Request】
Field Mus Remarks
t
Inpu
t
Shipment batch Y ZY+ warehouse number
number (Header) + yyyyMMdd + 000 + 5-bit serial number
The batch number will not be repeated
To EC Warehouse Y warehouse number
(Header)
Delivery big Y [][YW-JD][DATE][][0000]
package’s
number (Item)
Delivery big Y YW weight, KG, keep three decimal points,
package’s gross accurate to 1g
weight (Item)
Unit of Y KG
weight(Item)
Magellan waybill Y
number(Sub Item)
Merchant package Y JD.th POP Order ， Merchant package
number(Sub Item) number= Thailand Qinglong order no.；
JD.id POP Order, Merchant package number
= Indonesia Qinglong order no.；
Small packet Y YW weight YW must transmit,keep three
weight (Sub Item) decimal points, accurate to 1g
Unit of small Y KG
packet weight
(Sub Item)

【Example of Request】

【Content of Response】
Field name Meaning Type Whether Notes (examples)
(length) must
status state 10 Y SUCCESS
exception abnormal 255 N
informatio
n