qww

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

名称
 
接口地址
创建订单 URL1 http://www.sz56t.com:8082
打印标签 URL2 http://www.sz56t.com:8089

 

 

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

示例:

参数format

参数PrintType

标签格式

A4_EMS_BGD.frx

1

A4中邮+报关单8*9

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

 

小语种打印,支持希伯来语,泰语等  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": "签收人"
}
]
}
]
}
]

 

获取跟踪号

URL1/getOrderTrackingNumber.htm?documentCode=订单号
URL1/getOrderTrackingNumber.htm?order_id=订单id
为避免调用异常,以上接口请均用POST方式提交

 

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



华磊系统对接马帮3.0
ECPP对接教程
13417321658
公司名称:深圳华磊物流通信息科技有限公司
地址:深圳市宝安区西乡街道黄田鸿丰华互联网创意园F4020
收缩
  • 13417321658