乌拉圭本地化电子发票指南 – Odoo 配置与使用
乌拉圭
介绍 {#uruguay/intro}
通过乌拉圭本地化,您可以使用其 XML、税务编号、电子签名以及通过 Uruware 与税务机关 Dirección General Impositiva (DGI) 的连接来生成电子文档。
支持的文档包括:
e-发票,e-发票信用票据,e-发票借记票据;e-票据,e-票据信用票据,e-票据借记票据;出口 e-发票,出口 e-发票信用票据,出口 e-发票借记票据.
本地化需要一个 Uruware 账户,该账户使用户能够在 Odoo 中生成电子文档。
::: seealso 乌拉圭电子发票合法性及合规性文档 <../accounting/customer_invoices/electronic_invoicing/uruguay> :::
术语表
以下术语在乌拉圭本地化中频繁使用:
- DGI:Dirección General Impositiva,乌拉圭负责税款征收的政府机构。
- EDI:Electronic Data Interchange,指电子文档的发送。
- Uruware:第三方机构,负责公司与乌拉圭政府之间的电子文档交换。
- CAE:Constancia de Autorización de Emisión,从税务机关网站获取的用于启用电子发票的授权文件。
配置
模块安装
安装 <general/install> 以下模块即可获得乌拉圭本地化的全部功能:
| 名称 | 技术名称 | 描述 |
|---|---|---|
乌拉圭 - 会计{.interpreted-text role=“guilabel”} | [l10n_uy] | 默认的 财政本地化包。它为乌拉圭本地化添加会计特性,是公司在乌拉圭运营的最小配置,包括加载科目表、税种、文档类型和税务支持类型。 |
乌拉圭会计 EDI{.interpreted-text role=“guilabel”} | [l10n_uy_edi] | 包含生成和验证 电子文档 的全部技术与功能需求,基于 DGI 发布的技术文档。授权文档见上文 介绍。 |
:::: note
::: title
注意
:::
当在创建数据库时选择 乌拉圭 为国家时,Odoo 会自动安装基础模块 乌拉圭 - 会计。但要启用电子发票,需要手动 安装 <general/install> 乌拉圭会计 EDI([l10n_uy_edi])模块。
::::
公司
在 设置 应用中,向下滚动到 公司 部分,点击 更新信息,并配置以下内容:
公司名称地址(包括街道、城市、省份、邮编、国家)税号:输入所选纳税人类型的识别号码。DGI 主分支代码:创建电子文档时 XML 中需要的字段,若未设置,所有电子文档将被拒绝。
获取 DGI 主分支代码 的步骤:
- 登录您的 DGI 账户,进入
Servicios en línea DGI --> Registro único tributario --> Consulta de datos。 - 选择
Consulta de Datos Registrales --> Consulta de Datos de Entidades。 - 打开生成的 PDF,从
Domicilio Fiscal Número de Local部分获取 DGI 主分支代码。
在数据库设置完成后,前往 联系人 并搜索您的公司,确认:
- 公司类型为
Company。 识别号码的类型为RUT / RUC。
设置 Uruware 账户 {#l10n_uy/uruware-account}
创建 Uruware 账户的步骤:
- 确认您拥有有效的 Odoo 订阅。
- 在
会计 --> 配置 --> 设置中找到 Uruware 凭证设置。 - 向下滚动到
乌拉圭本地化部分,选择环境(生产或测试)。 - 点击
创建 Uruware 账户。
完成后,系统会向您 Odoo 订阅关联的邮箱发送一封邮件,包含登录 Uruware 门户并设置账户的密码。
:::: tip ::: title 提示 :::
- 邮件可能延迟至 48 小时才收到。
- 必须先设置公司的
税号才能创建 Uruware 账户。 - 密码 24 小时后失效,可在 Uruware 门户使用 “忘记密码” 链接重置。
::::
:::: note ::: title 注意 ::: 创建的 Uruware 账户信息包括:
- 法人名称(razón social)
- 公司 RUT
- 用户名(Odoo 订阅邮箱或
[RUT].odoo,如213344556677.odoo) - Odoo 数据库链接
请确保上述信息完整,以免账户创建不成功。 ::::
收到凭证邮件后,可在 Uruware 测试门户(https://odootest.ucfe.com.uy/Gestion/)或 生产门户(https://prod6109.ucfe.com.uy/Gestion/)使用邮件中的账户凭证登录。
在 Uruware 门户中,需要完成以下步骤才能在 Odoo 中开具发票:
- 完善公司信息。
- 添加数字证书。
- 为计划开具的每种文档类型添加
CAEs(Constancia de Autorización para Emisión)。 - 配置要打印并发送给客户的 PDF 格式。
:::: important
::: title
重要
:::
请务必分别配置 测试 与 生产 两个账户。证书在两个环境均需,而 CAEs 仅在生产环境需要。
::::
::: seealso
电子发票数据
要配置电子发票数据,需要在 会计 --> 配置 --> 设置 中的 乌拉圭本地化 部分选择环境并填写凭证。
环境选择
生产:用于正式数据库,电子文档通过 Uruware 发送至 DGI 进行验证。测试:用于测试数据库,文档发送至 DGI 测试环境。演示:文档自动创建并接受,但 不 发送至 DGI,适用于演示,不会出现拒绝错误。请勿在生产库中使用。
:::: note
::: title
注意
::: 演示 模式不需要 Uruware 账户。
::::
输入 Uruware 数据
Uruware WS 密码商户代码终端代码
:::: note
::: title
注意
:::
上述数据可在 Uruware 门户的 Uruware 账户 页面获取。获取方式:
Uruware WS 密码:在配置 --> 公司 --> 编辑,验证者与附加信息标签页查找。商户代码:在配置 --> 分支中查看。终端代码:在配置 --> 开票点中查看。
::::
主数据
科目表
本地化模块默认安装 科目表,并自动映射税务、默认应付/应收科目。可根据公司需求增删科目。
::: seealso ../accounting/get_started/chart_of_accounts :::
联系人
在 联系人 应用中新建联系人,填写:
公司名称地址(街道、城市、省份、邮编、国家)识别号码(类型、号码)
税务
乌拉圭本地化模块自动创建税种并关联相应财务科目。
文档类型
政府(DGI)定义的文档类型会在模块安装时自动创建。可在 会计 --> 配置 --> 文档类型 查看。
:::: note
::: title
注意
:::
在乌拉圭,CAEs(Constancia de Autorización de Emisión) 必须在 Uruware 中上传。序列号和 PDF 由 Uruware 根据 CAEs 返回。CAEs 仅在生产环境使用,测试时只需设置 Uruware 提供的序列范围。
::::
销售日记账
配置电子文档的销售日记账要点:
开票类型:默认Electronic,用于通过 Uruware 向 DGI 发送电子文档。Manual用于已在其他系统(如 DGI)预先盖章的发票。使用文档?:若该日记账将使用 Odoo 中的文档类型列表,请启用此选项。
工作流
配置完数据库后,即可创建各种文档。
销售文档
客户发票
客户发票 <../accounting/customer_invoices> 为电子文档,验证后通过 Uruware 发送至 DGI。可从销售订单创建或手工创建,必须包含:
客户:填写客户信息。到期日:决定是现付还是信用。日记账:选择电子销售日记账。文档类型:如(111) e-发票。产品:选择带正确税率的产品。
:::: note
::: title
注意
:::
每种文档类型都有对应的信用票据和借记票据,例如 (111) e-发票 对应 (112) e-发票信用票据。
::::
客户信用票据
客户信用票据 <../accounting/customer_invoices/credit_notes> 为电子文档,需先有已验证(已记账)的发票。操作步骤:
- 在发票上点击
信用票据按钮。 - 在弹出的表单中填写:
原因日记账(必须是电子且启用 “使用文档?”)文档类型(信用票据类型)冲销日期
客户借记票据
客户借记票据 <../accounting/customer_invoices/credit_notes> 同样需要已验证的发票。操作步骤:
- 在发票上点击右上角
fa-cog(操作菜单),选择借记票据。 - 在表单中填写:
原因日记账(同上)- 勾选
复制行以复制发票明细。 借记票据日期
:::: note
::: title
注意
:::
确认发票后点击 发送并打印 并勾选 创建 CFE,系统会从 Uruware 获取合法的文档序列号。请确保 Uruware 中已有可用的 CAEs。
::::
:::: note ::: title 注意 ::: 已验证文档的 PDF 由 Uruware 按乌拉圭政府(DGI)的规范提供。 ::::
附加信息和披露
附加信息 与 披露 是可选或必填的补充说明。创建新附加信息的路径:会计 --> 配置 --> 附加信息和披露 → 新建。
需要填写:
名称:附加信息或强制披露的名称。类型:选择备注类型,决定在 XML 中的插入位置。是否为声明:若为强制披露则勾选,否则留空。内容:完整的文字内容。
产品中的声明与补充信息
如需在产品及其 XML 中加入声明(leyenda),需在发票行的 披露 字段选择相应的预设附加信息。
发票中的声明与补充信息
在发票的 其他信息 标签页,选择 附加信息和披露 字段中的项,即可在 XML 与 PDF 中显示。
适用的附加信息类型包括:
- 文档
- 开票方
- 收票方
- 附加信息
:::: note
::: title
注意
:::
如需在电子文档中临时添加说明,可使用 条款与条件 字段,该信息会随附加信息一起发送,但不会被保存用于后续文档。
::::