菜单

CRM和ERP的对接配置

 

 

一 、 ERP标品环境配置

1.  打开菜单OpenApi -> 第三方应用

 

2. 点击新增按钮,在弹出页中填写如下信息

系统编码 wg_openapi

系统名称: 为谷openapi

访问策略中点击默认AccessToken认证密钥编辑按钮,在弹窗中填写   Wgadmin123Wgadmin123~

在服务授权页面,点击授权新服务,弹出页面中选择库存管理API服务,基础资料API服务,基础资料(质量管理)API服务添加。

 在自建API授权页面,点击新增授权,弹出页面中选择所有编码添加。

3.  Api部署:  

打开菜单OpenApi -> API开发 ,打开api管理列表,在自定义页签导入部署包中标品目录下API服务(openapi_apilist)_为谷_xxxx.zipAPI服务(openapi_apilist)_为谷同步_xxxx.zip文件,注:文件下载地址为 https://drive.weixin.qq.com/s?k=AO8AFgeeAA8UI0XBi7

 

导入后api如下

4  开发事件部署

 4.1  打开菜单OpenApi -> 开放事件定义,导入部署包中标品目录下开发事件目录下zip文件中的dts文件。

说明:导入的事件默认是禁用的,选择所有事件编码,点击启用

 

4.2事件推送订阅该步骤需要获取isvwg_sync_event配置信息,请在配置完isv后再配置)

  特别说明:配置该步骤的前提是完成下面的ISV CRM环境配置步骤

手动创建下图中三个订阅, 事件订阅回调地址使用isv环境基本认证的调用api

syncbill(单据同步(反写))、wg_customer_trade(客户转交易)、wg_data_push(为谷数据推送)、wg_bi_push(单据同步)

 

配置回调地址填写说明:

回调地址的前缀为isvapi管理中syncEvent/syncbillsyncEvent/tradesyncEvent/webhook的完整服务地址,如下图:

回调地址的openApiSign参数取自isv上第三方应用中wg_sync_event 中的基本认证的用户密钥(链接?openApiSign=xxxx&x-acgw-identity=xxxx),

回调地址的x-acgw-identity 参数取自isv上第三方应用中wg_sync_event 中的x-acgw-identity

 

事件推送订阅回调地址为:“API管理里面的完整服务地址”?openApiSign=“第三方应用-同步事件回调-基本认证-secret key”&“第三方应用-同步事件回调的x-acgw-identity值”

链接和参数是?隔开,参数和参数之间是&隔开

syncbill(单据同步(反写))里订阅事件如下:

wg_bi_push(单据同步)里订阅事件如下:

 

配置已订阅事件说明:

客户转交易新增 收款单保存客户转交易,销售订单保存客户转交易,销售出库单保存客户转交易三个事件

单据同步反写新增 销售订单同步,其他出库单同步,费用报销单同步,其他入库单同步四个事件

为谷数据推送新增之前导入的其他的同步事件。

注意:发布!!!

二  ISV CRM环境配置

  •  1. ISV是否对接ERP开关设置: 

           打开菜单为谷crm->基础设置->系统参数,如下

 

  • 2.  打开菜单OpenApi -> 第三方应用 新增第三方应用,填写如下信息:

系统编码 wg_sync_event  

名称 同步事件回调

点击添加策略,选择基本认证, 在弹窗中输入认证用户。本步骤会自动生成用户密钥,标品事件订阅回调地址api签名使用。

 在自建API授权页面,点击新增授权,弹出页面中选择同步事件回调(编码:syncEvent/webhook)、单据同步(反写)(编码:syncEvent/syncbill)和客户转交易(syncEvent/trade)

 

 

  • 3.  打开菜单OpenApi -> API开发 ,打开api管理列表,在自定义页签导入部署包中ISV目录中的自定义API文件, 导入后显示如下开放事件调用的api:

 

 

  • 4. 打开菜单 为谷云 ->基础设置 -> 第三方OpenAPI配置,填写如下信息:

访问地址前缀: 填写isv要访问的标品登录地址

第三方appid: 填写标品部署第三方应用中系统编码wg_openapi

第三方app的密码:填写标品部署第三方应用中中AccessToken认证密码

x-acgw-identity填写标品部署第三方应用中自动的该字段值

租户ID:   可通过打开标品的第三方应用wg_openapi获取,点击该api页面中获取token示例中tenantid值。

OpenAPI配置

 

5   金蝶标准api初始化更新。(本步骤若客户环境已经初始化过了,不需要再执行) 

分享文章
最近修改: 2025-10-16