以下地址为华磊测试系统地址，对接成功后联系货代切换货代地址

 

 

1身份认证 

 URL1/selectAuth.htm?username=TEST&password=123456

返回值：

  {'customer_id':'6581','customer_userid':'6901','ack':'true'}

ack=true则代表认证成功，customer_id和customer_userid用于新建订单

 

2.渠道列表

URL1/getProductList.htm

返回

[{"product_id":"***","product_shortname":"***小包"}]

 

 

3添加订单(UTF-8)

 URL1/createOrderApi.htm?param={"buyerid":"","consignee_address":"收件地址街道，必填","consignee_city":"城市","consignee_mobile":"","order_returnsign":"退回标志，默认N表示不退回，Y标表示退回。中邮可以忽略该属性","consignee_name":"收件人,必填","trade_type":"ZYXT","consignee_postcode":"邮编，有邮编的国家必填","consignee_state":"州/省","consignee_telephone":"收件电话，必填","country":"收件国家二字代码，必填","customer_id":"客户ID，必填","customer_userid":"登录人ID，必填","orderInvoiceParam":[{"invoice_amount":"申报总价值，必填","invoice_pcs":"件数，必填","invoice_title":"英文品名，必填","invoice_weight":"单件重","item_id":"","item_transactionid":"","sku":"中文品名","sku_code":"配货信息"}],"order_customerinvoicecode":"原单号，必填","product_id":"运输方式ID，必填","weight":"总重，选填，如果sku上有单重可不填该项","product_imagepath":"图片地址，多图片地址用分号隔开"}

以上请求以post方式提交

返回值

{"ack":"true","message":"如果未获取到转单号，则该列存放失败原因","reference_number":"参考号","tracking_number":"跟踪号",”order_id”:”xxxxxxx”}

message进行了urlencode,请编程人员进行urldecode查看原始内容

 

如有添加订单不需要系统自动分配单号，请按如下方式进行对接

 URL1/createOrderApi.htm?getTrackingNumber=2&param={"buyerid":"","consignee_address":"收件地址街道，必填","consignee_city":"城市","consignee_mobile":"","order_returnsign":"退回标志，默认N表示不退回，Y标表示退回。中邮可以忽略该属性","consignee_name":"收件人,必填","trade_type":"ZYXT","consignee_postcode":"邮编，有邮编的国家必填","consignee_state":"州/省","consignee_telephone":"收件电话，必填","country":"收件国家二字代码，必填","customer_id":"客户ID，必填","customer_userid":"登录人ID，必填","orderInvoiceParam":[{"invoice_amount":"申报总价值，必填","invoice_pcs":"件数，必填","invoice_title":"英文品名，必填","invoice_weight":"单件重","item_id":"","item_transactionid":"","sku":"中文品名","sku_code":"配货信息"}],"order_customerinvoicecode":"原单号，必填","product_id":"运输方式ID，必填","weight":"总重，选填，如果sku上有单重可不填该项","product_imagepath":"图片地址，多图片地址用分号隔开","order_serveinvoicecode":"跟踪号码"}

返回值

{"ack":"true","message":"如果未获取到转单号，则该列存放失败原因","reference_number":"参考号","tracking_number":"跟踪号",”order_id”:”xxxxxxx”}

message进行了urlencode,请编程人员进行urldecode查看原始内容

 

Trade_type可选值，请对号入座

SUMAI 速脉ERP

QQZS 全球助手

WDJL 网店精灵

IEBAY365 IEBAY365

STOMS 赛兔OMS

TTERP 通途ERP

MGDZ 芒果店长

LRERP 懒人erp

SUMOOL 速猫ERP

GLBPAY 上海九赢

DXM 店小秘

ZYXT 客户自用系统/其他不在列表中的均使用该代码

 

 

 

4.标记发货

URL1/postOrderApi.htm?customer_id=**&order_customerinvoicecode=**

 

5.客户自选标签模版 打印标签

URL2/order/FastRpt/PDF_NEW.aspx

参数：标签格式：format=A4_EMS_BGD.frx

       打印类型:PrintType=1打印类型由以下对照表得到

  需要打印的订单  order_id=308897    多个订单号以英文逗号隔开

参考URL:  URL2/order/FastRpt/PDF_NEW.aspx?Format=A4_EMS_BGD.frx&PrintType=1&order_id=308897

示例：

请注意，打印的接口地址和其他地址不同

 

小语种打印，支持希伯来语，泰语等  URL2/order/FastRpt/PDF_NEW.aspx?Format=A4_EMS_BGD.frx&PrintType=1&order_id=308897&Print=1

如需支持小语种，请货代设置标签的时候注意选择字体，最好是微软雅黑

 

 

通过接口获取所有系统支持的打印类型

URL1/selectLabelType.htm

 

6. 一键打印10*10标签（需要货代在系统设置各渠道的10*10标签)

URL2/order/FastRpt/PDF_NEW.aspx?PrintType=lab10_10&order_id=订单ID，多个用逗号分割。

 一键打印A4标签（需要货代在系统设置各渠道的A4标签)

URL2/order/FastRpt/PDF_NEW.aspx?PrintType=A4&order_id=订单ID，多个用逗号分割。

 

特殊渠道标签打印地址:

E邮宝，E特快A4打印，返回pdf路径

URL1/getEUBPrintPath.htm?order_id=订单id，多个以英文逗号隔开&format=A4

E邮宝10*10不干胶打印，返回pdf路径

URL1/getEUBPrintPath.htm?order_id=订单id，多个以英文逗号隔开&format=10*10

FPX标签

URL1/printFpxApi.htm?order_id=订单id，多个以英文逗号隔开

一级专线标签

URL1/downloadOneWorldLabel.htm?order_id=订单id，多个以英文逗号分开

 

 

7.轨迹查询

URL1/selectTrack.htm?documentCode=**********

返回

[
{
"ack": "true",
"data": [
{
"businessId": "",
"consigneeCountry": "收件国家代码",
"productKindName": "物流方式",
"referenceNumber": "参考号",
"trackContent": "末条轨迹内容",
"trackDate": "末条轨迹时间",
"trackLocation": "上海",
"trackSignperson": "签收人",
"trackingNumber": "跟踪号",
"trackDetails": [
{
"business_id": "",
"system_id": "1",
"track_content": "轨迹内容",
"track_createdate": "轨迹创建时间，忽略掉",
"track_date": "轨迹时间",
"track_id": "",
"track_kind": "ARRIVAL",
"track_location": "上海",
"track_signdate": "签收时间",
"track_signperson": "签收人"
}
]
}
]
}
]

 

获取跟踪号

为避免调用异常，以上接口请均用POST方式提交

 

点击下载java对接demo    点击下载  c# demo       点击下载PHP示例    下载 Python Demo