快递100 API
  1. 接口文档
快递100 API
  • 入门指南
    • 如何注册企业账号
    • 如何开通产品服务
    • 如何联系工作人员
    • 企业版和基础版的区别
  • 产品文档
    • 快递查询
      • 实时快递查询
        • 产品介绍
        • 接口文档
          • 实时快递查询接口
      • 快递信息推送服务
        • 产品介绍
        • 接口文档
          • 快递订阅查询快递api接口技术文档
          • 推送接口
      • 快递查询地图轨迹
        • 产品介绍
        • 接口文档
          • 快递查询地图轨迹技术文档
      • 地图轨迹推送服务
        • 产品介绍
        • 接口文档
          • 订阅接口
          • 推送接口
    • 电子面单与云打印
      • 电子面单
        • 产品介绍
        • 电子面单参数
        • 第三方平台账号授权
          • 第三方授权回调
          • 第三方平台网点&面单余额接口
          • 电子面单账号授权
        • 电子面单接口
          • 打印状态回调
          • 电子面单下单接口
          • 电子面单复打接口
        • 电子面单取消接口
      • 订单导入
        • 产品介绍
        • 接口文档
          • 提交售后(退货)订单获取任务接口
          • 售后(退货)订单获取结果推送接口
          • 快递单号回传及订单发货接口
          • 获取店铺授权超链接接口
          • 提交订单获取任务接口
          • 订单获取结果推送接口
      • 自定义打印
        • 产品介绍
        • 自定义模板打印
          • 自定义模板打印接口
          • 自定义模板打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 附件打印
          • 附件打印接口
          • 附件打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 指令打印
          • 指令打印接口
          • 指令打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
      • 发货单
        • 产品介绍
        • 接口文档
          • 发货单接口
          • 打印回调接口
    • 物流服务
      • 商家寄件
        • 产品介绍
        • 接口文档
          • 快递公司编码
          • 商家寄件下单接口
            POST
          • 下单回调接口
            POST
          • 商家寄件下单取消接口
            POST
          • 商家寄件下单价格接口
            POST
          • 快递信息推送接口
            POST
          • 商家寄件订单详情查询接口
            POST
          • 电子面单复打接口
            POST
      • 同城配送
        • 产品介绍
        • 参数字典
        • 同城配送接账号授权
          • 授权回调接口
          • 同城配送账号授权接口
        • 同城配送下单
          • 下单回调接口
          • 同城配送下单
        • 同城配送查询订单
        • 同城配送取消下单接口
      • C端寄件
        • 产品文档
        • 接口文档
          • C端寄件下单接口
          • 下单回调接口
          • C端寄件下单取消接口
          • C端寄件价格查询接口
          • 快递信息推送接口
    • 跨境服务
      • 国际电子面单API
        • 产品介绍
        • 参考数字典
        • 接口文档
          • 国际电子面单下单API
          • 预约取件API
          • 取消预约PI
    • 增值服务
      • 短信提醒发送
        • 产品介绍
        • 接口文档
          • 快递100短信回调请求
          • 快递100短信发送接口
      • 智能单号识别
        • 产品介绍
        • 智能识别接口说明
      • 快递面单OCR识别
        • 产品介绍
        • 快递面单OCR识别接口
      • 快递可用性查询
        • 产品介绍
        • 快递可用性接口
  • 常见问题
    • 查询类问题
      • 实时快递查询
      • 快递信息推送服务
      • 智能单号识别
      • 短信提醒发送
      • Excel表格批量查询
    • 电子面单类问题
      • 电子面单
      • 快递面单模板
      • 参数配置
      • 云打印机/云盒
    • 地图轨迹类问题
      • 快递查询地图轨迹
    • 物流类服务
      • 同城配送
      • 商家寄件
      • 个人寄件
    • 云打印类问题
      • 自定义打印
      • 云打印
      • 发货单
    • 申请与审核
      • 企业版
      • 基础版
    • 支付与支票
      • 产品价格
      • 账单与充值
      • 发票问题
    • 政策与规范
      • 商家寄件服务协议
      • 用户协议
      • 授权声明
      • 隐私政策
      • 增值服务
      • 服务协议
      • 保密协议
    • 账号与密码
      • 账号密码
      • 授权问题
    • 快递公司入驻
      • 入驻资料及审核
      • 电子面单接口示例
      • 快递公司接入快递100实时查询接口
      • 快递公司接入快递100订阅推送接口
      • 手机app快递查询接口
  1. 接口文档

商家寄件下单接口

