qimen.taobao.pos.items.get (商品信息同步接口)

POS从ERP获取基础商品数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page Number 必须 1 当前页
pageSize Number 必须 20 每页条数
productCode String 可选 PEUTET378472
  • 最大长度:50
  • 商品的SPU编码
    itemCode String 可选 SKUEWRYU178673
  • 最大长度:50
  • 商品SKU编码
    startTime String 可选 YYYY-MM-DD hh:mm:ss
  • 最大长度:19
  • 最后修改的起始时间
    endTime String 可选 YYYY-MM-DD hh:mm:ss
  • 最大长度:19
  • 最后修改的结束时间
    customerid String 必须 A12345
  • 最大长度:50
  • 指定路由参数

    响应参数

    名称 类型 示例值 描述
    flag String success|failure 响应结果
    code String errorcode 响应码
    message String msg 响应信息
    total Number 200 总条数
    item Struct []
    • └ productCode
    • String
    • PEUTET378472
    • ERP的商品spu编码
    • └ itemCode
    • String
    • SKUEWRYU178673
    • ERP的商品sku编码
    • └ originCode
    • String
    • yuanchangcode134
    • 原厂编码
    • └ itemName
    • String
    • 女夏季短袖
    • 商品名称
    • └ barCode
    • String
    • 96295629652
    • 条形码
    • └ skuProperty
    • String
    • 如红色 XXL
    • 商品属性
    • └ color
    • String
    • red
    • 颜色编码
    • └ size
    • String
    • XXL
    • 尺码编码
    • └ grossWeight
    • String
    • 0.5千克
    • 毛重
    • └ netWeight
    • String
    • 0.4千克
    • 净重
    • └ stockUnit
    • String
    • 千克
    • 商品计量单位
    • └ categoryId
    • String
    • cat0002
    • 商品类别Id
    • └ categoryName
    • String
    • 女装
    • 商品类别名称
    • └ standardPrice
    • String
    • 200
    • 标准价
    • └ referencePrice
    • String
    • 150
    • 参考价
    • └ retailPrice
    • String
    • 120
    • 零售价
    • └ tagPrice
    • String
    • 450
    • 吊牌价
    • └ costPrice
    • String
    • 50
    • 成本价
    • └ discount
    • String
    • 0.9000
    • 折扣
    • priceAdjustment
    • Struct
    • └ type
    • String
    • 0=调价格1=调折扣2=调价格
    • 调价类型
    • └ standardPrice
    • String
    • 100
    • 调价后的价格
    • └ discount
    • String
    • 0.9000
    • 折扣
    • └ startDate
    • String
    • YYYY-MM-DD
    • 调价开始日期
    • └ endDate
    • String
    • YYYY-MM-DD
    • 调价结束日期
    • └ seasonCode
    • String
    • summer
    • 季节编码
    • └ seasonName
    • String
    • 季节名称
    • └ brandCode
    • String
    • HDYS
    • 品牌代码
    • └ brandName
    • String
    • 韩都衣舍
    • 品牌名称
    • └ isValid
    • String
    • Y/N
    • 是否有效
    • └ createTime
    • String
    • YYYY-MM-DD HH:MM:SS
    • 创建时间
    • └ latestUpdateTime
    • String
    • YYYY-MM-DD hh:mm:ss
    • 最新更新时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    TaobaoPosItemsGetRequest req = new TaobaoPosItemsGetRequest();
    req.setPage(1L);
    req.setPageSize(20L);
    req.setProductCode("PEUTET378472");
    req.setItemCode("SKUEWRYU178673");
    req.setStartTime("YYYY-MM-DD hh:mm:ss");
    req.setEndTime("YYYY-MM-DD hh:mm:ss");
    req.setCustomerid("A12345");
    TaobaoPosItemsGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <flag>success|failure</flag>
    <code>errorcode</code>
    <message>msg</message>
    <total>200</total>
    <item>
        <struct>
            <productCode>PEUTET378472</productCode>
            <itemCode>SKUEWRYU178673</itemCode>
            <originCode>yuanchangcode134</originCode>
            <itemName>女夏季短袖</itemName>
            <barCode>96295629652</barCode>
            <skuProperty>如红色 XXL</skuProperty>
            <color>red</color>
            <size>XXL</size>
            <grossWeight>0.5千克</grossWeight>
            <netWeight>0.4千克</netWeight>
            <stockUnit>千克</stockUnit>
            <categoryId>cat0002</categoryId>
            <categoryName>女装</categoryName>
            <standardPrice>200</standardPrice>
            <referencePrice>150</referencePrice>
            <retailPrice>120</retailPrice>
            <tagPrice>450</tagPrice>
            <costPrice>50</costPrice>
            <discount>0.9000</discount>
            <priceAdjustment>
                <type>0=调价格1=调折扣2=调价格</type>
                <standardPrice>100</standardPrice>
                <discount>0.9000</discount>
                <startDate>YYYY-MM-DD</startDate>
                <endDate>YYYY-MM-DD</endDate>
            </priceAdjustment>
            <seasonCode>summer</seasonCode>
            <seasonName>夏</seasonName>
            <brandCode>HDYS</brandCode>
            <brandName>韩都衣舍</brandName>
            <isValid>Y/N</isValid>
            <createTime>YYYY-MM-DD HH:MM:SS</createTime>
            <latestUpdateTime>YYYY-MM-DD hh:mm:ss</latestUpdateTime>
        </struct>
    </item>
    

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部