API
创建订单v3.0(lma.shipment.create)
更新时间: 2019-09-17 14:24:20 访问次数:1403

接口说明

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

接口英文名称

lma.shipment.create

使用场景

卖家或第三方通过该接口可新增货单

备注

注意以下物流渠道,下单后大概2小时左右才能获取面单,所以建议卖家和第三方ERP在使用以下渠道时,没有抓取到面单文件,请继续抓取,持续抓取24小时。
物流渠道编码 物流渠道名称
OSF711003533 USPS First Class Package-LMA917
OSF711003548 USPS First Class Package-LMA917

常见报错:
"code" : "02010250089", "msg" : "Remote call [postkeeper] Vendor [LABEL] service exception, please contact your system administrator, related no [LMA010024129735CN], exception information: [02033502058]: 02033502039", "data" : ""

建议:
1.以上两个渠道,获取面单要在创建订单成功后2小时开始
2.当查询面单中返回报错code=02010250089,代表面单未生成,请继续请求,持续请求至订单创建时间后的48小时。

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
接口名lma.shipment.create
版本3.0
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
根据使用的PSC不同,部分PSC为必填,比如:OSF711002684(可咨询商务该PSC是否需要预先分配快递单号)
名称 类型 必填 说明 示例
sellerOrderNo String(50) Y 卖家订单号 唯一标识,禁止重复
shipDate String() Y 发货日期 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 备注,部分物流渠道的备注将打印在面单上。
产品信息 productInfo
winitProductCode String(50) Y winit PSC产品编码,每个物流渠道的PSC编码不一样,请以业务提供的为准 OSF710014
发货人信息shipper
pickupAddressCode String(8) Y 虚拟仓库编码,请以业务提供的为准 WinitSeller123
定制服务serviceOptions
isNeedSignature boolean N true or false,如果所选PSC不支持signature,则必须填true true
收货人receiver
receiverName String(50) Y 收件人名字
phoneNo String(20) Y 收件人电话
email String(60) N 收件人邮箱
postCode String(10) Y 收件人邮编
countryCode String(50) Y 收件人国家,收件人国家名称,可使用国家英文全称或是ISO国家代码,和海外仓API保持一致 AU
state String(50) N收件人区州,和海外仓出库创建出库单API保持一致
city String(50) Y收件人城市
addressLine1 String(35) Y收件人地址第一行
addressLine2 String(35) N收件人地址第二行
houseNo String(10) O收件人门牌号,如果派送方式为DHL,门牌号必填
totalParcelsNumber Numeric(3)  N包裹数量,国际派送只能一个包裹,英国Parcel force的国内派送方式支持多个包裹
totalParcelsWeight Numeric(8)  N总包裹重量,单位:KG(值范围:0.00-10000.00)
包裹列表  parcelList
-|parcelDesc String(60) N包裹描述
-|parcelNo String(60) N包裹号
包裹号禁止重复,不能超过20位字符
-|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)
-|merchandiseList Array 商品列表
以下为merchandiseList的子节点,如果需要国际派送发票则以下内容要填写
-|-|eBayTransactionId String(30) N ebay交易ID
-|-|eBayItemId String(30) N ebay条目ID
-|-|merchandiseName String(255) N 商品名称
-|-|merchandiseCode String(255) Y 商品编码
-|-|hasBattery boolean(10) N 是否含有电池,按PSC要求填写,请以业务为准
-|-|quantity Integer(8) Y 数量,按PSC要求填写,请以业务为准
-|-|specifications String(255) N 商品规格
-|-|salePrice Numberic N 售价
-|-|saleCurrency String(10) N 销售币种
-|-|declaredValue Numeric(10,2) Y 申报价格,按PSC要求填写,请以业务为准
-|-|declaredCurrency String(10) Y 申报币种,按PSC要求填写,请以业务为准
-|-|declaredNameCn String(100) Y 申报品名(中文),按PSC要求填写,请以业务为准
-|-|declaredNameEn String(30) Y 申报品名(英文),按PSC要求填写,请以业务为准
请求示例
{
    "action":"lma.shipment.create",
    "app_key":"rebecca",
"client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "data":{
        "sellerOrderNo":"test123450101112342",
		"shiperMemo":"Test",
        "shipDate":"2016-07-11 12:12:12",
        "totalParcelsNumber":"1",
        "totalParcelsWeight":"3.2",
        "trackingNo":"",
        "productInfo":{
            "winitProductCode":"OSF710014"
        },
        "ebayOrderId":"12111341-1",
        "ebaySellerId":"test-1234",
        "ebayBuyerId":"test-2341",
        "shipper":{
            "pickupAddressCode":"WinitSeller123"
        },
        "receiver":{
            "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-0",
                "weight":"12.2",
                "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":"193425E81310A302EFCCA3EA8C908C44",
   "client_sign":"D16E0770B1A7D71A2796F7A9BCCC979C",
    "sign_method":"md5",
    "timestamp":"2016-07-1023: 04: 52",
    "version":"3.0"
}

                            
返回出参
名称 类型 必填 说明 示例
orderNo String(40) Y Winit订单号 LMA1469499464727
返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data": {"orderNo": "LMA010000000900CN"}
}