开发者文档
创建ISP订单新接口(中国出口)

接口说明

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

使用场景

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

 

请求说明

URL

http://openapi.winit.com.cn/openapi/service

接口测试

http://openapi.sandbox.winit.com.cn/openapi/service

请求方法

action:isp.order.createOrder

验证方式

Token,md5

格式

json

http请求方式

http,post

请求数限制

默认每分钟300,有需要可以申请加大

 

请求入参

名称

类型

必填

说明

示例

refNo

String(60)

N

卖家订单号


winitProductCode

String(60)

Y

winit产品编码


warehouseCode

String(10)

Y

仓库Code,必须填写

【发货方式】为“自发快递”则【仓库Code】必填;

如果【发货方式】为其他则【仓库Code】自动取【寄件人地址code】绑定的默认仓库,但仍须填写经审核的仓库


dispatchType

String(1)

Y

发货方式

P:winit揽收  S:自发快递

 

(中邮揽收只能用于中邮产品)


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

以下字段为packageList子节点

Y

包裹列表


-|packageDesc

String(60)

Y

包裹描述


-|weight

Numeric(10,2)

Y

重量(KG)


-|length

Numeric(10,2)

Y

长(CM)


-|width

Numeric(10,2)

Y

宽(CM)


-|height

Numeric(10,2)

N

高(CM)


-|merchandiseList

以下字段为merchandiseList子节点

Y

商品列表


-|-|transactionID

String(30)

N

交易ID(eBay订单必填)


-|-|itemID

String(30)

N

条目ID(eBay订单必填)


-|-|declaredValue

Numeric(10,2)

Y

单个商品申报价格(USD)


-|-|declaredNameCn

String(100)

Y

申报品名(中文)


-|-|merchandiseQuantity

Numeric(10,2)

N

商品数量


返回出参

名称

类型

说明

示例

 orderNo

 String(60)

 ISP 订单号


 trackingNo

 String(60)

 跟踪号


 

请求示例

{
    "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,
                        "transactionID":110,
                        "merchandiseQuantity":2

                    }
                ]
,
                "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"
}

返回参数说明

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

}

正确的返回结果:出库单号,跟踪号。

错误的返回结果:错误码,错误信息

