API
查询商品编码的单品条码及其状态
更新时间: 2019-12-17 21:01:08 访问次数:995
接口说明

该接口提供给第三方平台或是卖家自有系统通过商品编码SKU查询单品条码,以及单品的状态。
若卖家使用的是商品化管理,则S码返回为空,
若买家使用的是单品化管理,则S吗返回有值。
卖家默认是单品化管理,如不知道卖家是否商品化管理,请提供一个商品SKU给万邑通在线客服查询确认。

使用场景

卖家可以通过该接口实现查询商品SKU和单品状态:
1.查询商品编码对应的单品条码:入参:skuCode,返回SKU和对应的商品条码和单品条码。(商品化管理,没有单品条码)
2.查询某个单品的订单状态:入参:skuCode+barcode,返回SKU和单品条码对应的状态。

接口英文名称

winit.singleitem.list

备注

单品状态说明:

状态编码 状态中文名 状态中文名 说明
INIT准备中单品条码的初始状态。
ON_ORDER在途验货完成后为在途状态。
WAITING_OUTBOUND待发单品验货完成且没有出库,为待发状态。
USABLE可用单品验货完成且没有被占用,为可用状态。
WAITING_DESTRUCTION待销毁已下销毁单且在库未销毁时,为待销毁状态。
LOST_CONFIRMING丢失确认中仓库拣选失败,且没有确认丢失,为丢失确认中状态。
LOST已丢失在异常处理中心,已确认处理的单品,为已丢失状态。
DESTRUCTION已销毁已经销毁的单品,为已销毁状态。
OUTBOUND已出库已经出库的单品,为已出库状态。
PICKED已拣选拣选扫描单品码后,且整个出库单没有全部拣选,为已拣选状态。
PACKED已打包打包扫码单品码后,为已打包状态。
PKC拣选完成整个出库单拣选完成,为拣选完成状态。
LOST_INBOUND入库丢失已验货但是未上架的单品,为入库丢失状态。
SPLIT海外已拆包

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
skuCodeString(255)Y商品编码 LCD-IP5-01
specificationString(255)N商品规格红色
barcodeString(255)N单品条码S000000000123456789
statusString(255)N单品状态
准备中:INIT;
在途:ON_ORDER;
待发:WAITING_OUTBOUND;
可用:USABLE;
待销毁:WAITING_DESTRUCTION;
丢失确认中:LOST_CONFIRMING;
已丢失:LOST;
已销毁:DESTRUCTION;
已出库:OUTBOUND;
已拣选:PICKED;
已打包:PACKED;
拣选完成:PKC;
海外已拆包:SPLIT;
入库丢失:LOST_INBOUND;
INIT
pageSizeIntegerY每页显示数量/分页大小10
pageNoIntegerY页码/第几页1
请求示例
1.全部查询
{
    "action": "winit.singleitem.list",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "data": {
        "skuCode": "LCD-IP5-01",
        "specification": "",
        "barcode": "",
        "status": "",
        "pageVo": {
            "pageNo": 1,
            "pageSize": 10
        }
    },
    "format": "json",
    "language": "zh_CN",
    "sign": "F60496CD31D565C8CEDA1115606927C1",
    "sign_method": "md5",
    "platform": "OWNERERP",
    "timestamp": "2015-06-16 00:19:26",
    "version": "1.0",
    "client_sign": "903150A315B5F3A024BD52191F81B25C"
}

2.单个查询: { "action": "winit.singleitem.list", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "data": { "skuCode": "LCD-IP5-01", "specification": "", "barcode": "S509900000005456771", "status": "", "pageVo": { "pageNo": 1, "pageSize": 10 } }, "format": "json", "language": "zh_CN", "sign": "32FE9622B48339D4C25D56C83B0A5106", "sign_method": "md5", "platform": "OWNERERP", "timestamp": "2015-06-16 00:19:26", "version": "1.0", "client_sign": "950C11C547B27E0047A2B5D295398C91" }

                            
返回出参
名称 类型 必填 说明 示例
barcodeString()Y单品条码
skuString()Y商品条码
skuCodeString()Y商品编码
specificationString()Y商品规格
statusString()Y单品状态
返回示例
1.全部查询:{
    "code": "0",
    "msg": "操作成功",
    "data": {
        "pageParams": {
            "pageNo": 1,
            "pageSize": 10,
            "totalCount": 146
        },
        "list": [
            {
                "barcode": "S509900000005456774",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456773",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456772",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456771",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456770",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456769",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456768",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456767",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456766",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            },
            {
                "barcode": "S509900000005456765",
                "sku": "M010000000000062792",
                "skuCode": "LCD-IP5-01",
                "specification": "",
                "status": "USABLE"
            }
        ]
    }
}

2.单个查询: { "code": "0", "msg": "操作成功", "data": { "pageParams": { "pageNo": 1, "pageSize": 10, "totalCount": 1 }, "list": [ { "barcode": "S509900000005456771", "sku": "M010000000000062792", "skuCode": "LCD-IP5-01", "specification": "", "status": "USABLE" } ] } }