API
创建小包订单(中国出口)
更新时间: 2019-09-11 20:29:29 访问次数:6188
接口说明

卖家或第三方通过该接口可新增ISP订单,一次请求仅支持创建一个ISP单。

接口英文名称

isp.order.createOrder

使用场景

卖家或第三方通过该接口可新增ISP订单。

备注

请求说明
正式URL http://openapi.winit.com.cn/openapi/service
测试URL http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
refNo String(60) N 卖家订单号
isAllowRepeat String(60) N 是否允许卖家订单号重复
可选:
不可重复:N
可重复:Y,为空,入参不填
入参不填,则为允许重复,建议必填该入参
winitProductCode String(60) Y winit产品编码
即物流产品代码,通过接口调用查询小包物流渠道接口或者通过页面:开发者-物流代码-海外仓获得
warehouseCode String(10) Y 验货仓Code
通过接口调用查询国内验货仓接口或者通过页面:开发者-物流代码-全球直发快递(ISP)获得
dispatchType String(1) Y 发货方式
P:Winit揽收;需要提交的“寄件/提货地址“为winit揽收并且审核通过;
S:自发快递;提交的“寄件/提货地址“审核不通过;
T:卖家自送;提交的“寄件/提货地址“审核不通过;
C:中邮揽收;需要提交的“寄件/提货地址“为中邮揽收并且审核通过;
D:DHL揽收(限香港);需要提交的“寄件/提货地址“为DHL揽收并且审核通过;
根据物流渠道要求不同,选择不同的发货方式
shipperAddrCode String(8) Y 寄件/提货地址编号
进入万邑联-个人中心-服务设置-地址管理中的寄件/提货地址编号进行查询
buyerName String(50) Y 收件人名字
buyerContactNo String(20) Y 收件人电话
buyerEmail String(60) N 收件人邮箱
buyerZipCode String(10) Y 收件人邮编
buyerCountry String(50) Y 收件人国家
buyerState String(20) Y 收件人州
buyerCity String(50) Y 收件人城市
buyerAddress1 String(100) Y 收件人地址1
buyerAddress2 String(100) N 收件人地址2
ebaySellerId String(60) O ebay卖家ID
eBay订单必填
buyerHouseNo String(10) N 收件人门牌号
pickUpCode String(50) N 捡货条码
packageList Array 包裹列表,以下字段为packageList子节点
--|trackingNo String(60) O 第三方跟踪号
小包正常下单可以不填写

--|weight Numeric(6,2) Y 总重量/包裹总量(KG)
--|length Numeric(6,2) Y 长(CM)
--|width Numeric(6,2) Y 宽(CM)
--|height Numeric(6,2) Y 高(CM)
-|merchandiseList Y 商品列表,以下字段为merchandiseList子节点
--|--|transactionID String(30) O ebay交易ID
eBay订单必填
--|--|itemID String(30) O ebayItemID
eBay订单必填
--|--|declaredValue Numeric(10,2) Y 单个商品申报价格(USD)
--|--|declaredNameCn String(100) Y 申报品名(中文)
--|--|HSCodeString(32)
O 海关申报编码
部分渠道必填,winitProdwuctCodeWP-MYP002、WP-MYP101、WP-MYP001

--|--|merchandiseQuantity Long N 商品数量
--|--|merchandiseCode String(100) N 商品sku 配货单
--|--|goodsLocation String(20) N 库位 配货单
请求示例
{
    "action":"isp.order.createOrder",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"A207E1138CAED6E7616E49FC639CDD03",
    "data":{
        "buyerAddress1":"abc",
        "buyerAddress2":"",
        "buyerCity":"Bolton",
        "buyerContactNo":"13800001111",
        "buyerCountry":"UK",
        "buyerEmail":"abc@winit.com.cn",
        "buyerHouseNo":"1",
        "buyerName":"COCO",
        "buyerState":"North West",
        "buyerZipCode":"BL5 1BT ",
        "dispatchType":"S",
        "ebaySellerId":"bessky_cn",
        "packageList":[
            {
                "height":"1.23",
                "length":"2",
                "merchandiseList":[
                    {
                        "declaredNameCn":"苹果手机12345",
                        "declaredNameEn":"ihpone",
                        "declaredValue":"10.23",
                        "HSCode":"3924100090",
                        "goodsLocation":"A01-002",
                        "itemID":"110",
                        "merchandiseQuantity":"2",
                        "merchandiseCode":"IPhone X",
                        "transactionID":"1234567890"
                    }
                ],
                "trackingNumber":"UJ239014141",
                "weight":"1.23",
                "width":"1.23"
            }
        ],
        "pickUpCode":"111111",
        "refNo":"AUTO1002",
        "shipperAddrCode":"20190036",
        "warehouseCode":"YW10000008",
        "winitProductCode":"ISP041450 "
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"4934F1B5A0BE072333C7E88388F2DA1E",
    "sign_method":"md5",
    "timestamp":"2016-03-22 19:26:41",
    "version":"1.0"
}}

                            
返回出参
名称 类型 必填 说明 示例
orderNo String(60) Y ISP 订单号
trackingNo String(60) Y 跟踪号

正确的返回结果:出库单号,跟踪号。 错误的返回结果:错误码,错误信息

返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "orderNo": "ID15270000000487ZZ",
      "trackingNo": "AT06031845335CN"
   }
}