API名称 | 修改订单 |
描述 | 通过订单号orderNo,可修改状态在1.草稿、2.已预报中的订单信息。 |
URL | http://www.mgoship.com/api.php?op=storage&mod=tms_orders&action=edit_tms_order |
接口测试 | http://test.mgoship.com//api.php?op=storage&mod=tms_orders&action=edit_tms_order |
数据格式 | JSON |
方法 | HTTP POST |
请求参数
名称 | 类型 | 必选 | 说明 |
---|---|---|---|
params | Array | 是 | |
-| consignee | Array | 是 | 收件人信息 |
--| address | String(200) | 是 | 详细地址(日文) |
--| buyerid | String(50) | 否 | 买家ID |
--| company | String(100) | 否 | 公司名称 |
String(50) | 否 | 邮箱 | |
--| mobile | int(20) | 否 | 手机号 |
--| name | String(50) | 是 | 收件人姓名(日文) |
--| phone | int(20) | 是 | 联系电话 |
--| postcode | int(10) | 是 | 邮政编码(例:901-1515) |
--| region | String(30) | 是 | 收货地区(例:沖縄県)(日文) |
-| declare | Array | 是 | 海关申报品 |
--| cnname | String(50) | 否 | 中文品名 |
--| enname | String(50) | 是 | 英文品名 |
--| hscode | String(20) | 是 | HS CODE 海关编码 |
--| material | String(50) | 是 | 产品材质(英文) |
--| note | String(30) | 否 | 配货备注 |
--| pickupname | String(30) | 否 | 配货信息 |
--| qty | int | 是 | 数量 |
--| unitprice | float | 是 | 单价(USD),例如:5.10(小数点后两位) |
-| order | Array | 是 | 基本信息 |
--| customerno | String(30) | 否 | 客户自定义单号(不传值,原系统生成单号将不修改) |
--| hasbattery | String | 是 | 是否带电池,Y:是,N:否 |
--| insurance | String | 是 | 如购买保险,NO:不购买,5Y:5元每票,6P:0.6%保费 |
--| insvalue | float | 否 | 保价金额(元)。如选择购买保险,此字段必填,例如:5.10(小数点后两位) |
--| orderNo | int | 是 | 订单号 |
--| shipmenttype | int | 是 | 货物类型, 1:礼品,2:文件,3:商品货样,4:其他 |
--| shipway | String | 是 | 运输方式:GH |
--| status | int | 否 | 订单状态。订单状态修改至1:草稿,2:已预报 |
--| stop | int | 否 | 是否拦截订单。0:取消拦截,1:拦截订单 |
--| weight | float | 否 | 重量(kg),例如:0.580(小数点后三位) |
请求示例
{
"appid": "M10001",
"sign": "838D30FB22FE09D0D8D6DE4C194AF176DC55C860",
"version": "1.0",
"params": {
"consignee": {
"address": "秋田市八橋本町3-14-14",
"company": "歯科医院",
"name": "田中 裕美",
"phone": "0188646322",
"postcode": "103-4520",
"region": "秋田県"
},
"declare": [{
"cnname": "WiFi放大器",
"enname": "WiFi Amplifier",
"hscode": "9620009900",
"material": "Metal,Plastic",
"qty": 1,
"unitprice": "2.00"
}, {
"cnname": "耳机",
"enname": "IN EARPHONE",
"hscode": "890238908",
"material": "Metal,Plastic",
"qty": 1,
"unitprice": "5.00"
}],
"order": {
"customerno": "A000091906080D9A",
"hasbattery": "N",
"insurance": "NO",
"orderNo": "122022930777",
"shipmenttype": "4",
"shipway": "GH",
"weight": "0.351"
}
}
}
返回结果
名称 | 说明 | |
---|---|---|
status 状态参数 | ||
code | API访问状态编码,如果成功返回"OK",并返回结果字段,如果失败返回错误编码"ERROR",并返回错误说明 | |
msg | 返回状态说明 | |
data 数据参数 | ||
status | 订单状态:1.草稿 2.已预报 | |
orderNo | 订单号 | |
trackno | 服务商单号 | |
labelUrl | 运单PDF文件Url |
结果示例
{
"status": {
"code": "OK",
"msg": [
"订单修改成功"
]
},
"data": {
"status": 2,
"orderNo": "122022930777",
"trackno": "569440926682"
"labelUrl": "http://www.mgoship.com/label/20200220/122022930777.pdf"
}
}