巴西¶
介绍¶
使用巴西本地化,您可以通过API调用自动计算商品的销售税,使用AvaTax(Avalara),还可以配置服务的税费。
对于商品税务计算部分,您需要从Odoo常规设置中配置: contacts , company , products ,以及 在Avatax中创建一个账户 。
对于服务税,您可以直接从Odoo创建和配置,而无需使用AvaTax进行计算。
本地化还包括税收和可根据需要进行修改的账户模板。
配置¶
模块安装¶
:ref:`安装 <general/install>`以下模块以获取巴西本地化的所有功能:
名称 |
技术名称 |
描述 |
---|---|---|
巴西 - 会计 |
|
默认 财务本地化包 - 为巴西本地化添加了会计特性,这是公司在巴西运营所需的最低配置。模块的安装会自动加载:账户图表、税收和必要字段,以正确配置联系人。 |
巴西 - 会计报告 |
|
添加了一个简单的税务报告,可以帮助检查给定时间段内每个税务组的税额。还为巴西市场添加了适用的损益表和资产负债表。 |
Avatax Brazil |
|
通过Avatax添加巴西税务计算,并添加所有必要的字段以配置Odoo,以便正确使用Avatax并发送所需的财务信息以检索正确的税金。 |
巴西销售订单的Avatax |
|
与 |
配置您的公司¶
要配置您的公司信息,请转到
应用程序并搜索您公司的名称。选择页面顶部的 公司 选项。然后,配置以下字段:
名称
地址`(添加 :guilabel:`城市, 州, 邮编, 国家)
税号(CNPJ)
IE (州登记)
IM (市政登记)
SUFRAMA code (Superintendence of the Manaus Free Trade Zone - add if applicable)
电话
Email
在 销售和采购 选项卡中配置 财务信息:
添加 财务位置 到 Avatax Brazil。
:guilabel:`税制`(联邦税制)
:guilabel:`ICMS 纳税人类型`(表示 ICMS 制度、免税状态或非纳税人。)
主要活动领域
最后,上传公司标志并保存联系人。
注解
如果您是简化制度,您需要在
下配置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设置密码:
访问 Avalara 门户
点击 Meu primeiro acesso
将您在Odoo中使用的电子邮件地址添加到Avalara/Avatax帐户中,然后点击 Solicitar Senha 。
您将收到一封带有令牌和创建密码链接的电子邮件。点击此链接并复制粘贴令牌以分配您所需的密码。
警告
如果您打算首先在测试或沙盒数据库上尝试集成,建议使用另一个电子邮件地址,因为您将无法在生产数据库上重新使用相同的电子邮件地址。
小技巧
您可以在Odoo中开始使用AvaTax而无需创建密码和访问Avalara Portal;对于Odoo来说,开始使用Avalara税务计算引擎的唯一要求是从设置页面创建一个帐户。
注解
您可以转移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 自动创建了三个产品,用于与销售相关的运输成本。它们的名称分别为 Freight
、 Insurance
和 Other Costs
。它们已经配置好,如果需要创建更多,请复制并使用相同的配置(所需配置: 产品类型 服务
, 运输成本类型 保险
、 运费
或 其他成本
)
联系人¶
在使用集成之前,请在联系人上指定以下信息:
关于联系人的一般信息:
选择 公司 选项以选择一个带有税号 (CNPJ) 的联系人,或者选择 个人 选项以选择一个带有 CPF 的联系人。
名称
地址: 邮政编码 是一个必填字段,用于正确计算税费。
税号 或者 CPF: 个人使用 CPF,公司使用税号 (CNPJ)
IE: 状态税务识别号
IM: 市税号
SUFRAMA代码:SUFRAMA注册号码
电话
Email
注解
在 Country 设置为
Brazil
之前, CPF 、 IE 、 IM 和 SUFRAMA code 字段都是隐藏的。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)
,才能自动计算税费。
另请参阅