开放服务-API列表

热词搜索：

suning.logistics.outerorder.add 外部订单创建接口

￥免费

通过此接口，外部用户传输需要苏宁物流配送的订单至苏宁

公共参数

名称	类型	是否必须	示例值	描述
appMethod	String	Y	suning.custom.category.query	方法名
appRequestTime	String	Y	2012-04-25 20:23:30	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。
format	String	N	XML	默认xml,可指定格式为xml,json
appKey	String	Y	b0c332a133c102765f39de**********	分配给应用的访问令牌
versionNo	String	Y	v1.2	API的版本，目前为v1.2版本
signInfo	String	Y	460d7ff15b073e463125b4**********	appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写)，其中appSecret为appKey对应的密钥
access_token	String	N	a1c5c62b08df3a3cbf7efd**********	采用OAuth授权方式为必填参数

请求参数

名称	类型	是否必须	示例值	描述
oriSys	String	Y	sys123	外部系统。公约的外部系统编号用于唯一识别外部公司的接单系统。字母或数字
orderItem	String	Y	null
orderId	String	Y	12345	订单号。外部公司订单的订单编号，同一个外部系统的订单号唯一。字母或数字
businessType	String	Y	B808	业务类型。用于区分不同的订单类型，如B008－API小件揽件快递业务。字母或数字
shipCondition	String	Y	01	装运条件。01－配送（含网点投件）；06－自提（投件自提点/柜，取件也是自提点/柜）
expressValue	String	N	25.12	快递运费。订单由收件人支付的物流运费（不含增值服务），数值（13，2）
announcedValue	String	N	589.67	货主总价值。订单货物的价值。若“保价标识”不为空，则不可为空。数值（13，2）
valueUnit	String	N	CNY	金额单位。字母或数字。若“货主总价值”或“代收货款方式”有其一不为空，则不可为空。CNY-人民币
insuredValue	String	N	X	保价标识。是否需要保价服务，空－不需要；X－需要，若为需要一般还要提供声明价值，即货主总价值
receiptBillFlag	String	N	X	签回单标识。是否需要签单返还，空－不需要；X－需要
cashonDeliveryType	String	N	02	代收货款方式。02：移动POS支付 03：现金支付
cashonDeliveryValue	String	N	25.8	代收货款金额。数值（13，2）
receiveCheckCode	String	N	123	收货校验码。字母或数字
deliPoint	String	N	01	揽件网点。投件的苏宁网点编码。字母或数字
homeLanFlag	String	N	X	上门揽件标识。是否需要上门取货标识，空－表示不需要，为投件；X－表示需要上门
taxOnbaggage	String	N		国际快递行邮税。国际件对应的行邮税
taxUnit	String	N		税额单位。行邮税对应的金额单位
pickupDate	String	Y	2015-01-01	期望取货日期。格式：yyyy-MM-dd，判断大于等于当前日期
pickupTime	String	Y	08:01:01	期望取货时间。格式：hh:mm:ss
expectDate	String	N	2015-01-01	期望送货日期。格式：yyyy-MM-dd，判断大于等于当前日期，说明：此日期只作为参考，实际送货日期以期望取货日期时间+物流作业必要时间为准
expectTime	String	N	08:01:01	期望送货时间。格式：hh:mm:ss
orderCustomer	String	Y	123456	寄件人/下单客户编码。
priorityGrade	String	N		优先级。特殊等级收件顾客标识
createNumLes	String	Y	abc	前台创建者。订单创建用户标识，如系统名、固定用户标识等。字母或数字，允许特殊符“－._”
createTimeLes	String	Y	08:01:01	前台创建时间。订单创建时间。格式：hh:mm:ss
createDateLes	String	Y	2015-01-01	前台创建日期。订单创建日期。格式：yyyy-MM-dd
crossItems	String	Y	null
orderPartners	String	Y	null
crossItem	String	Y	null
itemNumber	String	Y	20	行项目号。商品子结构-行项目号，数字
expressCode	String	N	123456	物流运单号。预制的快递面单的面单号。字母或数字
crossName	String	N	电扇	物品名称。所寄物品的简短描述
length	String	N	25.4	商品长。物品的长（包装后），数值（13，3）
width	String	N	12.5	商品宽。物品的宽（包装后），数值（13，3）
height	String	N	26.74	商品高。物品的高（包装后），数值（13，3）
lengthUnit	String	N	CM	长度单位。长度单位，默认为CM。字母或数字
volume	String	N	36.855	商品体积。物品的体积（包装后）。数值（13，3）
volumeUnit	String	N	CM3	体积单位。体积单位，一般为CM3。字母或数字
crossWeight	String	N	25.365	商品毛重。物品的毛重（包装后）。数值（13，3）
weightUnit	String	N	KG	重量单位。重量单位，一般为KG。字母或数字
remarks	String	N	备注信息	备注。寄件的其它说明信息。255个汉字或字母或数字或符号文本
relationTaskSys	String	N		关联任务单系统。与此物流订单相关联的任务单系统，用于关联作业
relationTaskId	String	N		关联任务单号。与此物流订单相关联的关联任务单号，用于关联作业
relationTaskItemId	String	N		关联任务单行号。
orderPartner	String	Y	null
itemNumber	String	Y	10	行项目号。订单客户子结构-行项目号，数字
customerType	String	Y	AG	客户类型。AG－寄件人/下单客户；RE－开票方；RG－付款方；WE－收件人
customerId	String	N	111111	客户编号。字母或数字
name	String	Y	张飞	姓名。40个字母或数字或汉字，允许特殊符“－._”，若“客户类型”为“WE”，则不可为空
address1	String	Y	测试地址	详细地址。60个字母或数字或汉字或特殊符文本，若“客户类型”为“WE”或“Z1”，则不可为空
address2	String	N	八段地址	八段地址。120个字母或数字或汉字或特殊符文本
zipCode	String	N	225242	邮编。字母或数字，允许特殊符“－._”
province	String	Y	江苏省	省。20个字母或数字或汉字或特殊符文本
city	String	Y	南京市	城市。20个字母或数字或汉字或特殊符文本
district	String	Y	玄武区	区/县。20个字母或数字或汉字或特殊符文本
town	String	N	仙鹤门街道	乡镇。20个字母或数字或汉字或特殊符文本
region	String	N	025	地区。字母或数字
fixedlineTelephone	String	N	025-66996699	客户的固定电话。20个数字或“-”
mobilePhone	String	N	18651661111	手机号码。11个字母或数字或特殊符文本
email	String	N	test@126.com	客户的电子邮箱。50个字母或数字或汉字或特殊符文本
transportationZone	String	N	001	运输区域。字母或数字
orderItem	String	Y	null
orderId	String	Y	12345	订单号。外部公司订单的订单编号，同一个外部系统的订单号唯一。字母或数字
businessType	String	Y	B808	业务类型。用于区分不同的订单类型，如B008－API小件揽件快递业务。字母或数字
shipCondition	String	Y	01	装运条件。01－配送（含网点投件）；06－自提（投件自提点/柜，取件也是自提点/柜）
expressValue	String	N	25.12	快递运费。订单由收件人支付的物流运费（不含增值服务），数值（13，2）
announcedValue	String	N	589.67	货主总价值。订单货物的价值。若“保价标识”不为空，则不可为空。数值（13，2）
valueUnit	String	N	CNY	金额单位。字母或数字。若“货主总价值”或“代收货款方式”有其一不为空，则不可为空。CNY-人民币
insuredValue	String	N	X	保价标识。是否需要保价服务，空－不需要；X－需要，若为需要一般还要提供声明价值，即货主总价值
receiptBillFlag	String	N	X	签回单标识。是否需要签单返还，空－不需要；X－需要
cashonDeliveryType	String	N	02	代收货款方式。02：移动POS支付 03：现金支付
cashonDeliveryValue	String	N	25.8	代收货款金额。数值（13，2）
receiveCheckCode	String	N	123	收货校验码。字母或数字
deliPoint	String	N	01	揽件网点。投件的苏宁网点编码。字母或数字
homeLanFlag	String	N	X	上门揽件标识。是否需要上门取货标识，空－表示不需要，为投件；X－表示需要上门
taxOnbaggage	String	N		国际快递行邮税。国际件对应的行邮税
taxUnit	String	N		税额单位。行邮税对应的金额单位
pickupDate	String	Y	2015-01-01	期望取货日期。格式：yyyy-MM-dd，判断大于等于当前日期
pickupTime	String	Y	08:01:01	期望取货时间。格式：hh:mm:ss
expectDate	String	N	2015-01-01	期望送货日期。格式：yyyy-MM-dd，判断大于等于当前日期，说明：此日期只作为参考，实际送货日期以期望取货日期时间+物流作业必要时间为准
expectTime	String	N	08:01:01	期望送货时间。格式：hh:mm:ss
orderCustomer	String	Y	123456	寄件人/下单客户编码。
priorityGrade	String	N		优先级。特殊等级收件顾客标识
createNumLes	String	Y	abc	前台创建者。订单创建用户标识，如系统名、固定用户标识等。字母或数字，允许特殊符“－._”
createTimeLes	String	Y	08:01:01	前台创建时间。订单创建时间。格式：hh:mm:ss
createDateLes	String	Y	2015-01-01	前台创建日期。订单创建日期。格式：yyyy-MM-dd
crossItems	String	Y	null
orderPartners	String	Y	null
crossItem	String	Y	null
itemNumber	String	Y	20	行项目号。商品子结构-行项目号，数字
expressCode	String	N	123456	物流运单号。预制的快递面单的面单号。字母或数字
crossName	String	N	电扇	物品名称。所寄物品的简短描述
length	String	N	25.4	商品长。物品的长（包装后），数值（13，3）
width	String	N	12.5	商品宽。物品的宽（包装后），数值（13，3）
height	String	N	26.74	商品高。物品的高（包装后），数值（13，3）
lengthUnit	String	N	CM	长度单位。长度单位，默认为CM。字母或数字
volume	String	N	36.855	商品体积。物品的体积（包装后）。数值（13，3）
volumeUnit	String	N	CM3	体积单位。体积单位，一般为CM3。字母或数字
crossWeight	String	N	25.365	商品毛重。物品的毛重（包装后）。数值（13，3）
weightUnit	String	N	KG	重量单位。重量单位，一般为KG。字母或数字
remarks	String	N	备注信息	备注。寄件的其它说明信息。255个汉字或字母或数字或符号文本
relationTaskSys	String	N		关联任务单系统。与此物流订单相关联的任务单系统，用于关联作业
relationTaskId	String	N		关联任务单号。与此物流订单相关联的关联任务单号，用于关联作业
relationTaskItemId	String	N		关联任务单行号。
orderPartner	String	Y	null
itemNumber	String	Y	10	行项目号。订单客户子结构-行项目号，数字
customerType	String	Y	AG	客户类型。AG－寄件人/下单客户；RE－开票方；RG－付款方；WE－收件人
customerId	String	N	111111	客户编号。字母或数字
name	String	Y	张飞	姓名。40个字母或数字或汉字，允许特殊符“－._”，若“客户类型”为“WE”，则不可为空
address1	String	Y	测试地址	详细地址。60个字母或数字或汉字或特殊符文本，若“客户类型”为“WE”或“Z1”，则不可为空
address2	String	N	八段地址	八段地址。120个字母或数字或汉字或特殊符文本
zipCode	String	N	225242	邮编。字母或数字，允许特殊符“－._”
province	String	Y	江苏省	省。20个字母或数字或汉字或特殊符文本
city	String	Y	南京市	城市。20个字母或数字或汉字或特殊符文本
district	String	Y	玄武区	区/县。20个字母或数字或汉字或特殊符文本
town	String	N	仙鹤门街道	乡镇。20个字母或数字或汉字或特殊符文本
region	String	N	025	地区。字母或数字
fixedlineTelephone	String	N	025-66996699	客户的固定电话。20个数字或“-”
mobilePhone	String	N	18651661111	手机号码。11个字母或数字或特殊符文本
email	String	N	test@126.com	客户的电子邮箱。50个字母或数字或汉字或特殊符文本
transportationZone	String	N	001	运输区域。字母或数字
orderItem	String	Y	null
orderId	String	Y	12345	订单号。外部公司订单的订单编号，同一个外部系统的订单号唯一。字母或数字
businessType	String	Y	B808	业务类型。用于区分不同的订单类型，如B008－API小件揽件快递业务。字母或数字
shipCondition	String	Y	01	装运条件。01－配送（含网点投件）；06－自提（投件自提点/柜，取件也是自提点/柜）
expressValue	String	N	25.12	快递运费。订单由收件人支付的物流运费（不含增值服务），数值（13，2）
announcedValue	String	N	589.67	货主总价值。订单货物的价值。若“保价标识”不为空，则不可为空。数值（13，2）
valueUnit	String	N	CNY	金额单位。字母或数字。若“货主总价值”或“代收货款方式”有其一不为空，则不可为空。CNY-人民币
insuredValue	String	N	X	保价标识。是否需要保价服务，空－不需要；X－需要，若为需要一般还要提供声明价值，即货主总价值
receiptBillFlag	String	N	X	签回单标识。是否需要签单返还，空－不需要；X－需要
cashonDeliveryType	String	N	02	代收货款方式。02：移动POS支付 03：现金支付
cashonDeliveryValue	String	N	25.8	代收货款金额。数值（13，2）
receiveCheckCode	String	N	123	收货校验码。字母或数字
deliPoint	String	N	01	揽件网点。投件的苏宁网点编码。字母或数字
homeLanFlag	String	N	X	上门揽件标识。是否需要上门取货标识，空－表示不需要，为投件；X－表示需要上门
taxOnbaggage	String	N		国际快递行邮税。国际件对应的行邮税
taxUnit	String	N		税额单位。行邮税对应的金额单位
pickupDate	String	Y	2015-01-01	期望取货日期。格式：yyyy-MM-dd，判断大于等于当前日期
pickupTime	String	Y	08:01:01	期望取货时间。格式：hh:mm:ss
expectDate	String	N	2015-01-01	期望送货日期。格式：yyyy-MM-dd，判断大于等于当前日期，说明：此日期只作为参考，实际送货日期以期望取货日期时间+物流作业必要时间为准
expectTime	String	N	08:01:01	期望送货时间。格式：hh:mm:ss
orderCustomer	String	Y	123456	寄件人/下单客户编码。
priorityGrade	String	N		优先级。特殊等级收件顾客标识
createNumLes	String	Y	abc	前台创建者。订单创建用户标识，如系统名、固定用户标识等。字母或数字，允许特殊符“－._”
createTimeLes	String	Y	08:01:01	前台创建时间。订单创建时间。格式：hh:mm:ss
createDateLes	String	Y	2015-01-01	前台创建日期。订单创建日期。格式：yyyy-MM-dd
crossItems	String	Y	null
orderPartners	String	Y	null
crossItem	String	Y	null
itemNumber	String	Y	20	行项目号。商品子结构-行项目号，数字
expressCode	String	N	123456	物流运单号。预制的快递面单的面单号。字母或数字
crossName	String	N	电扇	物品名称。所寄物品的简短描述
length	String	N	25.4	商品长。物品的长（包装后），数值（13，3）
width	String	N	12.5	商品宽。物品的宽（包装后），数值（13，3）
height	String	N	26.74	商品高。物品的高（包装后），数值（13，3）
lengthUnit	String	N	CM	长度单位。长度单位，默认为CM。字母或数字
volume	String	N	36.855	商品体积。物品的体积（包装后）。数值（13，3）
volumeUnit	String	N	CM3	体积单位。体积单位，一般为CM3。字母或数字
crossWeight	String	N	25.365	商品毛重。物品的毛重（包装后）。数值（13，3）
weightUnit	String	N	KG	重量单位。重量单位，一般为KG。字母或数字
remarks	String	N	备注信息	备注。寄件的其它说明信息。255个汉字或字母或数字或符号文本
relationTaskSys	String	N		关联任务单系统。与此物流订单相关联的任务单系统，用于关联作业
relationTaskId	String	N		关联任务单号。与此物流订单相关联的关联任务单号，用于关联作业
relationTaskItemId	String	N		关联任务单行号。
orderPartner	String	Y	null
itemNumber	String	Y	10	行项目号。订单客户子结构-行项目号，数字
customerType	String	Y	AG	客户类型。AG－寄件人/下单客户；RE－开票方；RG－付款方；WE－收件人
customerId	String	N	111111	客户编号。字母或数字
name	String	Y	张飞	姓名。40个字母或数字或汉字，允许特殊符“－._”，若“客户类型”为“WE”，则不可为空
address1	String	Y	测试地址	详细地址。60个字母或数字或汉字或特殊符文本，若“客户类型”为“WE”或“Z1”，则不可为空
address2	String	N	八段地址	八段地址。120个字母或数字或汉字或特殊符文本
zipCode	String	N	225242	邮编。字母或数字，允许特殊符“－._”
province	String	Y	江苏省	省。20个字母或数字或汉字或特殊符文本
city	String	Y	南京市	城市。20个字母或数字或汉字或特殊符文本
district	String	Y	玄武区	区/县。20个字母或数字或汉字或特殊符文本
town	String	N	仙鹤门街道	乡镇。20个字母或数字或汉字或特殊符文本
region	String	N	025	地区。字母或数字
fixedlineTelephone	String	N	025-66996699	客户的固定电话。20个数字或“-”
mobilePhone	String	N	18651661111	手机号码。11个字母或数字或特殊符文本
email	String	N	test@126.com	客户的电子邮箱。50个字母或数字或汉字或特殊符文本
transportationZone	String	N	001	运输区域。字母或数字
orderItem	String	Y	null
orderId	String	Y	12345	订单号。外部公司订单的订单编号，同一个外部系统的订单号唯一。字母或数字
businessType	String	Y	B808	业务类型。用于区分不同的订单类型，如B008－API小件揽件快递业务。字母或数字
shipCondition	String	Y	01	装运条件。01－配送（含网点投件）；06－自提（投件自提点/柜，取件也是自提点/柜）
expressValue	String	N	25.12	快递运费。订单由收件人支付的物流运费（不含增值服务），数值（13，2）
announcedValue	String	N	589.67	货主总价值。订单货物的价值。若“保价标识”不为空，则不可为空。数值（13，2）
valueUnit	String	N	CNY	金额单位。字母或数字。若“货主总价值”或“代收货款方式”有其一不为空，则不可为空。CNY-人民币
insuredValue	String	N	X	保价标识。是否需要保价服务，空－不需要；X－需要，若为需要一般还要提供声明价值，即货主总价值
receiptBillFlag	String	N	X	签回单标识。是否需要签单返还，空－不需要；X－需要
cashonDeliveryType	String	N	02	代收货款方式。02：移动POS支付 03：现金支付
cashonDeliveryValue	String	N	25.8	代收货款金额。数值（13，2）
receiveCheckCode	String	N	123	收货校验码。字母或数字
deliPoint	String	N	01	揽件网点。投件的苏宁网点编码。字母或数字
homeLanFlag	String	N	X	上门揽件标识。是否需要上门取货标识，空－表示不需要，为投件；X－表示需要上门
taxOnbaggage	String	N		国际快递行邮税。国际件对应的行邮税
taxUnit	String	N		税额单位。行邮税对应的金额单位
pickupDate	String	Y	2015-01-01	期望取货日期。格式：yyyy-MM-dd，判断大于等于当前日期
pickupTime	String	Y	08:01:01	期望取货时间。格式：hh:mm:ss
expectDate	String	N	2015-01-01	期望送货日期。格式：yyyy-MM-dd，判断大于等于当前日期，说明：此日期只作为参考，实际送货日期以期望取货日期时间+物流作业必要时间为准
expectTime	String	N	08:01:01	期望送货时间。格式：hh:mm:ss
orderCustomer	String	Y	123456	寄件人/下单客户编码。
priorityGrade	String	N		优先级。特殊等级收件顾客标识
createNumLes	String	Y	abc	前台创建者。订单创建用户标识，如系统名、固定用户标识等。字母或数字，允许特殊符“－._”
createTimeLes	String	Y	08:01:01	前台创建时间。订单创建时间。格式：hh:mm:ss
createDateLes	String	Y	2015-01-01	前台创建日期。订单创建日期。格式：yyyy-MM-dd
crossItems	String	Y	null
orderPartners	String	Y	null
crossItem	String	Y	null
itemNumber	String	Y	20	行项目号。商品子结构-行项目号，数字
expressCode	String	N	123456	物流运单号。预制的快递面单的面单号。字母或数字
crossName	String	N	电扇	物品名称。所寄物品的简短描述
length	String	N	25.4	商品长。物品的长（包装后），数值（13，3）
width	String	N	12.5	商品宽。物品的宽（包装后），数值（13，3）
height	String	N	26.74	商品高。物品的高（包装后），数值（13，3）
lengthUnit	String	N	CM	长度单位。长度单位，默认为CM。字母或数字
volume	String	N	36.855	商品体积。物品的体积（包装后）。数值（13，3）
volumeUnit	String	N	CM3	体积单位。体积单位，一般为CM3。字母或数字
crossWeight	String	N	25.365	商品毛重。物品的毛重（包装后）。数值（13，3）
weightUnit	String	N	KG	重量单位。重量单位，一般为KG。字母或数字
remarks	String	N	备注信息	备注。寄件的其它说明信息。255个汉字或字母或数字或符号文本
relationTaskSys	String	N		关联任务单系统。与此物流订单相关联的任务单系统，用于关联作业
relationTaskId	String	N		关联任务单号。与此物流订单相关联的关联任务单号，用于关联作业
relationTaskItemId	String	N		关联任务单行号。
orderPartner	String	Y	null
itemNumber	String	Y	10	行项目号。订单客户子结构-行项目号，数字
customerType	String	Y	AG	客户类型。AG－寄件人/下单客户；RE－开票方；RG－付款方；WE－收件人
customerId	String	N	111111	客户编号。字母或数字
name	String	Y	张飞	姓名。40个字母或数字或汉字，允许特殊符“－._”，若“客户类型”为“WE”，则不可为空
address1	String	Y	测试地址	详细地址。60个字母或数字或汉字或特殊符文本，若“客户类型”为“WE”或“Z1”，则不可为空
address2	String	N	八段地址	八段地址。120个字母或数字或汉字或特殊符文本
zipCode	String	N	225242	邮编。字母或数字，允许特殊符“－._”
province	String	Y	江苏省	省。20个字母或数字或汉字或特殊符文本
city	String	Y	南京市	城市。20个字母或数字或汉字或特殊符文本
district	String	Y	玄武区	区/县。20个字母或数字或汉字或特殊符文本
town	String	N	仙鹤门街道	乡镇。20个字母或数字或汉字或特殊符文本
region	String	N	025	地区。字母或数字
fixedlineTelephone	String	N	025-66996699	客户的固定电话。20个数字或“-”
mobilePhone	String	N	18651661111	手机号码。11个字母或数字或特殊符文本
email	String	N	test@126.com	客户的电子邮箱。50个字母或数字或汉字或特殊符文本
transportationZone	String	N	001	运输区域。字母或数字
orderItem	String	Y	null
orderId	String	Y	12345	订单号。外部公司订单的订单编号，同一个外部系统的订单号唯一。字母或数字
businessType	String	Y	B808	业务类型。用于区分不同的订单类型，如B008－API小件揽件快递业务。字母或数字
shipCondition	String	Y	01	装运条件。01－配送（含网点投件）；06－自提（投件自提点/柜，取件也是自提点/柜）
expressValue	String	N	25.12	快递运费。订单由收件人支付的物流运费（不含增值服务），数值（13，2）
announcedValue	String	N	589.67	货主总价值。订单货物的价值。若“保价标识”不为空，则不可为空。数值（13，2）
valueUnit	String	N	CNY	金额单位。字母或数字。若“货主总价值”或“代收货款方式”有其一不为空，则不可为空。CNY-人民币
insuredValue	String	N	X	保价标识。是否需要保价服务，空－不需要；X－需要，若为需要一般还要提供声明价值，即货主总价值
receiptBillFlag	String	N	X	签回单标识。是否需要签单返还，空－不需要；X－需要
cashonDeliveryType	String	N	02	代收货款方式。02：移动POS支付 03：现金支付
cashonDeliveryValue	String	N	25.8	代收货款金额。数值（13，2）
receiveCheckCode	String	N	123	收货校验码。字母或数字
deliPoint	String	N	01	揽件网点。投件的苏宁网点编码。字母或数字
homeLanFlag	String	N	X	上门揽件标识。是否需要上门取货标识，空－表示不需要，为投件；X－表示需要上门
taxOnbaggage	String	N		国际快递行邮税。国际件对应的行邮税
taxUnit	String	N		税额单位。行邮税对应的金额单位
pickupDate	String	Y	2015-01-01	期望取货日期。格式：yyyy-MM-dd，判断大于等于当前日期
pickupTime	String	Y	08:01:01	期望取货时间。格式：hh:mm:ss
expectDate	String	N	2015-01-01	期望送货日期。格式：yyyy-MM-dd，判断大于等于当前日期，说明：此日期只作为参考，实际送货日期以期望取货日期时间+物流作业必要时间为准
expectTime	String	N	08:01:01	期望送货时间。格式：hh:mm:ss
orderCustomer	String	Y	123456	寄件人/下单客户编码。
priorityGrade	String	N		优先级。特殊等级收件顾客标识
createNumLes	String	Y	abc	前台创建者。订单创建用户标识，如系统名、固定用户标识等。字母或数字，允许特殊符“－._”
createTimeLes	String	Y	08:01:01	前台创建时间。订单创建时间。格式：hh:mm:ss
createDateLes	String	Y	2015-01-01	前台创建日期。订单创建日期。格式：yyyy-MM-dd
crossItems	String	Y	null
orderPartners	String	Y	null
crossItem	String	Y	null
itemNumber	String	Y	20	行项目号。商品子结构-行项目号，数字
expressCode	String	N	123456	物流运单号。预制的快递面单的面单号。字母或数字
crossName	String	N	电扇	物品名称。所寄物品的简短描述
length	String	N	25.4	商品长。物品的长（包装后），数值（13，3）
width	String	N	12.5	商品宽。物品的宽（包装后），数值（13，3）
height	String	N	26.74	商品高。物品的高（包装后），数值（13，3）
lengthUnit	String	N	CM	长度单位。长度单位，默认为CM。字母或数字
volume	String	N	36.855	商品体积。物品的体积（包装后）。数值（13，3）
volumeUnit	String	N	CM3	体积单位。体积单位，一般为CM3。字母或数字
crossWeight	String	N	25.365	商品毛重。物品的毛重（包装后）。数值（13，3）
weightUnit	String	N	KG	重量单位。重量单位，一般为KG。字母或数字
remarks	String	N	备注信息	备注。寄件的其它说明信息。255个汉字或字母或数字或符号文本
relationTaskSys	String	N		关联任务单系统。与此物流订单相关联的任务单系统，用于关联作业
relationTaskId	String	N		关联任务单号。与此物流订单相关联的关联任务单号，用于关联作业
relationTaskItemId	String	N		关联任务单行号。
orderPartner	String	Y	null
itemNumber	String	Y	10	行项目号。订单客户子结构-行项目号，数字
customerType	String	Y	AG	客户类型。AG－寄件人/下单客户；RE－开票方；RG－付款方；WE－收件人
customerId	String	N	111111	客户编号。字母或数字
name	String	Y	张飞	姓名。40个字母或数字或汉字，允许特殊符“－._”，若“客户类型”为“WE”，则不可为空
address1	String	Y	测试地址	详细地址。60个字母或数字或汉字或特殊符文本，若“客户类型”为“WE”或“Z1”，则不可为空
address2	String	N	八段地址	八段地址。120个字母或数字或汉字或特殊符文本
zipCode	String	N	225242	邮编。字母或数字，允许特殊符“－._”
province	String	Y	江苏省	省。20个字母或数字或汉字或特殊符文本
city	String	Y	南京市	城市。20个字母或数字或汉字或特殊符文本
district	String	Y	玄武区	区/县。20个字母或数字或汉字或特殊符文本
town	String	N	仙鹤门街道	乡镇。20个字母或数字或汉字或特殊符文本
region	String	N	025	地区。字母或数字
fixedlineTelephone	String	N	025-66996699	客户的固定电话。20个数字或“-”
mobilePhone	String	N	18651661111	手机号码。11个字母或数字或特殊符文本
email	String	N	test@126.com	客户的电子邮箱。50个字母或数字或汉字或特殊符文本
transportationZone	String	N	001	运输区域。字母或数字
orderItem	String	Y	null
orderId	String	Y	12345	订单号。外部公司订单的订单编号，同一个外部系统的订单号唯一。字母或数字
businessType	String	Y	B808	业务类型。用于区分不同的订单类型，如B008－API小件揽件快递业务。字母或数字
shipCondition	String	Y	01	装运条件。01－配送（含网点投件）；06－自提（投件自提点/柜，取件也是自提点/柜）
expressValue	String	N	25.12	快递运费。订单由收件人支付的物流运费（不含增值服务），数值（13，2）
announcedValue	String	N	589.67	货主总价值。订单货物的价值。若“保价标识”不为空，则不可为空。数值（13，2）
valueUnit	String	N	CNY	金额单位。字母或数字。若“货主总价值”或“代收货款方式”有其一不为空，则不可为空。CNY-人民币
insuredValue	String	N	X	保价标识。是否需要保价服务，空－不需要；X－需要，若为需要一般还要提供声明价值，即货主总价值
receiptBillFlag	String	N	X	签回单标识。是否需要签单返还，空－不需要；X－需要
cashonDeliveryType	String	N	02	代收货款方式。02：移动POS支付 03：现金支付
cashonDeliveryValue	String	N	25.8	代收货款金额。数值（13，2）
receiveCheckCode	String	N	123	收货校验码。字母或数字
deliPoint	String	N	01	揽件网点。投件的苏宁网点编码。字母或数字
homeLanFlag	String	N	X	上门揽件标识。是否需要上门取货标识，空－表示不需要，为投件；X－表示需要上门
taxOnbaggage	String	N		国际快递行邮税。国际件对应的行邮税
taxUnit	String	N		税额单位。行邮税对应的金额单位
pickupDate	String	Y	2015-01-01	期望取货日期。格式：yyyy-MM-dd，判断大于等于当前日期
pickupTime	String	Y	08:01:01	期望取货时间。格式：hh:mm:ss
expectDate	String	N	2015-01-01	期望送货日期。格式：yyyy-MM-dd，判断大于等于当前日期，说明：此日期只作为参考，实际送货日期以期望取货日期时间+物流作业必要时间为准
expectTime	String	N	08:01:01	期望送货时间。格式：hh:mm:ss
orderCustomer	String	Y	123456	寄件人/下单客户编码。
priorityGrade	String	N		优先级。特殊等级收件顾客标识
createNumLes	String	Y	abc	前台创建者。订单创建用户标识，如系统名、固定用户标识等。字母或数字，允许特殊符“－._”
createTimeLes	String	Y	08:01:01	前台创建时间。订单创建时间。格式：hh:mm:ss
createDateLes	String	Y	2015-01-01	前台创建日期。订单创建日期。格式：yyyy-MM-dd
crossItems	String	Y	null
orderPartners	String	Y	null
crossItem	String	Y	null
itemNumber	String	Y	20	行项目号。商品子结构-行项目号，数字
expressCode	String	N	123456	物流运单号。预制的快递面单的面单号。字母或数字
crossName	String	N	电扇	物品名称。所寄物品的简短描述
length	String	N	25.4	商品长。物品的长（包装后），数值（13，3）
width	String	N	12.5	商品宽。物品的宽（包装后），数值（13，3）
height	String	N	26.74	商品高。物品的高（包装后），数值（13，3）
lengthUnit	String	N	CM	长度单位。长度单位，默认为CM。字母或数字
volume	String	N	36.855	商品体积。物品的体积（包装后）。数值（13，3）
volumeUnit	String	N	CM3	体积单位。体积单位，一般为CM3。字母或数字
crossWeight	String	N	25.365	商品毛重。物品的毛重（包装后）。数值（13，3）
weightUnit	String	N	KG	重量单位。重量单位，一般为KG。字母或数字
remarks	String	N	备注信息	备注。寄件的其它说明信息。255个汉字或字母或数字或符号文本
relationTaskSys	String	N		关联任务单系统。与此物流订单相关联的任务单系统，用于关联作业
relationTaskId	String	N		关联任务单号。与此物流订单相关联的关联任务单号，用于关联作业
relationTaskItemId	String	N		关联任务单行号。
orderPartner	String	Y	null
itemNumber	String	Y	10	行项目号。订单客户子结构-行项目号，数字
customerType	String	Y	AG	客户类型。AG－寄件人/下单客户；RE－开票方；RG－付款方；WE－收件人
customerId	String	N	111111	客户编号。字母或数字
name	String	Y	张飞	姓名。40个字母或数字或汉字，允许特殊符“－._”，若“客户类型”为“WE”，则不可为空
address1	String	Y	测试地址	详细地址。60个字母或数字或汉字或特殊符文本，若“客户类型”为“WE”或“Z1”，则不可为空
address2	String	N	八段地址	八段地址。120个字母或数字或汉字或特殊符文本
zipCode	String	N	225242	邮编。字母或数字，允许特殊符“－._”
province	String	Y	江苏省	省。20个字母或数字或汉字或特殊符文本
city	String	Y	南京市	城市。20个字母或数字或汉字或特殊符文本
district	String	Y	玄武区	区/县。20个字母或数字或汉字或特殊符文本
town	String	N	仙鹤门街道	乡镇。20个字母或数字或汉字或特殊符文本
region	String	N	025	地区。字母或数字
fixedlineTelephone	String	N	025-66996699	客户的固定电话。20个数字或“-”
mobilePhone	String	N	18651661111	手机号码。11个字母或数字或特殊符文本
email	String	N	test@126.com	客户的电子邮箱。50个字母或数字或汉字或特殊符文本
transportationZone	String	N	001	运输区域。字母或数字

