提交订单

API名称 提交订单
描述 提交小包发货订单
URL http://www.mgoship.com/api.php?op=storage&mod=tms_orders&action=add_tms_order
接口测试 http://test.mgoship.com//api.php?op=storage&mod=tms_orders&action=add_tms_order
数据格式 JSON
方法 HTTP POST
请求参数
名称 类型 必选 说明
params Array
-| consignee Array 收件人信息
--| address String(200) 详细地址(日文)
--| buyerid String(50) 买家ID
--| company String(100) 公司名称
--| email 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 海关编码(例:9405409990)
--| 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 保价金额(元)。如选择购买保险,此字段必填,例如:500.00
--| shipmenttype int 货物类型, 1:礼品,2:文件,3:商品货样,4:其他
--| shipway String 运输方式:GH; (挂号小包)
--| weight float 重量(kg),例如:0.580(小数点后三位)
请求示例
{
	"appid": "M10001",
	"sign": "EC3827D98DDF688CDA3189E75174CDE3B706FD05",
	"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": 2,
			"unitprice": "2.00"
		}, {
			"cnname": "耳机",
			"enname": "IN EARPHONE",
			"hscode": "890238908",
			"material": "Metal,Plastic",
			"qty": 1,
			"unitprice": "5.00"
		}],
		"order": {
			"customerno": "A000091906080D9A",
			"hasbattery": "N",
			"insurance": "NO",
			"shipmenttype": "4",
			"shipway": "GH",
			"weight": "0.351"
		}
	}
}
返回结果
名称 说明
status 状态参数
code API访问状态编码,如果成功返回"OK",并返回结果字段,如果失败返回错误编码"ERROR",并返回错误说明
msg 返回状态说明
data 数据参数
status 订单状态:1.草稿 2.已预报 3.已入库 4.库内作业中 5.已出库 6.已派送 7.已完成
orderNo 订单号
trackno 服务商单号
labelUrl 运单PDF文件Url
结果示例
{
    "status": {
        "code": "OK", 
        "msg": [
            "订单提交成功"
        ]
    }, 
    "data": {
        "status": 2, 
        "orderNo": "112743284828", 
        "trackno": "2781356000194"
        "labelUrl": "http://www.mgoship.com/label/20181204/112743284828.pdf"
    }
}