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

qimen.taobao.pos.clerk.synchronize (店员信息同步接口)

POS机与ERP之间同步店员基础数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
actionType String 必须 add=新增 update=修改 delete=删除
  • 最大长度:50
  • 操作
    total Number 可选 100 所有的总条数
    clerk Struct [] 可选
  • 最大列表长度:20
    • └ 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
    • 最新更新时间
    customerid String 必须 A12345 指定路由参数

    响应参数

    名称 类型 示例值 描述
    flag String success|failure 响应结果
    code String errorcode 响应码
    message String msg 响应信息
    clerk Struct []
    • └ clerkCode
    • String
    • employee0001
    • POS中的店员编码
    • └ clerkName
    • String
    • 小红
    • 店员名称
    • └ storeCode
    • String
    • hz0001
    • 门店编码
    • └ startTime
    • String
    • YYYY-MM-DD hh:mm:ss
    • 最后修改的起始时间
    • └ endTime
    • String
    • YYYY-MM-DD hh:mm:ss
    • 最后修改的结束时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    TaobaoPosClerkSynchronizeRequest req = new TaobaoPosClerkSynchronizeRequest();
    req.setActionType("add=新增 update=修改 delete=删除");
    req.setTotal(100L);
    List<TaobaoPosClerkSynchronizeRequest.Struct> list2 = new ArrayList<TaobaoPosClerkSynchronizeRequest.Struct>();
    TaobaoPosClerkSynchronizeRequest.Struct obj3 = new TaobaoPosClerkSynchronizeRequest.Struct();
    list2.add(obj3);
    obj3.setStoreCode("hz0001");
    obj3.setClerkCode("employee0001");
    obj3.setSourceClerkCode("erpcode882652");
    obj3.setClerkName("小红");
    obj3.setClerkType("DZ=店长 SYY=收银员 SHY=售货员 OTHER=其他");
    TaobaoPosClerkSynchronizeRequest.Struct obj5 = new TaobaoPosClerkSynchronizeRequest.Struct();
    obj5.setName("张三");
    obj5.setBirthDate("YYYY-MM-DD");
    obj5.setGender("M=男性F=女性");
    obj5.setCareer("IT工程师");
    obj5.setZipCode("132000");
    obj5.setTel("0571-85022088");
    obj5.setMobile("13542088088");
    obj5.setFax("0571-85022088");
    obj5.setEmail("zhangsan@taobao.com");
    obj5.setProvince("浙江省");
    obj5.setCity("杭州市");
    obj5.setArea("西湖区");
    obj5.setTown("光明村");
    obj5.setDetailAddress("延安路2001号");
    list4.setContactInfo(obj5);
    obj3.setIsValid("Y/N");
    obj3.setCreateTime("YYYY-MM-DD hh:mm:ss");
    obj3.setLatestUpdateTime("YYYY-MM-DD hh:mm:ss");
    req.setClerk(list2);
    req.setCustomerid("A12345");
    TaobaoPosClerkSynchronizeResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <flag>success|failure</flag>
    <code>errorcode</code>
    <message>msg</message>
    <clerk>
        <struct>
            <clerkCode>employee0001</clerkCode>
            <clerkName>小红</clerkName>
            <storeCode>hz0001</storeCode>
            <startTime>YYYY-MM-DD hh:mm:ss</startTime>
            <endTime>YYYY-MM-DD hh:mm:ss</endTime>
        </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

    返回
    顶部