万邑通开发者网站 - 创建LMA订单

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
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
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	收件人地址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

请求示例

Json

{
    "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

返回示例

Json

{
   "code": "0",
   "msg": "操作成功",
   "data": {"orderNo": "LMA010000000900CN"}
}

关键词

创建LMA订单