API
创建LMA订单
更新时间: 2021-06-24 16:50:31 访问次数:6251

接口说明

卖家或第三方通过该接口可新增发货单,支持一单多面单

请求说明
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
trackingNoString(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
email 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收件人地址1Lde1
addressLine2 String(35) N收件人地址2 L32
houseNoString(10)O收件人门牌号
DHL必填
1
totalParcelsNumberNumeric(3)N包裹数量
支持多包裹
1
totalParcelsWeightNumeric(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
请求示例
{
    "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"}
}

                            

关键词