快递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

返回响应

🟢200成功
application/json
Body

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

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

扫码加入交流群
修改于 2022-12-20 06:10:23
上一页
快递公司编码
下一页
下单回调接口
Built with