API
创建LMA订单
更新时间: 2024-01-24 17:33:03 访问次数:10181

接口说明

卖家或第三方通过该接口可新增发货单,支持一单多面单
根据业务场景不同使用的仓库编码、Winit产品编码等入参存在差异,需要与商务确认

接口名称

lma.shipment.create

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
sellerOrderNo String(50) Y 卖家订单号
唯一
test120101112342
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
shipDate String() N 预计发货日期
不能小于API推送时间
2019-03-11 12:12:12
shiperMemo String(100) N 备注 Test
productInfo Object Y 产品信息
winitProductCode String(50) Y winitPSC产品编码 OSF710014
serviceOptions Object N 定制服务
isNeedSignature boolean N 是否签名服务
true/false
true
shipper Object Y 发货人信息
iossNo String(128) N IOSS
senderVat String(128) N 发件人VAT
senderEori String(128) N 发件人EORI
pickupAddressCode String(8) Y 虚拟仓库编码 WinitSeller123
receiver Object Y 收货人
countryCode String(50) Y 收件人国家 US
state String(50) N 收件州/省 Texas
city String(50) Y 收件人城市 Humble
postCode String(10) Y 收件人邮编 77346
addressLine1 String(35) Y 收件人地址1 Lde1
addressLine2 String(35) N 收件人地址2 L32
houseNo String(10) O 收件人门牌号
DHL必填
1
receiverName String(50) Y 收件人名字 Json
phoneNo String(20) O 收件人电话 02301234101
email String(60) N 收件人邮箱 123457@12345.com
buyerCompany String(100) N 收件人公司
reciverVatEori String(128) N 收件人VAT/EORI
totalParcelsNumber Numeric(3) N 包裹数量
支持多包裹
1
totalParcelsWeight Numeric(8) N 总包裹重量
单位:KG
值范围:0.01-10000.00
3.2
parcelList Array Y 包裹列表
parcelDesc String(60) N 包裹描述
parcelNo String(20) N 包裹号
唯一
weight Numeric Y 包裹重量 ,单位:KG
值范围:(0.0001-10000.0000) 最多支持四位小数
length Numeric Y 长,单位:cm
值范围:(1-10000)
最多支持二位小数
width Numeric Y 宽,单位:cm
值范围:(1-10000)
最多支持二位小数
height Numeric Y 高,单位:cm
值范围:(1-10000)
最多支持二位小数
merchandiseList Array Y 商品信息列表
merchandiseCode String(255) Y 商品编码
面单展示说明
Z-1
specifications String(255) N 商品规格 1dfa
merchandiseName String(255) N 商品名称 clother
quantity Integer(8) Y 数量 1
hasBattery boolean(10) N 是否含有电池
true/false,不传默认为false
false
isDG String(1) N 是否危险品(Dangerous goods)
Y/N,不传默认为N
N
eBayTransactionId String(30) N ebay交易ID
eBayItemId String(30) N ebay条目ID
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

请求示例

  1. {
  2. "action": "lma.shipment.create",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "data": {
  6. "sellerOrderNo": "test120101112342",
  7. "shiperMemo": "Test",
  8. "shipDate": "",
  9. "totalParcelsNumber": "1",
  10. "totalParcelsWeight": "3.2",
  11. "trackingNo": "",
  12. "productInfo": {
  13. "winitProductCode": "OSF710016"
  14. },
  15. "ebayOrderId": "12111341-1",
  16. "ebaySellerId": "test-1234",
  17. "ebayBuyerId": "test-2341",
  18. "shipper": {
  19. "pickupAddressCode": "LMAUS0001",
  20. "iossNo": "",
  21. "senderVat": "SV001",
  22. "senderEori": "SE001"
  23. },
  24. "receiver": {
  25. "buyerCompany": "",
  26. "receiverVatEori": "RV001",
  27. "receiverName": "Json",
  28. "phoneNo": "02301234101",
  29. "email": "123457@12345.com",
  30. "postCode": "77346",
  31. "countryCode": "US",
  32. "state": "Texas",
  33. "city": "Humble",
  34. "addressLine1": "Lde1",
  35. "addressLine2": "L32",
  36. "houseNo": "1"
  37. },
  38. "parcelList": [
  39. {
  40. "parcelDesc": "parcelDesc",
  41. "parcelNo": "123456790-1",
  42. "weight": "3",
  43. "length": "12.2",
  44. "width": "12.2",
  45. "height": "1.2",
  46. "merchandiseList": [
  47. {
  48. "merchandiseName": "clother",
  49. "merchandiseCode": "Z-1",
  50. "specifications": "1dfa",
  51. "quantity": "1",
  52. "eBayTransactionId": "12341",
  53. "eBayItemId": "1234",
  54. "salePrice": "1.2",
  55. "declaredValue": "13",
  56. "declaredCurrency": "USD",
  57. "declaredNameCn": "SHDF",
  58. "declaredNameEn": "dfa1"
  59. "hasBattery":"false",
  60. "isDG":"Y"
  61. }
  62. ]
  63. }
  64. ]
  65. },
  66. "format": "json",
  67. "language": "zh_CN",
  68. "platform": "OWNERERP",
  69. "sign": "40DD66671E8A97643E80AC5C78A9D7E5",
  70. "client_sign": "09D988D3E8EF631CE1516066ECFFB4A9",
  71. "sign_method": "md5",
  72. "timestamp": "2016-07-1023: 04: 52",
  73. "version": "3.0"
  74. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

名称 类型 必传 说明 示例
orderNo String(40) Y Winit订单号 LMA1469499464727

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "orderNo": "LMA010000000900CN"
  6. }
  7. }
关键词