巴西¶

介绍¶

在巴西本地化功能中，可以通过AvaTax（Avalara）的 API 调用自动计算销售税，并发送货物的电子发票（NF-e）。此外，还可以配置服务税。

For the goods tax computation and electronic invoicing process, you need to configure the contacts, company, products, and create an account in Avatax need to be configured in the general settings.

For the services taxes, you can create and configure them from Odoo directly without computing them with AvaTax.

The localization also includes taxes and a chart of accounts template that can be modified if needed.

配置¶

安装巴西财务本地化服务包以获得巴西本地化的所有默认会计功能，并遵循:abbr:IFRS（国际财务报告标准） 规则。

Configure your company¶

To configure your company information, go to the Contacts app and search the name given to your company.

选择页面顶部的公司选项。然后，配置以下字段：
- 名称。
- 地址（添加城市, 州/市, 邮政编码, 国家/地区）。
  - 在:guilabel:街道 字段中，输入街道名称、编号和其他地址信息。
  - 在街道 2 字段中，输入街区信息。
- 识别码`（:guilabel:`CNPJ、CPF）。
- :guilabel:`税号`（与识别类型相关）。
- :guilabel:`IE`（州注册）。
- :guilabel:`IM`（市级注册）。
- :guilabel:`SUFRAMA 代码`（如果适用，则为马瑙斯自由贸易区总局）。
- 电话。
- 电子邮件。
配置销售及采购选项卡中的财务信息：
- 为 Avatax Brazil 添加财政状况。
- :guilabel:`税收制度`（联邦税制）
- :guilabel:`ICMS 纳税人类型`（表示 ICMS 制度、豁免状态或非纳税人）。
- 主要活动部门。
最后，上传公司徽标并保存联系人

注解

如果是简化制度，则需要在会计 ‣ 配置 ‣ 设置 ‣ 税收 ‣ Avatax Brazil 下配置 ICMS 税率。

配置 AvaTax 整合¶

Avalara AvaTax 是一个税款计算和电子发票提供商，可整合至 Odoo 系统，通过考虑公司、联系人（客户）、产品和交易信息自动计算税款，检索出正确的税款，然后向政府处理电子发票。

使用此整合需要应用内购买（IAP）来计算税款和发送电子发票。每次计算税款时，都会使用您的 IAP 信用余额中的信用额度调用 API 呼叫。

注解

Odoo 是 Avalara Brazil 公司的认证合作伙伴。

凭证配置¶

要在 Odoo 中激活 AvaTax，您需要创建一个账户。请进入会计 ‣ 配置 ‣ 设置 ‣ 税务， AvaTax Brazil 部分，在 Avatax Portal Email 中添加用于 AvaTax 门户网站的管理电子邮件地址，然后点击创建账户。

警告

在测试或沙箱数据库中**测试** :guilabel:`Avatax 门户电子邮件`整合时，请使用备用电子邮件地址。不能在生产数据库中重复使用相同的电子邮件地址。

从 Odoo 创建账户后，您需要进入 Avalara 门户设置密码：

访问 Avalara 门户网站。
点击 Meu primeiro acesso。
添加您在 Odoo 中用于创建 Avalara/Avatax 账户的电子邮件地址，然后点击:guilabel:Solicitar Senha。
您将收到一封电子邮件，其中包含一个令牌和一个创建密码的链接。点击该链接并复制粘贴令牌，即可分配您所需的密码。

小技巧

您可以开始使用 Odoo 中的 AvaTax 进行税务计算，**无需**创建密码和访问 Odoo 数据库中的 Avalara 门户。但是，为了使用电子发票服务，您**必须**访问 AvaTax 门户网站并上传您的证书。

注解

您可以转移 API 证书。只有当您已在另一个 Odoo 实例中创建了账户并希望重复使用该账户时，才可使用此功能。

A1 证书上传¶

为了开具电子发票，需要将证书上传到`AvaTax 门户网站 <https://portal.avalarabrasil.com.br/Login>`_。

只要 AvaTax 门户中的外部识别码（不含特殊字符）与 CNPJ 编号一致，且 Odoo 中的识别码（CNPJ）与 AvaTax 中的 CNPJ 一致，证书就会与 Odoo 同步。

Configure master data¶

科目表¶

The chart of accounts is installed by default as part of the data set included in the localization module. The accounts are mapped automatically in their corresponding taxes, and the default account payable and account receivable fields.

注解

The chart of accounts for Brazil is based on the SPED CoA, which gives a baseline of the accounts needed in Brazil.

您可以根据公司需要添加或删除账户。

日记账¶

在巴西，*系列*号与电子发票的序列号范围相关联。系列号可通过系列字段在 Odoo 的销售日记账上配置。如果需要一个以上的系列号，则需要创建一个新的销售日记账，并为每个系列号分配一个新的系列号。

需要选择使用文档字段。开具电子发票和非电子发票时，类型字段选择创建发票时使用的文档类型。只有在日记账中选择了使用文档字段，才会显示类型字段。

Journal configuration with the Use Documents? field checked.

注解

When creating the journal, ensure the field Dedicated Credit Note Sequence is unchecked, as in Brazil, sequences between invoices, credit notes, and debit notes are shared per series number, which means per journal.

税¶