响应参数

名称	类型	示例值	描述
oriSys	String	null	外部系统。
orderBackItem	String	null
orderId	String		外部订单号。
logisticsOrderId	String		物流订单号。(returnCode=S时必填)
returnCode	String	S	返回标识。S：成功 F：失败
errorCode	String		报错码。API异常码(returnCode=F时必填)
orderBackItem	String	null
orderId	String		外部订单号。
logisticsOrderId	String		物流订单号。(returnCode=S时必填)
returnCode	String	S	返回标识。S：成功 F：失败
errorCode	String		报错码。API异常码(returnCode=F时必填)

请求示例

XML示例
JSON示例

复制全部代码

                                <sn_request>
	<sn_body>
		<addOuterOrder>
			<oriSys>ZZD</oriSys>
			<orderItems>
				<orderItem>
					<orderId>1004232622100105</orderId>
					<businessType>B008</businessType>
					<shipCondition>01</shipCondition>
					<expressValue>25.12</expressValue>
					<announcedValue>589.67</announcedValue>
					<valueUnit>CNY</valueUnit>
					<insuredValue>X</insuredValue>
					<receiptBillFlag>X</receiptBillFlag>
					<cashonDeliveryType>02</cashonDeliveryType>
					<cashonDeliveryValue>25.8</cashonDeliveryValue>
					<receiveCheckCode>123</receiveCheckCode>
					<deliPoint>01</deliPoint>
					<homeLanFlag>X</homeLanFlag>
					<pickupDate>2015-08-04</pickupDate>
					<pickupTime>23:22:22</pickupTime>
					<expectDate>2015-08-10</expectDate>
					<expectTime>23:00:00</expectTime>
					<createNumLes>admin</createNumLes>
					<createTimeLes>12:02:23</createTimeLes>
					<createDateLes>2014-02-23</createDateLes>
					<orderCustomer>0010000011</orderCustomer>
					<crossItems>
						<crossItem>
							<itemNumber>10</itemNumber>
							<expressCode>123456</expressCode>
							<crossName>aa</crossName>
							<length>25.4</length>
							<width>12.5</width>
							<height>26.74</height>
							<lengthUnit>CM</lengthUnit>
							<volume>136.78</volume>
							<volumeUnit>CM3</volumeUnit>
							<crossWeight>1.726</crossWeight>
							<weightUnit>KG</weightUnit>
							<remarks>重要物品,请轻拿轻放</remarks>
						</crossItem>
						<crossItem>
							<itemNumber>10</itemNumber>
							<expressCode>123456</expressCode>
							<crossName>aa</crossName>
							<length>25.4</length>
							<width>12.5</width>
							<height>26.74</height>
							<lengthUnit>CM</lengthUnit>
							<volume>136.78</volume>
							<volumeUnit>CM3</volumeUnit>
							<crossWeight>1.726</crossWeight>
							<weightUnit>KG</weightUnit>
							<remarks>重要物品,请轻拿轻放</remarks>
						</crossItem>
					</crossItems>
					<orderPartners>
						<orderPartner>
							<itemNumber>20</itemNumber>
							<customerType>AG</customerType>
							<customerId>0010000016</customerId>
							<name>zhagnshan</name>
							<address1>仙鹤门</address1>
							<address2>测试地址</address2>
							<zipCode>215247</zipCode>
							<province>江苏省</province>
							<city>南京市</city>
							<district>玄武区</district>
							<town>仙鹤门街道</town>
							<region>025</region>
							<fixedlineTelephone>025-66996699</fixedlineTelephone>
							<mobilePhone>13412345670</mobilePhone>
							<email>test@126.com</email>
							<transportationZone>001</transportationZone>
						</orderPartner>
						<orderPartner>
							<itemNumber>20</itemNumber>
							<customerType>WE</customerType>
							<customerId>0010000016</customerId>
							<name>zhagnshan</name>
							<address1>仙鹤门</address1>
							<address2>测试地址</address2>
							<zipCode>215247</zipCode>
							<province>江苏省</province>
							<city>南京市</city>
							<district>玄武区</district>
							<town>仙鹤门街道</town>
							<region>025</region>
							<fixedlineTelephone>025-66996699</fixedlineTelephone>
							<mobilePhone>13412345670</mobilePhone>
							<email>test@126.com</email>
							<transportationZone>001</transportationZone>
						</orderPartner>
					</orderPartners>
				</orderItem>
			</orderItems>
		</addOuterOrder>
	</sn_body>
