巴西¶
模块¶
提供以下与巴西本地化相关的模块：
名称 |
技术名称 |
描述 |
|---|---|---|
巴西 - 会计 |
|
巴西 fiscal localization package，包含巴西会计科目表、税收、税务报告、财务状况以及文件和身份证明类型。 |
巴西 - 会计报告 |
|
巴西的会计报告。 |
AvaTax Brazil、Avatax Brazil Sale 和 Test SOs for the Brazilian Avatax |
|
通过 Avalara 计算商品和服务税。 |
Brazilian Accounting EDI |
|
通过 Avatax 提供电子发票。 |
Brazilian Accounting EDI For Sale |
|
向发票结转的销售订单添加一些字段。 |
Brazilian Accounting EDI for POS |
|
通过 POS 中的 Avatax 提供电子发票。 |
Brazilian Accounting EDI for eCommerce |
|
允许电子商务用户进行税务计算和 EDI。 |
Brazilian Accounting EDI for stock |
|
将交付相关信息添加到 NF-e。 |
Brazil - Website Sale |
|
允许电子商务用户进行税务计算和 EDI。 |
Brazil - Sale |
|
巴西销售修改 |
Brazil - Sale Subscription |
|
巴西销售订阅修改 |
注解
本地化的核心模块会随本地化一起自动安装。其余的可以手动:doc:installed </applications/general/apps_modules>。
本地化概述¶
巴西本地化包确保遵守巴西财政和会计法规。它包括管理税收、财政状况、报告和根据巴西标准定制的预定义科目表的工具。
巴西本地化包提供以下主要功能，以确保遵守当地财政和会计法规：
Chart of accounts：根据巴西会计标准定制的预定义结构
Taxes：预先配置的税率，包括标准增值税、零税率和免税选项。
科目表¶
在 chart of accounts 中，科目会自动映射到相应的税费以及默认的应付账款和应收账款字段。
注解
巴西会计科目表基于 SPED CoA，它提供了必要科目的基准。
税¶
安装巴西本地化版本时会自动创建和配置 Taxes。 Avalara 使用一些来计算销售订单或发票的税费。
用于服务的税费必须手动添加和配置，因为费率可能因提供服务的城市而异。
重要
无法为手动创建的服务税开具 NFS-e。对于 electronically send an NFS-e，使用 Avalara 计算税费。
警告
不要删除税费，因为它们用于 AvaTax 税费计算。如果删除，Odoo 在 SO 或发票中使用时会再次创建它们，并使用 AvaTax 计算税费。但是，用于注册税务的帐户必须在税务的 Definition 选项卡的 Distribution for invoices 和 Distribution for refunds 部分下重新配置。
公司及联系方式¶
要使用此财务本地化的所有功能，company record 上需要以下字段：
名称
地址：添加 城市、州/省、邮政编码、国家/地区
在 街道 字段中，输入街道名称、编号和其他地址信息。
在 街道 2 字段中，输入街区信息。
识别号码：CNPJ 或 CPF
税号：与识别类型相关联
IE：州/省注册
IM：市级登记
SUFRAMA 编码：马瑙斯自由贸易区监管 - 如适用可加入
电话
电子邮件
配置 销售及采购 选项卡中的 财务信息：
添加 AvaTax 巴西的 Fiscal Position。
财务制度：联邦税务制度
ICMS 纳税人类型：表示 ICMS 制度、豁免状态 或:guilabel:
非纳税人。主要活动部门
配置以下额外 Fiscal Information 以发出 NFS-e：
添加 AvaTax 巴西的 Fiscal Position。
COFINS Details：Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended
PIS Details Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended
CSLL Taxable 公司是否受 CSLL 约束
小技巧
如果是简化机制，则必须配置 ICMS 速率。为此，请转到 ，向下滚动到 Taxes 部分，然后在 Default Taxes 部分中设置 Sales Tax 和 Purchase Tax 字段。
使用 AvaTax 集成时，相同的配置适用于相关 contact 表单。
注解
如果联系人有税号（CNPJ），请选择 公司 选项；如果联系人有 CPF，请选择 个人。
AvaTax 整合功能¶
注解
确保 install AvaTax Brazil (
l10n_br_avatax) 模块。Odoo 是 Avalara Brazil 公司的认证合作伙伴。
Avalara AvaTax integration 使用 In-App-Purchases (IAPs) 计算税款并处理电子文档（例如 NF-e、NFS-e）。每个操作都会消耗 IAP credit balance 的积分。创建后，新数据库将获得 500 个免费积分。
要计算商品和服务税并处理电子发票，需要以下配置：
配置¶
授权认证¶
Activate AvaTax in Odoo，然后在 AvaTax Brazil 部分的 AvaTax Portal Email 字段中添加 AvaTax 门户管理员的电子邮件地址，然后单击:icon:fa-plug Create account。
警告
在沙箱或生产数据库中 测试 或 创建生产 AvaTax Portal Email 集成时，请使用真实的电子邮件地址，因为无论是测试还是在生产中使用它，都需要 connect to Avalara 并设置证书。
有两个不同的巴西 Avalara 门户：
从 Odoo 创建帐户后，选择正确的环境。此外，用于开设帐户的电子邮件不能用于开设其他帐户。从 Odoo 创建帐户时保存 API ID 和 API Key。
从 Odoo 创建帐户后，转到 Avalara 门户设置密码：
访问 Avalara 门户网站。
单击:guilabel:
Meu primeiro acesso。添加 Odoo 中用于创建 Avalara/AvaTax 帐户的电子邮件地址，然后单击 Solicitar Senha。
然后将收到一封电子邮件，其中包含令牌和用于创建密码的链接。单击此链接并复制粘贴令牌以分配所需的密码。
小技巧
如果您在 Odoo 中使用 AvaTax **仅**进行税务计算，则无需设置密码或访问 Avalara 门户。但是，要使用电子发票服务，需要访问 AvaTax，并且需要访问 certificate must be uploaded。
注解
API 凭证可以转移。仅当帐户已在另一个 Odoo 实例中创建且必须重复使用时，才应使用此选项。
A1 证书上传¶
要开具电子发票，必须将证书上传到 AvaTax portal。
只要 AvaTax 门户中的外部标识符号与 CNPJ 号匹配（无特殊字符），并且 Odoo 中的标识号 (CNPJ) 与 AvaTax 中的 CNPJ 匹配，证书就会与 Odoo 同步。
重要
一些城市要求在从 Odoo 颁发 NFS-e 之前将证书链接到 City Portal 系统中。
如果收到来自城市的错误消息，显示 Your certificate is not linked to the user，则需要在城市门户中完成此过程。
财政状况¶
要设置 Automatic Tax Mapping (Avalara Brazil) fiscal position，请启用 Detect Automatically 和 Use AvaTax Brazil API 选项。
其他资料
产品¶
要在销售订单和发票上使用 AvaTax 集成，请根据产品的使用方式，在 Brazil Accounting 部分下产品表单的 Sales 选项卡中输入以下信息。
货物电子发票 (NF-e)¶
重要
Avalara integration 在基于信用的系统上运行，每次与 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)¶
重要
Avalara integration 在基于信用的系统上运行，每次与 Avalara 的交互都会消耗一个信用。以下是主要的信用消耗操作：
销售申请
报价单和销售订单的税计算。
会计申请
发票上的税费计算。
电子发票提交（NF-e 或 NFS-e）。
发票状态检查（每次检查发票状态消耗 1 个积分）。
偶尔操作：（每一步单独计费）
注解
如果在 销售 应用程序中计算税费，然后在 会计 应用程序中开具发票，则计算会发生两次，消耗两个积分。
Example
Mercosul NCM 代码： 南方共同市场产品共同命名代码
Purpose of Use：本产品的预期使用目的
服务代码来源：提供商注册的城市服务代码
Labor Assignment：用于选择服务是否涉及人工的复选框
Transport Cost Type：选择的运输成本类型
Service Codes：提供服务的城市服务代码；如果未添加代码，则将使用 Service Code Origin。
税费计算¶
其他资料
报价单和销售订单的税款计算¶
通过以下任一方式触发 API 调用，使用 AvaTax 自动计算报价单或销售订单上的税款：
- 报价确认
将报价单确认为销售订单。
- 手动触发
单击:guilabel:
Compute Taxes Using AvaTax。
- 预览
单击:guilabel:
Preview。
- 通过电子邮件发送报价/销售订单
通过电子邮件向客户发送报价单或销售订单。
- 在线报价
当客户在线访问报价单时（通过门户视图），就会触发 API 调用。
Mirto Bonan¶
通过以下任一方式触发 API 呼叫，使用 AvaTax 自动计算客户发票上的税款：
- 手动触发
单击:guilabel:
Compute Taxes Using AvaTax。
- 预览
单击:guilabel:
Preview。
- 在线发票访问
当客户在线（通过门户视图）访问发票时，就会触发 API 调用。
注解
必须将 财政状况 设为`自动税收映射（Avalara Brazil）`，这些操作才能自动计算税款。
其他资料
会计¶
电子文档¶
配置¶
*系列*编号链接到电子发票的序列号范围。要在销售日记帐上配置序列号，请转至 并在 Series 字段中进行设置。如果需要多个系列，则必须创建新的销售日记帐，并且必须为每个系列分配新的系列号。
启用 Use Documents? 选项，因为仅当在日记帐上选择 Use Documents? 选项时才会显示 Series 字段。
开具电子和非电子发票时，Type 字段选择创建发票时使用的文档类型。
注解
创建日记帐时，请确保未选中 Accounting Information 部分中的 Dedicated Credit Note Sequence 字段，就像在巴西一样，发票、贷项票据和借项票据之间的序列按序列号（即每个日记帐）共享。
客户开票¶
要处理货物 (NF-e) 或服务 (NFS-e) 的电子发票，发票必须由 Avalara 确认并计算税费。必须填写以下字段：
Customer，包含所有客户信息
Payment Method: Brazil：指定预期的付款方式。
Document Type：选择:guilabel:
(55) Electronic Invoice (NF-e)或:guilabel:(SE) Electronic Service Invoice (NFS-e)。
Other Info 选项卡：
Fiscal Position 设置为 Automatic Tax Mapping (Avalara Brazil)。
一些可选字段取决于交易的性质。 Other Info 选项卡中的这些字段不是必需的，因此在大多数情况下，将它们留空不会导致政府在提交发票时出现错误：
Freight Model 确定货物计划如何运输 - 国内。
Transporter Brazil 确定由谁进行运输。
然后，单击 Send。在弹出窗口中，单击 Process e-invoice 和任何其他选项，例如 Download 或 Email。最后，点击 Send 向政府处理发票。
注解
如果需要，发票上用于开具电子发票的所有可用字段也可在销售订单上使用。创建第一张发票时，会显示 Document Number 字段并将其分配为第一个编号，以便按顺序用于后续发票。
贷记单¶
如果需要注册销售退货，请填写 credit note can be created in Odoo 并发送给政府进行验证。
注解
贷记单仅适用于货物电子发票 (NF-e)。
借记单¶
如果需要包含其他信息或需要更正原始发票中未准确提供的值，则为 debit note can be issued。
注解
借记单仅适用于货物电子发票 （NF-e）。
只有原始发票中包含的产品才能包含在借项单中。虽然可以更改产品的单价或数量，但产品**不能**添加到借项单中。本文件的目的只是声明相同或更少产品的原始发票中添加的金额。
开票取消¶
可以取消政府验证的电子发票。
注解
检查电子发票是否仍在取消期限内，该期限可能根据每个州的立法而有所不同。
货物电子发票 (NF-e)¶
要在 Odoo 中取消货物电子发票 (NF-e)，请单击 Request Cancel 并在出现的弹出窗口中添加取消 Reason。要通过电子邮件将此取消原因发送给客户，请启用 E-mail 复选框。
注解
这是电子取消，这意味着 Odoo 将向政府发送取消 NF-e 的请求。然后，当发生 API 调用时，它将消耗一个 IAP 积分。
服务电子发票 (NFS-e)¶
要在 Odoo 中取消服务电子发票 (NFS-e)，请单击 Request Cancel。在这种情况下，没有电子取消流程，因为并非每个城市都提供此服务。用户需要在城市门户手动取消此NFS-e。完成该步骤后，他们可以在 Odoo 中请求取消，这将取消发票。
更正信¶
可以创建更正函并将其链接到政府验证的电子货物发票 (NF-e)。
要在 Odoo 中执行此操作，请单击 Correction Letter 并向弹出窗口添加更正 Reason。要通过电子邮件向客户发送更正原因，请启用 E-mail 复选框。
注解
更正信仅适用于电子货物发票 (NF-e)。
发票号码范围失效¶
如果分配给销售日记帐的一系列序列当前未使用**且**将来也不会使用，政府可能会使其无效。为此，请转至 ，打开日志，单击 :icon:`fa-cog`（齿轮）图标，然后选择 :guilabel:`Invalidate Number Range (BR)`。在 Invalidate Number Range (BR) 向导中，添加应取消的范围的 Initial Number 和 End Number，并输入失效 Reason。
注解
发票编号范围失效仅适用于货物电子发票 (NF-e)。
该期刊的聊天记录了已取消号码的日志以及 XML 文件。
供应商账单¶
当收到供应商的发票时，通过添加所有商业信息和 customer invoices 上记录的相同巴西特定信息，在 Odoo 中对账单进行编码。
这些巴西特定字段是：
Payment Method: Brazil：指定预期的付款方式。
Document Type：由供应商使用
Document Number：供应商的发票号码
货运模式：特定于 NF-e 计划如何运输货物 - 国内
:guilabel:`巴西运输服务商`（特定于 NF-e）：负责运输的服务商。
销售点 NFC-e¶
NFC-e是支持向最终客户销售商品或商品的法律文件。与 NF-e 一样，电子客户发票也以 XML 文件格式开具，并具有称为 NFC-e 摘要 的辅助文档 (DANFC-e)。该电子文档可以通过 Odoo 销售点 签发。
其法律有效性由数字签名和巴西各州的 SEFAZ (Secretaria da Fazenda) 保证。
重要
Avalara integration 在基于信用的系统上运行。每项涉及与 Avalara 通信的操作都会消耗一个积分。 销售点 (POS) 应用程序中的以下操作需要信用消耗：
销售时的税费计算
电子发票开具（NFC-e）
注解
每个步骤单独计费。例如，为同一 POS 交易计算税费并开具发票会消耗两个积分。
其他资料
配置¶
Install Brazilian Accounting EDI for POS (l10nbr_edi_pos) 模块并确保激活 AvaTax。
CSC详情¶
转到 并滚动到 Taxes 部分。在 NFC-e configuration 部分中，填写以下 CSC（纳税人安全代码）字段：
CSC ID：CSC ID 或 CSC 令牌 是纳税人安全代码的标识，可以有 1 到 6 位数字，可在您所在州的财政部 (SEFAZ) 的官方网站上找到。
CSC Number：CSC 编号 是一个最多 36 个字符的代码，只有您和财政部知道。用于生成NFC-e的二维码，保证DANFE的真实性。
注解
这些字段所需的信息可由公司会计师通过巴西各州的 SEFAZ 网站生成。
产品配置¶
访问相关的:doc:product form in POS <../../sales/point_of_sale/products>，然后配置:ref:`product <localizations/brazil/products>`的:guilabel:`Brazil Accounting`字段。
销售点¶
转至 并确保相关销售点为 selected at the top of the screen。然后，滚动到 Accounting 部分并配置 Brazilian EDI 字段：
Series
Next number：要发布的序列中的下一个 NFC-e 号码，例如，如果 SEFAZ 中发布的最后一个号码是
100，则*下一个号码*将为101。
工作流¶
生成 NFC-e¶
要生成 NFC-e，请执行以下步骤：
验证付款以计算税费并颁发 NFC-e。有效的 NFC-e 显示在屏幕右侧。
注解
还可以发行 NFC-e，通过 CPF/CNPJ 来识别客户。为此，请单击:icon:fa-user Customer，搜索客户或创建新客户。
以下是签发 CPF/CNPJ 识别的 NFC-e 的必填字段：
名称
发票开具地 City 和 State
CPF/CNPJ
单击:guilabel:
Validate。 NFC-e 出现，在打印件上突出显示客户的 CPF。单击 Print 或 Send via e-mail 将发票交付给客户。
NFC-e 票据打印¶
generating and validating the NFC-e 之后，点击 Print 发送发票。
注解
Odoo NFC-e 功能与任何热敏打印机兼容，不需要 Odoo IoT Box。
重新发出 NFC-e 错误的 PoS 订单¶
如果 NFC-e 返回错误，请按照以下步骤操作：
纠正错误。
单击 (menu) 图标并选择 Orders 重新签发 NFC-e。
过滤列表以仅显示 Paid 订单，然后单击 Details。显示错误。
单击:guilabel:
Send NFC-e。
注解
如果错误已更正并且 POS 收银机已关闭，Odoo 会将税务调整记录在相关日记帐分录的记录中。订单的日记帐分录表明税费计算不正确。在这种情况下，需要对NFC-e进行重新处理。
NFC-e 退款和取消¶
Refunds can be processed directly in Odoo，但*取消*必须通过官方政府门户网站进行。
该流程完成后，将创建已批准的退货 NF-e，这意味着**之前的 NFC-e 被取消**。
重要
SEFAZ 仅允许在 SEFAZ 网站上签发 NFC-e **后 30 分钟内**取消。在此期限之后，必须处理手动退款，并签发*退货 NF-e*。