ERP对接API接口顺序
1、注册账号
2、获取 api_key(通用)
1、登录到系统
2、登录页面后,点击菜单栏 ”设置“ 下的 “个人信息”
3、打开后找到“API秘钥”字样,复制对应的值,用于后续接口对接登录凭证
如下图:
3、获取 company_id(通用)
登录到系统
登录页面后,点击菜单栏右上角的站点名称
打开“进入其他站点”对话框,下拉框中显示的是当前用户有权限登录的站点, 站点名称的前两位/三位数字即company_id
如下图:
4、接口基本操作(通用)
系统API采用 restful风格,通过url的GET, POST, PUT, DELETE可以直接操作相应的对象.
基本使用参考:
https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1540385
https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1540390
5、对接具体业务接口
完整接口见 https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1944748045 。 以下是较常用业务接口:
站点信息 | https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1953726708 | 辅助数据, 用于获取客人开通的全部站点信息。调用其他业务接口需要传company_id, 此接口可以获取到完整的可用的company_id. |
邮递服务信息 | https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1953628356 | 用于获取发货渠道信息。下出库单需要提供出货渠道delivery_service_id, 此接口可以获取到完整的可用的delivery_service_id列表 |
产品信息 | https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1953595810 https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1953595858 https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1953628642 https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1936556324 https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1942683734 | 用于创建和管理备案产品,以及产品库存。创建入库单(本地发货)和出库单都需要在鸟系统做产品信息备案,对接此接口方便批量备案产品. |
入库单 | 客户发货单-批量创建Preview | 用于创建入库单,将产品入库到鸟系统 |
出库单 | 1、本地/专线订单Preview 2、代理专线订单Preview 3、FBA订单Preview 订单删除 (通用)Preview 订单修改 (通用)Preview 订单查询 (通用)Preview | 用于创建出库单,将产品通过发货渠道发到买家手里 |
6、生产环境和测试环境
生产环境地址: <详询客服和IT技术人员>
api_key: 注册后能在自己账号中找到
company_id: 根据客人业务范围,在站点列表中选择
为了方便客人测试,我们准备了一个数据独立的测试环境,本对接文档中的各个案例,也是在测试环境下的数据
地址: <详询客服和IT技术人员>
api_key: <详询客服和IT技术人员>
company_id: <详询客服和IT技术人员>