</sn_request>

                                {
  "sn_request": {
    "sn_body": {
      "addOuterOrder": {
        "oriSys": "ZZD",
        "orderItems": {
          "orderItem": {
            "orderId": "1004232622100105",
            "businessType": "B008",
            "shipCondition": "01",
            "expressValue": "25.12",
            "announcedValue": "589.67",
            "valueUnit": "CNY",
            "insuredValue": "X",
            "receiptBillFlag": "X",
            "cashonDeliveryType": "02",
            "cashonDeliveryValue": "25.8",
            "receiveCheckCode": "123",
            "deliPoint": "01",
            "homeLanFlag": "X",
            "pickupDate": "2015-08-04",
            "pickupTime": "23:22:22",
            "expectDate": "2015-08-10",
            "expectTime": "23:00:00",
            "createNumLes": "admin",
            "createTimeLes": "12:02:23",
            "createDateLes": "2014-02-23",
            "orderCustomer": "0010000011",
            "crossItems": {
              "crossItem": [
                {
                  "itemNumber": "11",
                  "expressCode": "123456",
                  "crossName": "aa",
                  "length": "25.4",
                  "width": "12.5",
                  "height": "26.74",
                  "lengthUnit": "CM",
                  "volume": "136.78",
                  "volumeUnit": "CM3",
                  "crossWeight": "1.726",
                  "weightUnit": "KG",
                  "remarks": "重要物品,请轻拿轻放"
                },
                {
                  "itemNumber": "10",
                  "expressCode": "123456",
                  "crossName": "bb",
                  "length": "25.4",
                  "width": "12.5",
                  "height": "26.74",
                  "lengthUnit": "CM",
                  "volume": "136.78",
                  "volumeUnit": "CM3",
                  "crossWeight": "1.726",
                  "weightUnit": "KG",
                  "remarks": "重要物品,请轻拿轻放"
                }
              ]
            },
            "orderPartners": {
              "orderPartner": [
                {
                  "itemNumber": "20",
                  "customerType": "AG",
                  "customerId": "0010000016",
                  "name": "zhagnshan",
                  "address1": "仙鹤门",
                  "address2": "测试地址",
                  "zipCode": "215247",
                  "province": "江苏省",
                  "city": "南京市",
                  "district": "玄武区",
                  "town": "仙鹤门街道",
                  "region": "025",
                  "fixedlineTelephone": "025-66996699",
                  "mobilePhone": "13412345670",
                  "email": "test@126.com",
                  "transportationZone": "001"
                },
                {
                  "itemNumber": "20",
                  "customerType": "WE",
                  "customerId": "0010000016",
                  "name": "zhagnshan",
                  "address1": "仙鹤门",
                  "address2": "测试地址",
                  "zipCode": "215247",
                  "province": "江苏省",
                  "city": "南京市",
                  "district": "玄武区",
                  "town": "仙鹤门街道",
                  "region": "025",
                  "fixedlineTelephone": "025-66996699",
                  "mobilePhone": "13412345670",
                  "email": "test@126.com",
                  "transportationZone": "001"
                }
              ]
            }
          }
        }
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              <sn_responseContent>
	<sn_body>
		<addOuterOrder>
			<oriSys>ZZD</oriSys>
			<orderItems>
				<orderBackItem>
          			<orderId>1004232622100105</orderId>
          			<logisticsOrderId>1015150141044</logisticsOrderId>
          			<returnCode>S</returnCode>
					<errorCode></errorCode>
        		</orderBackItem>
			</orderItems>
		</addOuterOrder>
	</sn_body>
	<sn_head/>
</sn_responseContent>

                              {
  "sn_responseContent": {
    "sn_body": {
      "addOuterOrder": {
        "oriSys": "ZZD",
        "orderItems": {
          "orderBackItem": {
            "orderId": "1004232622100105",
            "logisticsOrderId": "1015150141044",
            "returnCode": "S",
			"errorCode": ""
          }
        }
      }
    },
	"sn_head": {
	}
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}

业务异常码

异常码	错误描述	解决方案
biz.logistics.addouterorder.missing-parameter:*	请求参数为空。必填，*用某业务字段名替换	请输入正确参数。
biz.logistics.addouterorder.*:value-inexistence	请求参数值不存在。*用某业务字段名（小写）替换	请输入正确参数。
biz.logistics.addouterorder.*:format-error	请求参数格式错误。*用某业务字段名（小写）替换	请输入正确参数。
biz.logistics.addouterorder.*:outofrange	请求参数值不在指定范围内。比如值域范围[0-x]，*用某业务字段名（小写）替换	请输入正确参数。
biz.logistics.addouterorder.*:length-overlong	请求参数值超过指定长度。*用某业务字段名（小写）替换	请输入正确参数。
biz.logistics.addouterorder.*:enumeration-error	枚举值错误(值选择)，只能输入某些特定值。*用某业务字段名（小写）替换	请输入正确参数。
biz.logistics.addouterorder.*:value-existence	重复校验，值已存在。*用某业务字段名（小写）替换	请输入正确参数。
isp.sys.service.unavailable.lps	服务不可用（系统异常）	请联系苏宁技术人员。
biz.logistics.addouterorder.invalid-biz:100	根据地址无法获取到运输区编码，请检查寄件人或收件人地址	请输入正确参数。
biz.logistics.addouterorder.invalid-biz:102	配送范围不可送达	请输入正确参数。
biz.logistics.addouterorder.invalid-biz:103	无法满足上门取货日期时间要求，请重新确认后下单	请输入正确参数。
biz.logistics.addouterorder.invalid-biz:104	客户编码不是有效的编码	请输入正确参数。

公共异常码

异常码	错误描述	解决方案
sys.check.user-permission:inexistence	访问令牌不存在	更换访问令牌
sys.check.user-permission:overdue	访问令牌已过期	请使用刷新令牌刷新
sys.check.api-permission:inexistence	Api方法不存在	请参考帮助中心
sys.check.api-permission:overdue	Api方法已过期	请参考帮助中心
sys.check.method-permission:authority	无权操作此api	确认是否有访问该方法权限
sys.auth.vendor-request:errory	无权操作此供应商	请确认供应商编码是否正确
sys.controller.api-request:limit	Api请求受控	超过请求次数
sys.check.app-time:error	请求参数错误api请求时间误差大	参考帮助中心
sys.check.request-params:error	请求报文结构错误	参考帮助中心、日期格式等
sys.check.starttime-format:error	请求开始时间错误	参考帮助中心、日期格式等
biz.handler.data-get:success	业务数据查询成功	无
biz.handler.data-get:fail	业务数据查询失败	检查请求条件
biz.handler.data-get:no-result	业务数据结果为空	无
sys.check.pageno-format:error	pageNo格式错误，只允许1到99999之间的整数	检查pageNo输入是否有误
sys.check.pagesize-format:error	pageSize格式错误，只允许1到50之间的整数(订单相关是1到100)	检查pageSize输入是否有误
sys.check.page-param:error	pageNo或者pageSize不在要求范围内，pageNo只允许1到99999之间的整数，pageSize只允许1到50之间的整数(订单相关是1到100)	检查pageNo和pageSize输入是否有误
sys.check.miss-time:starttime	不存在开始时间(节点)	检查输入
sys.check.miss-time:endtime	不存在结束时间(节点)	检查输入
sys.check.starttime-value:null	开始时间为空(值)	检查输入
sys.check.endtime-value:null	结束时间为空(值)	检查输入
sys.check.starttime-format:error	校验开始时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.endtime-format:error	校验结束时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.query-time:error	开始时间是否小于结束时间	检查开始和结束时间大小
sys.check.query-time:outofrange	时间查询是否超出指定范围	检查时间范围
sys.check.app-sign:null	签名信息为空	检查签名信息
sys.check.app-sign:error	签名信息错误	检查签名信息
sys.check.missing-parameter:apiversion	API版本号未指定	检查API版本号
sys.check.missing-parameter:appRequestTime	请求时间丢失	检查请求时间
sys.check.missing-nestElement:sn_body	缺少sn_body节点	检查sn_body是否存在
sys.check.user-permission:inexistence	用户key不存在	检查用户key是否存在
biz.handler.batch-handler:no-support	非查询类API不支持批量操作	检查API类型
biz.handler.request-message:error	查询类API输入多个业务节点	检查业务节点
sys.check.header-param:null	header参数为空	请检查header参数
sys.controller.api-access:limit	访问限制	无
sys.controller.api-frequency:limit	访问频率限制	无
sys.error.network:failure	网络异常	无
sys.error.network-status:?	响应失败 ?为状态码	无
sys.check.snunionid.length.is.not:48	混淆会员编码长度不是48位	使用转换器转换混淆会员编码规定要求混淆会员编码48位

API工具

API TOOLS 在线测试工具异常码查询工具 SDK调用示例 SDK下载

FAQ

Q：外部订单创建接口接口如何使用？

A：通过此接口可外部订单创建接口

物流业务