接口说明

通创建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

请求示例

{
    "action": "lma.shipment.createOrderSync",
    "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": "1.0"
}

返回出参

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

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

返回示例

{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "orderNo": "LMA0100000000314CN",
        "barcodeNo": "420773469205590332390200000000039",
        "trackingNo": "9205590332390200000039"
    }
}

关键词