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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request Request 可选
  • └ actionType
  • String
  • 必须
  • add
  • 操作(add=新增、update=修改、delete=删除)
  • └ total
  • Number
  • 可选
  • 12
  • 所有的总条数
  • stores
  • Store []
  • 可选
  • 门店信息
  • └ storeCode
  • String
  • 必须
  • W123
  • 门店(仓储)编码
  • └ storeName
  • String
  • 必须
  • 测试门店
  • 门店(仓储)名称
  • └ storeType
  • String
  • 必须
  • MD
  • 类型(MD=门店、CK=仓库、OTHER=其他)
  • └ region
  • String
  • 可选
  • 华南区
  • 区域(如华南区)
  • └ orgCode
  • String
  • 可选
  • ZH123
  • 上级组织编码
  • └ businessType
  • String
  • 可选
  • ZB
  • 业务类型(ZB=总部、ZY=直营、JM=加盟)
  • └ customerType
  • String
  • 可选
  • ZB
  • 客户类型(ZB=总部、FB=分部、DL=代理商、ZY=直营店、JM=加盟店)
  • └ retailType
  • String
  • 可选
  • PT
  • 销售模式(PT=普通、DX=代销、ZX=直销)
  • └ purchaseDiscount
  • String
  • 可选
  • 12
  • 进货折扣
  • └ retailDiscount
  • String
  • 可选
  • 12
  • 零售折扣
  • settlementInfo
  • SettlementInfo
  • 可选
  • 结算信息
  • └ settlementType
  • Number
  • 可选
  • 0
  • 结算类型(0=不结算、1=发货结算、2=零售结算)
  • └ currency
  • String
  • 可选
  • RMB
  • 结算币制(RMB=人民币、USD=美元)
  • detail
  • Detail
  • 可选
  • 门店详情
  • └ name
  • String
  • 可选
  • 老王
  • 姓名(门店联系人)
  • └ zipCode
  • String
  • 可选
  • 043355
  • 邮编(门店)
  • └ tel
  • String
  • 可选
  • 0987654
  • 固定电话(门店)
  • └ mobile
  • String
  • 可选
  • 12345677
  • 移动电话(门店)
  • └ fax
  • String
  • 可选
  • 987654
  • 传真(门店)
  • └ countryCode
  • String
  • 可选
  • 余杭区
  • 国家二字码(门店地址)
  • └ province
  • String
  • 可选
  • 浙江
  • 省份(门店地址)
  • └ city
  • String
  • 可选
  • 杭州
  • 城市(门店地址)
  • └ area
  • String
  • 可选
  • 西溪
  • 区域(门店地址)
  • └ town
  • String
  • 可选
  • 986号
  • 村镇(门店地址)
  • └ detailAddress
  • String
  • 可选
  • 浙江余杭
  • 详细地址(门店地址)
  • └ isValid
  • String
  • 可选
  • Y
  • 是否有效(Y/N|默认为Y)
  • └ createTime
  • String
  • 可选
  • 2017-01-12 00:00:00
  • 创建时间(YYYY-MM-DD hh:mm:ss)
  • └ latestUpdateTime
  • String
  • 可选
  • 2017-01-12 00:00:00
  • 最新更新时间(YYYY-MM-DD hh:mm:ss)
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
response Response
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • stores
  • Store []
  • 门店信息
  • └ storeCode
  • String
  • C123
  • 门店(仓储)编码
  • └ storeName
  • String
  • M123
  • 门店(仓储)名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
PosStoreSynchronizeRequest req = new PosStoreSynchronizeRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setActionType("add");
req.setTotal(12L);
Store obj1 = new Store();
obj1.setStoreCode("W123");
obj1.setStoreName("测试门店");
obj1.setStoreType("MD");
obj1.setRegion("华南区");
obj1.setOrgCode("ZH123");
obj1.setBusinessType("ZB");
obj1.setCustomerType("ZB");
obj1.setRetailType("PT");
obj1.setPurchaseDiscount("12");
obj1.setRetailDiscount("12");
SettlementInfo obj2 = new SettlementInfo();
obj2.setSettlementType(0L);
obj2.setCurrency("RMB");
obj1.setSettlementInfo(obj2);
Detail obj3 = new Detail();
obj3.setName("老王");
obj3.setZipCode("043355");
obj3.setTel("0987654");
obj3.setMobile("12345677");
obj3.setFax("987654");
obj3.setCountryCode("余杭区");
obj3.setProvince("浙江");
obj3.setCity("杭州");
obj3.setArea("西溪");
obj3.setTown("986号");
obj3.setDetailAddress("浙江余杭");
obj1.setDetail(obj3);
obj1.setIsValid("Y");
obj1.setCreateTime("2017-01-12 00:00:00");
obj1.setLatestUpdateTime("2017-01-12 00:00:00");
req.setStores(obj1);
PosStoreSynchronizeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <stores>
        <store>
            <storeCode>C123</storeCode>
            <storeName>M123</storeName>
        </store>
    </stores>
</response>

异常示例

  • 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

返回
顶部