接口说明

使用本接口可以直接下海外仓入库单至“已下单”状态。
根据入库单类型不同，入参存在差异。填写入参请详细阅读《海外仓入库时序图和API列表》
创建入库单旧和新的区别：新的inspectionWarehouseCode和exportDeclarationType是必填的，
旧已经停止维护，请用户尽快转换使用新的接口

接口名称

winit.wh.inbound.order.create

请求说明

请求内容	说明
URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，1000有需要可申请加大。

请求入参

名称	类型	必填	说明	示例
sellerOrderNo	String(50)	N	客户订单号
orderType	String(30)	Y	订单类型编码 SD：标准海外仓入库 DW：直发海外验入库 DI：直发国内验入库	SD
winitProductCode	String(32)	Y	Winit产品编码 取[查询头程服务]的Winit产品编码	OW01010334
inspectionWarehouseCode	String(50)	Y	验货仓编码 取[查询验货/目的仓]仓库编码 直发自验入库-非Winit承运：CSIW01(客户自验仓)	GZ0001
destinationWarehouseCode	String(40)	Y	目的仓编码 取[查询验货/目的仓]仓库编码	US0001
logisticsPlanNo	String(40)	O	物流计划编码 取[查询物流计划]的物流计划编码 头程通过Winit承运的时（WINIT产品名称中含有“WINIT头程”字样），必填 头程通过卖家自发的时，不需要填写，删除整个入参	198402
exportDeclarationType	String(50)	O	出口报关类型编码 取[查询出口报关-EOR类型]的EOR类型编码(CODE) Winit承运时：必填 卖家直发时：无需填，整个字段无需传入	CEOR
exporterCode	String（40)	O	出口商编码 通过查询进/出口商接口查询获得 当exportDeclarationType为：TEOR-第三方出口商或者FEOR-金融出口商，无需填(整个字段无需传入) 当exportDeclarationType为：CEOR-自有出口商，必填且只能填写非Winit的出口商
importDeclarationRuleCode	String(50)	O	进口报关规则编码 取[查询进口报关-IOR规则]的进口报关规则编码的EOR类型编码(CODE) Winit承运时：必填 卖家直发时：无需填，整个字段无需传入	CIOR
importerCode	String(40)	O	进口商编码 通过查询进/出口商接口查询获得 当importDeclarationRuleCode为：TIOR-第三方进口商的时候，无需填(整个字段无需传入) 当importDeclarationRuleCode为：CIOR-自有进口商的时候，必填且只能填写非Winit的进口商 注意：当目的国是英国或德国时，无论卖家直发还是WINIT承运，都必填
stockType	String(30)	N	库存类型， 2C：toC入库 2B：toB入库 非必填，卖家需要开启2B，2C库存管理才能使用，一般不入参 测试sandbox环境默认入参2C	2C
isForecastOrder	String(1)	N	是否无箱单明细的预报订单，Y/N 不传入时默认为否 若传Y，则需要填写planMerchandiseList（必填）orderIdentificationCodeList（必填）valueAddedService（选填） 若传N或不传，则需要填写packageList（必填）
packageList	Array	Y	有箱单，商品信息list
-|sellerCaseNo	String(20)	Y	卖家箱号
-|thirdPartyCaseNo	String(50)	N	自定义包裹条码（第三方箱号barcode） 注意：贴在实物包裹上的非Winit箱号，需全局唯一性，保证海外仓可扫描识别。
-|sellerWeight	Numberic(10,4)	Y	包裹重量(KG) 卖家下单数据
-|sellerLength	Numeric(10,2)	Y	包裹长(CM) 卖家下单数据
-|sellerWidth	Numeric(10,2)	Y	包裹宽(CM) 卖家下单数据
-|sellerHeight	Numberic(10,2)	Y	包裹高(CM) 卖家下单数据
-|isAutoBoxStorage	String(30)	N	已弃用 是否使用自动组箱存储增值服务，Y/N。默认不使用 入参Y后，仅满足下述条件时，才会自动按箱产品存储： 1、包裹内为单一产品 2、包裹等级为A或A+包裹 3、使用海外验入库 4、万邑通仓库确认包裹满足SKU包裹级库存标准
-|merchandiseList	Array	Y	包裹中的商品信息
-|-|merchandiseCode	String(255)	Y	商品编码 取 [查询入库可选商品]的商品编码	3010011818-20
-|-|specification	String(255)	N	商品规格 注意：若规格存在，则必填；若不存，则可不填
-|-|skuType	String(30)	N	SKU类型 SINGLE：单一商品 SUITE：套装商品 BOX：箱商品	BOX
-|-|standardPartsQty	Integer	O	标准件数 当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时，必填 当SKU类型(skuType)为单一商品(SINGLE)时，可不填，不填则默认为1	10
-|-|quantity	Integer	Y	数量 当SKU类型(skuType)为单一商品(SINGLE)时，单品件数 当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时，套数或箱数
-|-|productionBatch	String(255)	O	产品批次号 仅开通了保质期管理或生产批次管理的SKU可填
-|-|productionDate	String(30)	O	生产日期，YYYY-MM-DD 仅开通了保质期管理或生产批次管理的SKU可填
-|-|expirationDate	String(30)	O	失效日期，YYYY-MM-DD 仅开通了保质期管理或生产批次管理的SKU可填
-|-|barcodeValue	String(30)	O	条码值 开通条码值白名单权限，且商品为条码值管理时，必填
-|-|itemList	Array	O	包裹中商品的实物单品条码信息。以下为itemList的子节点
-|-|-|itemSerno	String(128)	O	单品条码 即下单商品(套装)对应的实物条码。 注意： 1、当下单商品的SKU类型(skuType)为套装商品(SUITE)，且其管理方式为单品化管理(SI)时，必填；其他情形，不填。 2、支持2种格式条码：Winit单品条码(S码)、第三方单品条码(非Winit)。 3、第三方(非Winit)单品条码，需全局唯一性，保证海外仓可扫描识别。
-|-|-|originItemSerno	String(128)	O	源单一商品的单品条码 即指下单商品的源单一商品的实物条码。 注意： 1、当下单商品SKU类型(skuType)为箱商品(BOX)\套装商品(SUITE)，且箱/套内的源单一商品(SINGLE)的管理方式为单品化管理(SI)时，必填； 2、支持2种格式条码：Winit单品条码(S码)、第三方单品条码(非Winit)。 3、第三方(非Winit)单品条码，需全局唯一性，保证海外仓可扫描识别。
-|-|inventoryAttribute	Array	O	库存属性集合list
-|-|-|tagName	String(50)	Y	库存属性编码。 stockOrg-库存组织 stockOwner-货主
-|-|-|tagValue	String(50)	Y	库存属性值。
planMerchandiseList	Array	O	无箱单，必填商品信息list
-|merchandiseCode	String(255)	Y	商品编码 取 [查询入库可选商品]的商品编码	3010011818-20
-|specification	String(255)	N	商品规格 注意：若规格存在，则必填；若不存，则可不填
-|skuType	String(30)	Y	SKU类型 SINGLE：单一商品 SUITE：套装商品 BOX：箱商品	SINGLE
-|standardPartsQty	Integer	O	标准件数 注意： 当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时，必填。 当SKU类型(skuType)为单一商品(SINGLE)时，可不填，不填则默认为1	1
-|quantity	Integer	Y	数量
orderIdentificationCodeList	Array	O	无箱单，必填订单识别码清单信息
-|type	String(30)	Y	识别码类型 TRACKING_NO 快递单号 ORDER 入库单号 OTHER 其他
-|code	String(128)	N	识别码，当识别码为快递单号或其他时必填
-|expressCompany	String(128)	N	物流公司 注意：当识别码类型为快递(TRACKING_NO)时需填写。 取值如下： UPS DHL TNT FEDEX Others - 其他
valueAddedService	object	O	无箱单，选填入库增值服务
-|shelveAsDefectiveProducts	String(1)	N	直接上架到不良品区服务 Y：启用服务 N：不启用 不传入则默认不启用
-|singleToBoxService	String(1)	N	单一转箱产品存储服务 Y：启用服务 N：不启用 不传入则默认不启用
dispatchInfo	Object	O	提货/验货信息list 入库单类型为SD-标准海外仓入库时必填
-|inspectionType	String(32)	N	验货方式 VI：上门验货（已停用） WI：验货仓验货
-|pickupType	String(32)	N	提货方式 P：上门提货 S：自发物流
-|reservePickupDateFrom	String(30)	N	提货开始时间 格式：yyyy-MM-dd HH:mm:ss，下列情况下必填： 1，验货方式为上门验货； 2，验货方式为验货仓验货并且提货方式为上门提货 提货时间段，一般为：”09:00:00-12:00:00”, “14:00:00-16:00:00”, “15:00:00-17:00:00”,”16:00:00-18:00:00” “09:00:00-12:00:00”段：需要提前15个小时预约 “14:00:00-16:00:00”段：需要提前2个小时预约 “15:00:00-17:00:00”段：需要提前3个小时预约 “16:00:00-18:00:00”段：需要提前4个小时预约	2019-06-25 09:00:00
-|reservePickupDateTo	String(50)	N	提货结束时间 格式：yyyy-MM-dd HH:mm:ss，下列情况下必填： 1，验货方式为上门验货； 2，验货方式为验货仓验货并且提货方式为上门提货 提货时间段，一般为：”09:00:00-12:00:00”, “14:00:00-16:00:00”, “15:00:00-17:00:00”,”16:00:00-18:00:00” “09:00:00-12:00:00”段：需要提前15个小时预约 “14:00:00-16:00:00”段：需要提前2个小时预约 “15:00:00-17:00:00”段：需要提前3个小时预约 “16:00:00-18:00:00”段：需要提前4个小时预约	2019-06-25 12:00:00
-|pickupAddressCode	String(30)	O	提货/验货地址编码 通过接口《查询提货地址》获得的addressCode或者登录万邑联-个人中心-服务设置-地址管理-寄件/提货地址-提货地址编号得到； 下列情况下必填： 1，验货方式为上门验货； 2，验货方式为验货仓验货并且提货方式为上门提货
-|expressVendorCode	String(30)	O	发货供应商编码 提货方式(pickupType)为自发物流(S)时，发货供应商编码和发货供应商名称其中之一必填，取 [查询发货供应商]的承运人编码	LB
-|expressVendorName	String(50)	O	发货供应商名称 提货方式(pickupType)为自发物流(S)时，发货供应商编码和发货供应商名称其中之一必填，取 [查询发货供应商]的承运人名称	龙邦
-|expressNo	String(30)	N	快递单号 提货方式(pickupType)为自发物流(S)时必填
directForecastInfo	Object	O	直发预报信息list 卖家直发必填，否则可以直接不填写
-|expectedSendWarehouseTime	String（60）	Y	预计送仓时间 格式yyyy-MM-dd	2019-08-12
-|preparedOffPortDate	String（30）	Y	预计离港时间(即预计起航时间) 格式yyyy-MM-dd	2019-07-10
-|preparedArrivePortDate	String（60）	Y	预计到港时间 格式yyyy-MM-dd	2019-07-12
sendPortInfo	Object	O	送港信息list 只有WINIT头程才需要填写 （产品名称中含有“WINIT头程”字样）
-|sendPortType	String(50)	Y	送港类型 WINIT：winit送港； SELF：自送港
-|sendPortDate	String	O	送港时间 格式yyyy-MM-dd 当送港类型是WINIT送港时，无需填； 当送港类型是自送港时，必填；
-|pickupCartonAddressCode	String(50)	O	提柜地址编码 与提货地址编号相同，通过接口《查询提货地址》获得的addressCode或者登录万邑联-个人中心-服务设置-地址管理-寄件/提货地址-提货地址编号得到； 当送港类型是WINIT送港时，必填； 当送港类型是自送港时，无需填，整个字段无需传入；
-|containerNo	String(50)	N	柜号 当送港类型是WINIT送港时，无需填，整个字段无需传入； 当送港类型是自送港时，可填；
-|sealNo	String(50)	N	铅封号 当送港类型是WINIT送港时，无需填，整个字段无需传入； 当送港类型是自送港时，可填；

