哥伦比亚¶

Odoo 的哥伦比亚本地化包为哥伦比亚数据库提供会计、税务和法律功能，例如科目表、税种和电子发票。使用 Odoo 的 DIAN 自有软件解决方案时，本地化需要满足以下先决条件：

在 `RUT <https://www.dian.gov.co/tramitesservicios/tramites-y-servicios/tributarios/Paginas/RUT.aspx>`_（唯一税务登记）中注册，并拥有有效的 NIT。
持有由 ONAC 批准的有效数字签名证书 https://onac.org.co/directorio-de-acreditados/ 。
通过完成 DIAN 要求的认证流程进行注册并启用。

参见

有关如何完成 DIAN 模块认证流程的更多信息，请查看以下网络研讨会。
智能教程 - 哥伦比亚本地化
哥伦比亚电子发票合法性与合规性文档

配置¶

模块安装¶

安装下列模块，以获得哥伦比亚本地化的所有功能：

名称	技术名称	描述
哥伦比亚 - 会计	`l10n_co`	默认财务本地化套装。该模块为哥伦比亚本地化添加了基本会计功能：会计科目表、税金、预扣款和身份证明文件类型。
DIAN 支持的哥伦比亚电子发票	`l10n_co_dian`	此模块包含作为自有软件与 DIAN 集成所需的功能，并根据 DIAN 规定增加了生成电子发票和支持文档的能力。
哥伦比亚 - 会计报告	`l10n_co_reports`	此模块包含向供应商发送扣缴证明的会计报告。
哥伦比亚电子发票 - 使用 Carvajal	`l10n_co_edi`	此模块包含与 Carvajal 集成所需的功能，并根据 DIAN 规定增加了生成电子发票和支持文档的能力。
哥伦比亚 - 销售点	`l10n_co_pos`	此模块包含适用于哥伦比亚本地化的销售点（POS）收据。

公司信息¶

配置您的公司信息：

访问您公司的联系表单：
- 前往联系人应用并搜索您的公司，或者；
- 前往设置应用，激活开发者模式，然后在公司部分点击更新信息。接着，在联系人字段中点击公司名称。
配置以下信息：
- 公司名称。
- 地址：包括城市、省/部门和邮政编码。
- 识别号码：选择识别类型（ NIT、公民身份证、民事登记等）。当识别类型为 NIT 时，识别号码必须以连字符（- ）为前缀，并在 ID 的末尾包含 校验码 。
前往销售与采购标签页并配置税务信息：
- 义务与责任：选择公司的税务责任。（ O-13 大纳税人、O-15 自行扣缴代理、O-23 增值税扣缴代理、O-47 简化税收制度、R-99-PN 不适用）。
- 大纳税人：如果公司是 大纳税人 ，启用此选项。
- 税务制度：选择公司的税种名称（增值税 (IVA)、所得税 (INC)、增值税和所得税 (IVA e INC) 或不适用）。
- 商业名称：如果公司使用特定的商业名称并且需要显示在发票上。

小技巧

在税务信息部分配置的数据将打印在有效的税务 PDF 报告中。

电子发票凭证和 DIAN 环境¶

要配置用于连接 DIAN 的 Web 服务和 DIAN 环境的用户凭证，请导航至会计 ‣ 配置 ‣ 设置并滚动到哥伦比亚电子发票部分。然后，按照以下步骤操作：

选择 DIAN：免费服务作为电子发票提供商。
为从 Odoo 生成的不同类型的文档（电子发票 或 支持文件）配置操作模式。点击添加一行，然后填写字段：
- 软件模式：通过操作模式生成的文档类型。
- 软件 ID ：由 DIAN 为特定操作模式生成的 ID。
- 软件 PIN ：在 DIAN 门户中配置操作模式时选择的 PIN。
- 测试 ID ：由 DIAN 生成并在测试操作模式后获得的 ID。
配置可用的证书以签署电子文档。点击添加一行，然后填写字段：
- 名称：证书的名称。
- 证书：上传 PEM 格式的证书文件。在屏幕上出现的私钥字段中，选择现有的私钥或创建一个新的私钥。为此，请输入密钥名称并选择创建并编辑。然后，在创建私钥向导中上传有效的密钥文件并点击保存并关闭。
配置 DIAN 环境；DIAN 电子发票模块提供三种不同的 DIAN 环境供连接：
- 认证环境 ：该环境用于通过 DIAN 认证流程，并从 Odoo 获得启用状态以开具发票。要激活该环境，请同时启用测试环境和启动认证程序复选框。
- 测试环境 ：该环境允许在 DIAN 测试门户中重现电子发票流程和验证。要激活它，只需启用测试环境复选框。
- 正式运营环境 ：激活正式运营数据库以生成有效的电子文档。要激活它，请禁用测试环境和激活认证流程复选框。

注解

在多公司数据库中，每家公司都可以拥有自己的证书。

参见

有关使用 Carvajal 解决方案的电子发票配置，请观看以下视频：Configuración de Facturación Electrónica - Localización de Colombia 。

主数据¶

联系人¶

在联系人表单上配置以下字段：

识别号码（税号）：选择识别号码类型并输入识别号码。如果识别号码类型为 NIT ，识别号码必须包含校验码，并以连字符（- ）为前缀。
销售与采购标签页中的税务信息字段。

产品¶

通过会计 ‣ 客户 ‣ 产品访问产品表单，并确保配置了 UNSPSC 类别字段（位于会计标签页中）或内部参考字段（位于基本信息标签页中）。

税项¶

要创建或修改税种，请转到会计 ‣ 配置 ‣ 税项并选择相关税项。

