巴西¶
其他资料
巴西本地化的有用资源，包括入门材料和视频：
<https://youtube.com/playlist?list=PL1-aSABtP6ADqexw4YNCbKPmpFggajxlX&si=RgmZR3Jco3223Np4>YouTube 播放列表 - 巴西（本地化）。
<https://youtube.com/playlist?list=PL1-aSABtP6ACGOW2UREePGjHQ2Bgdy-UZ&si=j6tiI36eB7BoKVQB>YouTube 播放列表 - Tutoriais Odoo em Português。
模块¶
提供以下与巴西本地化相关的模块：
名称 |
技术名称 |
描述 |
|---|---|---|
巴西 - 会计 |
|
巴西财务本地化包，包含完整的巴西会计科目表、税费、税务报表、财务状况、文档和身份识别类型。 |
巴西 - 会计报告 |
|
巴西的会计报告。 |
AvaTax Brazil、Avatax Brazil Sale 和 Test SOs for the Brazilian Avatax |
|
通过 Avalara 计算商品和服务税。 |
巴西会计 EDI |
|
通过 Avatax 提供电子发票。 |
巴西会计 EDI 销售版 |
|
将一些字段添加到销售订单，这些字段会结转到发票。 |
巴西会计 EDI（POS） |
|
通过 Avatax 在 POS 中提供电子发票功能。 |
巴西会计 EDI（电子商务） |
|
允许电子商务用户进行税务计算和 EDI。 |
巴西会计 EDI（库存） |
|
将交付相关信息添加到 NF-e。 |
巴西 - 网站销售 |
|
允许电子商务用户进行税务计算和 EDI。 |
巴西 - 销售 |
|
巴西销售修改 |
巴西 - 销售订阅 |
|
巴西销售订阅修改 |
注解
本地化核心模块会随本地化包自动安装。其余模块可以手动安装。
本地化概述¶
巴西本地化包确保符合巴西财务和会计法规。它包含用于管理税务、财务状况、报告的工具，以及针对巴西标准定制的预定义会计科目表。
巴西本地化套件提供以下关键功能，以确保符合当地财务和会计法规：
科目表¶
在会计科目表中，账户会自动映射到相应的税费以及默认的应付账款和应收账款字段。
注解
巴西会计科目表基于 SPED CoA，提供了必要账户的基准。
税¶
安装巴西本地化时，税费会自动创建和配置。Avalara 使用其中一些来计算销售订单或发票的税费。
用于服务的税费必须手动添加和配置，因为税率可能因提供服务的城市而异。
重要
无法为手动创建的服务税费开具 NFS-e。要以电子方式发送 NFS-e，请使用 Avalara 计算税费。
警告
不要删除税费，因为它们用于 AvaTax 税费计算。如果删除，Odoo 会在 SO 或发票中使用时再次创建它们，并使用 AvaTax 计算税费。但是，必须在税费的定义选项卡中，在发票分配和退款分配部分重新配置用于登记税费的账户。
公司和联系人¶
要使用此财务本地化的所有功能，公司记录上需要以下字段：
名称
地址：添加 城市、州/省、邮政编码、国家/地区
在 街道 字段中，输入街道名称、编号和其他地址信息。
在 街道 2 字段中，输入街区信息。
识别号码：CNPJ 或 CPF
税号：与识别类型相关联
IE：州/省注册
IM：市级登记
SUFRAMA 编码：马瑙斯自由贸易区监管 - 如适用可加入
电话
电子邮件
配置 销售及采购 选项卡中的 财务信息：
为 AvaTax 巴西添加财务规则。
财务制度：联邦税务制度
ICMS 纳税人类型：表示 ICMS 制度、豁免状态 或:guilabel:
非纳税人。主要活动部门
配置以下额外的财务信息以开具 NFS-e：
为 AvaTax 巴西添加财务规则。
COFINS 详情：应税、不应税、税率为 0% 应税、免税、暂停
PIS 详细信息：应课税、非课税、应税税率为0%、豁免缴税、暂停缴税
CSLL 应纳税：公司是否受 CSLL 监管。
小技巧
如果是简化制度，则必须配置 ICMS 税率。为此，请转到，向下滚动到税费部分，并在默认税费部分设置销售税和采购税字段。
使用 AvaTax 集成时，相同的配置也适用于相关的联系人表单。
注解
如果联系人有税号（CNPJ），请选择 公司 选项；如果联系人有 CPF，请选择 个人。
AvaTax 整合功能¶
注解
确保安装AvaTax Brazil（
l10n_br_avatax）模块。Odoo 是 Avalara Brazil 公司的认证合作伙伴。
Avalara AvaTax 集成使用应用内购买（IAPs）来计算税费并处理电子文档（例如NF-e、NFS-e）。每个操作都会消耗 IAP 信用余额 中的信用。创建时，新数据库会收到 500 个免费信用。
要计算商品和服务税并处理电子发票，需要以下配置：
配置¶
授权认证¶
在 Odoo 中激活 AvaTax，然后在AvaTax Brazil部分的AvaTax Portal Email字段中添加 AvaTax 门户的管理员电子邮件地址，接着点击创建账户。
警告
在**测试**或**创建生产环境**AvaTax Portal Email集成时，无论是在沙盒数据库还是生产数据库中，都应使用真实的电子邮件地址，因为需要用它来连接到 Avalara并设置证书，无论是用于测试还是用于生产。
巴西 Avalara 门户有两种不同的环境：
从 Odoo 创建账户时，请选择正确的环境。此外，用于开设账户的电子邮件不能用于开设其他账户。从 Odoo 创建账户时，请保存API ID和API Key。
从 Odoo 创建账户后，前往 Avalara 门户设置密码：
访问 Avalara 门户网站。
点击Meu primeiro acesso。
添加在 Odoo 中用于创建 Avalara/AvaTax 账户的电子邮件地址，然后点击Solicitar Senha。
随后将收到一封电子邮件，其中包含令牌和用于创建密码的链接。点击此链接并复制粘贴令牌以分配所需的密码。
小技巧
如果仅在 Odoo 中使用 AvaTax 进行税务计算，则无需设置密码或访问 Avalara 门户。但是，若要使用电子发票服务，则需要访问 AvaTax，并且必须上传证书。
注解
API凭据可以转移。此选项仅在另一个 Odoo 实例中已创建账户并且必须重新使用时使用。
A1 证书上传¶
要签发电子发票，必须将证书上传到`AvaTax 门户<https://portal.avalarabrasil.com.br/Login>`_。
只要 AvaTax 门户中的外部识别码（不含特殊字符）与 CNPJ 编号一致，且 Odoo 中的识别码 （CNPJ） 与 AvaTax 中的 CNPJ 一致，证书就会与 Odoo 同步。
重要
某些城市要求在从 Odoo 签发 NFS-e 之前，先在城市门户系统中关联证书。
如果收到来自城市的错误消息，显示您的证书未关联到用户，则需要在城市门户中完成此流程。
财政状况¶
要設定Automatic Tax Mapping (Avalara Brazil)財務規則，請啟用Detect Automatically和Use AvaTax Brazil API選項。
其他资料
产品¶
要在銷售訂單和發票上使用 AvaTax 整合，請根據產品的使用方式，在產品表單的銷售分頁下的Brazil Accounting區段中輸入以下資訊。
商品電子發票（NF-e）¶
重要
:ref:`Avalara 整合 <localizations/brazil/avatax-account>`採用基於信用的系統，每次與 Avalara 互動都會消耗一個信用。以下是主要消耗信用的操作：
銷售應用程式
报价单和销售订单的税款计算
會計應用程式
發票上的稅額計算。
電子發票提交（NF-e 或 NFS-e）。
偶發性操作：（每個步驟分別計費）
注解
如果稅額在銷售應用程式中計算，且發票稍後在會計應用程式中開立，則計算會進行兩次，消耗兩個信用。
Example
CEST Code：税务分类代码，用于识别受ICMS法规下税务替代约束的商品和产品，并帮助确定特定项目的适用税务处理和程序。产品对此要求的适用性可在https://www.codigocest.com.br/进行验证。
Mercosul NCM 代码： 南方共同市场产品共同命名代码
Source of Origin：产品的来源，可以是国外或国内，以及其他可能的选项，具体取决于特定用例
SPED Fiscal Product Type：根据SPED列表表格的财务产品类型
Purpose of Use：此产品的预期使用目的
注解
Odoo自动创建三个产品用于与销售相关的运输成本。这些产品名为Freight、Insurance和Other Costs，并已配置完成。如果需要创建更多产品，请复制并使用相同的配置：
Product Type：Service
Transportation Cost Type：Insurance、Freight或Other Costs
服务电子发票 (NFS-e)¶
重要
:ref:`Avalara 整合 <localizations/brazil/avatax-account>`採用基於信用的系統，每次與 Avalara 互動都會消耗一個信用。以下是主要消耗信用的操作：
銷售應用程式
报价单和销售订单的税款计算
會計應用程式
發票上的稅額計算。
電子發票提交（NF-e 或 NFS-e）。
发票状态检查（每次检查发票状态消耗1个信用）。
偶發性操作：（每個步驟分別計費）
注解
如果在销售应用中计算税额，然后在会计应用中开具发票，则计算会进行两次，消耗两个信用。
Example
Mercosul NCM 代码： 南方共同市场产品共同命名代码
Purpose of Use：此产品的预期使用目的
服务代码来源：提供商注册的城市服务代码
Labor Assignment：复选框，用于选择服务是否涉及劳动
Transport Cost Type：要选择的运输成本类型
服务代码：提供服务的城市服务代码，如果不添加代码，将使用始发城市代码
税费计算¶
其他资料
报价单和销售订单的税款计算¶
通过以下任一方式触发 API 调用，使用 AvaTax 自动计算报价单或销售订单上的税款：
- 报价确认
将报价单确认为销售订单。
- 手动触发
点击Compute Taxes Using AvaTax。
- 预览
点击Preview。
- 通过电子邮件发送报价单/销售订单
通过电子邮件向客户发送报价单或销售订单。
- 在线报价
当客户在线访问报价单时（通过门户视图），就会触发 API 调用。
Mirto Bonan¶
通过以下任一方式触发 API 呼叫，使用 AvaTax 自动计算客户发票上的税款：
- 手动触发
点击Compute Taxes Using AvaTax。
- 预览
点击Preview。
- 在线发票访问
当客户在线（通过门户视图）访问发票时，就会触发 API 调用。
注解
必须将 财政状况 设为`自动税收映射（Avalara Brazil）`，这些操作才能自动计算税款。
其他资料
会计¶
电子文档¶
配置¶
*系列*编号与电子发票的序列号范围相关联。要在销售日记账上配置系列编号，请前往并在Series字段中设置。如果需要多个系列，则必须创建新的销售日记账，并为每个系列分配新的系列编号。
启用Use Documents?选项，因为Series字段仅在日记账上选择了Use Documents?选项时才会显示。
在开具电子和非电子发票时，Type字段选择创建发票时使用的文档类型。
注解
创建日记账时，请确保Accounting Information部分中的Dedicated Credit Note Sequence字段未选中，因为在巴西，发票、贷项通知单和借项通知单之间的序列按系列编号共享，即按日记账共享。
客户开票¶
要处理商品（NF-e）或服务（NFS-e）的电子发票，必须确认发票并由Avalara计算税额。必须填写以下字段：
Customer，包含所有客户信息
付款方式：巴西：指定预期的付款方式。
单据类型：选择(55) 电子发票 (NF-e)或(SE) 电子服务发票 (NFS-e)。
其他信息标签：
财务规则设置为自动税务映射（Avalara Brazil）。
某些可选字段取决于交易性质。其他信息标签中的这些字段不是必填项，因此在大多数情况下，将其留空不会导致提交发票时政府端出现错误：
:guilabel:`货运模式`决定了计划运输货物的方式 - 国内运输
Transporter Brazil 决定由谁进行运输
然后，点击发送。在弹出窗口中，点击处理电子发票以及其他选项，例如下载或电子邮件。最后，点击发送以向政府机构处理发票。
注解
如需要，用于开具电子发票的发票上的所有可用字段也可在销售订单上使用。创建第一张发票时，会显示单据编号字段，并将其分配为后续发票按顺序使用的第一个编号。
贷记单¶
如需登记销售退货，可以在 Odoo 中创建贷项通知单并发送给政府进行验证。
注解
贷记单仅适用于货物电子发票 (NF-e)。
借记单¶
如需包含其他信息或更正原始发票中未准确提供的值，可以开具借项通知单。
注解
借记单仅适用于货物电子发票 （NF-e）。
借项通知单中只能包含原始发票中包含的产品。虽然可以更改产品的单价或数量，但不能在借项通知单中添加产品。此单据的目的仅是声明要添加到原始发票中相同或更少产品的金额。
开票取消¶
可以取消政府已验证的电子发票。
注解
检查电子发票是否仍在取消期限内，该期限可能根据各州的法规而有所不同。
商品電子發票（NF-e）¶
要在 Odoo 中取消货物电子发票 (NF-e)，请点击请求取消，并在出现的弹出窗口中添加取消原因。要通过电子邮件将此取消原因发送给客户，请启用电子邮件复选框。
注解
这是一种电子取消，意味 Odoo 将向政府发送取消 NF-e 的请求，然后在发生 API 呼叫时，消耗一个 IAP 点数。
服务电子发票 (NFS-e)¶
要在 Odoo 中取消服务电子发票 (NFS-e)，请点击请求取消。在这种情况下没有电子取消流程，因为并非每个城市都提供此服务。用户需要在城市门户网站上手动取消此 NFS-e。完成该步骤后，他们可以在 Odoo 中请求取消，这将取消发票。
更正信¶
可以为政府已验证的货物电子发票 (NF-e) 创建并关联更正函。
要在 Odoo 中执行此操作，请点击更正函，并在弹出窗口中添加更正原因。要通过电子邮件将更正原因发送给客户，请启用电子邮件复选框。
注解
更正信仅适用于电子货物发票 (NF-e)。
发票编号范围作废¶
如果分配给销售日记账的序列范围当前未使用且将来不会使用，则政府可以将其作废。为此，请转到，打开日记账，点击图标，然后选择作废编号范围 (BR)。在作废编号范围 (BR)向导中，添加应取消范围的起始编号和结束编号，并输入作废原因。
注解
发票编号范围作废仅适用于货物电子发票 (NF-e)。
日记账的讨论区记录已取消编号的日志以及 XML 文件。
供应商账单¶
从供应商处收到发票时，通过添加所有商业信息和与客户发票相同的巴西特定信息，在 Odoo 中编码账单。
这些巴西特定领域是：
付款方式：巴西：指定预期的付款方式。
单据类型：供应商使用
单据编号：供应商的发票编号
货运模式：特定于 NF-e 计划如何运输货物 - 国内
:guilabel:`巴西运输服务商`（特定于 NF-e）：负责运输的服务商。
销售点 NFC-e¶
NFC-e 是支持向最终客户销售商品或货物的法律文件。与NF-e一样，电子客户发票也以 XML 文件格式签发，并有一个称为 NFC-e 摘要*的辅助文件（DANFC-e）。该电子文件可通过**Odoo POS*签发。
其法律效力由数字签名和巴西各州财政部（SEFAZ - Secretaria da Fazenda）保障。
注解
每个步骤单独计费。例如，为同一笔 POS 交易计算税金并签发发票会消耗两个信用点。
其他资料
配置¶
CSC 详情¶
前往并向下滚动至税金部分。在NFC-e 配置部分，填写以下 CSC（纳税人安全代码）字段：
CSC ID：CSC ID 或 *CSC 令牌*是纳税人安全代码的标识，可包含 1 至 6 位数字，可在您所在州财政部（SEFAZ）官方网站上获取。
CSC 编号：*CSC 编号*是最多 36 个字符的代码，只有您和财政部知道。它用于生成 NFC-e 的二维码并确保 DANFE 的真实性。
注解
这些字段所需的信息可由公司会计通过巴西各州的 SEFAZ 网站生成。
产品配置¶
Access the relevant product form in POS, then configure the product’s Brazil Accounting fields.
POS：¶
Go to and make sure that the relevant Point of Sale is selected at the top of the screen. Then, scroll to the Accounting section and configure the Brazilian EDI fields:
系列
下一个编号：将要签发的序列中的下一个 NFC-e 编号，例如，如果 SEFAZ 中签发的最后一个编号是
100，则*下一个编号*将是101。
工作流¶
生成 NFC-e¶
要生成 NFC-e，请按照以下步骤操作：
验证付款以计算税费并开具 NFC-e。有效的 NFC-e 显示在屏幕右侧。
注解
也可以通过客户的 CPF/CNPJ 开具 NFC-e。为此，请点击客户，搜索客户或创建新客户。
以下是开具带 CPF/CNPJ 标识的 NFC-e 的必填字段：
名称
开具发票的城市`和:guilabel:`州
CPF/CNPJ
NFC-e 票据打印¶
在:ref:`生成并验证 NFC-e <localizations/brazil/generate-nfc-e>`后，点击:guilabel:`打印`交付发票。
注解
Odoo NFC-e 功能兼容任何热敏打印机，不需要Odoo IoT Box。
重新开具出现 NFC-e 错误的 POS 订单¶
如果 NFC-e 返回错误，请按照以下步骤操作：
更正错误。
点击（菜单）`图标并选择:guilabel:`订单，重新开具 NFC-e。
筛选列表以仅显示已付款`订单，然后点击:guilabel:`详情。错误将显示。
点击发送 NFC-e。
注解
If the error has been corrected and the PoS session is closed, Odoo logs the tax adjustment in the chatter of the related journal entry. The journal entry for the order indicates that the taxes were incorrectly calculated. In this case, reprocessing the NFC-e is required.
NFC-e 退款与取消¶
Refunds can be processed directly in Odoo, but cancellations must be performed through the official government portal.
流程完成后，将创建已批准的退货 NF-e，这意味着**先前的 NFC-e 已取消**。
重要
SEFAZ 仅允许在其于 SEFAZ 网站上发行后30 分钟内取消 NFC-e。超过此期限后，必须处理手动退款，并发行退货 NF-e。