华磊科技

页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 63 下一个 »

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

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

(请注意,这里是测试环境url,正式环境url请联系货代)

(请注意,这里是测试环境url,正式环境url请联系货代)

(请注意,这里是测试环境url,正式环境url请联系货代)

 

 

 

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":"配货信息","hs_code":"海关编码"}],"order_customerinvoicecode":"原单号,必填","product_id":"运输方式ID,必填","weight":"总重,选填,如果sku上有单重可不填该项","product_imagepath":"图片地址,多图片地址用分号隔开","order_transactionurl":"产品销售地址","consignee_email":"邮箱,选填","consignee_companyname":"收件公司名,如有最好填写","order_cargoamount":"订单实际金额,用于白关申报","order_insurance":"保险金额"}

以上请求以post方式提交

返回值

{"ack":"true","message":"如果未获取到转单号,则该列存放失败原因(该内容请urldecode后查看)","order_transfercode": "特殊情况下使用,默认不用理会","reference_number":"参考号","tracking_number":"跟踪号",”order_id”:”xxxxxxx”}

 

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

 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":"配货信息","hs_code":"海关编码"}],"order_customerinvoicecode":"原单号,必填","product_id":"运输方式ID,必填","weight":"总重,选填,如果sku上有单重可不填该项","product_imagepath":"图片地址,多图片地址用分号隔开","order_serveinvoicecode":"跟踪号码","order_transactionurl":"产品销售地址","consignee_email":"邮箱,选填","consignee_companyname":"收件公司名,如有最好填写","order_cargoamount":"订单实际金额,用于白关申报","order_insurance":"保险金额"}

返回值

{"ack":"true","message":"如果未获取到转单号,则该列存放失败原因(该内容请urldecode后查看)","order_transfercode": "特殊情况下使用,默认不用理会","reference_number":"参考号","tracking_number":"跟踪号",”order_id”:”xxxxxxx”}

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

 

 

含发件人

 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":"配货信息","hs_code":"海关编码"}],"order_customerinvoicecode":"原单号,必填","product_id":"运输方式ID,必填","weight":"总重,选填,如果sku上有单重可不填该项","product_imagepath":"图片地址,多图片地址用分号隔开","shipper_name":"发件人姓名,选填","shipper_companyname":"发件人公司名,选填","shipper_address1":"发件人地址1,选填",

"shipper_address2":"发件人地址2,选填","shipper_address3":"发件人地址3,选填","shipper_city":"发件人城市,选填","shipper_state":"发件人州,选填","shipper_postcode":"发件人邮编,选填","shipper_country":"发件人国家,选填","shipper_telephone":"发件人电话,选填","order_transactionurl":"产品销售地址","consignee_email":"邮箱,选填","consignee_companyname":"收件公司名,如有最好填写","order_cargoamount":"订单实际金额,用于白关申报","order_insurance":"保险金额"}

 

 

代收货款业务

 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":"配货信息","hs_code":"海关编码"}],"order_customerinvoicecode":"原单号,必填","product_id":"运输方式ID,必填","weight":"总重,选填,如果sku上有单重可不填该项","product_imagepath":"图片地址,多图片地址用分号隔开","shipper_name":"发件人姓名,选填","shipper_companyname":"发件人公司名,选填","shipper_address1":"发件人地址1,选填",

"shipper_address2":"发件人地址2,选填","shipper_address3":"发件人地址3,选填","shipper_city":"发件人城市,选填","shipper_state":"发件人州,选填","shipper_postcode":"发件人邮编,选填","shipper_country":"发件人国家,选填","shipper_telephone":"发件人电话,选填","order_transactionurl":"产品销售地址","consignee_email":"邮箱,选填","consignee_companyname":"收件公司名,如有最好填写",

"order_codamount":"代收金额","order_codcurrency":"币种,标准三字代码","order_cargoamount":"订单实际金额,用于白关申报","order_insurance":"保险金额"}

 

批量下单接口

 URL1/createOrderBatchApi.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":"配货信息","hs_code":"海关编码"}],"order_customerinvoicecode":"原单号,必填","product_id":"运输方式ID,必填","weight":"总重,选填,如果sku上有单重可不填该项","product_imagepath":"图片地址,多图片地址用分号隔开","shipper_name":"发件人姓名,选填","shipper_companyname":"发件人公司名,选填","shipper_address1":"发件人地址1,选填",

"shipper_address2":"发件人地址2,选填","shipper_address3":"发件人地址3,选填","shipper_city":"发件人城市,选填","shipper_state":"发件人州,选填","shipper_postcode":"发件人邮编,选填","shipper_country":"发件人国家,选填","shipper_telephone":"发件人电话,选填","order_transactionurl":"产品销售地址","consignee_email":"邮箱,选填","consignee_companyname":"收件公司名,如有最好填写",

"order_codamount":"代收金额","order_codcurrency":"币种,标准三字代码","order_cargoamount":"订单实际金额,用于白关申报","order_insurance":"保险金额"},

{"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":"配货信息","hs_code":"海关编码"}],"order_customerinvoicecode":"原单号,必填","product_id":"运输方式ID,必填","weight":"总重,选填,如果sku上有单重可不填该项","product_imagepath":"图片地址,多图片地址用分号隔开","shipper_name":"发件人姓名,选填","shipper_companyname":"发件人公司名,选填","shipper_address1":"发件人地址1,选填",

"shipper_address2":"发件人地址2,选填","shipper_address3":"发件人地址3,选填","shipper_city":"发件人城市,选填","shipper_state":"发件人州,选填","shipper_postcode":"发件人邮编,选填","shipper_country":"发件人国家,选填","shipper_telephone":"发件人电话,选填","order_transactionurl":"产品销售地址","consignee_email":"邮箱,选填","consignee_companyname":"收件公司名,如有最好填写",

"order_codamount":"代收金额","order_codcurrency":"币种,标准三字代码","order_cargoamount":"订单实际金额,用于白关申报","order_insurance":"保险金额"}]

返回信息:

{
"data": [
{
"ack": "true",  //下单成功或失败的标准,成功返回true,失败返回false
"message": "", //下单失败时返回原因,urldecode解码
"order_id": "35864", //订单id,请持久化保存,用于打印面单
"order_transfercode": "", //特殊情况下使用,默认不用理会
"reference_number": "SF701708290061B",  //客户的原始单号,参考号
"tracking_number": "RF000000204DEL" //转单号/跟踪号
}
],
"message": "",   返回json不合法或未传param参数
"resultCode": "true"  //仅当json不合法以及未传递param参数时该状态返回false,其他情况下返回true
}

 

 

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/updateOrderWeightByApi.htm?customerId=客户id&orderNo=订单号&weight=重量

 

 

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

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,多个用逗号分割。

 

 

7.轨迹查询

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

返回

[
{
"ack": "true",
"data": [
{
"consigneeCountry": "收件国家代码 country code",
"productKindName": "物流方式 express type ",
"referenceNumber": "参考号 ref number",
"trackContent": "末条轨迹内容 the last track content",
"trackDate": "末条轨迹时间 the last track date",
"trackLocation": "上海 the last track location",
"trackSignperson": "签收人 sign person,if no sign it's empty",
"trackingNumber": "跟踪号 tracking number",
"trackDetails": [
{
"track_content": "轨迹内容track conent",
"track_date": "轨迹时间 track date",
"track_location": "上海 track location",
"track_signdate": "签收时间 sign date,if no sign it's empty",
"track_signperson": "签收人 sign person,if no sign it's empty"
}
]
}
]
}
]

 

获取跟踪号

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

 

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

  • 无标签