哥伦比亚

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

  • 已在 RUT（税务唯一登记）注册，并拥有有效的 NIT（税务识别号）。
  • 拥有经 ONAC 批准的有效数字签名证书。ONAC 认证目录。
  • 通过完成 DIAN（国家税务海关局） 要求的认证流程，完成注册并启用。

::: seealso

安装 <general/install> 以下模块即可获得哥伦比亚本地化的全部功能：

名称技术名称描述
哥伦比亚 - 会计l10n_co默认的 税务本地化包。提供科目表、税种、预扣以及证件类型等基础会计功能。
哥伦比亚 DIAN 电子发票l10n_co_dian集成 DIAN（国家税务海关局）自有软件，支持根据 DIAN 规定生成电子发票及支持文件。
哥伦比亚 - 会计报表l10n_co_reports包含向供应商发送预扣认证的会计报表。
哥伦比亚 Carvajal 电子发票l10n_co_edi集成 Carvajal，依据 DIAN 规定生成电子发票及支持文件。
哥伦比亚 - 销售点l10n_co_pos为哥伦比亚本地化提供 POS 收据。

配置公司信息的步骤：

  1. 访问公司联系表单
    • 在 联系人 应用中搜索公司；或
    • 在 设置 应用中，开启 开发者模式 <developer-mode>，在 公司 区块点击 更新信息，再在 联系人 字段点击公司名称。
  2. 配置以下信息：
    • 公司名称。
    • 地址：包括 城市、省/州、邮编。
    • 识别号：选择 识别类型（NIT、公民身份证、民事登记 等），若为 NIT，必须在编号末尾加上以连字符 - 为前缀的 校验位。
  3. 前往 销售 & 采购 选项卡，配置 税务信息：
    • 义务与责任：选择公司对应的税务责任（如 O-13 大纳税人、O-15 自预扣、O-23 IVA 预扣代理、O-47 简易税制、R-99-PN 不适用）。
    • 大纳税人：若公司为大纳税人，勾选此项。
    • 税务制度：选择公司适用的税种名称（IVA、INC、IVA e INC 或 不适用）。
    • 商业名称：若公司使用特定商业名称，填写以便在发票中显示。

:::: tip ::: title 提示 ::: 在 税务信息 区块填写的数据会出现在有效的税务 PDF 报表中。
::::

在 会计 → 配置 → 设置 页面，滚动至 哥伦比亚电子发票 区块，按以下步骤配置：

  1. 将 电子发票提供方 选择为 DIAN：免费服务。

  2. 为不同文档类型（电子发票或支持文件）配置 操作模式：点击 添加行，填写以下字段：

    • 软件模式：文档类型。
    • 软件 ID：DIAN 为该模式生成的 ID。
    • 软件 PIN：DIAN 门户中为该模式设置的 PIN。
    • 测试 ID：DIAN 在测试模式下生成的 ID。

  3. 配置用于签署电子文档的 证书：点击 添加行，填写：

    • 名称：证书名称。
    • 证书：上传 PEM 格式的证书文件。随后在出现的 私钥 字段中选择已有私钥或点击 创建并编辑，在向导中上传有效的密钥文件并保存。

  4. 配置 DIAN 环境，DIAN 电子发票模块提供四种环境：

    • DIAN 演示模式：使用演示证书进行全流程测试，文件自动创建且不发送至任何 DIAN 环境。勾选 DIAN 演示模式。
      :::: note ::: title 注意 ::: 勾选 测试环境 时，DIAN 演示模式 复选框会隐藏。
      :::

    • 认证环境：用于完成 DIAN 认证流程并获得 已启用 状态，可正式开票。需同时勾选 测试环境 与 激活认证流程。

    • 测试环境：在 DIAN 测试门户中复现电子发票流程与校验，仅勾选 测试环境。

    • 生产环境：生成正式电子文档，需取消勾选 测试环境 与 激活认证流程。

      :::: important ::: title 重要 ::: 生产数据库切勿启用 DIAN 演示模式，该模式仅用于测试。
      :::

:::: note ::: title 备注 ::: 在多公司数据库中，每家公司可以拥有独立的证书。
::::

::: seealso 如需使用 Carvajal 方案配置电子发票，请观看视频：Configuración de Facturación Electrónica - Localización de Colombia。
:::

在 联系表单 <../../essentials/contacts> 中配置：

  • 识别号（VAT）：选择识别类型并输入编号；若为 NIT，编号必须包含尾部的校验位（以 - 为前缀）。
  • 在 销售 & 采购 选项卡中填写 税务信息字段（参见公司信息章节）。

