一 、 ERP标品环境配置
1. 打开菜单OpenApi -> 第三方应用

2. 点击新增按钮,在弹出页中填写如下信息
系统编码: wg_openapi
系统名称: 为谷openapi
访问策略中点击默认AccessToken认证密钥编辑按钮,在弹窗中填写 : Wgadmin123Wgadmin123~
在服务授权页面,点击授权新服务,弹出页面中选择库存管理API服务,基础资料API服务,基础资料(质量管理)API服务添加。
在自建API授权页面,点击新增授权,弹出页面中选择所有编码添加。




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


导入后api如下:

4 开发事件部署:
4.1 打开菜单OpenApi -> 开放事件定义,导入部署包中标品目录下开发事件目录下zip文件中的dts文件。
说明:导入的事件默认是禁用的,选择所有事件编码,点击启用
4.2事件推送订阅(该步骤需要获取isv的wg_sync_event配置信息,请在配置完isv后再配置)
特别说明:配置该步骤的前提是完成下面的ISV CRM环境配置步骤
手动创建下图中三个订阅, 事件订阅回调地址使用isv环境基本认证的调用api
syncbill(单据同步(反写))、wg_customer_trade(客户转交易)、wg_data_push(为谷数据推送)、wg_bi_push(单据同步)

配置回调地址填写说明:
回调地址的前缀为isv上api管理中syncEvent/syncbill,syncEvent/trade,syncEvent/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初始化更新。(本步骤若客户环境已经初始化过了,不需要再执行)

