API开放平台

TIP

# 新增修改客户仓库

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/dmsStorehouse/v1/saveCmStorehouse/{openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "operate_type": "1",
  "code": "CK6317",
  "name": "仓库名称",
  "address": "江苏省南京市建邺区",
  "area": "1000平米",
  "floor": "3楼",
  "remark": "",
  "linkman": "李明",
  "linkman_phone": "15951234567",
  "cm_code": "CUS00001",
  "is_default": "1",
  "is_enable": "QY"
}

参数说明：

参数 类型 必填 说明
operate_type VARCHAR(32) 否 1：新增 2：修改。默认新增。
id VARCHAR(32) 否 仓库id。id,code,name在修改时匹配仓库优先级依次降低
code VARCHAR(200) 是 仓库编码。id,code,name在修改时匹配仓库优先级依次降低
name VARCHAR(200) 是 仓库名称。id,code,name在修改时匹配仓库优先级依次降低
cm_id VARCHAR(32) 否 客户id，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
cm_code VARCHAR(100) 否 客户编码，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
cm_source_code VARCHAR(100) 否 客户第三方唯一标识，客户id、客户编码、客户第三方唯一标识必须传一个，如果同时存在，优先级依次递减
linkman VARCHAR(200) 是 联系人
linkman_phone VARCHAR(200) 是 联系人电话
address VARCHAR(1000) 是 地址
area VARCHAR(1000) 否 仓库面积
floor VARCHAR(1000) 否 楼层
remark VARCHAR(4000) 否 说明
is_enable VARCHAR(32) 是 仓库状态 QY：启用, TY：停用
is_default VARCHAR(32) 否 是否默认仓库 1：是, 0：否。默认否

响应示例：

{
  "return_code": "1",
  "return_msg": "",
  "msg_id": "X0000000001"
}

参数说明：

参数 类型 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码：0成功 1失败
return_msg VARCHAR(100) 响应说明

# 客户仓库查询

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/dmsStorehouse/v1/queryCmStorehouse/{openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "createDateStart": "1970-01-01",
  "createDateEnd": "1970-01-02",
  "page": "1",
  "rows": "1000",
  "isEnable": "QY"
}

参数说明：

参数 类型 必填 说明
createDateStart TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
createDateEnd TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
modifyDateStart TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
modifyDateEnd TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd
isEnable VARCHAR 否 启用状态。启用：QY，停用：TY
dealerId VARCHAR 否 关联客户ID。多个用英文逗号分割
dealerName VARCHAR 否 关联客户名称。多个用英文逗号分割
dealerCode VARCHAR 否 关联客户编码。多个用英文逗号分割
page INT 否 页码默认1，每页默认1000条
rows INT 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

{
  "return_code": "1",
  "return_msg": "",
  "msg_id": "X0000000001",
  "response_data":"<<DATA>>"
}

数据DATA示例:

[
    {
      "id": "5428366834768977542",
      "code": "CK252554",
      "name": "XX批发部南京仓",
      "dealerId": "5428366834768977542",
      "dealerName": "XX批发部",
      "dealerCode": "KH252334",
      "isDefault": "1",
      "linkman": "",
      "linkmanPhone": "",
      "addr": "",
      "area": "",
      "floor": "",
      "remark": "",
      "isEnable": "QY",
      "createTime": "1970-01-01 10:10:10",
      "modifyTime": "1970-01-01 11:11:11",
      "status": "1",
    }
]

参数说明：

参数 类型 说明
id String 主键ID
code String 仓库编码
name String 仓库名称
dealerId String 关联客户ID
dealerName String 关联客户名称
dealerCode String 关联客户编码
isDefault String 默认仓库。T：是，F:否
linkman String 联系人
linkmanPhone String 联系电话
addr String 地址
area String 仓库面积
floor String 楼层
remark String 备注
isEnable String 启用状态。QY：启用，TY：停用
createTime String 创建时间
modifyTime String 修改时间
status String 删除状态。0：删除，1：正常

← 客户库存接口 →