巴西¶
其他资料
巴西本地化的有用资源，包括入门材料和视频：
<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 网站生成。
产品配置¶
POS：¶
转到，确保在屏幕顶部选中了相关的 POS。然后，向下滚动到会计部分，并配置巴西 EDI字段：
系列
下一个编号：将要签发的序列中的下一个 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。
注解
如果錯誤已更正且POS收銀機已關閉，Odoo會在相關日記帳分錄的討論串中記錄稅務調整。訂單的日記帳分錄表示稅款計算錯誤。在這種情況下，需要重新處理NFC-e。
NFC-e 退款与取消¶
退款可以直接在Odoo中處理，但*取消*必須透過官方政府門戶執行。
流程完成后，将创建已批准的退货 NF-e，这意味着**先前的 NFC-e 已取消**。
重要
SEFAZ 仅允许在其于 SEFAZ 网站上发行后30 分钟内取消 NFC-e。超过此期限后，必须处理手动退款，并发行退货 NF-e。