错误代码错误信息(中文)错误信息(英文)解决方案
01030241030未签署合同不允许使用该产品,请进入万邑联个人中心-个人资料中签订线上中国邮政平常小包服务协议后再下单Product   is not available without a contract. Please sign the service agreement of   'ChinaPost Packet+' product through 'My Center'-'My Profile' before placing   orders.使用该产品下单前+客户需进入万邑联个人中心签署线上合同,请完成操作后重新请求
01030241028您的账号不允许使用该产品,建议使用其他产品下单,如有问题请反馈我们Your   account is not allowed to use the product, we recommend the use of other   single product, any questions please us feedback当前客户已被限制使用此产品,更换产品后重新请求,如需使用联系销售经理或客服
03010250007当前用户不是isp用户The   current user is not the isp user未开通ISP服务,请客户联系销售经理或客服
01030241029此产品为测试产品,仅支持部分客户下单,建议使用其他产品,如有问题请反馈我们This   item is for testing products, supports only a single part of the customer, it   is recommended to use other products, any questions please us feedback此产品为测试产品,仅支持部分客户下单,更换产品下单,如需使用联系销售经理或客服
01030241008账户余额不足,请充值Insufficient   balance. Please recharge your account.当前客户账号余额已不足,联系客户登录万邑联充值后重新请求
01030241012TrancationId[{0}]、ItemID[{1}]信息重复,请核对后下单Duplicate   Information in TrancationId[{0}] and ItemID[{1}]. Please place the order   after recheck.TrancationId[{0}]、ItemID[{1}]信息已被其他订单使用,请核对或修改,如需继续使用需作废原订单
01030243058当前winit产品只支持ebay订单,Ebay   Seller ID,TransactionId和ItemId不能为空Current   winit product only support eBay orders, Ebay Seller ID,TransactionId and   ItemId not be empty当前winit产品只支持ebay订单,请正确填写Ebay   Seller ID,TransactionId和ItemId后重新请求
01030243060Ebay校验失败(TransactionId:{0}、itemId:{1}   填写有误),该winit产品仅支持ebay订单The   Ebay validation failed (the TransactionId:{0} and itemId:{1} you entered are   incorrect). This Winit product supports only Ebay orders.正确填写Ebay Seller   ID,TransactionId和ItemId后重新请求
01030243064Item   ID,TransactionID只能为数字类型Item   ID,TransactionID can only be numeric typeItem   ID,TransactionID仅支持数字格式,修改后重新请求
01030243061调用ebay订单校验接口,ebay订单校验不通过,{0}{0}ebay实时验证异常,根据提示修改数据后重新请求
01030243062Ebay账号填写有误或未在winit绑定该账号The   Ebay account you entered is incorrect or not bound to Winit.当前客户下单使用的ebay Seller   ID未在万邑联绑定或填写错误,修改后重新请求
01030243059Seller   ID、Item ID、TransactionID不匹配,请核对后重新输入Current   winit product only support eBay orders修改字段值后重新请求
01030241003Winit产品code[{0}]有误,请核对后重新输入The   code [{0}] of Winit  products you   entered is incorrect. Please check and try again.此winit产品code不存在或已下架,请联系Winit   IT更新数据,或调用【查询WINIT产品】获取信息
02030240058验货仓{0}填写有误或未填写,请核对Warehouse:{0}   dones not exist此验货仓code不存在或已暂停服务,请联系Winit   IT更新数据,或调用【查询验货仓】获取信息
01030241006订单规则校验不通过:{0}{0}按照正确规则提示修改后重新请求
01030241027Winit产品不支持该发货方式Winit   product does not support the way of delivery此winit产品对应的发货方式填写有误,核对修改后重新请求
01030241004Winit产品所配置的组织或服务出现异常,请联系客服处理Exceptions   found in the organizations or services configured in the Winit products.   Please contact customer service.此产品或服务不支持派送,请更换Winit产品后重新请求。
01030240006寄件人/提货地址编码不存在,请核对后重新输入或进入地址管理查看The   shipper/pick-up address code does not exist. Please check and try again, or   view details in the Address Management.当前客户提交的寄件/提货地址code有误,登陆万邑联核对修改后重新请求
01030241025提货地址未审核,审核未通过或验货仓不匹配Delivery   address is not audited, the audit did not pass or check the warehouse does   not match当前客户提交的寄件/提货地址code未审核或审核不通过,请修改后重新请求或联系客服
02030240006计算费用失败:{0}Cacl   fee failed:{0}此产品或服务不支持派送,请更换Winit产品后重新请求。
02030240064此地址/邮编无法送达!This   address/zip code could not be served此产品或服务不支持派送至此邮编/地址,请更换产品服务
02030240057Winit产品不支持派送该地址,请联系客服处理WinitProduct:{0}   does not belong to inspection warehouse:{1}此产品或服务不支持派送至此地址,请更换产品服务
02010250001字段[{0}]不能为空The   field[{0}] can not null填写相应字段值后重新请求
01030240019英文寄件人地址长度不能超过70The   length of the english address must be less {0}修改字段值长度后重新请求
02010250003字段[{0}]类型错误The   type of the field [{0}] is wrong{字段}的类型填写有误,修改后重新请求
01030241002收件人国家[{0}]填写有误,请核对后重新输入The   receiver's country [{0}]name you entered is incorrect. Please check and try   again.收件人国家应正确填写二字代码,修改后重新请求
02010250042字段[{0}]不能大于[{1}]The   field[{0}] can not greater than [{1}]根据提示修改字段值后重新请求
02010250002字段[{0}]长度不能超过{1}The   length of the field[{0}] must be less {1}根据提示修改字段值后重新请求
02010250005邮箱[{0}]格式错误The   format of email[{0}] error正确填写邮箱后重新请求
02010250010[{0}]   输入值必须大于0[{0}]   input value can not less than 0按照正确规则提示修改后重新请求
02010250048字段{0}整数位超过长度{1}Field   {0} integer bit over length {1}按照正确规则提示修改后重新请求
02010250049字段{0}小数位超过长度{1}Field   {0} decimal number over length {1}按照正确规则提示修改后重新请求
02010250110字段[{0}]只允许填写0-9的数字Field[{0}]   is only allowed to fill in the number of 0-9按照正确规则提示修改后重新请求
01030241018英文品名格式有误,仅支持英文字母、半角字符及数字The   format of the product's English name you entered is incorrect. Please enter   only English letters, half-width characters and numbers.按照正确规则提示修改后重新请求
01030240003,01030240001系统异常,请您稍后重试或联系客服处理!System   is abnormal, Please try again later or contact customer service processing!稍后重新发起请求,如长时间出现此问题请联系Winit IT
说明:{0},{1}都表示提示信息中的参数值