如果销售交易包含含税产品，请在高级选项标签页中配置值类型字段。扣缴税种（ ICA、IVA、源泉税）也包括在内。此配置用于在发票上正确显示税款。

销售日记账¶

一旦 DIAN 分配了电子发票决议的正式序列和前缀，必须在 Odoo 中更新与发票相关的销售日记账。为此，请导航至会计 ‣ 配置 ‣ 日记账，选择现有的销售日记账或使用创建按钮创建新的日记账。

在销售日记账表单中，输入日记账名称和类型，然后在日记账条目标签页中设置唯一的简码。接着，在高级设置标签页中配置以下数据：

电子发票：启用 UBL 2.1（哥伦比亚）。
发票决议：由 DIAN 通过其测试集颁发给公司的决议编号。
决议日期：决议的初始生效日期。
决议结束日期：决议的有效期结束日期。
编号范围（最小值）：第一个授权的发票编号。
编号范围（最大值）：最后一个授权的发票编号。
技术密钥：从 DIAN 门户测试集或生产环境中的 Web 服务获取的控制密钥。

当数据库配置为生产环境时，无需手动配置这些字段，而是点击重新加载 DIAN 配置按钮，从 DIAN Web 服务获取 DIAN 决议信息。

重要

日记账的简码和决议必须与 DIAN 门户测试集或 MUISCA 门户中收到的一致。
在创建第一张发票时，必须正确配置发票序列和前缀。Odoo 会自动为后续发票分配前缀和序列。

采购日记账¶

一旦 DIAN 为与供应商账单相关的*支持文件*指定了正式序列和前缀，就需要在 Odoo 中更新与其支持文件相关的采购日记账。该过程类似于配置销售日记账。

参见

有关使用 Carvajal 解决方案支持文档期刊的更多信息，请查阅`Documento Soporte - Localización de Colombia video <https://www.youtube.com/watch?v=UmYsFcD7xzE&list=PL1-aSABtP6ABxZshems3snMjx7bj_7ZsZ&index=8>`_ 。

科目表¶

作为本地化模块的一部分， :doc:`会计科目表</applications/finance/accounting/get_started/chart_of_accounts>`是默认安装的，会计科目自动映射为税金、默认应付账款和默认应收账款。哥伦比亚的会计科目表基于 PUC（Plan Unico de Cuentas）。

主要工作流程¶

电子发票¶

以下是哥伦比亚本地化电子发票主要工作流程的细目：

用户创建发票。
Odoo 会生成合法的 XML 文件。
Odoo 生成带有电子签名的 CUFE（发票电子代码）。
Odoo 向 DIAN 发送通知。
DIAN 验证发票。
DIAN 接受或拒绝发票。
Odoo 会生成带有二维码的 PDF 发票。
Odoo 会将所附文档（包含发送的 XML 文件和 DIAN 验证响应）和有效 PDF 压缩成 .zip 文件。
用户通过 Odoo 将发票（ .zip 文件）发送给收单机构。

开票创建¶

注解

发票验证前的功能工作流程**不会**改变电子发票带来的主要变化。

电子发票生成后将同时发送至 DIAN 和客户。这些文档可以从销售订单生成，也可以手动创建。要创建新发票，请导航至会计 ‣ 客户 ‣ 发票，然后选择创建。在发票表单中，配置以下字段：

客户：客户信息。
日记账：用于电子发票的日记账。
电子发票类型：选择文件类型。默认情况下，选择 Factura de Venta 。
发票行：指定正确纳税的产品。

重要

在创建与电子发票日记账相关的第一张发票时，需要手动将发票的序列更改为 DIAN 格式：前缀 + 序列 。

例如，将序列从 SETP/2024/00001 格式化为 SETP1 。

完成后，点击确认。

电子发票发送¶

在发票确认后，点击打印并发送。在出现的向导中，确保勾选 DIAN 和电子邮件复选框，以将 XML 发送到 DIAN Web 服务，并将验证后的发票发送到客户的税务邮箱，然后点击打印并发送。随后：

XML 文档已创建。
CUFE 已生成。
XML 被 DIAN 同步处理。
如果被接受，文件将显示在聊天记录中，并通过电子邮件发送给客户，附带相应的 .zip 文件。

DIAN 标签页随后显示以下内容：

签署日期：XML 创建的时间戳。
状态：从 DIAN 响应中获取的状态结果。如果发票被拒绝，可以在此处查看错误消息。
测试环境：了解发送的文档是否已交付至 DIAN 测试环境。
认证流程：了解文档是否作为 DIAN 认证流程的一部分发送。
下载：即使 DIAN 结果被拒绝，仍可下载已发送的 XML 文件。
获取附件文档：下载包含在交付给客户的 .zip 文件中的生成附件文档。

贷记单¶

贷记单的流程与发票相同。要参照发票创建信用证，请转到会计 ‣ 客户 ‣ 发票。在发票上点击添加贷记单，然后填写以下信息：

贷记方式：选择贷记方式的类型。
- 部分退款：部分退款时使用此选项。
- 全额退款：如果贷记票据为全额，请使用此选项。
- 全额退款和新发票草稿：如果贷记单已自动验证并与发票对账，则使用此选项。原始发票将作为新的草稿被复制。
原因：输入贷记的原因。
逆转日期：选择是否要为贷方票据设置一个特定日期，或者是日记账分录日期。
使用特定日记账：为贷记单选择日记账，如果想使用与原始发票相同的日记账，则将其留空。
退款日期：如果选择了特定日期，请选择退款日期。