万邑通开发者网站 - ISP05.创建ISP订单(中国出口)

API

ISP05.创建ISP订单(中国出口)

更新时间： 2017-11-22 18:41:26 访问次数：809

接口说明

卖家或第三方通过该接口可新增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	商品数量

请求示例

Json
XML

{
    "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	跟踪号

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

返回示例

Json
XML

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

关键词

ISP05.创建ISP订单(中国出口)