硬件设备 | 预约演示 | 热线 : 0755-27211799

国际物流系统(T7)API提交订单接口说明文档

编 写 人:吴海龙

审核部门:技术研发部

审 核 人:杨全

完成时间:2018年11月29日

审核时间:2018年11月30日

更新时间:2019年04月02日

深圳市全景世纪科技有限公司

目录

调用说明 3

返回结果 6

返回错误信息 7

返回JSON格式案例 9

提交JSON格式案例 10

测试账号信息 14

一.调用说明

1. 请求参数说明:

订单请求接口地址:

http://api.56sys.com/Helper/WayDate.ashx(注:正式地址)

渠道请求地址

http://api.56sys.com/Helper/Apiinformation.ashx

验证调用参数

参数

类型

是否必填

说明

wd_SecretKey

String

Json数组对象自面量

PartnerID

String

合作者身份ID

PartnerKey

String

合作者秘钥

IdUser

String

账号

2. 包裹信息调用参数:

调用参数:

参数

类型

是否必填

说明

PackageItemDetail

String

Json数组对象自面量

EnglishName

String

英文品名

ChineseName

String

中文品名

Number

int

数量

Price

Deciamal

单价

ItemNumber

String

海关编码

Remark

String

产地

3. 运单信息添加接口请求:

请求接口地址:http://api.56sys.com/Helper/WayDate.ashx(注:正式地址)

调用参数:

参数

类型

是否必填

说明

waybill

String

Json数组对象自面量

IdUser

String

会员账号

Columns

int

包裹件数

Weight

Deciamal

包裹重量

Proxy

String

原始单号

Bagnumber

String

产品种类P(包裹)D(文件)

Deliveryid

int

渠道ID

ChannelsTxt

String

发货渠道中文

Product

String

产品(默认Express Worldwide)

PackageType

int

包装类型(1.花袋/信封2.DHL箱子3.你自己的包装)

PaymentMethod

int

重量单位(默认4002)

Remark

String

字符串长度限制(255)

SenderVAT

String

发件人税号

RecipientsVAT

String

收件人税号

CustomsDeclared

Deciamal

通关申报价值

DeclaredValue

Deciamal

申报价值

DeclaredType

String

价值币种

Long

Deciamal

Width

Deciamal

Height

Deciamal

4.收件人请求参数(注意:地址只填收件人即可):

AddressReceived

String

收件人Json数组对象自面量

Companyname

String

所在公司

Name

String

名称

Country

String

国家

Countryid

int

国家ID

Province

String

City

String

城市

Provinceid

int

州ID

Zipcode

String

邮编

Phone

String

电话

Adress

String

详细地址

AdressTwo

String

详细地址2

AdressThree

String

详细地址3

Email

String

邮箱

Code

String

国家代码

二.返回结果

1. 提交订单返回结果参数:

字段名称

字段含义

Status

True(成功)false失败

Code

错误编号

Description

错误描述

WaybillnumberS

快递单号

Pdf

面单   

2. 获取渠道返回结果参数:

字段名称

字段含义

Title

渠道名称

ID

渠道ID

三.返回错误信息

Code

说明

1

json格式不对

2

秘钥,合作者身份id,账号不能为空

3

秘钥,合作者身份id,账号信息不对

4

运单账号不能为空

5

货物名称不能为空

6

备注不能为空

7

通关申报价值不能为空

8

通关申报价值币种不能为空

9

发货渠道不能为空

10

产品代码不能为空

11

发货渠道不存在

12

重量单位不存在

13

收件人不能为空

13

国家代码不能为空

13

收件邮编不能为空

13

收件城市不能为空

13

收件人不能为空

14

收件人信息不存在

15

原始单号已存在

16

该运单不在该渠道重量范围内,请选择其他渠道

17

该渠道接口信息有误

18

该渠道当日订单量已超出

19

包裹信息填写不完整

20

接口请求失败

四.返回json格式案例

1. 返回订单json:

错误json:

{"Status":false,"ResponseStatusList":[{"Code":17,"Description":"发件邮编不能为空","WaybillnumberS":""}]}

正确json:

、{"Status":true,"ResponseStatusList":[{"Code":0,"Description":"成功","WaybillnumberS":"8900101176"}]}

2. 返回渠道json:

