快麦适配器配置指南

快麦ERP平台连接器配置指南

一、平台接口API文档

• 获取地址：快麦ERP平台API文档
• 联系供应商：获取更多具体信息
• 示例方案：https://pro.qliang.cloud/strategy/detail/1fb32607-f292-3d0f-9c8f-8afb2cc556c0
• 示例方案：https://pro.qliang.cloud/strategy/detail/075cf909-2877-3547-943e-2073867579ab

二、连接器与适配器配置

2.1 连接器配置

• 平台选择：快麦ERP
• 配置参数：
  • Host：快麦接口请求地址，如 https://gw.superboss.cc/router
  • AppKey：快麦提供的
  • AppSecret：快麦密钥
  • CompanyID：公司ID
  • Token：接口验证Token
  • RefreshToken：用于刷新的Token

注意：避免在两个地方使用同一个Token，以防止Token冲突。

2.2 适配器

• 查询适配器：KuaiMaiQueryAdapter
• 查询列表详情适配器 KuaiMaiDetailsQueryAdapter
• 写入适配器：KuaiMaiExecuteAdapter

三、方案配置

3.1 查询配置

• 接口信息配置：如API地址 open.system.time.get
• 请求参数配置：根据接口需求配置参数

3.1.1 Request参数配置

• 配置接口所需的请求参数

3.1.2 其它请求参数-otherRequest (列表详情请求时需要加上)

• otherapi：详情接口请求地址
• detailkey：详情响应数据字段，如 list
• detailkey1：详情请求参数key，如 id
• detailkey2：列表响应参数key,放到详情请求参数中，如 id

3.1.3 OtherResponse参数配置（接口响应参数）

• StatusKey：接口响应状态字段，支持最多两级
• StatusValue：接口响应成功状态值
• DataKey：接口响应数据的key，支持最多三级
• PageKey：分页key

请求示例：

{
  "refreshToken": "string"
}

列表详情请求示例：

{
  "otherapi": "purchase.order.get",
  "detailkey1": "id",
  "detailkey2": "id",
  "pageNo": "1",
  "pageSize": "1",
  "timeType": "upd_time",
  "startModified": "2024-04-16 23:26:43",
  "endModified": "2024-04-30 14:51:14"
}

详情请求示例：

{
  "isdetails": "true",
  "qcloudid": "4791158530302420",
  "id": 4791158530302420
}

3.2 写入配置

• 接口信息配置：如API地址 erp.item.tag.add

3.2.1 Request参数配置

• 根据接口文档要求配置参数

3.2.2 OtherRequest参数配置

• 暂无特殊配置

3.2.3 OtherResponse参数配置（接口响应参数）

• 参数同查询配置的OtherResponse

请求示例：

{
  "name": "春季新款"
}

四、其他注意事项

• 普通查询和列表查询需要使用不同的适配器。