哥伦比亚¶
Odoo 的哥伦比亚本地化包为哥伦比亚的数据库提供会计、财务和法律功能，例如会计科目表、税收和电子发票。在 Odoo 中使用 DIAN 自有软件 解决方案时，本地化具有以下 先决条件：
在 `RUT<https://www.dian.gov.co/tramitesservicios/tramites-y-servicios/tributarios/Paginas/RUT.aspx>`_（税务登记簿）中注册，并具有有效的NIT。
拥有 ONAC 批准的 有效数字签名证书。
通过完成DIAN要求的认证流程来 注册并获得启用。
其他资料
For more information on how to complete the certification process for the DIAN module, review the following webinar
配置¶
模块安装¶
安装 下列模块，以获得哥伦比亚本地化的所有功能：
名称 |
技术名称 |
描述 |
|---|---|---|
哥伦比亚 - 会计 |
|
默认 财务本地化套装。该模块为哥伦比亚本地化添加了基本会计功能：会计科目表、税金、预扣款和身份证明文件类型。 |
哥伦比亚 DIAN 电子发票 |
|
此模块包含与DIAN作为其自有软件集成所需的功能，并根据DIAN法规添加了生成电子发票和支持文档的能力。 |
哥伦比亚 - 会计报告 |
|
此模块包含会计报告，用于向供应商发送已应用预扣税的认证。 |
哥伦比亚电子发票 - 使用 Carvajal |
|
此模块包含与 Carvajal 集成所需的功能。根据DIAN法规添加了生成电子发票和支持文档的能力。 |
哥伦比亚 - 销售点 |
|
此模块包括哥伦比亚本地化的POS收据。 |
公司信息¶
配置您的公司信息：
访问您公司的联系人表单：
前往联系人应用并搜索您的公司；或
前往设置应用，启用开发者模式，然后在公司部分中，点击更新信息。接着，在联系人字段中，点击公司名称。
配置以下信息：
公司名称。
地址：包括 城市、部门 和 邮政编码。
识别号码：选择 识别类型`（`NIT、
Cédula de Ciudadanía、Registro Civil`等）。当 :guilabel:`识别类型为NIT时，识别号码 必须 在 ID 末尾有*验证码*，以连字号（-）为前缀。
前往销售与采购选项卡并配置财务信息：
Obligaciones y Responsabilidades：选择公司的财务责任（`O-13`Gran Contribuyente、`O-15`Autorretenedor、`O-23`Agente de retención IVA、`O-47`Regimen de tributación simple、`R-99-PN`No Aplica）。
Gran Contribuyente：如果公司是 Gran Contribuyente，请启用此选项。
财务制度：选择适用于公司的征税项目名称（
IVA、INC、IVA e INC或No Aplica)商业名称：如果公司使用特定的商业名称，并且需要在发票中显示。
小技巧
在财务信息部分配置的数据会打印在有效的财务 PDF 报告中。
电子发票凭证和DIAN环境¶
要配置用于连接DIAN网络服务和DIAN环境的用户凭证，请导航至并滚动到哥伦比亚电子发票部分。然后，按照以下步骤操作：
选择DIAN：免费服务作为电子发票提供商。
为从 Odoo 生成的相应文档类型（电子发票*或*支持文档）配置操作模式。点击添加行，然后填写以下字段：
软件模式：要使用该操作模式生成的文档类型。
软件 ID：由DIAN为特定操作模式生成的 ID。
软件 PIN：在DIAN门户的操作模式配置中选择的 PIN。
测试 ID：由DIAN生成并在测试操作模式后获得的测试 ID。
配置用于签署电子文档的可用证书。点击添加行，然后填写以下字段：
名称：证书的名称。
证书：上传 PEM 格式的证书文件。在屏幕上显示的私钥字段中，选择现有的私钥或创建新的私钥。为此，请输入密钥名称并选择创建并编辑。然后，在创建私钥向导中，上传有效的密钥文件并点击保存并关闭。
配置DIAN环境；DIAN电子发票模块提供四种不同的DIAN环境以供连接：
DIAN 演示模式：此环境允许使用演示数字证书测试电子发票工作流程。文件会自动创建和接受，且不会发送到任何DIAN环境。可以测试所有内部验证。要激活它，请勾选DIAN 演示模式复选框。
注解
当启用测试环境复选框时，DIAN 演示模式复选框将隐藏。
认证环境：该环境用于通过 DIAN 认证流程，并从 Odoo 获得 启用 状态以开具发票。要激活该环境，请同时启用 测试环境 和 启动认证程序 复选框。
测试环境：该环境允许在 DIAN 测试门户中重现电子发票流程和验证。要激活它，只需启用 测试环境 复选框。
生产环境：此环境允许生成有效的电子文档。要激活它，请同时禁用测试环境和激活认证流程复选框。
重要
不要在生产数据库上激活DIAN 演示模式。此模式仅供测试环境使用。
注解
在多公司数据库中，每家公司都可以拥有自己的证书。
其他资料
有关使用 Carvajal 解决方案的电子发票配置，请观看以下视频：Configuración de Facturación Electrónica - Localización de Colombia。
主数据¶
联系人¶
在联系人表单上配置以下字段：
识别号`（VAT）：选择识别号类型并输入识别号。如果识别号类型为:guilabel:`NIT，识别号末尾必须包含校验位，前面加连字符（
-）。销售与采购选项卡中的财务信息字段。
产品¶
通过访问产品表单，并确保配置了UNSPSC 类别字段（位于会计选项卡中）或内部参考字段（位于常规信息选项卡中）。
税¶
要创建或修改税种，请转到 并选择相关税项。
如果销售交易包含含税产品，请在高级选项选项卡中配置值类型字段。还包括预扣税类型（ICA、IVA、Fuente）。此配置用于在发票上正确显示税费。
销售日记账¶
一旦 DIAN 为电子发票决议指定了正式序列和前缀，**必须**在 Odoo 中更新与发票相关的销售日记账。要执行此操作，请导航至:menuselection:会计 --> 配置 --> 日记账，然后选择一个现有的销售日记账，或使用:guilabel:`创建`按钮创建一个新的销售日记账。
在销售日记账表单中，输入 日记账名称、类型，并在 日记账条目 选项卡中设置唯一的 简码。然后，在 高级设置 选项卡中配置以下数据：
电子发票： 启用 UBL 2.1 (哥伦比亚)。
发票决议：DIAN通过其测试集向公司发放的决议号。
决议日期：决议的初始生效日期。
决议结束日期：决议有效期的结束日期。
编号范围（最小）：第一个授权发票编号。
编号范围（最大值）：最后授权的发票号码。
技术密钥：从DIAN门户测试集或其网络服务（生产环境情况下）接收的控制密钥。
当数据库配置为生产环境时，无需手动配置这些字段，点击重新加载 DIAN 配置按钮即可从DIAN网络服务获取DIAN决议信息。
采购日记账¶
一旦 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）。
多币种¶
哥伦比亚的官方汇率由Banco de la República提供。
要启用自动汇率更新，请按照以下步骤操作：
前往。
导航到货币部分并启用自动货币汇率。
确保选择[CO] Bank of the Republic作为服务。
选择间隔，以设置货币汇率自动更新的频率。
主要工作流程¶
电子发票¶
以下是哥伦比亚本地化电子发票主要工作流程的细目：
用户创建发票。
Odoo 会生成合法的 XML 文件。
Odoo 生成带有电子签名的 CUFE（发票电子代码）。
Odoo 向 DIAN 发送通知。
DIAN 验证发票。
DIAN 接受或拒绝发票。
Odoo 会生成带有二维码的 PDF 发票。
Odoo 会将所附文档（包含发送的 XML 文件和 DIAN 验证响应）和有效 PDF 压缩成
.zip文件。用户通过 Odoo 向收单机构发送发票（:file:`.zip`文件）。
开票创建¶
注解
发票验证前的功能工作流程**不会**改变电子发票带来的主要变化。
生成电子发票并发送给|DIAN|和客户。这些文件可以根据销售订单创建，也可以手动生成。要创建新发票，请进入 并选择 创建。在发票表单中，配置以下字段：
客户：客户信息。
日记账：电子发票使用的日记账。
电子发票类型：选择文件类型。默认情况下，选择 Factura de Venta。
发票行：指定正确纳税的产品。
重要
在创建与电子发票日记账相关的第一张发票时，需要手动将发票的*序列*更改为|DIAN|格式：前缀 + 序列。
例如，格式化从 SETP/2024/00001 到 SETP1 的序列。
完成后，点击 确认。
电子发票发送¶
在发票确认后，点击发送。在出现的向导中，确保启用DIAN和电子邮件复选框，以便向DIAN网络服务发送 XML，并将已验证的发票发送到客户的财务电子邮件，然后点击发送。然后：
XML 文档已创建。
CUFE 已生成。
XML 由DIAN同步处理。
如果被接受，文件将显示在聊天记录中，并向客户发送包含相应
.zip文件的电子邮件。
DIAN选项卡显示以下内容：
签署日期：XML 创建的时间戳记录。
状态：在DIAN响应中获得的状态结果。如果发票被拒绝，可以在此处查看错误消息。
测试环境：了解发送的文档是否已交付到DIAN测试环境。
认证流程：了解文档是否作为与DIAN的认证流程的一部分发送。
下载：下载已发送的 XML 文件，即使DIAN结果被拒绝。
获取附加文档：下载包含在交付给客户的
.zip文件中的生成附加文档文件。
贷记单¶
贷记单的流程与发票相同。要参照发票创建信用证，请转到 。在发票上点击 添加贷记单，然后填写以下信息：
贷记方式：选择贷记方式的类型。
部分退款： 部分退款时使用此选项。
全额退款：如果贷记票据为全额，请使用此选项。
全额退款和新发票草稿：如果贷记单已自动验证并与发票对账，则使用此选项。原始发票将作为新的草稿被复制。
原因：输入贷记的原因。
逆转日期：选择是否要为贷方票据设置一个特定日期，或者是日记账分录日期。
使用特定日记账：为贷记单选择日记账，如果想使用与原始发票相同的日记账，则将其留空。
退款日期：如果选择了特定日期，请选择退款日期。
审核完毕后，点击 逆转 按钮。
借记单¶
借记单的创建过程与贷记单类似。要参照发票创建借记单，请转到 。在发票上点击 添加借记单 按钮，然后输入以下信息：
原因：键入借记的原因。
借记日期：选择特定选项。
复制行：如果您需要用发票的相同行数登记借记票据，请选择此选项。
使用特定日记账：选择借记单的打印点，如果要使用与原始发票相同的日记账，则将其留空。
完成后，点击 创建借记单。
供应商账单支持文件¶
有了主数据、凭证和为供应商账单相关支持文档配置的采购日记账，您就可以开始使用*支持文档*了。
供应商账单的支持文件可通过采购订单或手动创建。进入 并填写以下数据：
供应商：输入供应商信息。
账单日期：选择账单日期。
日记账：选择与供应商账单相关的支持文件的日记账。
已开票行：指定正确纳税的产品。
审核完成后，点击 确认 按钮。确认后，将创建一个 XML 文件并自动发送给 Carvajal。
Common errors¶
在 XML 验证过程中，最常见的错误与缺少 :ref:`主数据 <localization/colombia/master-data>`有关。在这种情况下，会显示验证错误信息并阻止发送。
如果发票已发送，并被 DIAN 设置为*已拒绝*，则可通过点击 DIAN 选项卡中:guilabel:状态`字段旁边的 :icon:`fa-info-circle:guilabel:`(info circle)`图标查看错误信息。使用所报告的错误代码，可以在重新发送前查看要应用的解决方案。
更正主数据或其他问题后，可以再次重新处理 XML。请按照 电子发票发送 流程操作。
财务报告¶
Certificado de Retención en ICA¶
该报告是向供应商提供的哥伦比亚工商业税（ICA）预扣证明。该报告可在 下找到。
点击 （齿轮） 图标，显示 下载 Excel 和 复制到文件 选项。
Certificado de Retención en IVA¶
该报告出具关于从供应商预扣增值税金额的证明。该报告可在 下找到。
点击 （齿轮） 图标，显示 下载 Excel 和 复制到文件 选项。
Certificado de Retención en la Fuente¶
该证书用于向合作伙伴发放预扣税款。该报告可在 下找到。
点击 （齿轮） 图标，显示 下载 Excel 和 复制到文件 选项。
