巴西

介绍

使用巴西本地化,您可以通过API调用自动计算商品的销售税,使用AvaTax(Avalara),还可以配置服务的税费。

对于商品税务计算部分,您需要从Odoo常规设置中配置: contactscompanyproducts ,以及 在Avatax中创建一个账户

对于服务税,您可以直接从Odoo创建和配置,而无需使用AvaTax进行计算。

本地化还包括税收和可根据需要进行修改的账户模板。

配置

模块安装

:ref:`安装 <general/install>`以下模块以获取巴西本地化的所有功能:

名称

技术名称

描述

巴西 - 会计

l10n_br

默认 财务本地化包 - 为巴西本地化添加了会计特性,这是公司在巴西运营所需的最低配置。模块的安装会自动加载:账户图表、税收和必要字段,以正确配置联系人。

巴西 - 会计报告

l10n_br_reports

添加了一个简单的税务报告,可以帮助检查给定时间段内每个税务组的税额。还为巴西市场添加了适用的损益表和资产负债表。

Avatax Brazil

l10n_br_avatax

通过Avatax添加巴西税务计算,并添加所有必要的字段以配置Odoo,以便正确使用Avatax并发送所需的财务信息以检索正确的税金。

巴西销售订单的Avatax

l10n_br_avatax_sale

l10n_br_avatax 模块相同,但扩展到销售订单模块。

配置您的公司