路径：会计 → 客户 → 产品，确保在 会计 选项卡的 UNSPSC 类别 或 常规信息 选项卡的 内部参考 已填写。

路径：会计 → 配置 → 税种，选择并编辑相应税种。若销售含税产品，需要在 高级选项 选项卡的 值类型 中进行设置，包含 ICA、IVA、源税 等预扣税种，以便在发票上正确显示。

DIAN 为电子发票分配官方序列号和前缀后，需要在 Odoo 中更新对应的销售日记账：

  1. 前往 会计 → 配置 → 日记账，选择或新建销售日记账。

  2. 在表单中填写 日记账名称、类型，并在 日记账分录 选项卡设置唯一的 短代码。

  3. 在 高级设置 中配置：

    • 电子发票：启用 UBL 2.1（哥伦比亚）。
    • 发票分辨率：DIAN 为公司下发的分辨率编号。
    • 分辨率日期、分辨率结束日期。
    • 编号范围（最小）/（最大）：授权的首尾发票号码。
    • 技术密钥：DIAN 门户或 Web 服务返回的控制键。

    若已配置为 生产环境，可直接点击 重新加载 DIAN 配置 按钮，从 DIAN Web 服务获取最新分辨率信息。

    :::: important ::: title 重要 :::

    • 短代码与分辨率必须与 DIAN 门户提供的完全一致。
    • 首张发票的 序列号和前缀 必须手动匹配 DIAN 格式，随后 Odoo 将自动递增。
      :::

与销售日记账相同的步骤，用于 支持文档（供应商账单）。

::: seealso 更多关于 Carvajal 方案的支持文档日记账，请观看视频：Documento Soporte - Localización de Colombia。
:::

本地化模块默认安装 科目表，基于哥伦比亚的 PUC（统一科目表），并自动映射至税种、默认应付/应收科目。

官方汇率由 哥伦比亚共和国银行 提供。启用自动汇率更新：

  1. 前往 会计 → 配置 → 设置。
  2. 在 货币 区块勾选 自动货币汇率。
  3. 选择 [CO] 哥伦比亚共和国银行 为服务提供方。
  4. 设置更新间隔（如每日、每小时等）。

电子发票的核心流程：

  1. 用户创建发票。
  2. Odoo 生成合法的 XML 文件。
  3. Odoo 生成带电子签名的 CUFE（发票电子代码）。
  4. Odoo 向 DIAN 发送通知。
  5. DIAN 验证发票。
  6. DIAN 接受或拒绝发票。
  7. Odoo 生成含二维码的 PDF 发票。
  8. Odoo 将 XML、DIAN 验证响应及有效 PDF 打包为 .zip。
  9. 用户通过 Odoo 将 .zip 发送给收款方。

:::: note ::: title 注意 ::: 发票验证前的功能流程不影响电子发票的核心变更。
::::

可从销售订单或手动创建发票：会计 → 客户 → 发票 → 创建。在发票表单中填写：

  • 客户 信息。
  • 日记账（电子发票专用）。
  • 电子发票类型（默认 Factura de Venta）。
  • 发票行：选择带正确税率的产品。

:::: important ::: title 重要 ::: 首次使用电子发票日记账时，需要手动将发票序列号改为 DIAN 格式 [前缀+序列]（如 [SETP/2024/00001] 改为 [SETP1]）。
::::

完成后点击 确认。

发票确认后，点击 打印 & 发送，在弹窗中勾选 DIAN 与 邮件，系统将：

  • 生成 XML。
  • 生成 CUFE。
  • 同步向 DIAN 发送 XML。
  • 若被接受，聊天窗口显示 .zip 文件并发送邮件给客户。

DIAN 选项卡显示：

  • 签名日期、状态、测试环境、认证流程、下载、获取附加文档 等信息。

创建贷项通知单与发票相同：会计 → 客户 → 发票，在发票上点击 添加贷项通知单，填写：

  • 贷项方式（部分退款、全额退款、全额退款并生成新草稿）。
  • 原因、冲销日期、使用特定日记账、退款日期 等。

完成后点击 冲销。

创建借项通知单：会计 → 客户 → 发票 → 添加借项通知单，填写：

  • 原因、借项日期、复制行、使用特定日记账。

完成后点击 创建借项通知单。

在配置好主数据、凭证及采购日记账后，可创建 支持文档（供应商账单）：

  • 路径：会计 → 供应商 → 账单。
  • 填写 供应商、账单日期、日记账、发票行（含税品）。

确认后系统自动生成 XML 并发送至 Carvajal。