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

qimen.taobao.pos.clerk.get (店员信息获取接口)

POS机从ERP获取店员基础数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page Number 必须 1 当前页
pageSize Number 必须 20 每页条数
storeCode String 可选 hz0001
  • 最大长度:50
  • 门店(仓储)编码
    clerkCode String 可选 employee0001
  • 最大长度:50
  • POS中的店员编码
    startTime String 可选 YYYY-MM-DD hh:mm:ss
  • 最大长度:50
  • 最后修改的起始时间
    endTime String 可选 YYYY-MM-DD hh:mm:ss
  • 最大长度:50
  • 最后修改的结束时间
    customerid String 必须 A123456 指定路由参数

    响应参数

    名称 类型 示例值 描述
    flag String success|failure 响应结果
    code String errorcode 响应码
    message String msg 响应信息
    clerk Struct []
    • └ storeCode
    • String
    • hz0001
    • 门店编码
    • └ clerkCode
    • String
    • employee0001
    • POS中的店员编码
    • └ sourceClerkCode
    • String
    • erpcode882652
    • ERP中的店员编码
    • └ clerkName
    • String
    • 小红
    • 店员名称
    • └ clerkType
    • String
    • DZ=店长 SYY=收银员 SHY=售货员 OTHER=其他
    • 店员类型
    • contactInfo
    • Struct
    • └ name
    • String
    • 张三
    • 姓名
    • └ birthDate
    • String
    • YYYY-MM-DD
    • 出生年月
    • └ gender
    • String
    • M=男性F=女性
    • 性别
    • └ career
    • String
    • IT工程师
    • 职业
    • └ zipCode
    • String
    • 132000
    • 邮编
    • └ tel
    • String
    • 0571-85022088
    • 固定电话
    • └ mobile
    • String
    • 13542088088
    • 移动电话
    • └ fax
    • String
    • 0571-85022088
    • 传真(门店)
    • └ email
    • String
    • zhangsan@taobao.com
    • 电子邮箱
    • └ 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);
    TaobaoPosClerkGetRequest req = new TaobaoPosClerkGetRequest();
    req.setPage(1L);
    req.setPageSize(20L);
    req.setStoreCode("hz0001");
    req.setClerkCode("employee0001");
    req.setStartTime("YYYY-MM-DD hh:mm:ss");
    req.setEndTime("YYYY-MM-DD hh:mm:ss");
    req.setCustomerid("A123456");
    TaobaoPosClerkGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <flag>success|failure</flag>
    <code>errorcode</code>
    <message>msg</message>
    <clerk>
        <struct>
            <storeCode>hz0001</storeCode>
            <clerkCode>employee0001</clerkCode>
            <sourceClerkCode>erpcode882652</sourceClerkCode>
            <clerkName>小红</clerkName>
            <clerkType>DZ=店长 SYY=收银员 SHY=售货员 OTHER=其他</clerkType>
            <contactInfo>
                <name>张三</name>
                <birthDate>YYYY-MM-DD</birthDate>
                <gender>M=男性F=女性</gender>
                <career>IT工程师</career>
                <zipCode>132000</zipCode>
                <tel>0571-85022088</tel>
                <mobile>13542088088</mobile>
                <fax>0571-85022088</fax>
                <email>zhangsan@taobao.com</email>
                <province>浙江省</province>
                <city>杭州市</city>
                <area>西湖区</area>
                <town>光明村</town>
                <detailAddress>延安路2001号</detailAddress>
            </contactInfo>
            <isValid>Y/N</isValid>
            <createTime>YYYY-MM-DD hh:mm:ss</createTime>
            <latestUpdateTime>YYYY-MM-DD hh:mm:ss</latestUpdateTime>
        </struct>
    </clerk>
    

    异常示例

    • 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

    返回
    顶部