POST
https://poll.kuaidi100.com/order/borderapi.do
选择快递公司进行下单。
沙箱请求地址:https://api.kuaidi100.com/apiMock/border(订单将不推至快递公司:沙箱下单后,可通过:调试工具-商家寄件-下单回调,调试订单各阶段状态。)
param数据结构:
参数名是否必填类型说明
kuaidicom是string快递公司的编码,一律用小写字母,见《快递公司编码》
recManName是string收件人姓名
recManMobile是string收件人的手机号,手机号和电话号二者其一必填
recManPrintAddr是string收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园
sendManName是string寄件人姓名
sendManMobile是string寄件人的手机号,手机号和电话号二者其一必填
sendManPrintAddr是string寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
callBackUrl是stringcallBackUrl订单信息回调地址
cargo否string物品名称,例:文件。当kuaidicom=jd,yuantong时,必填
payment否string支付方式,SHIPPER: 寄付(默认)。不支持到付
serviceType否string业务类型,默认为标准快递,各快递公司业务类型对照参考:七、业务类型参数表
weight否string物品总重量KG,不需带单位,例:1.5
remark否string备注
dayType否string预约日期,例如:今天/明天/后天
pickupStartTime否string预约起始时间(HH:mm),例如:09:00,顺丰必填
pickupEndTime否string预约截止时间(HH:mm),例如:10:00,顺丰必填
channelSw否string渠道ID,如有多个同品牌运力,请联系商务提供后传入
下单扩展属性
valinsPay否string保价额度,单位:元
realName否string寄件人实名信息(圆通、极兔支持 )
sendIdCardType否string寄件人证件类型,1:居民身份证 ;2:港澳居民来往内地通行证 ;3:台湾居民来往大陆通行证 ;4:中国公民护照(圆通、极兔支持 )
sendIdCard否寄件人证件号码 (圆通、极兔支持 )
passwordSigning否string是否口令签收,Y:需要 N: 不需要,默认值为N(德邦快递专属参数)
op否string是否开启订阅功能 0:不开启(默认) 1:开启 说明开启订阅功能时:pollCallBackUrl必须填入 此功能只针对有快递单号的单
pollCallBackUrl否string如果op设置为1时,pollCallBackUrl必须填入,用于跟踪回调,回调内容通过五、快递信息推送接口返回(免费服务)
resultv2否string添加此字段表示开通行政区域解析功能 。 0:关闭(默认) 1:开通行政区域解析功能以及物流轨迹增加物流状态名称 4:开通行政解析功能以及物流轨迹增加物流高级状态名称、状态值并且返回出发、目的及当前城市信息(详见:快递信息推送接口文档)
returnType否string面单返回类型,默认为空,不返回面单内容。10:设备打印,20:生成图片短链回调。
siid否string设备码,returnType为10时必填
tempid否string模板编码,通过管理后台的电子面单模板信息获取 ,returnType不为空时必填
printCallBackUrl否string打印状态回调地址,returnType为10时必填
salt否string签名用随机字符串,用于验证签名sign。salt值不为null时,推送数据将包含该加密签名,加密方式:md5(param+salt)。注意: salt值为空串时,推送的数据也会包含sign,此时可忽略sign的校验。
eOrder数据结构
字段类型说明备注
bulkpenstring大头笔用于显示于电子面单上规定位置,非必需,是否有值取决于快递公司
orgCodestring始发地区域编码
orgNamestring始发地/始发网点名称
destCodestring目的地区域编码
destNamestring目的地/到达网点
orgSortingCodestring始发分拣编码
orgSortingNamestring始发分拣名称
destSortingCodestring目的分栋编码
destSortingNamestring目的分栋中心名称
orgExtrastring始发其他信息
destExtrastring目的其他信息
pkgCodestring集包编码
pkgNamestring集包地名称
roadstring路区
qrCodestring二维码
kdComOrderNumstring快递公司订单号
expressCodestring快递业务类型编码
expressNamestring快递业务类型名称
waterMarkstring水印
agingNamestring时效
abFlagstring电子产品类型图标
proCodestring时效产品图标
codingMappingstring进港映射码
codingMappingOutstring出港信息
printIconstring图标名称
destRouteLabelstring目的地(路由信息)
twoDimensionCodestring二维码信息
xbFlagstring顺丰面单标识,快运必填,xbFlag=1,打印SX标;xbFlag=2,打印融通标
注意:eOrder实际返回的字段各家快递公司不同,以实际返回为准
说明:
信息代码信息内容描述原因及建议处理方式
200提交成功提交成功
400参数错误等请根据技术文档请求,注意参数类型及是否必填
500服务器错误快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误
501重复提交重复提交了请求
503验证签名失败请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号
600您不是合法的用户(即授权Key出错)账号无可用余额,需要充值
601KEY已过期账号无可用余额,需要充值
700错误的回调地址检查回调地址,或者联系快递100工作人员
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://poll.kuaidi100.com/order/borderapi.do' \
--data-urlencode 'method=bOrder' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 't=1576123932000' \
--data-urlencode 'param='
响应示例响应示例
{
	"result": true,
	"returnCode": "200",
	"message": "提交成功",
	"data": {
		"taskId": "", // 任务ID
		"orderId": "" // 订单ID
		"kuaidinum": "" // 快递单号
		"eOrder": "[\"destName\":null,\"orgName\":null,\"pkgCode\":null,\"pkgName\":null,\"bulkpen\":\"上海-S33-K27-P\",\"orgExtra\":null}]"
	}
}

请求参数

Body 参数application/x-www-form-urlencoded
method
string 
必需
业务类型(默认:bOrder)
示例值:
bOrder
key
string 
必需
授权码,请到快递100页面申请企业版接口获取
sign
string 
必需
32位大写签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号secret在授权邮件里面有
t
string 
必需
时间戳如:1576123932000
示例值:
1576123932000
param
string 
由其他字段拼接
必需

返回响应

🟢200成功
application/json
Body
result
boolean 
必需
提交结果。true提交成功,false失败
returnCode
string 
返回编码
必需
message
string 
返回报文描述
必需
data
object 
必需
taskId
string 
任务ID
必需
orderId
string 
订单ID
必需

【快递100】API开发者 微信交流群

用微信扫右侧二维码,加入【快递100】API开发者 交流群,互助沟通

扫码加入交流群
上一页
快递公司编码
下一页
下单回调接口
Built with