巴西¶
介绍¶
通过巴西本地化，销售税可以自动计算，并且可以通过 API 调用使用 AvaTax (Avalara) 发送商品 (NF-e) 和服务 (NFS-e) 的电子发票。此外，还可以配置服务税。
为了进行商品和服务税计算以及电子发票流程，您需要配置 联系人、公司、产品，并在 AvaTax 中创建一个账户，该账户需要在常规设置中进行配置。
对于服务税，您可以直接从Odoo创建和配置，而无需使用AvaTax进行计算。
本地化还包括税收和可根据需要进行修改的账户模板。
配置¶
模块安装¶
安装 以下模块以获取巴西本地化的所有功能：
名称 |
技术名称 |
描述 |
|---|---|---|
巴西 - 会计 |
|
默认的 财务本地化包，它包含了通用的巴西会计科目和税务，以及文档类型和识别类型。 |
巴西 - 会计报告 |
|
巴西的会计报告。 |
AvaTax Brazil & AvaTax Brazil for Services |
|
通过 Avalara 计算商品和服务税。 |
巴西会计 EDI & 巴西服务会计 EDI |
|
通过 AvaTax 为巴西的商品和服务提供电子发票。 |
Brazil Pix QR codes |
|
为巴西实施 Pix 二维码。 |
配置您的公司¶
要配置您的公司信息，请转到 应用程序并搜索您公司的名称。
选择页面顶部的 公司 选项。然后，配置以下字段：
名称
地址: 添加 城市, 州, 邮政编码, 国家
在 Street 字段中，输入街道名称、门牌号以及任何其他地址信息。
在 街道 2 字段中，输入街区信息。
Identification Number: CNPJ 或 CPF
税号: 与识别类型相关联
IE: 州注册
IM: 市政登记
SUFRAMA 代码: 马瑙斯自由贸易区管理局 - 如果适用则添加
电话
Email
在 销售和采购 选项卡中配置 财务信息：
添加 Fiscal Position 以用于 AvaTax Brazil。
税务制度: 联邦税务制度
ICMS 纳税人类型: 表示 ICMS 制度、免税状态 或 非纳税人
主活动区域
配置以下额外的 财务信息 如果您要开具 NFS-e：
添加 Fiscal Position 以用于 AvaTax Brazil。
COFINS 详情: 应税、非应税、税率为 0% 的应税、免税、暂停
PIS 详情 应税、非应税、税率为 0% 的应税、免税、暂停
CSLL Taxable 公司是否需缴纳CSLL
最后，上传公司标志并保存联系人。
注解
如果您是简易税制，您需要在 下配置 ICMS 税率。
配置AvaTax集成¶
Avalara AvaTax 是一个税款计算和电子发票提供商，可整合至 Odoo 系统，通过考虑公司、联系人（客户）、产品和交易信息自动计算税款，检索出正确的税款，然后向政府处理电子发票。
使用此集成需要 应用内购买 (IAPs) 来计算税款并发送电子发票。每当您计算税款、发送电子文档（NF-e、NFS-e 等）或执行任何电子流程（NF-e 取消、更正信、使发票号码范围无效）时，都会使用您的 IAP 信用余额 中的信用进行 API 调用。
注解
Odoo 是 Avalara Brazil 公司的认证合作伙伴。
您可以在 odoo.com 购买 IAP 积分。
创建时，新数据库会收到 500 个免费积分。
凭证配置¶
要在 Odoo 中激活 AvaTax，您需要创建一个账户。为此，请前往 ，在 AvaTax Brazil 部分中，将用于 AvaTax 门户的管理员电子邮件地址添加到 AvaTax 门户电子邮件 中，然后点击 创建账户。
警告
当在沙盒或生产数据库中 测试 或 创建生产 AvaTax Portal Email 集成时，请使用真实的电子邮件地址，因为无论是测试还是生产使用，都需要登录 Avalara 门户并设置证书。
有两个不同的 Avalara 门户，一个用于测试，另一个用于生产：
在 Odoo 中创建账户时，请确保选择正确的环境。此外，用于开设账户的电子邮件不能用于开设另一个账户。在 Odoo 中创建账户时，请保存您的 API ID 和 API Key 。
在从Odoo创建帐户后，您需要转到Avalara Portal设置密码：
访问 Avalara 门户网站。
点击 Meu primeiro acesso。
将您在 Odoo 中用于创建 Avalara/AvaTax 账户的电子邮件地址添加进去，然后点击 Solicitar Senha。
您将收到一封带有令牌和创建密码链接的电子邮件。点击此链接并复制粘贴令牌以分配您所需的密码。
小技巧
您可以在 Odoo 中开始使用 AvaTax 进行税务计算 仅 无需创建密码并访问 Odoo 数据库中的 Avalara 门户。但是，为了使用电子发票服务，您 必须 访问 AvaTax 门户并在那里上传您的证书。
注解
您可以转移 API 证书。只有当您已在另一个 Odoo 实例中创建了账户并希望重复使用该账户时，才可使用此功能。
A1 证书上传¶
为了开具电子发票，需要将证书上传到`AvaTax 门户网站 <https://portal.avalarabrasil.com.br/Login>`_。
只要 AvaTax 门户中的外部识别码（不含特殊字符）与 CNPJ 编号一致，且 Odoo 中的识别码 （CNPJ） 与 AvaTax 中的 CNPJ 一致，证书就会与 Odoo 同步。
重要
要开具 NFS-e，某些城市要求您在从 Odoo 开具 NFS-e 之前，先在市政门户系统中关联证书。
如果你从城市收到一条错误信息，内容为 您的证书未链接到用户，这意味着此过程需要在城市门户中完成。
配置主数据¶
科目表¶
默认情况下，作为本地化模块中包含的数据集的一部分，会计科目表 会被安装。账户会自动映射到其相应的税项，以及默认的应付账款和应收账款字段。
注解
巴西的会计科目表基于SPED CoA，该表提供了巴西所需的基准科目。
您可以根据公司的需求添加或删除账户。
日记账¶
在巴西，系列 编号与电子发票的序列号范围相关联。可以在 Odoo 的销售日记账中通过 系列 字段配置系列编号。如果需要多个系列，则需要创建一个新的销售日记账，并为每个所需的系列分配一个新的系列编号。
需要选择 使用文档 字段。开具电子发票和非电子发票时，类型 字段选择创建发票时使用的文档类型。只有在日记账中选择了 使用文档 字段，才会显示 类型 字段。
注解
创建日记账时，请确保未勾选字段 专用贷项通知单序列，因为在巴西，发票、贷项通知单和借项通知单之间的序列是按系列号共享的，即按日记账共享。
税¶
安装巴西本地化时，税项会自动创建。税项已经配置好，其中一些在计算销售订单或发票的税项时由Avalara使用。
税金可以进行编辑，或者可以添加更多的税金。例如，一些用于服务的税金需要手动添加和配置，因为税率可能因提供服务的城市而异。
重要
如果您决定手动处理服务税，您将无法签发 NFS-e。要电子发送 NFS-e，您需要使用 Avalara 计算税款。
警告
不要删除税项，因为它们用于AvaTax税务计算。如果删除，Odoo在使用AvaTax计算税项的|SO|或发票时会重新创建它们，但用于登记税项的账户需要在税项的 定义 选项卡下重新配置，在 发票分配 和 退款分配 部分。
另请参阅
产品¶
要在销售订单和发票上使用 AvaTax 集成，首先根据产品的预期用途指定以下信息：
商品电子发票 (NF-e)¶
CEST 代码: 适用于 ICMS 税替代产品的代码
Mercosul NCM Code: 南方共同市场通用产品命名代码
来源: 表示产品的来源，可以是国外的或国内的，具体取决于特定的使用场景，还可能包括其他可能的选项。
SPED Fiscal Product Type: 根据 SPED 列表表的财税产品类型
用途: 指定该产品的预期用途
注解
Odoo 自动创建三个产品，用于与销售相关的运输成本。这些产品分别命名为 运费、保险 和 其他费用。它们已经配置好，如果需要创建更多，可以复制并使用相同的配置（所需配置： 产品类型 服务，运输成本类型 保险、运费 或 其他费用）。
服务电子发票 (NFS-e)¶
Mercosul NCM Code: 南方共同市场通用产品命名代码
用途: 指定该产品的预期用途
Service Code Origin: 提供者注册的城市服务代码
服务代码: 提供服务所在城市的服务代码，如果未添加代码，则将使用出发城市代码
Labor Assignment: 定义您的服务是否包含人工
联系人¶
在使用集成之前，请在联系人上指定以下信息：
关于联系人的一般信息：
选择 公司 选项以选择一个带有税号 (CNPJ) 的联系人，或者选择 个人 选项以选择一个带有 CPF 的联系人。
名称
地址: 添加 城市, 州, 邮政编码, 国家
在 街道 字段中，输入街道、号码和其他地址信息。
在 街道 2 字段中，输入街区信息。
Identification Number: CNPJ 或 CPF
税号: 与识别类型相关联
IE: 州税识别号
IM: 市政税识别号
SUFRAMA code: SUFRAMA 注册号
电话
Email
注解
在 Country 设置为
Brazil之前， CPF 、 IE 、 IM 和 SUFRAMA code 字段都是隐藏的。在 销售与采购 标签下查看联系人的财务信息：
财政状况：添加 AvaTax 财政状况，自动计算销售订单和发票上的税金。
税制: 联邦税制
ICMS 纳税人类型: 纳税人类型决定了联系人是否属于 ICMS 制度、免税状态 或 非纳税人
主要活动领域: 联系人的主要活动领域列表
配置以下额外的 财务信息 如果您要开具 NFS-e：
添加 税务位置 以用于 AvaTax 巴西
COFINS 详情: 应税、非应税、税率为 0% 的应税、免税、暂停
PIS 详情: 应税、非应税、税率为 0% 的应税、免税、暂停
CSLL Taxable: 公司是否需缴纳 CSLL
财政状况¶
为了在销售订单和发票上计算税款并发送电子发票，需要在 税务位置 中同时启用 自动检测 和 使用 AvaTax API 选项。
Fiscal Position 可以在 contact 上配置，或者在创建销售订单或发票时选择。
工作流程¶
本节概述了触发 API 调用 以进行税务计算的操作，并提供了如何发送商品电子发票（NF-e）和服务电子发票（NFS-e）以供政府验证的说明。
警告
请注意，每次 API 调用都会产生费用。请注意触发这些调用的操作，以便有效管理成本。
税务计算¶
报价单和销售订单的税款计算¶
通过以下任一方式触发 API 调用，使用 AvaTax 自动计算报价单或销售订单上的税款：
- 报价确认
确认报价单为销售订单。
- 手动触发
点击 使用 AvaTax 计算税费。
- 预览
点击 预览 按钮。
- 通过电子邮件发送报价单 / 销售订单
通过电子邮件向客户发送报价单或销售订单。
- 在线报价访问
当客户在线访问报价单时（通过门户视图），就会触发 API 调用。
发票上的税务计算¶
触发 API 调用，通过 AvaTax 自动计算客户发票上的税款，可通过以下任意一种方式实现：
- 手动触发
点击 使用 AvaTax 计算税费。
- 预览
点击 预览 按钮。
- 在线发票访问
当客户在线（通过门户视图）访问发票时，就会触发 API 调用。
注解
必须将 财务位置 设置为 自动税务映射（Avalara Brazil），才能自动计算税费。
另请参阅
电子文件¶
客户发票¶
要处理商品（NF-e）或服务（NFS-e）的电子发票，发票需要被确认，并且税款需要由 Avalara 计算。完成该步骤后，点击左上角的 发送并打印 按钮。在弹出的窗口中，点击 处理电子发票 以及任意其他选项 - 下载 或 电子邮件。最后，点击 发送并打印 以向政府处理发票。
在发送商品电子发票（NF-e）或服务电子发票（NFS-e）之前，需要在发票上填写一些字段：
Customer，包含所有客户信息
支付方式: 巴西: 发票计划如何支付
财政状况 设置为 自动税收映射（Avalara 巴西） 。
Document Type 设置为 (55) 电子发票 (NF-e) 或 (SE) 电子服务发票 (NFS-e)
这些是根据交易性质而定的一些可选字段。这些字段不是必填字段，因此在大多数情况下，如果不填写这些可选字段，政府不会出现错误。
货运模型 决定了货物的运输计划方式 —— 国内运输
Transporter Brazil 决定由谁进行运输
注解
如果需要，用于开具电子发票的发票上的所有字段也可在销售订单上使用。创建第一张发票时，会显示 文档编号 字段，并将其分配为第一个编号，在后续发票中按顺序使用。
贷记单¶
如果需要登记销售退货，则可在 Odoo 中创建贷记单据，发送给政府进行验证。
注解
贷项凭证仅适用于商品的电子发票（NF-e）。
另请参阅
借记通知单¶
如果需要提供更多信息，或需要更正原始发票中未准确提供的价值，可出具借记单。
注解
借记单仅适用于商品的电子发票（NF-e）。
只有包含在原始发票中的产品才能成为借记单的一部分。虽然可以更改产品的单价或数量，但 不能 将产品添加到借记单中。本文档的目的仅在于声明您希望为相同或更少的产品向原始发票添加的金额。
另请参阅
开票取消¶
可以注销经政府验证的电子发票。
注解
检查电子发票是否仍在取消期限内，各州/市的法律规定可能有所不同。
商品电子发票 (NF-e)¶
在 Odoo 中取消商品电子发票 (NF-e)，请点击 请求取消，并在弹出的窗口中添加取消 原因。如果您希望通过电子邮件将此取消原因发送给客户，请激活 电子邮件 复选框。
注解
这是一种电子取消操作，意味着 Odoo 将向政府发送请求以取消 NF-e，随后会消耗一个 IAP 信用，因为会进行一次 API 调用。
服务电子发票 (NFS-e)¶
在 Odoo 中取消服务电子发票（NFS-e），请点击 请求取消。在这种情况下，没有电子取消流程，因为并非每个城市都提供此服务。用户需要在城市门户网站上手动取消此 NFS-e。完成该步骤后，他们可以在 Odoo 中请求取消，这将取消发票。
更正信¶
可以创建更正函并将其链接到政府验证的货物电子发票（NF-e）。
在 Odoo 中点击 更正信 并在弹出的窗口中添加更正 原因 即可。要通过电子邮件将更正原因发送给客户，请激活 E-mail 复选框。
注解
更正函仅适用于商品电子发票 (NF-e)。
发票号码范围无效¶
一系列分配给销售日记账的序列号如果当前未被使用，并且 将来也不会使用，可以向政府申请作废。为此，请导航到日记账，并点击 。在 作废编号范围 (BR) 向导中，添加应取消范围的 起始编号 和 结束编号，并输入作废的 原因。
注解
无效的发票号码范围文档仅适用于商品的电子发票（NF-e）。
注解
已取消编号的日志以及 XML 文件记录在日记账的 chatter 中。
供应商账单¶
在供应商账单方面，当收到供应商的发票时，您可以在 Odoo 中通过添加所有商业信息以及记录在 客户发票 上的相同巴西特定信息来编码账单。
这些巴西特定领域是：
支付方式: 巴西: 发票计划如何支付
文档类型: 由您的供应商使用
文档编号: 来自您供应商的发票编号
货运模型: NF-e 特定 货物计划如何运输 - 国内
Transporter Brazil: NF-e 特定 负责运输的实体。