| 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"
}
}