开发须知

说明

本文档适用于铱云易订货2.0产品

::: tip

1. 对接之前请先申请对接口client信息，申请方式在下文
2. 所有接口都是json风格
3. 涉及到时间入参的date-time类型都是时间戳(毫秒)，如：1686023282000
   :::

   更新历史

   更新历史

API基本功能

开放接口提供基础数据管理，商品管理，进销存管理，订单管理

1） 公共模块，包括省市数据，物流公司信息

2）基础数据，包含客户局域，仓库列表，员工列表，客户分类，商品单位，商品品牌，商品授权方案

3） 客户管理，包括新增客户，修改客户，获取客户列表

4） 商品管理，包括新增商品，更新商品，增量商品变更，商品列表，新增商品规格

5） 订单管理，包括订单列表，退单列表，订单出库(发货)

6） 进销存管理，包括其他出入库，审核其他出入库，库存同步，签收列表，出库签收

7） 资金管理，包含收付款单

调用方式

接口调用是通过向供应链API的服务端地址发送HTTP请求，并按照接口说明在请求中加入相应请求参数来完成的；根据请求的处理情况，系统会返回处理结果。

1 请求结构

1.1 服务地址

供应链服务接入地址为：https://openapi.77ircloud.com

1.2 通讯协议

支持通过HTTPS通道进行请求通信。为了获得更高的安全性，推荐您使用HTTPS通道发送请求。

1.3 请求方法

支持HTTP GET方法发送请求，这种方式下请求参数需要包含在请求的URL中。

1.4 请求参数

每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。

1.5 字符编码

请求及返回结果都使用UTF-8字符集进行编码。

所有的请求都需要设置请求Content-Type

Content-Type: application/json; charset=UTF-8

2 公共参数

名称	类型	是否必须	描述
access_token	string	是	开发者准入标识，调用时必须使用
x-client-id	string	是	开发者准入标识，调用时必须使用

3 授权机制

使用标准的Oauth2.0协议进行授权，用户接入前需联系销售客服人员申请开通接口服务，以获取 API Key（client_id）和 Secret Key（client_secret），使用 client_id、client_secret进行登录授权，详情请查看
获取 access_token

4 公共返回参数

接口返回的数据是三段结构

{
    "code" : 返回状态码，业务成功完成是200,
    "message" : "返回信息",
    "data" : "返回数据结果（因接口不一样而一样）"
}