Appearance
财务凭证对接
当您需要使用对接金蝶云星空的财务凭证时，可以参考以下文档进行配置和使用。
1. 插件介绍
1.1 功能介绍
通过本应用，您可以调用凭证保存、提交和与其相关的其他金蝶功能。
1.2 效果展示
注意1： 此处仅展示凭证保存后的结果
注意2： 通过本应用生成的凭证，其业务类型这一列均为显示为WebAPI
2. 使用前配置
在表单 基础参数 中添加金蝶的账户信息，并保存。
获取账套ID
先使用 管理员账号 登录，然后依次点击 基础管理 -> 公共设置 -> WebAPI
在新的标签页中，随意点击一个接口，并点击左上方的 在线测试测试WebAPI ，在弹框中便可看到 账套ID
3. 主要功能使用说明
提示
以下均为业务流程的 使用示例，提供一个较为直观的演示说明。
实际使用时，应直接调用应用中的 业务流程 工作流，示例部分仅供参考 / 复制学习。
3.1 凭证信息-保存 / 暂存
若成功上传，则可在金蝶系统中查询到状态为 创建 的凭证信息
注意
调用 暂存 业务流程时，不会返回编码信息；仅有 保存 才会返回编码信息。
参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账簿编码 | 文本类型 | ✔️ | 指定使用的账簿，可在金蝶系统内获取到，也可调用 账簿获取-已审核列表 获取 |
| 凭证日期 | 日期类型 | ✔️ | 凭证生成的日期，一般是凭证生成当日 |
| 业务日期 | 日期类型 | 一般和凭证日期相同 | |
| 凭证字编码 | 文本类型 | ✔️ | 指定使用的凭证字，可在金蝶系统内获取到，也可调用 凭证字获取-已审核列表 获取 |
| 凭证号 | 数值类型 | ✔️ | 反应当前凭证的序号 |
| 附件数 | 数值类型 | - | |
| 币别编码 | 文本类型 | ✔️ | 指定账簿币别，可在金蝶系统内获取到，也可调用 账簿获取-已审核列表 获取 |
| 汇率编码 | 文本类型 | ✔️ | 指定账簿汇率，可在金蝶系统内获取到，也可调用 账簿获取-已审核列表 获取 |
| 分录 | 子表类型 | ✔️ | 反应借贷情况 |
| 核算维度 | 子表类型 | 当 分录 中所选科目编码具有核算维度时可填 | |
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 |
使用示例
- 选择名为 “凭证新增” 功能表单
- 点击右上方的 “+记录” 按钮
- 按照
引导填写相关数据，最后点击 “新增凭证” 按钮
存为草稿&提交
如果您没有填写完所有表单字段，可以点击 “存为草稿”，然后下次编辑。
如果您希望保存这一次的上传记录，可以点击 “提交” ，以供后续查阅。
3.2 凭证信息-提交
若调用成功，则可在金蝶系统中查询到状态为 审核中 的凭证信息
参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 凭证编码 | 文本类型 | ✔️ | 指定要提交的凭证，可在金蝶系统内获取到，也可使用 “凭证信息-保存” 的返回结果 |
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 |
使用示例
- 选择名为 “凭证新增” 功能表单
- 点击右上方的 “+记录” 按钮 / 或者点击 “已上传保存的记录”
- （下图为点击
已有记录的示例图）填写 “新增凭证编码” ，或者拿取保存上传凭证后的编码后，再点击 “提交凭证”
3.3 客户信息-保存
若调用成功，则可在金蝶系统中查询到状态为 创建 的客户
提示
显示上和凭证保存的结果一致，后续均省略结果图
参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 | |
| 创建者组织编码 | 文本类型 | ✔️ | 作为该客户的创建者组织，可在金蝶系统内查询，或者通过 账簿获取-已审核列表 获取 |
| 使用者组织编码 | 文本类型 | ✔️ | 作为该客户的创建者组织，可在金蝶系统内查询，或者通过 账簿获取-已审核列表 获取 |
| 客户名称 | 文本类型 | ✔️ | - |
| 简称 | 文本类型 | - | |
| 联系电话 | 文本类型 | - | |
| 币别编码 | 文本类型 | ✔️ | 可在金蝶系统内查询，或者通过 账簿获取-已审核列表 获取 |
| 备注 | 文本类型 | - |
使用示例
- 选择名为 “客户新增” 功能表单
- 点击右上方的 “+记录” 按钮
- 按照
引导填写相关数据，最后点击 “客户信息保存” 按钮
存为草稿&提交
如果您没有填写完所有表单字段，可以点击 “存为草稿”，然后下次编辑。
如果您希望保存这一次的上传记录，可以点击 “提交” ，以供后续查阅。
3.4 客户信息-提交 / 审核
提交： 若调用成功，则可在金蝶系统中查询到状态为 审核中 的客户
审核： 若调用成功，则可在金蝶系统中查询到状态为 已审核 的客户
提示
这两个功能的 输入输出 完全一致，所以合在一起说明
参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 客户编码 | 文本类型 | ✔️ | 指定要提交的凭证，可在金蝶系统内获取到，也可使用 “凭证信息-保存” 的返回结果 |
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 |
- 选择名为 “客户新增” 功能表单
- 点击右上方的 “+记录” 按钮 / 或点击 “已上传保存的客户记录”
- 点击 “客户信息提交” ，成功则金蝶系统内，客户的状态会变为 “审核中”
- 点击 “客户信息审核” ，成功则金蝶系统内，客户的状态会变为 “已审核”
4. 辅助功能使用说明
此处为辅助 主要功能 运作而存在的功能。单独使用则仅起到查询的作用。
4.1 账簿获取-已审核列表
此 “业务流程” 通过指定账户来查询可用的账簿列表。可通过此功能获取账簿相关的一些信息。
输入参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 |
输出参数说明
调用此功能时，可获取如下返回参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| 账簿名 | 文本类型 | - |
| 账簿编号 | 文本类型 | 金蝶系统内唯一编码/编号 |
| 科目表编码 | 文本类型 | 可用来查询该账簿可用的凭证字 |
| 组织ID | 文本类型 | 可认为是该账簿的 核算组织 / 可用组织 的编码 |
| 币别编号 | 文本类型 | 账簿的币别编号，保存凭证时会使用到 |
| 汇率编号 | 文本类型 | 账簿的汇率编号，保存凭证时会使用到 |
此 业务流程 会返回多条数据，可以配合 “流程调用控件” 使用
4.2 凭证字获取-已审核列表
此 “业务流程” 通过指定科目表来查询可用的凭证字。可通过此功能获取指定账簿可用的凭证字。
输入参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 | |
| 科目表编码 | 文本类型 | ✔️ | 根据提供科目表去查询可用的凭证字列表，可从 账簿获取-已审核列表 获取 |
输出参数说明
调用此功能时，可获取如下返回参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| 凭证-ID | 文本类型 | 金蝶系统内唯一编码/编号 |
| 凭证字 | 文本类型 | 凭证字名称，例如，记 |
此 业务流程 会返回多条数据，可以配合 “流程调用控件” 使用
4.3 科目编号获取-已审核列表
此 “业务流程” 通过指定组织来查询可用的科目列表。可通过此功能获取指定账簿可用的科目。
输入参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 | |
| 组织ID | 文本类型 | ✔️ | 根据提供组织去查询可用的科目列表，可从 账簿获取-已审核列表 获取 |
输出参数说明
调用此功能时，可获取如下返回参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| 科目编码 | 文本类型 | 金蝶系统内唯一编码/编号 |
| 科目名 | 文本类型 | 名称，例如，现金 |
| 核算维度名 | 文本类型 | 核算维度的名称；若有多个则使用 / 隔开 |
| 核算维度编号 | 文本类型 | 核算维度的编号；若有多个则使用 / 隔开，用于生成核算维度列表时的 编号 |
| 核算维度字段名 | 文本类型 | 核算维度的字段名；若有多个则使用 / 隔开，用于生成核算维度列表时的 字段名 |
此 业务流程 会返回多条数据，可以配合 “流程调用控件” 使用
4.4 组织获取-编号列表
此 “业务流程” 可获取到登录账号下的所有可用组织。
输入参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 |
输出参数说明
调用此功能时，可获取如下返回参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| 组织编码 | 文本类型 | 金蝶系统内唯一编码/编号 |
| 科目名称 | 文本类型 | 名称，例如，xxxx有限公司 |
| 核算类型 | 文本类型 | 法人 / 核算组织 |
此 业务流程 会返回多条数据，可以配合 “流程调用控件” 使用
4.5 币别获取-已审核列表
此 “业务流程” 可获取到登录账号下的所有可用币别。
输入参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 |
输出参数说明
调用此功能时，可获取如下返回参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| 币别编号 | 文本类型 | 金蝶系统内唯一编码/编号 |
| 币别名称 | 文本类型 | 名称，例如，人民币 |
| 货币代码 | 文本类型 | 例如：CNY，USD |
| 货币符号 | 文本类型 | 例如：￥，$ |
| 舍入类型 | 文本类型 | 1：四舍五入 4：四舍六入五双 |
此 业务流程 会返回多条数据，可以配合 “流程调用控件” 使用
4.6 客户查询-列表获取
此 “业务流程” 可查询已审核过的客户列表，可指定客户名称和联系电话查询。
输入参数说明
调用此功能时，需要指定以下参数类型：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 账号 | 文本类型 | 根据提供账号去检索系统内已配置的金蝶账号信息，若未填，则会使用系统内指定的默认账号 | |
| 客户名称 | 文本类型 | 不提供则查询所有，提供时会采用调用 "包含" 关系来查询 | |
| 联系电话 | 文本类型 | 不提供则查询所有，提供时会采用调用 "包含" 关系来查询 |
输出参数说明
调用此功能时，可获取如下返回参数：
| 参数名 | 类型 | 描述 |
|---|---|---|
| 是否请求错误 | 是否类型 | 若请求 失败，为 true，可从另两个错误字段中获取错误信息 |
| 错误代码 | 文本类型 | 若请求 失败 ，此处会存放金蝶返回的错误代码 |
| 错误信息 | 文本类型 | 若请求 失败 ，此处会存放金蝶返回的错误信息 |
| 客户列表 | 子表类型 | 若请求 成功 ，此处会存放包含 客户编码（文本） 和 客户名称（文本） 的列表 |
此 业务流程 返回单条数据，客户列表在子表中。
