API
创建LMA订单
更新时间: 2021-06-24 16:50:31 访问次数:6808
接口说明
卖家或第三方通过该接口可新增发货单,支持一单多面单
请求说明
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
接口名 | lma.shipment.create |
版本 | 3.0 |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
sellerOrderNo | String(50) | Y | 卖家订单号
唯一 |
test120101112342 |
shipDate | String() | N | 预计发货日期
不能小于API推送时间 |
2019-03-11 12:12:12 |
trackingNo | String(50) | O | 快递单号 | |
eBayOrderId | String(50) | N | ebay订单号 ebay订单必填 |
12111341-1 |
eBaySellerId | String(50) | N | ebay卖家ID ebay订单必填 |
test-1234 |
eBayBuyerId | String(50) | N | ebay买家ID ebay订单必填 |
test-23456 |
shiperMemo | String(100) | N | 备注 | Test |
产品信息 productInfo | ||||
winitProductCode | String(50) | Y | winitPSC产品编码 | OSF710014 |
发货人信息shipper | ||||
iossNo | String(128) | N | IOSS | |
senderVat | String(128) | N | 发件人VAT | |
senderEori | String(128) | N | 发件人EORI | |
pickupAddressCode | String(8) | Y | 虚拟仓库编码 | WinitSeller123 |
定制服务serviceOptions | ||||
isNeedSignature | boolean | N | 是否签名服务
true/false |
true |
收货人receiver | ||||
buyerCompany | String(100) | N | 收件人公司 | |
reciverVatEori | String(128) | N | 收件人VAT/EORI | |
receiverName | String(50) | Y | 收件人名字 | Json |
phoneNo | String(20) | O | 收件人电话 | 02301234101 |
String(60) | N | 收件人邮箱 | 123457@12345.com | |
postCode | String(10) | Y | 收件人邮编 | 77346 |
countryCode | String(50) | Y | 收件人国家 | US |
state | String(50) | N | 收件州/省 | Texas |
city | String(50) | Y | 收件人城市 | Humble |
addressLine1 | String(35) | Y | 收件人地址1 | Lde1 |
addressLine2 | String(35) | N | 收件人地址2 | L32 |
houseNo | String(10) | O | 收件人门牌号
DHL必填 | 1 |
totalParcelsNumber | Numeric(3) | N | 包裹数量
支持多包裹 | 1 |
totalParcelsWeight | Numeric(8) | N | 总包裹重量
单位:KG 值范围:0.00-10000.00 | 3.2 |
包裹列表parcelList | ||||
parcelDesc | String(60) | N | 包裹描述 | |
parcelNo | String(20) | N | 包裹号
唯一 | |
weight | Numeric | Y | 包裹重量
单位:KG 值范围:(0.0000-10000.0000) | |
length | Numeric | Y | 长 单位:cm 值范围:(0-10000) | |
width | Numeric | Y | 宽 单位:cm 值范围:(0-10000) | |
height | Numeric | Y | 高 单位:cm 值范围:(0-10000) | |
商品信息列表parcelList.merchandiseList | ||||
eBayTransactionId | String(30) | N | ebay交易ID | |
eBayItemId | String(30) | N | ebay条目ID | |
merchandiseName | String(255) | N | 商品名称 | clother |
merchandiseCode | String(255) | Y | 商品编码
面单展示说明 |
Z-1 |
hasBattery | boolean(10) | N | 是否含有电池
Y/N |
|
quantity | Integer(8) | Y | 数量 | 1 |
specifications | String(255) | N | 商品规格 | 1dfa |
salePrice | Numberic | N | 售价 | 1.2 |
saleCurrency | String(10) | N | 销售币种 | USD |
declaredValue | Numeric(10,2) | Y | 申报价格 | 13 |
declaredCurrency | String(10) | Y | 申报币种 | |
declaredNameCn | String(100) | Y | 申报品名(中文) | SHDF |
declaredNameEn | String(30) | Y | 申报品名(英文) | dfa1 |
declaredHscode | String(128) | N | 商品海关编码 | 853952000 |
请求示例
{ "action": "lma.shipment.create", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "sellerOrderNo": "test120101112342", "shiperMemo": "Test", "shipDate": "", "totalParcelsNumber": "1", "totalParcelsWeight": "3.2", "trackingNo": "", "productInfo": { "winitProductCode": "OSF710016" }, "ebayOrderId": "12111341-1", "ebaySellerId": "test-1234", "ebayBuyerId": "test-2341", "shipper": { "pickupAddressCode": "LMAUS0001", "iossNo": "", "senderVat": "SV001", "senderEori": "SE001" }, "receiver": { "buyerCompany": "", "receiverVatEori": "RV001", "receiverName": "Json", "phoneNo": "02301234101", "email": "123457@12345.com", "postCode": "77346", "countryCode": "US", "state": "Texas", "city": "Humble", "addressLine1": "Lde1", "addressLine2": "L32", "houseNo": "1" }, "parcelList": [ { "parcelDesc": "parcelDesc", "parcelNo": "123456790-1", "weight": "3", "length": "12.2", "width": "12.2", "height": "1.2", "merchandiseList": [ { "eBayTransactionId": "12341", "eBayItemId": "1234", "merchandiseName": "clother", "merchandiseCode": "Z-1", "specifications": "1dfa", "quantity": "1", "salePrice": "1.2", "declaredValue": "13", "declaredCurrency": "USD", "declaredNameCn": "SHDF", "declaredNameEn": "dfa1" } ] } ] }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "40DD66671E8A97643E80AC5C78A9D7E5", "client_sign": "09D988D3E8EF631CE1516066ECFFB4A9", "sign_method": "md5", "timestamp": "2016-07-1023: 04: 52", "version": "3.0" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
code | String(40) | Y | 响应编码
0正常,非0异常 |
0 |
msg | String(40) | Y | 响应描述 | 操作成功 |
orderNo | String(40) | Y | Winit订单号 | LMA1469499464727 |
返回示例
{ "code": "0", "msg": "操作成功", "data": {"orderNo": "LMA010000000900CN"} }
关键词