免费顺丰快递单号查询电⼦⾯单api接⼝对接【快递鸟API】顺丰速运快递查询接⼝API和电⼦⾯单接⼝怎么对接?
除了通过顺丰⾃⼰的接⼝对接外,⽤的最多的就是第三⽅通过快递鸟对接了,通过顺丰单号和⼿机号后四位查询轨迹信息,如果是通过快递鸟下单获得的顺丰单号,可通过单号直接查询,具体下载快递鸟接⼝技术⽂档查看接⼝说明。ShipperCode为SF,且快递单号⾮快递鸟渠道返回时,必填,对应收件⼈/寄件⼈⼿机号后四位;ShipperCode为SF,且快递单号为快递鸟渠道返回时,不填。
⼀、接⼊前准备(TO商家业务⼈员)
2、申请顺丰速运⽉结账号
顺丰⽉结账号需要线下与当地顺丰分部签订收派合同,签定后顺丰会提供10位数字的顺丰⽉结账号,⽤于发货结算运费;
注:获取到的⽉结账号不需要在快递鸟官⽹后台添加,直接通过接⼝传值下单即可;
3、购买打印机、打印纸
3.1打印机:
电⼦⾯单模板对打印机品牌、型号等没有要求,只要是热敏打印机即可,常见品牌如:斑马、得⼒、快麦、汉印、佳博等。
打印机可由快递⽹点提供或者在淘宝京东上购买,安装打印机及驱动程序联系打印机提供⽅;
3.2打印纸:
顺丰速运使⽤的打印纸有100mm150mm(切点90/60)、100mm180mm(切点110/70)、100mm*210mm(切点
90/60/60)三种,打印纸可由快递⽹点提供或者在淘宝京东上购买,购买时可选择全⽩热敏纸。
⼆、开发接⼊(TO商家技术开发⼈员)
2、参照技术⽂档开发
2.1 关于请求内容
以java为例:
2.2关于顺丰⽉结账号接⼝传值
MonthCode传值顺丰⽉结账号(PayType为1、2时不填,为3、4时必填),
PayType传值付款⽅式(包含:1-现付,2-到付,3-⽉结,4-第三⽅付),
高叶个人资料几岁了客户号配置页需留两个栏位(需正确对应以上两个字段)由发货商家填写,商家⾃⼰开发的系统也建议保留配置页,万⼀账号更换了呢?
2.3 关于快递类型
鲁迅故居导游词顺丰速运快递类型如下:
快递类型ExpType传值
顺丰标快1
顺丰特惠2
电商特惠3
四⽇件4
顺丰次晨5
顺丰即⽇6
电商速配7
医药常温11
医药温控12
物流普运13
冷运到家14
⽣鲜速配15
⼤闸蟹专递16
汽配吉运17
重货快运18
⾏邮专列20
医药专运(常温)21
医药专运(温控)22
电商专配28
即⽇220034
周润发老婆物资配送35
汇票专送36
证照专递产品110
顺丰空配112
专线普运125
夜配134
重货包裹154
⼩票零担155
医药常温(陆)195
顺丰微⼩件202
医药快运203
陆运微⼩件204
郭应泉个人资料特惠专配208
注:商家的顺丰⽉结账号是否能发对应的快递类型,请事先和顺丰速运分部⼈员确认,除1、2、5、6外,其他快递类型都需单独再签协议。
2.4 关于顺丰速运增值服务传值
保价
字段传值:"AddService": [{"Name":"INSURE ","Value":"1000"}]
代收货款
字段传值:
"AddService":[{"Name":"COD","Value":"1000","CustomerID":"1234567891"}]
⼦母件
Quantity传值⼤于等于2表⽰⼦母件,并且会返回对应的SubCount⼦单数量、SubOrders⼦单单号、SubPrintTemplates⼦单html模板;
签回单
IsReturnSignBill传1表⽰需要签回单,并且会返回对应的SignBillPrintTemplate签回单html模板,默认为0不需要;OperateRequire表⽰回单操作要求(如:签名、盖章、×××复印件等);
预约快递员上门
IsNotice表⽰是否通知快递员上门揽件,0-通知,1-不通知,默认为1;
关于是否需要预约快递员上门揽件:
1、如寄件点是全国各地不固定,需要快递员上门揽件则预约(此类情况务必对预约⽤户做限制,必须本⼈预约,通过⼿机验证码验证成功后⽅可预约,不然会造成⽤户恶意下单预约,导致顺丰速运投诉);
2、如是固定⼏个地点发货,且每天都需要发货,可线下与快递员协商定时定点定⼈上门揽件,接⼝上不需要预约;
3、如是固定地点发货,只是偶尔发⼏票,⾃⼰打印⾯单则随机预约其中⼀个订单,如需要快递员打印则全部预约(快递员是否能打印取决于顺丰速运当地⽹点);
注:如出现恶意预约,导致顺丰速运向快递鸟投诉超过3次的,快递鸟将停⽤⽤户此接⼝权限;
订阅物流节点短信通知
物流节点短信包含:寄件短信、派件短信、签收短信、问题件短信等;
字段传值:IsSendMessage 0-不需要,1-需要
短信通知是收费服务,需联系商务同事购买会员套餐或短信套餐后⽅可使⽤。郭晋安的老婆是谁
3、电⼦⾯单模板样式
顺丰速运模板共5个规格,具体如下
⼆联150(默认模板,TemplateSize传值为空)
三联210(TemplateSize传值210)
⼆联150新(TemplateSize传值15001)
⼆联180新(TemplateSize传值180)
三联210(TemplateSize传值21001)
4、电⼦⾯单模板处理
⽤户可根据⾃⾝的实际情况及未来发展的需要来决定是否需要接⼝返回模板(参数:IsReturnPrintTemplate 0-不需要,1-需要),推荐平台/⼯具/ERP类⽤户⾃⾏开发设计,直接发货商家使⽤接⼝返回的模板,如有特殊需求可⾃⾏开发;
4.1 平台性/⼯具/ERP类⽤户
因其系统使⽤商家较多,同⼀模板⽆法满⾜所有商家需求,推荐根据商家需求⾃⾏设计⾯单模板。
优势:灵活性⾼,不受快递鸟模板变动的影响,商家体验更好
劣势:对⽤户技术能⼒有⼀定要求
4.2 直接发货商家
A、对模板⽆要求,快递鸟接⼝返回的模板已能满⾜的商家,可直接使⽤。
优势:接⼊成本低,⽅便易⽤,可使⽤快递鸟批量打印功能
劣势:灵活性不⾼
B、对模板有⼀定要求,快递鸟接⼝返回的模板⽆法完全满⾜的商家,可对返回的html模板报⽂进⾏
处理,或⾃⾏设计⾯单模板样式。
优势:接⼊成本较低,⽅便快捷
劣势:对⽤户技术能⼒稍有要求
三、接⼝使⽤(TO商家系统操作⼈员)
使⽤过程中如遇到问题,先联系公司内部技术⼈员排查,如需快递鸟协助请让技术⼈员联系。
可能遇到的问题:
1、接⼝返回“校验码有误”是什么原因?
答:快递公司不⽀持的特殊字符:' " # & + % \ < >
请确认请求数据(包含收寄⽅姓名、电话、地址、商品名称等所有订单数据)中是否含有以上特殊字符;
2、电⼦⾯单下单返回结果false,错误码106,订单号已下单成功?
答:电⼦⾯单下单接⼝订单号OrderCode不能重复使⽤,重复使⽤会报错且返回的⾯单是此订单号上次下单的内容;
3、电⼦⾯单返回“暂⽆打印模板”是什么原因?
答:默认的模板TemplateSize⽆需传值,⾮默认模板传对应模板尺⼨,不可传不存在的模板尺⼨代码;
4、电⼦⾯单⽣成后可以取消吗?不发货的话单号会作废吗?
答:下单成功后如不需要发货,直接撕掉⾯单即可,不需要取消(如果⼀定要取消可对接”电⼦⾯单取消接⼝”),快递员揽件后才收费,单号不收费;
6、调⽤电⼦⾯单时,接⼝返回”您的预约超出今⽇营业时间,⽆法上门取件。”?
答:顺丰速运每个区域每个分部上门取件的服务时间不固定,建议更换时间预约,⼀般预约9:00—17:00内;
顺丰快递单号查询接⼝对接指南
⽬的
便于快递鸟⽤户理解快递单号查询接⼝作⽤并正确应⽤到实际场景。
接⼝作⽤
轨迹类接⼝包含:即时查询接⼝和物流跟踪接⼝。
即时查询接⼝:实时查询某个快递单号当前的物流状态;
物流跟踪接⼝:监控某个快递单号完整的物流状态。
应⽤场景
可应⽤于电商平台、⾃营商城、ERP、打单⼯具、楼宇/物业系统、云打印、⼩程序/、APP、OA等需要查看物流信息的场景。
接⼝逻辑
说明:
佟丽娅嫁了大人物快递鸟接⼝作为数据中转站,不对物流信息做处理,不做语⾔转换,只对数据字段做转换,分析物流状态;
发布评论