请求示例

1.标准海外仓入库

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "526482E2C51794D8BAB64F106AE94F63",
    "data": {
        "sellerOrderNo": "99999999",
        "inspectionWarehouseCode": "SZ0001",
        "destinationWarehouseCode": "US0001",
        "winitProductCode": "OW01010343",
        "importerCode": "IR0000000586",
        "exporterCode": "ER0000001405",
        "importDeclarationRuleCode": "CIOR",
        "exportDeclarationType": "CEOR",
        "logisticsPlanNo": "198402",
        "orderType": "SD",
        "dispatchInfo": {
            "inspectionType": "WI",
            "pickupType": "P",
            "pickupAddressCode": "12",
            "reservePickupDateFrom": "2019-06-25 09:00:00",
            "reservePickupDateTo": "2019-06-25 12:00:00",
            "expressVendorCode": "12",
            "expressVendorName": "龙邦",
            "expressNo": "LB0001"
        },
        "packageList": [
            {
                "sellerCaseNo": "qyk001",
                "thirdPartyCaseNo": "third2019062101",
                "sellerWeight": "0.01",
                "sellerLength": "18.00",
                "sellerWidth": "15.00",
                "sellerHeight": "2.00",
                "merchandiseList": [
                    {
                        "merchandiseCode": "iphoned6",
                        "specification": "",
                        "quantity": "1"
                    }
                ]
            }
        ]
    },
    "format": "json",
    "platform": "OWNERERP",
    "sign_method": "md5",
    "timestamp": "2015-08-11 10:48:39",
    "version": "1.0",
    "sign": "8E8293A48AFFFB4467DB27D15CC91598",
    "language": "zh_CN"
}

