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

概述

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

基础资料变更（存货、往来单位）

库存变动

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

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

一、基础资料推送

触发时机

存货（Ptype）、往来单位（Btype，含供应商和客户）发生新增、修改或删除操作后触发。

请求体结构

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

字段说明

字段	类型	说明
`code`	string	固定值 `"0"`
`message`	string	固定为空字符串
`basetype`	string	基础资料类型，见下表
`dealtype`	string	操作类型：`modify`（新增/修改）/ `delete`（删除）
`typeid`	string	被操作记录的ID

basetype 枚举值

值	含义
`ptype`	存货
`btype`	往来单位（包含供应商和客户）

二、库存推送

触发时机

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

请求体结构

{
  "code": "0",
  "message": "",
  "response": [
    {
      "ptypeid": "101",
      "ktypeid": "5",
      "blockno": "",
      "prodate": "",
      "custom1": "",
      "custom2": "",
      "custom3": "",
      "custom4": "",
      "qty": 100.00,
      "qtyother": 0.00,
      "kusercode": "WH001",
      "kfullname": "主仓库",
      "pusercode": "P001",
      "pfullname": "存货A",
      "c1usercode": "",
      "c1fullname": "",
      "c2usercode": "",
      "c2fullname": "",
      "krec": 1,
      "prec": 1,
      "custom1rec": 0,
      "custom2rec": 0
    }
  ]
}

字段说明

字段	类型	说明
`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

字段名均为小写。

三、接收端实现要求

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

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

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

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

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

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

四、URL配置说明

推送URL在系统后台「接口设置」页面进行配置，支持以下两个推送地址：

配置项	数据库配置名	说明
基本信息回调地址	`BaseInfoPushUrl`	基础资料变更时推送的目标URL
库存回调地址	`GoodsStocksPushUrl`	库存变动时推送的目标URL

各推送类型需在「权限设置」中开启对应的API权限后方可生效。

数据推送

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

概述#

一、基础资料推送#

触发时机#

请求体结构#

字段说明#

basetype 枚举值#

二、库存推送#

触发时机#

请求体结构#

字段说明#

response 数组对象字段说明#

三、接收端实现要求#

四、URL配置说明#

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

概述

一、基础资料推送

触发时机

请求体结构

字段说明

basetype 枚举值

二、库存推送

触发时机

请求体结构

字段说明

response 数组对象字段说明

三、接收端实现要求

四、URL配置说明