文档中心 > API类目 > 奇门POS接口

qimen.taobao.qimen.pos.store.get (门店信息获取接口)

POS从ERP获取门店(仓库)的基础信息数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page Number 必须 1 当前页(从1开始)
pageSize Number 必须 20 每页条数(不超过100)
storeCode String 可选 hz0001
  • 最大长度:50
  • 门店(仓储)编码
    startTime String 可选 YYYY-MM-DD hh:mm:ss 最后修改的起始时间
    endTime String 可选 YYYY-MM-DD hh:mm:ss 最后修改的结束时间

    响应参数

    名称 类型 示例值 描述
    flag String success|failure 响应结果
    code String errorcode 响应码
    message String msg 响应信息
    total Number 1000 所有的总条数
    store Struct []
    • └ storeCode
    • String
    • hz0001
    • 门店(仓储)编码
    • └ storeName
    • String
    • 杭州延安路旗舰店
    • 门店(仓储)名称
    • └ storeType
    • String
    • MD=门店 CK=仓库 OTHER=其他
    • 类型
    • └ region
    • String
    • 华南区
    • 区域
    • └ orgCode
    • String
    • 000001
    • 上级组织编码
    • └ businessType
    • String
    • ZB=总部 ZY=直营 JM=加盟
    • 业务类型
    • └ customerType
    • String
    • ZB=总部 FB=分部 DL=代理商 ZY=直营店 JM=加盟店
    • 客户类型
    • └ retailType
    • String
    • PT=普通 DX=代销 ZX=直销
    • 销售模式
    • └ purchaseDiscount
    • String
    • 0.85
    • 进货折扣
    • └ retailDiscount
    • String
    • 0.85
    • 零售折扣
    • settlementInfo
    • Struct
    • └ settlementType
    • Number
    • 0
    • 结算类型(0=不结算 1=发货结算 2=零售结算)
    • └ currency
    • String
    • RMB=人民币 USD=美元
    • 结算币制
    • detail
    • Struct
    • └ name
    • String
    • 张三
    • 姓名(门店联系人)
    • └ zipCode
    • String
    • 130000
    • 邮编(门店)
    • └ tel
    • String
    • 0571-85022088
    • 固定电话(门店)
    • └ mobile
    • String
    • 13542088088
    • 移动电话(门店)
    • └ fax
    • String
    • 0571-85022088
    • 传真(门店)
    • └ countryCode
    • String
    • 门店地址
    • 国家二字码
    • └ province
    • String
    • 浙江省
    • 省份(门店地址)
    • └ city
    • String
    • 杭州市
    • 城市(门店地址)
    • └ area
    • String
    • 西湖区
    • 区域(门店地址)
    • └ town
    • String
    • 光明村
    • 村镇(门店地址)
    • └ detailAddress
    • String
    • 延安路2001号
    • 详细地址(门店地址)
    • └ 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);
    TaobaoQimenPosStoreGetRequest req = new TaobaoQimenPosStoreGetRequest();
    req.setPage(1L);
    req.setPageSize(20L);
    req.setStoreCode("hz0001");
    req.setStartTime("YYYY-MM-DD hh:mm:ss");
    req.setEndTime("YYYY-MM-DD hh:mm:ss");
    TaobaoQimenPosStoreGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <flag>success|failure</flag>
    <code>errorcode</code>
    <message>msg</message>
    <total>1000</total>
    <store>
        <struct>
            <storeCode>hz0001</storeCode>
            <storeName>杭州延安路旗舰店</storeName>
            <storeType>MD=门店 CK=仓库 OTHER=其他</storeType>
            <region>华南区</region>
            <orgCode>000001</orgCode>
            <businessType>ZB=总部 ZY=直营 JM=加盟</businessType>
            <customerType>ZB=总部 FB=分部 DL=代理商 ZY=直营店 JM=加盟店</customerType>
            <retailType>PT=普通 DX=代销 ZX=直销</retailType>
            <purchaseDiscount>0.85</purchaseDiscount>
            <retailDiscount>0.85</retailDiscount>
            <settlementInfo>
                <settlementType>0</settlementType>
                <currency>RMB=人民币 USD=美元</currency>
            </settlementInfo>
            <detail>
                <name>张三</name>
                <zipCode>130000</zipCode>
                <tel>0571-85022088</tel>
                <mobile>13542088088</mobile>
                <fax>0571-85022088</fax>
                <countryCode>门店地址</countryCode>
                <province>浙江省</province>
                <city>杭州市</city>
                <area>西湖区</area>
                <town>光明村</town>
                <detailAddress>延安路2001号</detailAddress>
            </detail>
            <isValid>Y/N</isValid>
            <createTime>YYYY-MM-DD hh:mm:ss</createTime>
            <latestUpdateTime>YYYY-MM-DD hh:mm:ss</latestUpdateTime>
        </struct>
    </store>
    

    异常示例

    • 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

    返回
    顶部