财贸API 推送接口文档（第三方接收端）

概述

系统在以下事件发生时，会主动向已配置的第三方URL推送数据：

基础资料变更（存货、往来单位、职员、项目）

库存变动

单据操作（新增、修改、删除、审核、反审核）

推送方式：HTTP POST，Content-Type 为 application/json; charset=UTF-8

注意： 配置推送URL时，必须包含 http:// 或 https:// 协议前缀，例如 https://api.example.com/receive。

一、基础资料推送

触发时机

存货（Ptype）、供应商/客户（Btype）、职员（Etype）、项目（Mtype）发生新增、修改或删除操作后触发。

请求体结构

{
  "code": "0",
  "message": "",
  "response": [
    {
      "basetype": "ptype",
      "dealtype": "modify",
      "typeid": "12345"
    }
  ]
}

字段说明

字段	类型	说明
`code`	string	固定值 `"0"`
`message`	string	固定为空字符串
`response`	array	基础资料变更信息，固定只有一条记录
`response[0].basetype`	string	基础资料类型，见下表
`response[0].dealtype`	string	操作类型：`modify`（新增/修改）/ `delete`（删除）
`response[0].typeid`	string	被操作记录的ID

basetype 枚举值

值	含义
`ptype`	存货
`supplier`	供应商/客户（往来单位）
`etype`	职员
`mtype`	项目

二、库存推送

触发时机

单据操作导致库存发生变动时触发。

请求体结构

{
  "code": "0",
  "message": "",
  "response": [
    {
      "ptypeid": 101,
      "ptypename": "存货A",
      "warehouseid": 5,
      "warehousename": "主仓库",
      "qty": 100.00,
      "...": "..."
    }
  ]
}

字段说明

字段	类型	说明
`code`	string	固定值 `"0"`
`message`	string	固定为空字符串
`response`	array	库存记录列表

response 数组对象字段说明

字段	类型	说明
`ptypeid`	string	商品ID
`ktypeid`	string	仓库ID
`blockno`	string	批次号
`prodate`	string	生产日期
`custom1`	string	自定义项1 ID
`custom2`	string	自定义项2 ID
`custom3`	string	自定义项3
`custom4`	string	自定义项4
`qty`	decimal	库存数量
`qtyother`	decimal	其他数量
`kusercode`	string	仓库编号
`kfullname`	string	仓库名称
`pusercode`	string	商品编号
`pfullname`	string	商品名称
`c1usercode`	string	自定义项1编号
`c1fullname`	string	自定义项1名称
`c2usercode`	string	自定义项2编号
`c2fullname`	string	自定义项2名称
`krec`	int	仓库Rec
`prec`	int	商品Rec
`custom1rec`	int	自定义项1 Rec
`custom2rec`	int	自定义项2 Rec

字段名均为小写。

三、单据推送

触发时机

单据执行新增、修改、删除、审核、反审核操作后触发。

请求体结构

{
  "code": "0",
  "message": "",
  "response": [
    {
      "vchtype": 101,
      "vchcode": 100023,
      "dealtype": "audit"
    }
  ]
}

字段说明

字段	类型	说明
`code`	string	固定值 `"0"`
`message`	string	固定为空字符串
`response`	array	单据操作信息，固定只有一条记录
`response[0].vchtype`	number	单据类型编码
`response[0].vchcode`	number	单据编号（主键ID）
`response[0].dealtype`	string	操作类型，见下表

dealtype 枚举值

值	含义
`add`	新增保存
`modify`	修改保存
`delete`	删除
`audit`	审核
`unaudit`	反审核

四、接收端实现要求

接口方式：接收端须提供可接受 HTTP POST 请求的 URL 接口。

编码：请求体编码为 UTF-8。

异步推送：系统采用异步线程推送，第三方接口响应时间建议控制在 5秒以内，避免因超时导致系统线程积压。

幂等性：同一操作可能因网络重试等原因重复推送，第三方接口应具备幂等处理能力。

响应内容：推送为单向通知，系统不处理第三方的响应内容，第三方无需返回特定格式。

URL格式：推送URL必须携带 http:// 或 https:// 协议前缀。

五、URL配置说明

推送URL在系统后台进行配置，支持配置多个推送目标地址。不同推送类型（基础资料、库存、单据）分别维护独立的URL列表，各类型推送需单独开启权限开关后方可生效。

数据推送

财贸API 推送接口文档（第三方接收端）#

概述#

一、基础资料推送#

触发时机#

请求体结构#

字段说明#

basetype 枚举值#

二、库存推送#

触发时机#

请求体结构#

字段说明#

response 数组对象字段说明#

三、单据推送#

触发时机#

请求体结构#

字段说明#

dealtype 枚举值#

四、接收端实现要求#

五、URL配置说明#

财贸API 推送接口文档（第三方接收端）

概述

一、基础资料推送

触发时机

请求体结构

字段说明

basetype 枚举值

二、库存推送

触发时机

请求体结构

字段说明

response 数组对象字段说明

三、单据推送

触发时机

请求体结构

字段说明

dealtype 枚举值

四、接收端实现要求

五、URL配置说明