[{

       "TableName": "Channel",

       "PrimaryKey": "ID",

       "ID": 2018,

       "FID": 0,

       "Title": "DHL-D",

       "TitleEn": null,

       "Code": "",

       "IDNumberTrue": false,

       "IsTrue": true,

       "AddTime": "\/Date(1532070681000)\/",

       "OrderID": 1,

       "IsDelete": null,

       "WarehouseID": null,

       "Warehouse": null,

       "Compulsory": 0,

       "APIName": "dhl-D",

       "ApiID": 11,

       "Percentage": 0,

       "Volume": 5000,

       "BillingType": 1,

       "BillingTypeTxt": "国家"

}, {

       "TableName": "Channel",

       "PrimaryKey": "ID",

       "ID": 2007,

       "FID": 0,

       "Title": "DHLA",

       "TitleEn": null,

       "Code": "ups002",

       "IDNumberTrue": false,

       "IsTrue": true,

       "AddTime": "\/Date(1522377483000)\/",

       "OrderID": 1,

       "IsDelete": null,

       "WarehouseID": null,

       "Warehouse": null,

       "Compulsory": 5000,

       "APIName": "ATC",

       "ApiID": 2,

       "Percentage": 3,

       "Volume": 5000,

       "BillingType": 1,

       "BillingTypeTxt": "国家"

}, {

       "TableName": "Channel",

       "PrimaryKey": "ID",

       "ID": 2011,

       "FID": 0,

       "Title": "DHLB",

       "TitleEn": null,

       "Code": "",

       "IDNumberTrue": false,

       "IsTrue": true,

       "AddTime": "\/Date(1522377461000)\/",

       "OrderID": 1,

       "IsDelete": null,

       "WarehouseID": null,

       "Warehouse": null,

       "Compulsory": 0,

       "APIName": "XJ",

       "ApiID": 4,

       "Percentage": 0,

       "Volume": 5000,

       "BillingType": 1,

       "BillingTypeTxt": "国家"

}]

五.提交订单json格式Demo

dataArray={

       "waybill": {

              "PackageItemDetail": [{

                     "EnglishName": "ladys Woven dresses",

                     "ChineseName": "连衣裙",

                     "Number": 1,

                     "Price": 6.45,

                     "ItemNumber": "6204440090",

                     "Remark": "中国(China)"

              }, {

                     "EnglishName": "ladys Woven dresses",

                     "ChineseName": "T 恤衫",

                     "Number": 1,

                     "Price": 2.70,

                     "ItemNumber": "6109100010",

                     "Remark": "中国(China)"

              }],

              "AddressReceived": {

                     "Country": "United States Of America(美国)",

                     "Countryid": 14,

                     "Province": "NEW YORK",

                     "Provinceid": "49",

                     "Name": "LEAH VAN SON",

                     "City": "ADDISON",

                     "Email": " 2597618808@qq.com",

                     "Phone": "5857941335",

                     "Companyname": "LEAH VAN SON",

                     "Adress": "211 LAWRENCE STREET",

                     "AdressTwo": null,

                     "Remark": null,

                     "Zipcode": "14801",

                     "Code": "US"

              },

              "IdUser": "2597618808@qq.com",

              "Columns": 1,

              "Weight": 2.0,

              "Proxy": "ceshi201902205988",

              "Bagnumber": "P",

              "Deliveryid": 2007,

              "ChannelsTxt": "DHLA",

              "Product": "Express Worldwide",

              "PackageType": 1,

              "PaymentMethod": 4002,

              "Remark": "ladys Woven dresses",

              "SenderVAT": " ",

              "RecipientsVAT": "dddddd",

              "CustomsDeclared": 2.0,

              "DeclaredValue": 2.0,

              "DeclaredType": "USD",

              "Long": 1,

              "Width": 1,

              "Height": 1

       },

       "wd_SecretKey": {

              "PartnerID": "52192730152",

              "PartnerKey": "D49CDED23518224F659F12B779A342E6",

              "IdUser": "2597618808@qq.com"

       }

}

 

获取渠道json Demo

       dataArray1={"wd_SecretKey": {

                     "PartnerID": "52192730152",

                     "PartnerKey": "D49CDED23518224F659F12B779A342E6",

                     "IdUser": "2597618808@qq.com"

              }     

}

六.测试账号信息

账号:2597618808@qq.com

合作者身份ID:52192730152

KEY值:D49CDED23518224F659F12B779A342E6

所属服务:

集运系统 智能集运系统 转运系统 国际物流系统 小包系统

关键字:
国际物流系统  T7  API  提交订单接口  说明文档  API文档  API说明  API接入  T7国际物流系统会员API文档  API文档 
本文地址:
https://www.56sys.com//help-6101.htm转载请注明出处
上面无信息了
下面无信息了
评论列表

没有相关评论...

演示站 | 视频 | 帮助 | 下载 | 知识 | 链接 | 地图 | 联系 | 招聘 | 留言
Copyright © 2024   深圳市金蚁软件科技有限公司 www.56sys.com  金蚁软件 金蚁云     |  
本网站使用深圳市金蚁软件科技有限公司CMS V2.0制作,软著登第0807507号
物流系统/仓储系统/电商系统/ERP系统开发 国家高新技术企业
销售热线:0755-27211799 (0755)27211700 / 27211799 / 23703700
|