华南通用下单对接文档


1-下订单接口

下订单接口-速运类API

EXP_RECE_CREATE_ORDER

1. 功能描述
  • 下订单接口根据客户需要,可提供以下五个功能:

    ● 客户系统向顺丰下发订单。

    ● 为订单分配运单号。

    ● 筛单。

    ● 云打印面单推送(必选)。 提供给用户自主打单的服务,打印好的面单会直接推送到用户配置的地址

    ● 路由轨迹(可选)

2. 接口定义
2.1. 公共参数
名称
接口服务代码 EXP_RECE_CREATE_ORDER
生产环境地址 https://sz-mix.sf-express.com/backend/std/service/{hnCustomerCode} 生产{hnCustomerCode}请向大客获取。
沙箱环境地址 https://sz-mix.sit.sf-express.com/backend/std/service/{hnCustomerCode} 测试{hnCustomerCode}统一为11aeea6bdd7fbae1
批量交易 不支持
接口类型 接入
报文类型 JSON
2.2. 公共请求参数
序号 参数列表 类型 是否必传 含义
1 已作废 String(64)
2 requestID String(40) 请求唯一号UUID
3 serviceCode String(50) 接口服务代码
4 timestamp long 调用接口时间戳
5 已作废 String(128) 条件
6 已作废 String 条件
7 msgData String 业务数据报文
2.3. 请求参数\
2.3.1 元素 Order
序号 属性名 类型(约束) 必填 默认值 描述
1 language String(10) 响应报文的语言, 缺省值为zh-CN, 目前支持以下值zh-CN 表示中文简体, zh-TW或zh-HK或 zh-MO表示中文繁体, en表示英文
2 orderId String(64) 客户订单号,不能重复
3 waybillNoInfoList List 顺丰运单号
4 customsInfo CustomsInfo 报关信息
5 cargoDetails List 托寄物信息
6 cargoDesc String(20) 拖寄物类型描述,如: 文件,电子产品,衣服等
7 extraInfoList List 扩展属性
8 serviceList List 增值服务信息,支持附录: 《增值服务产品表》
9 contactInfoList List 收寄双方信息
10 monthlyCard String(20) 条件 顺丰月结卡号 月结支付时传值,现结不需传值;沙箱联调可使用测试月结卡号7551234567(非正式,无须绑定,仅支持联调使用)
11 payMethod Number(2) 1 付款方式,支持以下值: 1:寄方付 2:收方付 3:第三方付
12 expressTypeId Number(5) 1 快件产品类别, 支持附录 《快件产品类别表》 的产品编码值,仅可使用与顺丰销售约定的快件产品
13 parcelQty Number(5) 1 包裹数,一个包裹对应一个运单号;若包裹数大于1,则返回一个母运单号和N-1个子运单号
14 totalLength Number(16,5) 客户订单货物总长,单位厘米, 精确到小数点后3位, 包含子母件
15 totalWidth Number(16,5) 客户订单货物总宽,单位厘米, 精确到小数点后3位, 包含子母件
16 totalHeight Number(16,5) 客户订单货物总高,单位厘米, 精确到小数点后3位, 包含子母件
17 volume Number(16,5) 订单货物总体积,单位立方厘米, 精确到小数点后3位,会用于计抛 (是否计抛具体商务沟通中 双方约定)
18 totalWeight Number(17,5) 条件 订单货物总重量(郑州空港海关必填), 若为子母件必填, 单位千克, 精确到小数点后3位,如果提供此值, 必须>0 (子母件需>6)
19 totalNetWeight Number(17,5) 商品总净重
20 sendStartTm Date 接收 到报 文的 时间 要求上门取件开始时间, 格式: YYYY-MM-DD HH24:MM:SS, 示例: 2012-7-30 09:30:00
21 isDocall Number(1) 0 是否通过手持终端 通知顺丰收派 员上门收件,支持以下值: 1:要求 0:不要求
22 isSignBack Number(1) 0 是否返回签回单 (签单返还)的运单号, 支持以下值: 1:要求 0:不要求
23 custReferenceNo String(100) 客户参考编码:如客户原始订单号
24 temperatureRange Number(2) 条件 温度范围类型,当 express_type为12 医药温控件 时必填,支持以下值: 1:冷藏 3:冷冻
25 orderSource String(50) 订单平台类型 (对于平台类客户, 如果需要在订单中 区分订单来源, 则可使用此字段) 天猫:tmall, 拼多多:pinduoduo, 京东 : jd 等平台类型编码
27 remark String(100) 备注
28 isOneselfPickup Number(1) 0 快件自取,支持以下值: 1:客户同意快件自取 0:客户不同意快件自取
29 filterField String 筛单特殊字段用来人工筛单
30 isReturnQRCode Number(1) 0 是否返回用来退货业务的 二维码URL, 支持以下值: 1:返回二维码 0:不返回二维码
31 specialDeliveryTypeCode String(3) 特殊派送类型代码 1:身份验证
32 specialDeliveryValue String(100) 特殊派件具体表述 证件类型: 证件后8位如: 1:09296231(1 表示身份证, 暂不支持其他证件)
33 merchantPayOrderNo String(100) 商户支付订单号
34 isReturnSignBackRoute label Number(1) 0 是否返回签回单路由标签: 默认0, 1:返回路由标签, 0:不返回
35 isReturnRoutelabel Number(1) 1 是否返回路由标签: 默认1, 1:返回路由标签, 0:不返回;除部分特殊用户外,其余用户都默认返回
36 isUnifiedWaybillNo Number(1) 0 是否使用国家统一面单号 1:是, 0:否(默认)
37 podModelAddress String(1024) 签单返还范本地址
38 inProcessWaybillNo String(100) 头程运单号(郑州空港海关必填)
39 isGenWaybillNo Number(1) 1 是否需求分配运单号1:分配 0:不分配(若带单号下单,请传值0)
# 属性名 类型(约束) 必填 默认值 描述
1 waybillType Number (1) 运单号类型1:母单 2 :子单 3 : 签回单
2 waybillNo String(15) 运单号
3 boxNo String(64) 箱号
4 length Number (16,3) 长(cm)
5 width Number (16,3) 宽(cm)
6 height Number (16,2) 高(cm)
7 weight Number (16,2) 重量(kg)
9 volume Number (16,2) 体积(立方厘米)
2.3.2 元素Order/List
# 属性名 类型(约束) 必填 描述
1 contactType Number(1) 地址类型: 1,寄件方信息 2,到件方信息
2 company String(100) 条件 公司名称
3 contact String(100) 条件 联系人
4 tel String(20) 条件 联系电话
5 mobile String(20) 手机
6 zoneCode String(30) 条件 城市代码或国家代码,参考附录 《城市代码表》,如果是跨境件,则此字段为必填
7 country String(30) 国家或地区2位代码 参照附录《城市代码表》
8 province String(30) 所在省级行政区名称,必须是标准的省级行政区名称如:北 京、广东省、广西壮族自治区等;此字段影响原寄地代码识 别,建议尽可能传该字段的值
9 city String(100) 所在地级行政区名称,必须是标准的城市称谓 如:北京市、 深圳市、大理白族自治州等; 此字段影响原寄地代码识别, 建议尽可能传该字段的值
10 county String(30) 所在县/区级行政区名称,必须 是标准的县/区称谓,如:福田区,南涧彝族自治县、准格尔旗等
11 address String(200) 详细地址,若有四级行政区划,如镇/街道等信息可拼接至此字段,格式样例:镇/街道+详细地址。若province/city 字段的值不传,此字段必须包含省市信息,避免影响原寄地代码识别,如:广东省深圳市福田区新洲十一街万基商务大厦10楼;此字段地址必须详细,否则会影响目的地中转识别;
12 postCode String(25) 条件 邮编,跨境件必填(中国内地, 港澳台互寄除外)
13 email String(200) 邮箱地址
14 taxNo String(100) 税号
2.3.3 元素Order/List
# 属性名 类型(约束) 必填 描述
1 name String(128) 货物名称,如果需要生成电子 运单,则为必填
2 count Number(5) 条件 货物数量 跨境件报关需要填写
3 unit String(30) 条件 货物单位,如:个、台、本, 跨境件报关需要填写
4 weight Number(16,3) 条件 订单货物单位重量,包含子母件, 单位千克,精确到小数点后3位 跨境件报关需要填写
5 amount Number(17,3) 条件 货物单价,精确到小数点后3位, 跨境件报关需要填写
6 currency String(5) 条件 货物单价的币别: 参照附录《国际件币别表》
7 sourceArea String(5) 条件 原产地国别, 跨境件报关需要填写
8 productRecordNo String(18) 货物产品国检备案编号
9 goodPrepardNo String(100) 商品海关备案号
10 taxNo String(100) 商品行邮税号
11 hsCode String(100) 海关编码
12 goodsCode String(60) 商品编号
13 brand String(60) 货物品牌
14 specifications String(60) 货物规格型号
15 manufacturer String(100) 生产厂家
16 shipmentWeight Double (16,3) 托寄物毛重
17 length Double (16,3) 托寄物长
18 width Double (16,3) 托寄物宽
19 height Double (16,3) 托寄物高
20 volume Double (16,2) 托寄物体积
21 cargoDeclaredValue Double (16,5) 托寄物声明价值(杭州口岸必填)
22 declaredValueDeclaredCurrency String(5) 托寄物声明价值币别(杭州口岸必填)
23 cargoId String(60) 货物id(逆向物流)
24 intelligentInspection Number(1) 智能验货标识(1-是,0-否) (逆向物流)
25 snCode String(4000) 货物标识码(逆向物流)
26 stateBarCode String(50) 国条码
2.3.4 元素Order/List
# 属性名 类型(约束) 必填 默认值 描述
1 name String(20) 增值服务名,如COD等,支持附录: 《增值服务产品表》
2 value String(30) 条件 增值服务扩展属性,参考增值 服务传值说明
3 value1 String(30) 条件 增值服务扩展属性
4 value2 String(30) 条件 增值服务扩展属性2
5 value3 String(30) 条件 增值服务扩展属性3
6 value4 String(30) 条件 增值服务扩展属性4
2.3.5 元素Order/CustomsInfo
# 属性名 类型(约束) 必填 默认值 描述
1 declaredValue Number(16, 5) 条件 客户订单货物总声明价值, 包含子母件,精确到小数点 后3位。如果是跨境件,则必填
2 declaredValueCurrency String(5) 中国内地 默认CNY, 否则 默认USD 货物声明价值币别,跨境 件报关需要填写 参照附录币别代码附件
3 customsBatchs String(20) 报关批次
4 taxPayMethod Number(2) 税金付款方式,支持以下值: 1:寄付 2:到付
5 taxSettleAccounts String(30) 税金结算账号
6 paymentTool String(100) 支付工具
7 paymentNumber String(100) 支付号码
8 orderName String(100) 客户订单下单人姓名
9 orderCertType String(100) 客户订单下单人证件类型
10 orderCertNo String(100) 客户订单下单人证件号
11 tax String(10) 税款
2.3.6 元素Order/List
# 属性名 类型(约束) 必填 默认值 描述
1 waybillType Number(1) 运单号类型 1:母单 2 :子单 3 : 签回单
2 waybillNo String(15) 运单号
2.3.7 元素Order/List
# 属性名 类型(约束) 必填 默认值 描述
1 attrName String(256) 扩展字段说明:attrName为字段定义, 具体如下表,value存在attrVal
2 attrVal String(1024) 扩展字段值
2.3.7.1 扩展字段备注
attrName attrVal
attr001 物品件数(杭州口岸必填)
attr002 物品净重,郑州空港口岸, 郑州综保税必须字段,最多保留小数点后四位,单位Kg
attr003 进出口时间(郑州空港口岸必须字段格式:yyyy-MM-dd hh:mm:ss)
attr005 商品运输费用,无则填0(郑州综保,杭州海关,重庆口岸 要求字段)
attr006 报关批次(杭州口岸必填,yyyy-dd-mm)
attr007 商品保险费用,无则填0(郑州综保,杭州海关,重庆口岸 要求字段)
attr009 杭州海关版本代码:03
attr010 电商企业十位编码,郑州综保字段
2.4. 公共响应参数
# 属性名 类型(约束) 必填 默认值 描述
1 success String true 请求成功,false 请求失败
2 errorCode String 错误编码,S0000成功
3 errorMsg String 错误描述
4 msgData String 返回的详细数据
2.5. 响应参数\
2.5.1 元素 OrderResponse
# 属性名 类型(约束) 必填 描述
1 orderId String(64) 客户订单号
2 originCode String(10) 原寄地区域代码,可用于顺丰 电子运单标签打印
3 destCode String(10) 目的地区域代码,可用于顺丰 电子运单标签打印
4 filterResult Number(2) 筛单结果: 1:人工确认 2:可收派 3:不可以收派
5 remark String(100) 条件 如果filter_result=3时为必填, 不可以收派的原因代码: 1:收方超范围 2:派方超范围 3:其它原因 高峰管控提示信息 【数字】:【高峰管控提示信息】 (如 4:温馨提示 ,1:春运延时)
6 url Number(200) 二维码URL (用于CX退货操作的URL)
7 paymentLink String(200) 用于第三方支付运费的URL
8 isUpstairs String(1) 是否送货上楼 1:是
9 isSpecialWarehouseService String(4) true 包含特殊仓库增值服务
10 serviceList List 下单补充的增值服务信息
11 returnExtraInfoList List 返回信息扩展属性
12 waybillNoInfoList List 顺丰运单号
13 routeLabelInfo List 路由标签,除少量特殊场景用户外,其余均会返回
2.5.2 元素 OrderResponse/routeLabelInfo
# 属性名 类型(约束) 必填 描述
1 code String(30) 返回调用结果,1000:调用成功; 其他调用失败
2 routeLabelData List 路由标签数据详细数据,除少量特殊场景用户外,其余均会返回
3 message String(1000) 失败异常描述
2.5.3 元素 OrderResponse/routeLabelInfo/routeLabelData
# 属性名 类型(约束) 必填 描述
1 waybillNo String(30) 运单号
2 sourceTransferCode String(60) 原寄地中转场
3 sourceCityCode String(60) 原寄地城市代码
4 sourceDeptCode String(60) 原寄地网点代码
5 sourceTeamCode String(60 原寄地单元区域
6 destCityCode String(60) 目的地城市代码, eg:755
7 destDeptCode String(60) 目的地网点代码, eg:755AQ
8 destDeptCodeMapping String(60) 目的地网点代码映射码
9 destTeamCode String(60) 目的地单元区域, eg:001
10 destTeamCodeMapping String(60) 目的地单元区域映射码
11 destTransferCode String(60) 目的地中转场
12 destRouteLabel String(200) 若返回路由标签,则此项必会返回。如果手打是一段码,检查是否地址异常。打单时的路由标签信息如果是大网的路由标签,这里的值是目的地网点代码,如果 是同城配的路由标签,这里的值是根据同城配的设置映射出来的值,不同的配置结果会不一样,不能根据-符号切分(如:上海同城配,可能是:集散点-目的地网点-接驳点,也有可能是目的地网点代码-集散点-接驳点)
13 proName String(60) 产品名称 对应RLS:pro_name
14 cargoTypeCode String(30) 快件内容: 如:C816、SP601
15 limitTypeCode String(30) 时效代码, 如:T4
16 expressTypeCode String(30) 产品类型,如:B1
17 codingMapping String(60) 入港映射码 eg:S10 地址详细必会返回
18 codingMappingOut String(60) 出港映射码
19 xbFlag String(30) XB标志 0:不需要打印XB 1:需要打印XB
20 printFlag String(60) 打印标志 返回值总共有9位,每位只 有0和1两种,0表示按丰密 面单默认的规则,1是显示, 顺序如下,如111110000 表示打印寄方姓名、寄方 电话、寄方公司名、寄方 地址和重量,收方姓名、收 方电话、收方公司和收方 地址按丰密面单默认规则 1:寄方姓名 2:寄方电话 3:寄方公司名 4:寄方地址 5:重量 6:收方姓名 7:收方电话 8:收方公司名 9:收方地址
21 twoDimensionCode String(600) 二维码 根据规则生成字符串信息, 格式为MMM={‘k1’:’(目的 地中转场代码)’,‘k2’:’(目的 地原始网点代码)’,‘k3’:’(目 的地单元区域)’,‘k4’:’(附件 通过三维码(express_type_code、 limit_type_code、 cargo_type_code)映射时效类型)’,‘k5’:’(运单 号)’,‘k6’:’(AB标识)’,‘k7’:’( 校验码)’}
22 proCode String(30) 时效类型: 值为二维码中的K4
23 printIcon String(100) 打印图标,根据托寄物判断需 要打印的图标(重货,蟹类,生鲜,易碎,Z标) 返回值有8位,每一位只有0和1两种, 0表示按运单默认的规则, 1表示显示。后面两位默认0备用。 顺序如下:重货,蟹类,生鲜,易碎,医药类,Z标,酒标,0 如:00000000表示不需要打印重货,蟹类,生鲜,易碎 ,医药,Z标,酒标,备用
24 abFlag String(30) AB标
25 waybillIconList List 面单图标
25 errMsg String(1000) 查询出现异常时返回信息。 返回代码: 0 系统异常 1 未找到面单
26 destPortCode String(100) 目的地口岸代码
27 destCountry String(50) 目的国别(国别代码如:JP)
28 destPostCode String(100) 目的地邮编
29 goodsValueTotal String(30) 总价值(保留两位小数,数字类型,可补位)
30 currencySymbol String(30) 币种
31 goodsNumber String(20) 件数
32 destAddrKeyWord String(100) 目的地地址关键词
2.6. 请求示例\应用场景(JSON)示例

请求报文:(msgData字段):

{
    "language":"zh_CN",
    "orderId":"F2_20200604180946",
    "customsInfo": {
        "declaredValue":6000.9654
    },
    "cargoDetails":[
        {
            "amount":100.5111,
            "count":2.365,
            "currency":"HKD",
            "goodPrepardNo":"AAAA002",
            "hsCode":"AAAA004",
            "name":"护肤品1",
            "productRecordNo":"AAAA001",
            "sourceArea":"CHN",
            "taxNo":"AAAA003",
            "unit":"个",
            "weight":6.1
        }],
    "cargoDesc":"苹果",
    "extraInfoList":[
        {
            "attrName":"hhtWaybill",
            "attrVal":"0"
        },
        {
            "attrName":"shopCode",
            "attrVal":""
        },
        {
            "attrName":"merchantPayOrderNo",
            "attrVal":"184oe3725c7n3qi3jysa"
        },
        {
            "attrName":"podModelAddress",
            "attrVal":"EOS-FSS-CORE"
        }],
    "serviceList":[
        {
            "name":"INSURE",
            "value":"3000"
        }],
    "contactInfoList": [
        {
            "address":"软件产业基地11栋",
            "city":"深圳市",
            "contact":"曾不凡",
            "contactType":1,
            "country":"CN",
            "county":"南山区",
            "mobile":"13480155048",
            "postCode":"580058",
            "province":"广东省",
            "tel":"4006789888"
        },
        {
            "address":"广东省广州市白云区湖北大厦",
            "city":"",
            "company":"顺丰速运",
            "contact":"邱大维",
            "contactType":2,
            "country":"CN",
            "county":"",
            "mobile":"13925211148",
            "postCode":"580058",
            "province":"",
            "tel":"18688806057"
        }],
    "monthlyCard":"",
    "payMethod":1,
    "expressTypeId":1,
    "parcelQty":4,
    "totalLength":12.0,
    "totalWidth":12.0,
    "totalHeight":10.0,
    "volume":8.0,
    "totalWeight":11.1,
    "totalNetWeight":"12.1",
    "sendStartTm":"2020-03-10 10:00:00",
    "isDocall":1,
    "isSignBack":1
}
2.7. 返回示例\应用场景(JSON)示例

响应报文:

  • 成功响应:
{
    "apiErrorMsg": "",
    "apiResponseID": "0001727E2494543FEA449BF48D24123F",
    "apiResultCode": "A1000",
    "apiResultData": {
        "success": true,
        "errorCode": "S0000",
        "errorMsg": null,
        "msgData": {
            "orderId": "QIAO-20200528-006",
            "originCode": "719",
            "destCode": "710",
            "filterResult": 2,
            "remark": "",
            "url": null,
            "paymentLink": null,
            "isUpstairs": null,
            "isSpecialWarehouseService": null,
            "mappingMark": null,
            "agentMailno": null,
            "returnExtraInfoList": null,
            "waybillNoInfoList": [{
                "waybillType": 1,
                "waybillNo": "SF7444400043266"
            }],
            "routeLabelInfo": [{
                "code": "1000",
                "routeLabelData": {
                    "waybillNo": "SF7444400043266",
                    "sourceTransferCode": "",
                    "sourceCityCode": "719",
                    "sourceDeptCode": "719",
                    "sourceTeamCode": "",
                    "destCityCode": "710",
                    "destDeptCode": "710F",
                    "destDeptCodeMapping": "",
                    "destTeamCode": "",
                    "destTeamCodeMapping": "",
                    "destTransferCode": "710VA",
                    "destRouteLabel": "710VA-F",
                    "proName": "顺丰标快",
                    "cargoTypeCode": "C201",
                    "limitTypeCode": "T4",
                    "expressTypeCode": "B1",
                    "codingMapping": "",
                    "codingMappingOut": "",
                    "xbFlag": "0",
                    "printFlag": "000000000",
                    "twoDimensionCode": "MMM={'k1':'710VA','k2':'710F','k3':'','k4':'T4','k5':'SF7444400043266','k6':'','k7':'e177bc63'}",
                    "proCode": "T4",
                    "printIcon": "00000000",
                    "abFlag": "",
                    "destPortCode": "",
                    "destCountry": "",
                    "destPostCode": "",
                    "goodsValueTotal": "",
                    "currencySymbol": "",
                    "cusBatch": "",
                    "goodsNumber": "",
                    "errMsg": "",
                    "checkCode": "e177bc63",
                    "proIcon": "",
                    "fileIcon": "",
                    "fbaIcon": "",
                    "icsmIcon": "",
                    "destGisDeptCode": "710F",
                    "newIcon": null
                }",
                "message": "SF7444400043266:"
            }],
            "contactInfoList": null
        }
    }
}
  • 失败响应:
{
    "success":false,
    "errorCode":"8016",
    "errorMsg":"重复下单",
    "msgData":null
}
3.1. 错误代码
3.1 (API)平台结果代码列表
标识 说明 【处理建议】
A1000 统一接入平台校验成功,调用后端服务成功; 注意:不代表后端业务处理成功,实际业务处理结果, 需要查看响应属性apiResultData中的详细结果
A1001 必传参数不可为空 serviceCode 已作废 requestID timestamp 已作废 msgData 不可为空
A1002 请求时效已过期 时效参考auth2 https://open.sf-express.com/customerService/395002?interId=590549&faqId=4
A1003 IP无效 参考常见问题 https://open.sf-express.com/customerService/395002?activeIndex=905584&interId=590549&faqId=2
A1004 无对应服务权限 联系销售经理,配置权限
A1005 流量受控 测试环境流量限制为5000,请不要在测试环境做压测
A1006 数字签名无效 参考常见问题 签名加解密问题 https://open.sf-express.com/customerService/395002?activeIndex=905584&interId=795986
A1007 重复请求 过一分钟在尝试
A1008 数据解密失败
A1009 目标服务异常或不可达
A1099 系统异常
3.2 业务异常代码
错误代码 错误中文描述 错误英文描述 【处理建议】
1010 寄件地址不能为空 Shipper‘s address is required. address不能为空
1011 寄件联系人不能为空 Shipper‘s contract name is required. contact不能为空
1012 寄件电话不能为空 Shipper‘s telephone number is required. mobile和tel不能都为空
1014 到件地址不能为空 Receiver‘s adress is required. address不能为空
1015 到件联系人不能为空 Receiver‘s contact name is required. contact不能为空
1016 到件电话不能为空 Receiver‘s telephone number is required. mobile和tel不能都为空
1020 出口件邮编不能为空 Postal code is required for International shipments. postCode不能为空
1023 拖寄物品名不能为空 Commodity name is required. cargoDetails下面的name不能为空
1028 出口件时,拖寄物数量不能为空 Commodity quantity is required for international shipments. cargoDetails下面的count不能为空
1038 出口件声明价值不能为空 The declared value is required for International shipments. cargoDeclaredValue不能为空
6126 月结卡号不合法 Invalid credit account number. monthlyCard月结卡号必须为10位数字
6127 增值服务名不能为空 AVS name is required. serviceList下面的name为空
6128 增值服务名不合法 Invalid AVS name. serviceList 下面name传值不正确
6130 体积参数不合法 Invalid Volume Parameters volume传参不正确
6138 代收货款金额传入错误 COD amount data error. serviceList中name为COD 对应的value为数字
6139 代收货款金额小于0错误 Error! COD amount is less than 0. serviceList中name为COD 对应的value必须大于0
6200 国际件寄方邮编不能为空 The shipper postal code is required for International shipment. postCode不能为空
6201 国际件到方邮编不能为空 The receiver postal code is required for International shipment. postCode不能为空
6202 国际件货物数量不能为空 The cargo quantity is required for International shipment. cargoDetails下面的count不能为空
6203 国际件货物单位不能为空 The cargo unit is required for International shipment. cargoDetails下面的unit不能为空
6204 国际件货物单位重量不能为空 The cargo unit weight is required for International shipment. cargoDetails下面的weight不能为空
6205 国际件货物单价不能为空 The cargo unit value is required for International shipment. cargoDetails下面的amount不能为空
6206 国际件货物币种不能为空 The cargo currency is required for International shipment. cargoDetails下面的currency不能为空
6207 国际件原产地不能为空 Origin code is required for International shipment. cargoDetails下面的sourceArea不能为空
8016 重复下单 Duplicated order ID. orderId不能重复
8027 不存在的业务模板 Business template does not exist. bizTemplateCode传入了不存在的模板 或者传空了
8067 超过最大能申请子单号数量 Exceed the maximum number of the available sub waybills. 下单接口默认最大申请子单号数量为307个
8096 您的预约超出今日营业时间,无法上门收件。 sendStartTm传工作时间。或者isDocall传0
8114 传入了不可发货的月结卡号 联系销售经理增加该月结卡号下单权限
8117 下单包裹不能大于307个 下单接口默认最大申请子单号数量为307个
8119 月结卡号不存在或已失效 传入的monthlyCard不存在或已失效
8194 跨境件必须包含申明价值和币别 跨境件申明价值(consValue)和申明价值币别(consValueCurrencyCod)e必须要传
8196 信息异常 收件或者寄件电话号码黑名单
8247 运单号不合法 请核实运单号是否是顺丰运单号(注意顺丰生产环境 测试环境 丰桥上面的单不能混用)
8053 目的地不在定时派送服务范围内 到件地址不支持定时派送。可以去掉定时派送(IN26)增值服务
8052 原寄地不在定时派送服务范围内 寄件地址不支持定时派送。可以去掉定时派送(IN26)增值服务
8051 定时派送不在时效范围内,下单失败 传入的时间不在时效范围内,可以根据返回响应的时间段来传值
8179 卡号下未查到关联相应协议 需要找销售签订对应的产品协议
8177 类似 (正值运力高峰期,普通会员(非会员)的寄件通道预约已满,敬请谅解) 提示语组成 BPS:策略编号 高峰管控
20012 定时派送服务不支持重量超过300KG的快件 totalWeight不能超过300kg
20011 产品与定时派送服务时间段不匹配 修改TDELIVERY增值服务value1传值
8256 部分快件产品不支持到付和寄付现结,请调整付款方式后下单 付款方式payMethod传1 3 并且monthlyCard需要传值
20035 托寄物违禁品不可收寄 修改托寄物cargoDetails的name
20036 适用产品不满足 更改产品expressTypeId重新下单,如不行,请联系顺丰销售业务经理处理
8057 快件类型为空或未配置 expressTypeId不正确,请参看《快件产品类别表》

速运类接口业务相关错误码

页面列表

ITEM_HTML