商业票据书写集成路线图
同质化路线图描述了集成合作伙伴在进入生产环境发行商业票据之前，需要在 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 查看某个已登记发行人的详细信息 | 文档链接 |
投资人同质化
注意
对于投资人同质化流程，如果客户拥有固定基金，可以在初始配置阶段完成登记，从而简化集成。
在初始配置阶段完成登记的投资人同质化
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| INV1001* | 列出已登记的投资人 | 列出已登记的基金，可按 CNPJ、名称筛选 | 文档链接 | |
| INV1002* | 投资人详情 | 通过 investor_key 查看某个已登记投资人的详细信息 | 文档链接 |
商业票据发行
完成发行人和投资人的登记后，即可发行商业票据。为此存在若干发行流程组合，具体如下。
| 代码 | 步骤 | 描述 | 文档链接 | 前提条件 |
|---|---|---|---|---|
| COM0001 | 财务条件模拟 | 模拟一笔操作的财务条件与还款流 | 文档链接 | |
| COM0002* | 商业票据操作登记 | 根据财务数据和投资人数据创建一笔新的商业票据操作。 | 文档链接 | COM0001 |
| COM003* | 提交操作进行分析 | 将操作状态变更为"分析中"，送入书写机构的合规校验流程 | 文档链接 | COM0002 |
| COM004* | 提交已签署合同 | 本端点用于将在外部签署的合同提交至书写系统，提交的 base64 内容将由书写机构分析并批准。 | 文档链接 | COM0002 |
| COM0005 | 按筛选条件查询操作 | 使用可选筛选条件查询商业票据操作 | 文档链接 | COM0002、COM0003、COM0004 |
| COM0006 | 按键值查询操作 | 使用唯一键值查询某笔具体操作的完整详情。 | 文档链接 | COM0002、COM0003、COM0004 |
错误映射
来自发行人、投资人和商业票据 API 的错误，可在错误目录链接中查阅