开发须知

说明

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

提示

对接之前请先申请对接口client信息，申请方式在下文

所有接口都是json风格

涉及到时间入参的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" : "返回数据结果（因接口不一样而一样）"
}

说明#

更新历史#

API基本功能#

调用方式#

1 请求结构#

1.1 服务地址#

1.2 通讯协议#

1.3 请求方法#

1.4 请求参数#

1.5 字符编码#

2 公共参数#

3 授权机制#

4 公共返回参数#

说明

更新历史

API基本功能

调用方式

1 请求结构

1.1 服务地址

1.2 通讯协议

1.3 请求方法

1.4 请求参数

1.5 字符编码

2 公共参数

3 授权机制

4 公共返回参数