API
创建国内直发小包订单
更新时间: 2021-06-24 16:38:34 访问次数:13493
创建国内直发小包
接口说明

单个新增ISP订单。

环境参数
正式URL https://openapi.winit.com.cn/openapi/service
测试URL https://openapi.sandbox.winit.com.cn/openapi/service
接口名isp.order.createOrder
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
refNo String(60) N 卖家订单号
isAllowRepeat String(60) N 是否允许卖家订单号重复
Y:允许重复(不填写为允许重复)
N:不允许重复
winitProductCode String(60) Y winit产品编码
接口查询小包物流渠道的productCode
dispatchType String(1) Y 发货方式
P:Winit揽收
S:自发快递
T:卖家自送
C:中邮揽收(停用)
D:DHL揽收(停用)
warehouseCode String(10) Y 验货仓Code
接口查询国内验货仓的warehouseCode
shipperAddrCode String(8) Y 寄件人地址Code
接口查询提货地址的code
vatNo String(128) N 发件人税号
支持填写发件人VAT
iossNo String(128) O IOSS
选填,按PSC要求填写
eoriNo String(128) N 发件人EORI
ebaySellerId String(60) O ebay卖家ID
eBay订单必填
pickUpCode String(50) N 捡货条码/备注条码
buyerCompany String(50) N 收件人公司
buyerCountry String(50) Y 收件人国家
buyerState String(20) Y 收件人州
buyerCity String(50) Y 收件人城市
buyerZipCode String(10) Y 收件人邮编
buyerEmail String(60) N 收件人邮箱
buyerName String(50) Y 收件人名字
buyerContactNo String(20) O 收件人电话
buyerHouseNo String(10) N 收件人门牌号
recipientTaxID String(64) N 收件人税号
buyerAddress1 String(100) Y 收件人地址1
buyerAddress2 String(100) N 收件人地址2
packageList包裹列表
length Numeric(4,2) Y 长(CM)
width Numeric(4,2) Y 宽(CM)
height Numeric(4,2) Y 高(CM)
weight Numeric(4,6) Y 总重量(KG)
packageList.merchandiseList商品列表(配货单明细)
merchandiseCode String(100) N 商品sku
declaredNameCn String(100) Y 申报品名(中文)
declaredNameEn String(100) Y 申报品名(英文)
declaredValue Numeric(8,2) Y 单个商品申报价格(USD)
hsCodeString(32)
O 海关申报编码

transactionID String(30) O ebay交易ID
eBay订单必填
itemID String(30) O ebayItemID
eBay订单必填
merchandiseQuantity Long N 商品数量
goodsLocation String(20) N 库位
请求示例
{
    "action": "isp.order.createOrder",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "DFF0A6FC0AFDB044ED19E7C213C9D3BB",
    "data": {
        "winitProductCode": "WP-MYP002",
        "dispatchType": "S",
        "shipperAddrCode": "test110",
        "warehouseCode": "YW10000009",
        "refNo": "卖家订单号",
        "ebaySellerId": "bessky_cn",
        "isAllowRepeat": "Y",
        "vatNo": "GB123456789",
         "iossNo": "",
        "eoriNo": "GB012345678912",
        "pickUpCode": "123testremark",
         "buyerCompany":"",
        "buyerCountry": "US",
        "buyerState": "HI",
        "buyerCity": "Honolulu",
        "buyerZipCode": "96816-3343",
        "buyerEmail": "abc@winit.com.cn",
        "buyerName": "COCO",
        "buyerContactNo": "13800001111",
        "buyerHouseNo": "1",
        "recipientTaxID": "",
        "buyerAddress1": "3944 Sierra Dr",
        "buyerAddress2": "",
        "packageList": [
            {
                "length": "2",
                "width": "1.23",
                "height": "1.23",
                "weight": "1.23",
                "merchandiseList": [
                    {
                        "merchandiseCode": "IPhone X",
                        "declaredNameCn": "苹果手机12345",
                        "declaredNameEn": "ihpone",
                        "declaredValue": "10.23",
                        "hsCode": "3924100090",
                        "itemID": "110",
                        "transactionID": "1234567890",
                        "merchandiseQuantity": "2",
                        "goodsLocation": "测试库存"
                    }
                ]
            }
        ]
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "B60D8C0AA9598A91F041968D5971A0E1",
    "sign_method": "md5",
    "timestamp": "2016-03-22 19:26:41",
    "version": "1.0"
}
返回出参
名称 类型 必填 说明 示例
orderNo String(60) Y winit订单号
trackingNo String(60) Y 跟踪号
返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "orderNo": "ID15270000000487ZZ",
      "trackingNo": "AT06031845335CN"
   }
}