API
1. API 账号
使用API账号时，可以联系IT同事直接开通API账号。也可以选择使用T-OMS账号登录后自行开通
用户-API设置，进入页面后，点击新增秘钥，会更新API的token和key值，点击复制即可使用。
新增完成后，会看到左上角更新的API信息。
2. API 网址
SOAP请求地址
正式线：https://toms.sweip.com/default/svc/wsdl
REST请求地址
正式线：https://toms.sweip.com/default/svc/web-service
3. API 处理模块示例
1. 创建订单
- createOrder
请求JSON
JSON
{
"reference_no": "TEST0001",
"shipping_method": "PK0001",
"country_code": "PL",
"order_weight": 0.175,
"order_pieces": 1,
"reference_id": "461983",
"shipment_id": "1235646",
"POANumber": "64613135",
"Consignee": {
"consignee_street": "consignee street1",
"consignee_street2": "consignee street2",
"consignee_name": "consignee name",
"consignee_telephone": "48731271276",
"consignee_postcode": "32020",
"consignee_province": "consignee province",
"consignee_city": "consignee city"
},
"Shipper": {
"shipper_countrycode": "CN",
"shipper_province": "GuangDong",
"shipper_city": "ShenZhen",
"shipper_street": "Kengzi street",
"shipper_postcode": "518000",
"shipper_name": "Wang",
"shipper_telephone": "951218",
"shipper_mobile": "13800138000"
},
"ItemArr": [{
"invoice_cnname": "甲油胶",
"invoice_enname": "Nail Gel Polish",
"invoice_weight": "0.033",
"invoice_quantity": "1",
"invoice_unitcharge": "0.59",
"hs_code": "3506100090",
"invoice_brand": "服装",
"sku": "215131101",
"box_number":"U001"
}, {
"invoice_cnname": "甲油胶",
"invoice_enname": "Nail Gel Polish",
"invoice_weight": "0.028",
"invoice_quantity": 5,
"invoice_unitcharge": "0.54",
"hs_code": "3506100090",
"invoice_brand": "电子",
"sku": "227652501",
"box_number":"U002"
}],
"Volume": [{
"length": "10",
"width": "20",
"height": "30",
"weight": "1.25",
"box_number": "U001",
"child_number": "TEST1234U001"
},
{
"length": "10",
"width": "20",
"height": "30",
"weight": "1.25",
"box_number": "U002",
"child_number": "TEST1234U002"
}]
}响应JSON
JSON
{
"ask": "Success",
"message": "Success",
"reference_no": "TEST0001",
"shipping_method_no": "LZ251182095CN",
"order_code": "EC20188041602884YQ",
"track_status": 1,
"sender_info_status": 1,
"ODA": "",
"agent_number": "",
"system_number": "",
"time_cost(s)": "0.437490940094"
}JSON
{
"ask": "Failure",
"message": "订单数据不合法",
"reference_no": "TEST0002",
"Error": {
"errMessage": "服务异常[EC20188041602885YQ]换号失败。输入验证失败：收货人所在州参数长于最大长度,错误代码：202",
"errCode": "50048"
},
"time_cost(s)": "0.6406359672546"
}2. 获取标签
- getLabelUrl
请求JSON
JSON
{"reference_no":"TEST180417007","label_type":"2"}响应JSON
JSON
{
"ask": "Success",
"message": "Success",
"Error": {
"errCode": "",
"errMessage": ""
},
"type": "pdf",
"url": "http:\/\/127.0.0.1:10001\/PDF\/74ab766f-0de5-4af7-96a6-d9527a2e0c7e.pdf",
"reference_no": "123456789",
"time_cost(s)": 0.1
}3. 轨迹查询
- getCargoTrack
请求JSON
JSON
{"codes":["QGAMEX18041600000033"]}响应JSON
JSON
{
"ask": "Success",
"message": "Success",
"Data": [{
"Code": "QGAMEX18041600000033",
"Country_code": "AM",
"New_date": "2018-04-16 21:47:52",
"New_Comment": "快件到达深圳仓库 Arrived AT Sort Facility SHENZHEN - CHINA, PEOPLES REPUBLIC",
"Status": "DF",
"Detail": [{
"Occur_date": "2018-04-16 21:47:52",
"Comment": "快件到达深圳仓库 Arrived AT Sort Facility SHENZHEN - CHINA, PEOPLES REPUBLIC",
"track_area": "安道尔 test1 test1"
}, {
"Occur_date": "2018-04-16 21:46:50",
"Comment": "快件到达目的地国家 Shipmnet arrived at destination country",
"track_area": "安道尔 test3 test3"
}, {
"Occur_date": "2018-04-16 20:47:52",
"Comment": "快件到达作业中心 Express Arrive at The Job Center",
"track_area": "SHENZHEN"
}, {
"Occur_date": "2018-04-16 20:47:52",
"Comment": "快件操作完成 Express Operation Is Complete",
"track_area": "SHENZHEN"
}, {
"Occur_date": "2018-04-16 17:50:15",
"Comment": "快件电子信息已经收到 Shipment information received",
"track_area": ""
}],
"CreateBy": "ceshizhuanyong",
"WaybillNumber": "QGAMEX18041600000033",
"TrackingNumber": "TEST180416045"
}],
"Error": [],
"time_cost(s)": 0.7271420955658
}
根据实际需要选择对接的模块
4. API 文档
上面列举了常用的模块对接和报文信息，如果需要对接，请参考完整的API 文档
5. 马帮ERP绑定
针对一些使用马帮ERP的客户，可以直接通过马帮ERP绑定说明，绑定配置后，自动下单到T-OMS