API
ISP05.创建ISP订单(中国出口)
更新时间: 2017-11-22 18:41:26 访问次数:701
接口说明

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

使用场景

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

备注

请求说明
URL http://api.winit.com.cn/ADInterface/api
接口测试 http://erp.sandbox.winit.com.cn/ADInterface/api
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
refNo String(60) N 卖家订单号
winitProductCode String(60) Y winit产品编码,即物流产品代码
warehouseCode String(10) Y 仓库Code,必须填写,取【寄件人地址code】审核的的验货仓库
dispatchType String(1) Y 发货方式【P:Winit揽收、S:自发快递、T:卖家自送、C:中邮揽收、D:DHL揽收】,不同物流渠道要求与提交的“寄件/提货地址“的审核情况而定,审核通过选择【Winit揽收】,审核不通过使用【自发快递、卖家自送】,其它2个是特殊渠道的揽收方式
shipperAddrCode String(8) Y 寄件人地址code
buyerName String(50) Y 收件人名字
buyerContactNo String(20) Y 收件人电话
buyerEmail String(30) 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) N ebay卖家ID(eBay订单必填)
buyerHouseNo String(10) N 收件人门牌号
pickUpCode String(50) N 捡货条码
packageList Array 包裹列表,以下字段为packageList子节点
--|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) N 交易ID(eBay订单必填)
--|--|itemID String(30) N 条目ID(eBay订单必填)
--|--|declaredValue Numeric(10,2) Y 单个商品申报价格(USD)
--|--|declaredNameCn String(100) Y 申报品名(中文)
--|--|declaredNameEn String(100) Y 申报品名(英文)
--|--|merchandiseQuantity Long N 商品数量
请求示例
{
    "action":"isp.order.createOrder",
    "app_key":"rebecca",
    "data":{
        "buyerAddress1":"abc",
        "buyerAddress2":"",
        "buyerCity":"LA",
        "buyerContactNo":"13800001111",
        "buyerCountry":"UK",
        "buyerEmail":"abc@winit.com.cn",
        "buyerHouseNo":"1",
        "buyerName":"COCO",
        "buyerState":"CA",
        "buyerZipCode":"90001",
        "dispatchType":"P",
        "ebaySellerId":"bessky_cn",
        "packageList":[
            {
                "height":"1.23",
                "length":"1.23",
                "merchandiseList":[
                    {
                        "declaredNameCn":"苹果手机",
                        "declaredNameEn":"ihpone",
                        "declaredValue":"10.23",
                        "itemID":110,
                        "merchandiseQuantity":2,
                        "transactionID":110
                    }
                ],
                "weight":"1.23",
                "width":"1.23"
            }
        ],
        "pickUpCode":"111111",
        "refNo":"AUTO1002",
        "shipperAddrCode":"TEST222",
        "warehouseCode":"YW10000008",
        "winitProductCode":"WP-CNP007"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SW-S",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2016-03-21 19:26:41",
    "version":"1.0"
}

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

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

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