2.直发国内验-自验卖家直发

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "245002566@qq.com",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "8A4887740E73FA577C37314668A4C42B",
    "data": {
        "orderType": "DI",
        "winitProductCode": "OW01021351",
        "destinationWarehouseCode": "US0001",
        "inspectionWarehouseCode": "CSIW01",
        "sellerOrderNo": "567787",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "AA30108WM",
                        "specification": "",
                        "quantity": "1"
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "1234567801111",
                "sellerHeight": "2",
                "sellerLength": "1.00",
                "sellerWeight": "1",
                "sellerWidth": "1"
            }
        ],
        "directForecastInfo": {
            "preparedOffPortDate": "2020-02-20",
            "preparedArrivePortDate": "2020-02-27",
            "expectedSendWarehouseTime": "2020-04-30",
            " inventoryAttribute": [
                {
                    "tagName ": "stockOrg",
                    "tagValue": "AAA"
                },
                {
                    "tagName ": "stockOwner",
                    "tagValue": "XXX"
                }
            ]
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "3D434C2110F06BDBA022E1F3D6074C6E",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

3.直发国内验入-自验winit头程

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"65624DB16E3DFA9B372F9F6F82EE627E",
    "data": {
        "orderType": "DI",
        "winitProductCode": "OW01021405",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "inspectionWarehouseCode": "SZV001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "LCD-IP5c-02",
                        "specification": "",
                        "quantity": "1"
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "third_caseNo1_par2019062102",
                "sellerHeight": "10",
                "sellerLength": "10",
                "sellerWeight": "10",
                "sellerWidth": "1"
            }
        ],
        "importerCode": "IR0000000586",
        "exportDeclarationType":"",
        "exporterCode": "ER0000001405",
        "logisticsPlanNo": "198402",
        "sendPortInfo": {
            "sendPortType": "WINIT",
            "pickupCartonAddressCode": "zdw001",
            "sendPortDate": "2019-06-24",
            "containerNo": "1",
            "sealNo": "2"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "8B06C217C151D24A7AC60F556A711741",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

4.直发海外验-卖家直发

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"DB49AF3868EF493199827F0BA141582C",
    "data": {
        "orderType": "DW",
        "winitProductCode": "OW01030329",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "4BAR002A",
                        "quantity": "1",
                        "specification": ""
                    }
                ],
                "sellerCaseNo": "11",
                "thirdPartyCaseNo": "third_caseNo1_par20190701",
                "sellerHeight": "1",
                "sellerLength": "1",
                "sellerWeight":"1",
                "sellerWidth": "1"
            }
        ],
        "directForecastInfo": {
            "preparedOffPortDate": "2019-07-10",
            "preparedArrivePortDate": "2019-07-11",
            "expectedSendWarehouseTime": "2020-04-30"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "7A3CD72759832E3E82B33A6549D2DE3E",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

5.直发海外验-winit头程

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"2BAEE864F4B042926DD409BBA61C340C",
    "data": {
        "orderType": "DW",
        "winitProductCode": "OW01031342",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "inspectionWarehouseCode": "SZV001",
        "importDeclarationRuleCode": "",
        "packageList": [
            {
                "merchandiseList": [
                    {
                        "merchandiseCode": "216401",
                        "quantity": "1",
                        "specification": ""
                    }
                ],
                "sellerCaseNo": "1",
                "thirdPartyCaseNo": "third_caseNo1_par2019062103",
                "sellerHeight": "1",
                "sellerLength": "2.34",
                "sellerWeight": "0.08879",
                "sellerWidth": "1"
            }
        ],
        "importerCode": "IR0000000586",
        "exportDeclarationType":"",
        "exporterCode": "ER0000001405",
        "logisticsPlanNo": "198402",
        "sendPortInfo": {
            "sendPortType": "WINIT",
            "pickupCartonAddressCode": "12",
            "sendPortDate": "2017-09-15",
            "containerNo": "234",
            "sealNo": "7686"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "9486E1F6891234B179DE903CD7D598D1",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

6.直发海外验-无箱单预报

{
    "action": "winit.wh.inbound.order.create",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "DB49AF3868EF493199827F0BA141582C",
    "data": {
        "orderType": "DW",
        "winitProductCode": "OW01030329",
        "destinationWarehouseCode": "US0001",
        "sellerOrderNo": "autotest001",
        "importerCode": "RIR001",
        "isForecastOrder": "Y",
        "valueAddedService": {
            "shelveAsDefectiveProducts": "Y",
            "singleToBoxService": "Y"
        },
        "planMerchandiseList": [
            {
                "merchandiseCode": "4BAR002A",
                "specification": "",
                "skuType": "BOX",
                "standardPartsQty": 2,
                "quantity": "1"
            }
        ],
        "orderIdentificationCodeList": [
            {
                "type": "TRACKING_NO",
                "code": "1010001001",
                "expressCompany": "UPS"
            },
            {
                "type": "TRACKING_NO",
                "code": "1010001002",
                "expressCompany": "UPS"
            }
        ],
        "directForecastInfo": {
            "preparedOffPortDate": "2019-07-10",
            "preparedArrivePortDate": "2019-07-11",
            "expectedSendWarehouseTime": "2020-04-30"
        }
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "7A3CD72759832E3E82B33A6549D2DE3E",
    "sign_method": "md5",
    "timestamp": "2016-09-23 16:26:39",
    "version": "1.0"
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

名称	类型	必传	说明	示例
orderNo	String(64)	Y	入库单号

返回示例

{
      "code": "0",
      "msg": "操作成功",
      "data": {
          "orderNo": "W0100000000002324"
      }    
}

• api在线测试
• 错误代码查询