商业票据书写集成路线图
同质化路线图描述了集成合作伙伴在进入生产环境发行商业票据之前，需要在 QI Tech 沙盒环境（测试环境）中测试的所有功能和特性。
本路线图描述了产品所涉及的所有资源和功能。
注意
所有测试必须强制在 QI Tech 沙盒环境（测试环境）中进行。 在沙盒环境中执行的操作均为虚拟金融操作，仅用于 API 功能测试。
书写 API 注册与认证
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| CAB0001* | 公钥交换 | 与平台运营团队（suporte.dcm@qitech.com.br）进行公钥交换 | 文档链接 | |
| CAB0002* | 调用认证测试 | 从平台团队获取 API 密钥后，完成调用认证测试 | 文档链接 文档链接 | CAB0001 |
| CAB0003* | Webhooks 配置 | 配置 QI 发送 webhooks 的 URL。 | 文档链接 文档链接 文档链接 | CAB0001 和 CAB0002 |
发行人同质化
注意
对于发行人同质化流程，如果客户已完成与 QI TECH 出让人登记系统的集成，可以重复使用这些登记，简化书写系统的同质化流程。
通过书写系统在 QI TECH 出让人系统中完成登记的发行人同质化
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| CED1001* | 重用出让 人登记 | 使用 CNPJ 重用出让人登记。 | 文档链接 | |
| CED1002* | 已登记发行人列表 | 按 CNPJ、名称筛选的已登记出让人列表 | 文档链接 | |
| CED1003* | 发行人详情 | 通过 issuer_key 查看已登记发行人的详情 | 文档链接 |
通过书写系统完成登记的发行人同质化
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| CED0001* | 发行人基本登记 | 创建发行人，提交基本登记信息。 | 文档链接 | |
| CED0002* | 发行人文件上传和删除 | 上传和删除与已登记发行人关联的文件 | 文档链接 文档链接 | CED0001 |
| CED0003* | 发行人代表的登记和删除 | 上传和删除与已登记发行人关联的代表 | 文档链接 文档链接 | CED0001 |
| CED0004* | 发行人代表文件的上传和删除 | 上传和删除与已登记发行人代表关联的文件 | 文档链接 文档链接 | CED0001, CED0003 |
| CED0005* | 发行人银行账户的登记和删除 | 登记和删除与已登记发行人关联的银行账户 | 文档链接 文档链接 | CED0001 |
| CED0006* | 发行人签署人组的登记和删除 | 登记和删除与已登记发行人关联的签署人组 | 文档链接 文档链接 | CED0001 |
| CED0007* | 发行人联系信息的登记和删除 | 登记和删除与已登记发行人关联的联系信息 | 文档链接 文档链接 | CED0001 |
| CED0008* | 提交发行人分析 | 此端点允许将发行人状态更改为分析中，将其提交到验证流程。 | 文档链接 | CED0001, CED0002, CED0003, CED0004, CED0005, CED0006, CED0007 |
| CED0009* | 修改发行人登记 | 修改发行人以允许编辑 | 文档链接 | CED0001, CED0002, CED0003, CED0004, CED0005, CED0006, CED0007 |
| CED0010* | 已登记发行人列表 | 按 CNPJ、名称筛选的已登记出让人列表 | 文档链接 | |
| CED0011* | 发行人详情 | 通过 issuer_key 查看已登记发行人的详情 | 文档链接 |
投资人同质化
注意
对于投资人同质化流程，如果客户有固定基金，可以在设置时登记，简 化集成。
通过设置完成登记的投资人同质化
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| INV1001* | 已登记投资人列表 | 按 CNPJ、名称筛选的已登记基金列表 | 文档链接 | |
| INV1002* | 投资人详情 | 通过 investor_key 查看已登记投资人的详情 | 文档链接 |
通过书写系统完成登记的投资人同质化
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| INV0001* | 投资人基本登记 | 创建投资人，提交基本登记信息。 | 文档链接 | |
| INV0002* | 投资人文件上传和删除 | 上传和删除与已登记投资人关联的文件 | 文档链接 文档链接 | INV0001 |
| INV0003* | 投资人代表的登记和删除 | 上传和删除与已登记投资人关联的代表 | 文档链接 文档链接 | INV0001 |
| INV0004* | 投资人代表文件的上传和删除 | 上传和删除与已登记投资人代表关联的文件 | 文档链接 文档链接 | INV0001, INV0003 |
| INV0005* | 投资人银行账户的登记和删除 | 登记和删除与已登记投资人关联的银行账户 | 文档链接 文档链接 | INV0001 |
| INV0006* | 投资人签署人组的登记和删除 | 登记和删除与已登记投资人关联的签署人组 | 文档链接 文档链接 | INV0001 |
| INV0007* | 投资人联系信息的登记和删除 | 登记和删除与已登记投资人关联的联系信息 | 文档链接 文档链接 | INV0001 |
| INV0008* | 提交投资人分析 | 此端点允许将投资人状态更改为分析中，将其提交到验证流程。 | 文档链接 | INV0001, INV0002, INV0003, INV0004, INV0005, INV0006, INV0007 |
| INV0009* | 修改投资人登记 | 修改投资人以允许编辑 | 文档链接 | INV0001, INV0002, INV0003, INV0004, INV0005, INV0006, INV0007 |
| INV0010* | 已登记投资人列表 | 按 CNPJ、名称筛选的已登记基金列表 | 文档链接 | |
| INV0011* | 投资人详情 | 通过 investor_key 查看已登记投资人的详情 | 文档链接 |
商业票据发行
完成发行人和投资人登记后，即可进行商业票据发行。为此，存在多种发行流程组合，将在下方详细说明。
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| COM0001* | 财务条件模拟 | 模拟操作的财务条件和付款流程 | 文档链接 | |
| COM0002* | 商业票据操作登记 | 根据财务数据和投资人信息创建新的商业票据操作。 | 文档链接 | COM0001 |
| COM0003* | 相关方的登记和删除 | 登记和删除与操作相关的相关方 | 文档链接 | COM0002 |
| COM0004* | 相关方代表文件的上传和删除 | 上传和删除与操作相关方代表关联的文件 | 文档链接 | COM0002, COM0003 |
| COM0005* | 相关方代表签署人组的上传和删除 | 上传和删除与操作相关方代表关联的签署人组 | 文档链接 | COM0002, COM0003 |
| COM0006 | 预览章程协议 | 使用预定义模板为特定操作生成章程协议草稿。 | 文档链接 | COM0002 |
| COM0007* | 修改章程协议模板 | 修改特定操作的章程协议模板 | 文档链接 | COM0002 |
| COM0008* | 文件上传 | 上传与操作相关的文件。返回的 "document_key" 可用于担保系统等场景 | 文档链接 | COM0002 |
| COM0009* | 操作担保上传 | 添加与操作相关的担保 | 文档链接 | COM0002, COM0008 |
| COM0010* | 合同/担保中相关方的登记和删除 | 登记和删除操作中特定合同/担保的相关方 | 文档链接 | COM0002, COM0003 |
| COM0011* | 提交操作分析 | 将操作状态更改为"分析中"，提交到书写方的合规验证流程 | 文档链接 | COM0002, COM0003, COM0004, COM0005, COM0006, COM0007, COM0008, COM0009 |
| COM0012* | 提交已签署的批准纪要 | 此端点允许向书写系统提交外部签署的 SA 或 COP 类型公司的批准纪要（base64 格式），该纪要将由书写方审核批准。 | 文档链接 | COM0002 |
| COM0013* | 按筛选条件查询操作 | 使用可选筛选条件查询商业票据操作 | 文档链接 | COM0002, COM0003, COM0004, COM0005, COM0006, COM0007, COM0008, COM0009 |
| COM0014* | 按密钥查询操作 | 使用唯一密钥查询特定操作的完整详情。 | 文档链接 | COM0002, COM0003, COM0004, COM0005, COM0006, COM0007, COM0008, COM0009 |
通过 QI SIGN 签名的情况
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| COM0015* | 查询操作的 QI SIGN 签名链接 | 使用唯一密钥查询特定操作通过 QI SIGN 签名的所有链接。 | 文档链接 | COM0002, COM0003, COM0004, COM0005, COM0006, COM0007, COM0008, COM0009 |
| COM0016* | 查询操作的 QI SIGN 已签署合同链接 | 使用唯一密钥查询特定操作通过 QI SIGN 签署的所有文件 | 文档链接 | COM0002, COM0003, COM0004, COM0005, COM0006, COM0007, COM0008, COM0009 |
整合/认购流程
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| INT0001* | 按密钥查询整合 | 使用唯一密钥查询整合流程的详情 | 文档链接 | |
| INT0002* | 查询认购 | 查询进行中的认购 | 文档链接 | INT0001 |
| INT0003 | 认购登记 | 登记投资人认购整合中特定数量份额的意向（在需要调整认购日期时有用） | 文档链接 | INT0001, INT0002 |
| INT0004 | 取消认购 | 取消认购（在需要调整认购日期时有用） | 文档链接 | INT0001, INT0002 |
错误映射
发行人、投资人和商业票据 API 的错误可在 错误目录链接 中找到