API
创建LMA订单-sync
更新时间: 2024-01-24 17:32:56 访问次数:1607

接口说明

通创建LMA订单,同步抓单接口。仅支持部分供应商服务,详询客服
调用此接口在创建时即需校验订单信息并同步抓取面单,若匹配失败或抓取失败则下单失败

使用场景

此接口与lma.shipment.create(异步抓单)入参一致,二选一调用即可

接口名称

lma.shipment.createOrderSync

请求说明

请求内容 说明
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.createOrderSync",
  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. "eBayTransactionId": "12341",
  49. "eBayItemId": "1234",
  50. "merchandiseName": "clother",
  51. "merchandiseCode": "Z-1",
  52. "specifications": "1dfa",
  53. "quantity": "1",
  54. "salePrice": "1.2",
  55. "declaredValue": "13",
  56. "declaredCurrency": "USD",
  57. "declaredNameCn": "SHDF",
  58. "declaredNameEn": "dfa1"
  59. }
  60. ]
  61. }
  62. ]
  63. },
  64. "format": "json",
  65. "language": "zh_CN",
  66. "platform": "OWNERERP",
  67. "sign": "40DD66671E8A97643E80AC5C78A9D7E5",
  68. "client_sign": "09D988D3E8EF631CE1516066ECFFB4A9",
  69. "sign_method": "md5",
  70. "timestamp": "2016-07-1023: 04: 52",
  71. "version": "1.0"
  72. }

返回出参

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

名称 类型 必传 说明 示例
orderNo String(40) Y Winit订单号 LMA1469499464727
trackingNo String(128) Y 跟踪号 9205590332390200000039
barcodeNo String(128) N 面单条码
注:USPS未被截取的跟踪号
420773469205590332390200000000039

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "orderNo": "LMA0100000000314CN",
  6. "barcodeNo": "420773469205590332390200000000039",
  7. "trackingNo": "9205590332390200000039"
  8. }
  9. }
关键词