接口说明

卖家或第三方通过该接口可新增发货单,支持一单多面单
根据业务场景不同使用的仓库编码、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
totalParcelsNumber	Numeric(3)	N	包裹数量支持多包裹	1
totalParcelsWeight	Numeric(8)	N	总包裹重量单位：KG 值范围：0.01-10000.00	3.2
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(32)	Y	收件人地址1	Lde1
addressLine2	String(32)	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
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

请求示例

{
    "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": [
                    {
                        "merchandiseName": "clother",
                        "merchandiseCode": "Z-1",
                        "specifications": "1dfa",
                        "quantity": "1",
                        "eBayTransactionId": "12341",
                        "eBayItemId": "1234",
                        "salePrice": "1.2",
                        "declaredValue": "13",
                        "declaredCurrency": "USD",
                        "declaredNameCn": "SHDF",
                        "declaredNameEn": "dfa1"
                        "hasBattery":"false",
                        "isDG":"Y"
                    }
                ]
            }
        ]
    },
    "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：0及结果data，错误的返回错误码及错误信息msg。

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

返回示例

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

关键词

创建LMA订单