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

qimen.taobao.pos.store.synchronize (门店信息同步接口)

POS与ERP之间同步门店(仓库)的基础信息数据

公共参数

请求参数

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

    响应参数

    名称 类型 示例值 描述
    flag String success|failure 响应结果
    code String errorcode 响应码
    message String msg 响应信息
    store Struct [] 门店信息
    • └ storeCode
    • String
    • hz0001
    • 门店(仓储)编码
    • └ storeName
    • String
    • 杭州延安路旗舰店
    • 门店(仓储)名称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    TaobaoPosStoreSynchronizeRequest req = new TaobaoPosStoreSynchronizeRequest();
    req.setActionType("add=新增 update=修改 delete=删除");
    req.setTotal(100L);
    List<TaobaoPosStoreSynchronizeRequest.Struct> list2 = new ArrayList<TaobaoPosStoreSynchronizeRequest.Struct>();
    TaobaoPosStoreSynchronizeRequest.Struct obj3 = new TaobaoPosStoreSynchronizeRequest.Struct();
    list2.add(obj3);
    obj3.setStoreCode("hz0001");
    obj3.setStoreName("杭州延安路旗舰店");
    obj3.setStoreType("MD=门店 CK=仓库 OTHER=其他");
    obj3.setRegion("华南区");
    obj3.setOrgCode("000001");
    obj3.setBusinessType("ZB=总部 ZY=直营 JM=加盟");
    obj3.setCustomerType("ZB=总部 FB=分部 DL=代理商 ZY=直营店 JM=加盟店");
    obj3.setRetailType("PT=普通 DX=代销 ZX=直销");
    obj3.setPurchaseDiscount("0.85");
    obj3.setRetailDiscount("0.85");
    TaobaoPosStoreSynchronizeRequest.Struct obj5 = new TaobaoPosStoreSynchronizeRequest.Struct();
    obj5.setSettlementType(0L);
    obj5.setCurrency("RMB=人民币 USD=美元");
    list4.setSettlementInfo(obj5);
    TaobaoPosStoreSynchronizeRequest.Struct obj7 = new TaobaoPosStoreSynchronizeRequest.Struct();
    obj7.setName("张三");
    obj7.setZipCode("130000");
    obj7.setTel("0571-85022088");
    obj7.setMobile("13542088088");
    obj7.setFax("0571-85022088");
    obj7.setCountryCode("门店地址");
    obj7.setProvince("浙江省");
    obj7.setCity("杭州市");
    obj7.setArea("西湖区");
    obj7.setTown("光明村");
    obj7.setDetailAddress("延安路2001号");
    list6.setDetail(obj7);
    obj3.setIsValid("Y/N");
    obj3.setCreateTime("YYYY-MM-DD hh:mm:ss");
    obj3.setLatestUpdateTime("YYYY-MM-DD hh:mm:ss");
    req.setStore(list2);
    req.setCustomerid("A123456");
    TaobaoPosStoreSynchronizeResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <flag>success|failure</flag>
    <code>errorcode</code>
    <message>msg</message>
    <store>
        <struct>
            <storeCode>hz0001</storeCode>
            <storeName>杭州延安路旗舰店</storeName>
        </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

    返回
    顶部