安装巴西本地化软件时会自动创建税项。Avalara 在计算销售订单或发票上的税额时，会使用已配置的税额。

可以编辑税项或添加更多税项。例如，用于服务的某些税项需要手动添加和配置，因为税项可能因提供服务的城市而异。

重要

AvaTax 不计算服务税。只计算货物税。

When configuring a tax used for a service that is included in the final price (when the tax is not added or subtracted on top of the product price), set the Tax Computation to Percentage of Price Tax Included, and, on the Advanced Options tab, check the Included in Price option.

警告

请勿删除税项，因为它们用于 AvaTax 税务计算。如果被删除，当在销售订单（SO）或发票中使用 AvaTax 计算税项时，Odoo 会重新创建这些税项，但是用于登记税项的账户需要在税项的:guilabel:`定义`选项卡下重新配置，包括:guilabel:`发票分配`和:guilabel:`退款分配`部分。

参见

税务功能文档

产品¶

要在销售订单和发票上使用 AvaTax 整合，首先要在产品上指定以下信息：

:guilabel:`CEST代码`（适用于 ICMS 税收替代的产品代码）。
:guilabel:`Mercosul NCM Code`（南美共同市场商品编码）。
:guilabel:`原产地`（表示产品的原产地，可以是国外或国内，还有其他可能的选项，视具体使用情况而定）。
:guilabel:`SPED 财政产品类型`（根据 SPED 列表确定的税务产品类型）。
用途（说明该产品的预期用途）。

注解

Odoo 会自动创建三个产品，用于支付与销售相关的运输成本。它们分别被命名为 运费、保险费`和`其他费用。它们已经配置好，如果需要创建更多产品，请复制并使用相同的配置（所需配置：产品类型``服务、运输成本类型``保险、运费`或`其他成本）。

联系人¶

使用整合前，请在联系人上指定以下信息：

联系人的基本信息：
- 如果联系人有税号（CNPJ），请选择公司选项；如果联系人有 CPF，请选择个人。
- 名称。
- 地址（添加城市, 州/市, 邮政编码, 国家/地区）。
  - 在街道字段中，输入街道、号码和其他地址信息。
  - 在街道 2 字段中，输入街区信息。
- 识别码`（:guilabel:`CNPJ、CPF）。
- :guilabel:`税号`（与识别类型相关）。
- IE：州税识别号。
- IM: 市税识别号。
- SUFRAMA 代码：SUFRAMA 注册号。
- 电话。
- 电子邮件。
注解
在将:guilabel:国家/地区`设置为`巴西`之前， :guilabel:`CPF、IE、:guilabel:`IM`和 :guilabel:`SUFRAMA 代码`字段会被隐藏。
在销售与采购标签下查看联系人的财务信息：
- 财政状况：添加 AvaTax 财政状况，自动计算销售订单和发票上的税金。
- 税收制度：（联邦税制）
- ICMS Taxpayer Type: taxpayer type determines if the contact is within the ICMS regime, if it is exempt, or if it is a non-taxpayer
- Main Activity Sector: list of main activity sectors of the contact

财政状况¶

要在销售订单和发票上计算税款和发送电子发票，需要在:guilabel:`财政状况`中启用:guilabel:`自动检测`和:guilabel:`使用 AvaTax API`选项。

财政状况可在联系人上配置，或在创建销售订单或发票时选择。

工作流¶

本节概述了触发 `API 调用<https://en.wikipedia.org/wiki/API>`_以进行税款计算的操作，以及如何发送电子货物发票（NF-e）以供政府验证。

警告

请注意，每次 API 调用都会产生费用。请注意触发这些调用的操作，以便有效管理成本。

Tax computation¶

报价单和销售订单的税款计算¶

通过以下任一方式触发 API 调用，使用 AvaTax 自动计算报价单或销售订单上的税款：

报价确认
将报价单确认为销售订单。
手动触发
点击使用 Avatax 计算税额。
预览
点击预览按钮。
通过电子邮件发送报价单/销售订单
通过电子邮件向客户发送报价单或销售订单。
在线报价
当客户在线访问报价单时（通过门户视图），就会触发 API 调用。

Mirto Bonan¶

使用 AvaTax 触发 API 调用，以下列任何一种方式自动计算客户发票上的税款：

手动触发
点击使用 AvaTax 计算税款。
预览
点击预览按钮。
在线发票访问
当客户在线（通过门户视图）访问发票时，就会触发 API 调用。

注解

必须将财政状况设为`自动税收映射（Avalara Brazil）`，这些操作才能自动计算税款。

参见

财政状况（税收和账户映射）

电子文档¶

客户开票¶

要处理货物电子发票（NF-e），Avalara 需要确认发票并计算税款。完成该步骤后，点击左上角的发送打印按钮，弹出一个窗口。然后点击处理电子发票和其他选项 - 下载或电子邮件。最后，点击发送打印处理政府发票。

在发送电子货物发票（NF-e）之前，需要在发票上填写一些字段：

客户包含所有客户信息
:guilabel:`付款方式：巴西`（计划支付发票的方式）
财政状况设置为自动税收映射（Avalara 巴西）。
将:guilabel:文件类型 设置为:guilabel:(55)电子发票(NF-e)。目前，这是唯一
支持的电子文档类型。非电子发票可以进行注册，如果需要的话，可以激活其他文档类型。