要配置您的公司信息,请转到 联系人 应用程序并搜索您公司的名称。

  1. 选择页面顶部的 公司 选项。然后,配置以下字段:

    • 名称

    • 地址`(添加 :guilabel:`城市邮编国家

    • 税号(CNPJ

    • IE (州登记)

    • IM (市政登记)

    • SUFRAMA code (Superintendence of the Manaus Free Trade Zone - add if applicable)

    • 电话

    • Email

    公司配置。
  2. 销售和采购 选项卡中配置 财务信息

    • 添加 财务位置Avatax Brazil

    • :guilabel:`税制`(联邦税制)

    • :guilabel:`ICMS 纳税人类型`(表示 ICMS 制度、免税状态或非纳税人。)

    • 主要活动领域

    公司财务配置。
  3. 最后,上传公司标志并保存联系人。

注解

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

配置AvaTax集成

Avalara AvaTax 是一个可以集成到 Odoo 中的税务计算提供商,可以通过考虑公司、联系人(客户)、产品和交易信息来自动计算税款,以获取正确的税款。

Odoo 是 Avalara 巴西的认证合作伙伴,这意味着 Avalara 专家已经审查了集成范围内涵盖的工作流程。

Using this integration requires In-App-Purchases (IAPs) to compute taxes. Every time you compute taxes, an API call is made, using credits from your IAP credits balance.

凭证配置

要在Odoo中激活AvaTax,您需要创建一个帐户。要这样做,请转到 会计 ‣ 配置 ‣ 设置 ‣ 税收 ,然后在 AvaTax Brazil 部分中添加您要使用的电子邮件地址以登录到AvaTax门户,并单击 创建帐户 。此电子邮件将用作AvaTax中的管理员电子邮件地址。

在从Odoo创建帐户后,您需要转到Avalara Portal设置密码:

  1. 访问 Avalara 门户

  2. 点击 Meu primeiro acesso

  3. 将您在Odoo中使用的电子邮件地址添加到Avalara/Avatax帐户中,然后点击 Solicitar Senha

  4. 您将收到一封带有令牌和创建密码链接的电子邮件。点击此链接并复制粘贴令牌以分配您所需的密码。

警告

如果您打算首先在测试或沙盒数据库上尝试集成,建议使用另一个电子邮件地址,因为您将无法在生产数据库上重新使用相同的电子邮件地址。

小技巧

您可以在Odoo中开始使用AvaTax而无需创建密码和访问Avalara Portal;对于Odoo来说,开始使用Avalara税务计算引擎的唯一要求是从设置页面创建一个帐户。

Avatax 账户配置。

注解

您可以转移API凭据。仅在您已经在另一个Odoo实例中创建了帐户并希望重用它时使用此功能。

配置主数据

科目表

默认情况下, 会计科目 作为本地化模块中包含的数据集的一部分进行安装。这些科目会自动映射到相应的税项,以及默认的应付账款和应收账款字段。

注解

巴西的会计科目表基于SPED CoA,该表提供了巴西所需的基准科目。

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

税费

安装巴西本地化时,税项会自动创建。税项已经配置好,其中一些在计算销售订单或发票的税项时由Avalara使用。

税金可以进行编辑,或者可以添加更多的税金。例如,一些用于服务的税金需要手动添加和配置,因为税率可能因提供服务的城市而异。

重要

附加在服务上的税费不由AvaTax计算。只有商品税费会被计算。

当配置用于包含在最终价格中的服务的税费时(当税费不是在产品价格之上添加或减去时),将 税费计算 设置为 价格税费百分比已包含,并在 高级选项 选项卡上勾选 包含在价格中 选项。

要了解如何配置税务以更好地满足您的需求,请访问: 税务功能文档

税务配置。

警告

不要删除税项,因为它们用于AvaTax税务计算。如果删除,Odoo在使用AvaTax计算税项的|SO|或发票时会重新创建它们,但用于登记税项的账户需要在税项的 定义 选项卡下重新配置,在 发票分配退款分配 部分。

产品

要在销售订单和发票上使用AvaTax集成,请首先在产品上指定以下信息:

  • CEST Code (用于ICMS税替代产品的代码)

  • Mercosul NCM Code (Mercosur Common Nomenclature Product Code)

  • :guilabel:`产品来源`(指示产品的来源,可以是国外或国内,根据具体用例可能有其他可选项)

  • SPED Fiscal Product Type (Fiscal product type according to SPED list table)

  • 使用目的 (为此产品指定预期使用目的)

产品配置。

注解

Odoo 自动创建了三个产品,用于与销售相关的运输成本。它们的名称分别为 FreightInsuranceOther Costs 。它们已经配置好,如果需要创建更多,请复制并使用相同的配置(所需配置: 产品类型 服务运输成本类型 保险运费其他成本

联系人

在使用集成之前,请在联系人上指定以下信息:

  1. 关于联系人的一般信息:

    • 选择 公司 选项以选择一个带有税号 (CNPJ) 的联系人,或者选择 个人 选项以选择一个带有 CPF 的联系人。

    • 名称

    • 地址: 邮政编码 是一个必填字段,用于正确计算税费。

    • 税号 或者 CPF: 个人使用 CPF,公司使用税号 (CNPJ)

    • IE: 状态税务识别号

    • IM: 市税号

    • SUFRAMA代码:SUFRAMA注册号码

    • 电话

    • Email

    联系人配置。

    注解

    Country 设置为 Brazil 之前, CPFIEIMSUFRAMA code 字段都是隐藏的。

  2. Fiscal information about the contact under the Sales & Purchase tab:

    • 财务位置:将AvaTax财务位置添加到销售订单和发票中,以自动计算税费。

    • 税制: 联邦税制

    • ICMS纳税人类型:纳税人类型确定联系人是否属于ICMS制度,是否免税,或者是否为非纳税人。

    • 主要活动领域: 联系人的主要活动领域列表

    联系财务配置。

财政状况

要计算销售订单和发票上的税费,需要启用具有 自动检测使用 AvaTax API 选项的 财务位置

可以在联系人上配置 财务位置 或在创建销售订单或发票时选择。

财政状况配置

工作流程

本节概述了触发税务计算API调用的操作。

警告

请注意,每个API调用都会产生费用。请谨慎处理触发这些调用的操作,以有效管理成本。

报价/销售订单上的税务计算

以以下任何方式之一,通过AvaTax自动触发API调用以计算报价或销售订单上的税费:

  • 报价确认

    确认报价单为销售订单。

  • 手动触发

    点击 使用 Avatax 计算税费

  • 预览

    点击 预览 按钮。

  • 发送报价单/销售订单电子邮件

    通过电子邮件向客户发送报价单或销售订单。

  • 在线报价访问

    当客户通过门户视图在线访问报价时,将触发API调用。

发票上的税务计算

以任何一种以下方式,自动触发 API 调用以使用 AvaTax 计算客户发票上的税费:

  • 手动触发

    点击 使用 AvaTax 计算税费

  • 预览

    点击 预览 按钮。

  • 在线发票访问

    当客户通过门户视图在线访问发票时,会触发API调用。

注解

必须将 财务位置 设置为 自动税务映射(Avalara Brazil),才能自动计算税费。