国际电子面单下单

国际电子面单下单

一、国际电子面单下单

通过国际快递公司或网点提供的电子面单账号,提交生成电子面单号,返回固定面单模板,调用本地打印机即可打印出电子面单。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

http://poll.kuaidi100.com/eorderapi.do

请求参数(header)

名称类型默认值
Content-Typestringapplication/x-www-form-urlencoded

请求参数(body)

参数名是否必填类型说明
methodstring业务类型(默认:intership)
keystring授权码,请到快递100页面申请企业版接口获取
signstring32位大写签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret可在企业管理后台中企业信息查看
tstring时间戳如:1576123932000
paramparam由其他字段拼接

param数据结构:

参数名是否必填类型说明
partnerIdstring月结或支付账号
partnerNamestring月结账号用户名
partnerSecretstring月结账号用户密码
kuaidicomstring快递公司的编码,一律用小写字母,见参数字典
ΘrecManrecMan收件人信息
¬namestring收件人姓名
¬mobilestring收件人的手机号,手机号和电话号二者其一必填
¬addrstring收件人所在完整地址
¬districtstring郡|县,可作为收件地址补充
¬provincestring州|省,可作为收件地址补充
¬companystring公司名称
¬countryCodestring国家代号 CN-中国 ,US-美国等, 详见字典表
¬citystring城市
¬zipcodestring邮编
¬telstring电话
¬emailstring邮箱
ΘsendMansendMan寄件人信息
¬namestring寄件人姓名
¬mobilestring寄件人的手机号
¬addrstring寄件人所在的完整地址
¬districtstring郡|县,可作为收件地址补充
¬provincestring州|省,可作为收件地址补充
¬companystring公司名称
¬countryCodestring国家代号 CN-中国 ,US-美国等, 详见字典表
¬citystring城市
¬zipcodestring邮编
¬telstring电话
¬emailstring邮箱
cargostring货物描述
countstring物品总数量。 另外该属性与子单有关,如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
needChildstring是否需要子单: 1:需要 0:不需要(默认) 如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号); needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
payTypestring支付类型: SHIPPER:寄方付(默认) CONSIGNEE:到付 MONTHLY:月结 THIRDPARTY:第三方支付 (详细请参考参数字典))
expTypestring产品类型: 默认标准快递,请参考参数字典
remarkstring备注
exportCommodityCodestring出口商品码,建议填写,加快清关速度
importCommodityCodestring进口商品码,建议填写,加快清关速度
customsValueDouble申报价值,包裹类必填,货币单位根据currency确定,人民币单位是元
tradeTermstring贸易条款;CFR,DAP等,国际贸易规范用于,默认DAP
currencystring货币单位,CNY-人民币;USD-美元;默认CNY
packageInfosArray[Object]包裹信息集合
exportInfosArray[Object]出口信息集合,一般包裹类要求必填,文件类不用填,用于清关报备
packageInfos数据格式
heightstring高度;单位厘米,默认1.0
widthstring宽度;单位厘米, 默认10.0
lengthstring长度;单位厘米默认10.0
weightDouble重量; 单位千克,默认0.1
packageReferencestring该包裹的备注信息之类
exportInfos数据格式
netWeightDouble净重,单位kg,默认0.1
grossWeightDouble毛重,单位kg,默认 0.1
manufacturingCountryCodestring生产国代号;CN-中国,US-美国
unitPriceDouble物品单价,货币单位根据currency确定,人民币单位是元
quantityDouble物品数量,默认1.0
quantityUnitOfMeasurementstring计数单位,必填;PCS-件,KG-千克等,默认PCS
descriptionstring物品描述

1.3 请求参数示例

{
	"partnerId": "123456",
	"partnerName": "123654",
	"partnerSecret": "gsdgsdgz",
	"kuaidicom": "dhl",
	"sendMan": {
		"name": "Kaka",
		"mobile": "13500000000",
		"addr": "Kingdee Software Park",
		"district": "Hi-tech Park,Nanshang District",
		"province": "",
		"company": "QIAN HAI BAI DI",
		"countryCode": "CN",
		"city": "SHEN ZHEN",
		"zipcode": "518057",
		"tel": "",
		"email": "12344655@qq.com"
	},
	"recMan": {
		"name": "Cindy Martinez / Ana Luz Medina",
		"mobile": "(86)13500000001",
		"addr": "Apoquindo 4001, of. 501. Las Condes",
		"district": "Santiago, Chile",
		"province": "",
		"company": "Lamaignere Chile S.A.",
		"countryCode": "CL",
		"city": "Santiago",
		"zipcode": "7550000",
		"tel": " +56(9)123456",
		"email": "12344699@qq.com"
	},
	"cargo": "",
	"count": "1",
	"weight": "0.1",
	"needTemplate": "1",
	"payType": "SHIPPER",
	"expType": "文件-普通服务",
	"remark": "just a test demo",
	"needChild": "0",
	"collection": "0",
	"payAccount": "123",
	"payAccountName": "456",
	"valinsPay": "0",
	"needBack": "0",
	"packageInfos": [
		{
			"height": "10",
			"width": "20",
			"length": "11",
			"weight": "0.1",
			"packageReference": "just a user remark"
		}
	],
	"customsValue": "12",
	"tradeTerm": "DAP",
	"currency":"CNY"
}

1.4 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
statusstring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
kuaidinumstring快递单号

1.5 返回结果示例

{
    "result": true,
    "message": "成功",
    "status": "200",
    "data": [
        {
            "kuaidinum": 1197249701,
            "pdf": "base64 str",
            "pkgNums": "JD011100003646886420"
        }
    ]
}

1.6 返回结果示例

信息代码信息内容描述原因及建议处理方式
200提交成功提交成功
500服务器错误快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误

1.7 支持快递公司列表

快递公司编码
DHLdhl

1.8 国家代号字典表

国际名称国家代号
中国CN
印度尼西亚ID
葡萄牙PT
丹麦DK
卢森堡LU
克罗地亚HR
乌克兰UA
匈牙利HU
美国US
乌拉圭UY
印度IN
墨西哥MX
意大利IT
马来西亚MY
西班牙ES
阿根廷AR
巴西BR
智利CL
哥伦比亚CO
秘鲁PE
国际电子面单下单