Brazil¶
Xem thêm
Tài nguyên hữu ích cho bản địa hóa Brazil, bao gồm tài liệu và video hướng dẫn:
Mô đun¶
The following modules are installed automatically with the Brazilian localization:
Tên |
Tên kỹ thuật |
Mô tả |
|---|---|---|
Brazil - Kế toán |
|
Default fiscal localization package, which represents having the Generic Brazilian chart of accounts and Taxes, together with document types and identification types. |
Brazil - Báo cáo kế toán |
|
Báo cáo kế toán cho Brazil |
Brazil Pix QR codes |
|
Implements Pix QR codes for Brazil. |
Brazil - Sale Subscription |
|
Subscriptions modifications for Brazil. |
Brazil - Sale |
|
Sales modifications for Brazil. |
Brazil - Website Sale |
|
Cho phép tính thuế và EDI cho người dùng thương mại điện tử. |
Ngoài ra, các mô-đun sau phải được cài đặt thủ công:
Tên |
Tên kỹ thuật |
Mô tả |
|---|---|---|
Avatax Brazil & Avatax Brazil for Services & Test SOs for the Brazilian Avatax |
|
Goods and services tax computation through Avalara. |
Avatax Brazil eCommerce Fiscal Reform |
|
eCommerce modifications for fiscal reform. |
Avatax Brazil Fiscal Reform |
|
Avatax modifications for fiscal reform. |
Avatax Brazil Sale Fiscal Reform |
|
Sales Avatax modifications for fiscal reform |
Avatax Brazil Sale cho Dịch vụ |
|
Sales modifications for Brazil for services |
Brazilian Accounting EDI & Brazilian Accounting EDI for services |
|
Provides electronic invoicing for goods and services for Brazil through AvaTax. |
Brazilian Accounting EDI For Sale |
|
Adds fields to sales orders that will be carried over to the invoice. |
Ghi chú
Trong một số trường hợp, chẳng hạn như khi nâng cấp lên phiên bản có thêm mô-đun, có thể các mô-đun không được cài đặt tự động. Mọi mô-đun bị thiếu có thể được cài đặt thủ công.
Tổng quan về bản địa hóa¶
Gói bản địa hóa Brazil đảm bảo tuân thủ các quy định về thuế và kế toán của Brazil. Gói này bao gồm các công cụ quản lý thuế, vị trí tài chính, báo cáo và bảng kế toán được thiết lập sẵn phù hợp với các tiêu chuẩn của Brazil.
Gói bản địa hóa Brazil cung cấp các tính năng chính sau để đảm bảo tuân thủ các quy định về thuế và kế toán địa phương:
Bảng kế toán: cấu trúc được thiết lập sẵn phù hợp với các tiêu chuẩn kế toán của Brazil
Thuế: các mức thuế suất được cấu hình sẵn, bao gồm VAT tiêu chuẩn, thuế suất 0% và các tùy chọn miễn thuế.
Hệ thống tài khoản¶
Trong bảng kế toán, các tài khoản được ánh xạ tự động với các loại thuế tương ứng và các trường tài khoản phải trả và tài khoản phải thu mặc định.
Ghi chú
Bảng kế toán Brazil dựa trên SPED CoA, cung cấp nền tảng các tài khoản cần thiết.
Thuế¶
Thuế được tạo và cấu hình tự động khi cài đặt bản địa hóa Brazil. Avalara sử dụng một số loại thuế để tính thuế trên đơn hàng hoặc hóa đơn.
Thuế được sử dụng cho dịch vụ phải được thêm và cấu hình thủ công, vì thuế suất có thể khác nhau tùy thuộc vào thành phố nơi cung cấp dịch vụ.
Quan trọng
NFS-e không thể được phát hành cho các loại thuế dịch vụ được tạo thủ công. Để gửi NFS-e điện tử, hãy tính thuế bằng Avalara.
Cảnh báo
Không xóa thuế vì chúng được sử dụng để tính toán thuế AvaTax. Nếu bị xóa, Odoo sẽ tạo lại chúng khi được sử dụng trong SO hoặc hóa đơn, tính thuế với AvaTax. Tuy nhiên, tài khoản được sử dụng để ghi nhận thuế phải được cấu hình lại trong tab Định nghĩa của thuế, trong các phần Phân bổ cho hóa đơn và Phân bổ cho hoàn trả.
Sản phẩm¶
Accurate fiscal classification of goods and services is essential for tax calculation and electronic invoice issuance in compliance with Brazilian regulations and the 2026 Tax Reform.
Ghi chú
Brazil must be specified in the Country field of the company form to display the required fields for the fiscal reform.
The following information, specific to the fiscal reform, is required on the General Information tab of the products form:
Legal Unit of Measure: Select the conversion factor between the commercial unit and the taxable unit for taxes applied by quantity (ad rem).
IS taxable: Enable this option if the product is subject to Selective Tax (Imposto Seletivo or IS).
Special Customs Regime (optional): Select the applicable special customs regime if the transaction involving capital goods falls under such a regime.
L10N Br Transaction Usage (optional): Define the tax classification indicating how the good or service is used in the transaction, as this can affect tax calculation and invoice issuance.
If the selected Product Type is Service, select the NBS Code (Nomenclatura Brasileira de Serviços) necessary for tax classification.
Công ty và liên hệ¶
Để sử dụng tất cả các tính năng của bản địa hóa thuế này, các trường sau là bắt buộc trên hồ sơ công ty:
Tên
Địa chỉ: thêm Thành phố, Tiểu bang, Mã bưu điện, Quốc gia
Trong trường Đường, nhập tên đường, số nhà và bất kỳ thông tin địa chỉ bổ sung nào.
Trong trường Đường 2, nhập khu phố.
Số nhận dạng: CNPJ hoặc CPF
Mã số thuế: liên kết với loại nhận dạng
IE: Đăng ký cấp tiểu bang
IM: Đăng ký cấp thành phố
Mã SUFRAMA: Cơ quan Quản lý Khu Thương mại Tự do Manaus - thêm nếu có
Điện thoại
Email
Mẹo
To update your company's complete record, open the Contacts app and access the relevant record.
Configure the Fiscal Information within the Sales & Purchase tab:
Thêm Vị trí tài chính cho AvaTax Brazil.
Tax Regime: Federal tax regime.
ICMS Taxpayer Type: Select ICMS regime, Exempt status, or Non-Taxpayer.
Lĩnh vực Hoạt động Chính
2026 tax reform fields:
Tax Regime: For the simplified tax regime (Simples Nacional), set up the additional fields specific to the fiscal reform:
CBS/IBS Normal: Enable the option for Regime Normal (Regime Regular) regime or disable for Hybrid Simples Nacional (Regime Hibrido) regime. For Hybrid Simples Nacional (Regime Hibrido) tax regime, configure the following additional fields:
CBS Presumed Credit (%): Specify the percentage of presumed CBS credit available for entities under the Hybrid Simples Nacional tax model.
IBS Presumed Credit (%): Specify the percentage of presumed IBS credit available for entities under the Hybrid Simples Nacional tax model.
ISS Simplified Rate: Indicate the specific municipal service tax rate applicable to the simplified tax regime.
Entity Type: Select the legal classification.
CBS/IBS Taxpayer: Enable the option if the entity is subject to CBS or IBS. Disable it for exempt entities or those operating under special non-taxable regimes.
Cấu hình Thông tin Thuế bổ sung sau để phát hành NFS-e:
Thêm Vị trí tài chính cho AvaTax Brazil.
COFINS Details: When a transaction is exempt from COFINS even though all parties and items are taxable, this attribute identifies the exemption scenario and applies the override accordingly. Select the appropriate option.
PIS Details: When a transaction is exempt from PIS even though all parties and items are taxable, this attribute identifies the exemption scenario and applies the override accordingly. Select the appropriate option.
CSLL Taxable: Enable the option if the company is subject to CSLL.
Mẹo
Nếu là chế độ đơn giản hóa, phải cấu hình thuế suất ICMS. Để thực hiện, vào , cuộn xuống phần Thuế và đặt các trường Thuế Bán hàng và Thuế Mua hàng trong phần Thuế Mặc định.
Cấu hình tương tự áp dụng cho biểu mẫu liên hệ liên quan khi sử dụng tích hợp AvaTax.
Ghi chú
Chọn tùy chọn Công ty cho liên hệ có mã số thuế (CNPJ), hoặc chọn Cá nhân cho liên hệ có CPF.
Tích hợp AvaTax¶
Ghi chú
Đảm bảo cài đặt mô-đun AvaTax Brazil (
l10n_br_avatax).Odoo là đối tác được chứng nhận của Avalara Brazil.
Tích hợp Avalara AvaTax sử dụng Mua hàng Trong Ứng dụng (IAPs) để tính thuế và xử lý chứng từ điện tử (ví dụ: NF-e, NFS-e). Mỗi hành động tiêu thụ tín dụng từ số dư tín dụng IAP. Khi tạo mới, cơ sở dữ liệu nhận 500 tín dụng miễn phí.
Để tính thuế hàng hóa và dịch vụ cũng như xử lý hóa đơn điện tử, cần có các cấu hình sau:
Cấu hình¶
Thông tin đăng nhập¶
Connect AvaTax in the AvaTax Brazil section, add the administrator's email address for the AvaTax portal in the AvaTax Portal Email field, then click Create account.
Cảnh báo
When testing or creating a production AvaTax Portal Email integration in a sandbox or production database, use a real email address, as it is needed to connect to Avalara and set up the certificates, whether to test or use it on production.
Có hai Cổng thông tin Avalara Brazil khác nhau:
Một cho thử nghiệm: https://portal.sandbox.avalarabrasil.com.br/
Một cho sản xuất: https://portal.avalarabrasil.com.br/
Khi tài khoản được tạo từ Odoo, hãy chọn môi trường phù hợp. Hơn nữa, email dùng để mở tài khoản không thể dùng để mở tài khoản khác. Lưu API ID và API Key khi tài khoản được tạo từ Odoo.
Sau khi tài khoản được tạo từ Odoo, hãy vào Cổng thông tin Avalara để thiết lập mật khẩu:
Truy cập Cổng thông tin Avalara.
Nhấp vào Meu primeiro acesso.
Thêm địa chỉ email đã dùng trong Odoo để tạo tài khoản Avalara/AvaTax, sau đó nhấp vào Solicitar Senha.
An email will then be received with a token and a link to create a password. Click this link and copy-paste the token to set the desired password.
Mẹo
Nếu bạn sử dụng AvaTax trong Odoo chỉ để tính toán thuế, việc thiết lập mật khẩu hoặc truy cập cổng thông tin Avalara là không cần thiết. Tuy nhiên, để sử dụng dịch vụ hóa đơn điện tử, cần phải truy cập AvaTax và tải lên chứng chỉ.
Ghi chú
Có thể chuyển thông tin xác thực API. Tùy chọn này chỉ nên được sử dụng khi tài khoản đã được tạo trong phiên bản Odoo khác và cần tái sử dụng.
Fiscal reform¶
To enable the sending of the new attributes of the 2026 tax reform, follow these steps:
Go to and scroll to the Taxes section.
Under AvaTax Brazil, enable the Enable Brazilian fiscal reform option.
Mẹo
If inconsistencies occur when submitting fiscal reform information, disable the Enable Brazilian fiscal reform option to revert to the previous communication model.
Tải lên chứng chỉ A1¶
Để phát hành hóa đơn điện tử, chứng chỉ phải được tải lên cổng thông tin AvaTax.
Chứng chỉ sẽ được đồng bộ hóa với Odoo miễn là số định danh bên ngoài trong cổng thông tin AvaTax khớp, không có ký tự đặc biệt, với số CNPJ và số định danh (CNPJ) trong Odoo khớp với CNPJ trong AvaTax.
Quan trọng
Một số thành phố yêu cầu liên kết chứng chỉ trong hệ thống Cổng thông tin Thành phố trước khi phát hành NFS-e từ Odoo.
Pokud je přijata chybová zpráva od města s textem Váš certifikát není propojen s uživatelem, je třeba tento proces provést na portálu města.
Vị trí tài chính¶
To set up the Automatic Tax Mapping (Avalara Brazil) fiscal position, enable the Detect Automatically and Use AvaTax Brazil API options.
Sản phẩm¶
To use the AvaTax integration on sales orders and invoices, enter the following information on the product form, based on how the product will be used.
E-faktury pro zboží (NF-e)¶
Quan trọng
Integrace Avalara funguje na kreditovém systému, kde každá interakce s Avalarou spotřebuje jeden kredit. Níže jsou uvedeny hlavní operace spotřebovávající kredity:
Aplikace Prodej
Výpočet daní na nabídkách a prodejních objednávkách.
Aplikace Účetnictví
Výpočet daní na fakturách.
Odeslání elektronické faktury (NF-e nebo NFS-e).
Příležitostné operace: (každý krok je účtován samostatně)
Ghi chú
Pokud jsou daně vypočítány v aplikaci Prodej a faktura je později vystavena v aplikaci Účetnictví, výpočet proběhne dvakrát, což spotřebuje dva kredity.
Example
CEST Code: tax classification code identifying goods and products subject to tax substitution under ICMS regulations, and helps determine the applicable tax treatment and procedures for specific items. The product's applicability to this requirement can be verified on the Código CEST website.
Mã NCM Mercosul: Mã sản phẩm theo Danh mục chung Mercosur
Nguồn gốc xuất xứ: xuất xứ của sản phẩm, có thể là nước ngoài hoặc trong nước, cùng các tùy chọn khác tùy thuộc vào trường hợp sử dụng cụ thể
Loại sản phẩm thuế SPED: loại sản phẩm thuế theo bảng danh sách SPED
Mục đích sử dụng: mục đích sử dụng dự kiến cho sản phẩm này
Ghi chú
Odoo tự động tạo ba sản phẩm để sử dụng cho chi phí vận chuyển liên quan đến bán hàng. Chúng được đặt tên là Vận chuyển, Bảo hiểm và Chi phí khác và đã được cấu hình sẵn. Nếu cần tạo thêm, hãy sao chép và sử dụng cùng cấu hình:
Product Type: Service
Loại chi phí vận chuyển: Bảo hiểm, Vận chuyển, hoặc Chi phí khác
Hóa đơn điện tử cho dịch vụ (NFS-e)¶
Quan trọng
Integrace Avalara funguje na kreditovém systému, kde každá interakce s Avalarou spotřebuje jeden kredit. Níže jsou uvedeny hlavní operace spotřebovávající kredity:
Aplikace Prodej
Výpočet daní na nabídkách a prodejních objednávkách.
Aplikace Účetnictví
Výpočet daní na fakturách.
Odeslání elektronické faktury (NF-e nebo NFS-e).
Kiểm tra trạng thái hóa đơn (1 tín dụng được tiêu thụ mỗi lần kiểm tra trạng thái hóa đơn).
Příležitostné operace: (každý krok je účtován samostatně)
Ghi chú
Nếu thuế được tính trong ứng dụng Bán hàng và hóa đơn sau đó được phát hành trong ứng dụng Kế toán, việc tính toán xảy ra hai lần, tiêu thụ hai tín dụng.
Example
Mã NCM Mercosul: Mã sản phẩm theo Danh mục chung Mercosur
Mục đích sử dụng: mục đích sử dụng dự kiến cho sản phẩm này
Nguồn gốc mã dịch vụ: Mã dịch vụ thành phố nơi nhà cung cấp đăng ký
Phân công lao động: hộp kiểm để chọn nếu dịch vụ liên quan đến lao động
Loại chi phí vận chuyển: loại chi phí vận chuyển cần chọn
Mã dịch vụ: Mã dịch vụ thành phố nơi dịch vụ sẽ được cung cấp; nếu không có mã nào được thêm, Nguồn gốc mã dịch vụ sẽ được sử dụng.
Cách tính thuế¶
Xem thêm
Tính thuế trên báo giá và đơn bán hàng¶
Kích hoạt lệnh gọi API để tính thuế trên báo giá hoặc đơn bán hàng tự động với AvaTax bằng một trong các cách sau:
- Xác nhận báo giá
Xác nhận báo giá thành đơn bán hàng.
- Kích hoạt thủ công
Nhấp vào Compute Taxes Using AvaTax.
- Xem trước
Nhấp vào Preview.
- Gửi email báo giá/đơn bán hàng
Gửi báo giá hoặc đơn bán hàng đến khách hàng qua email.
- Truy cập báo giá trực tuyến
Khi khách hàng truy cập báo giá trực tuyến (qua chế độ xem cổng thông tin), lệnh gọi API sẽ được kích hoạt.
Tính thuế trên hóa đơn¶
Kích hoạt lệnh gọi API để tính thuế tự động trên hóa đơn khách hàng bằng AvaTax theo bất kỳ cách nào sau đây:
- Kích hoạt thủ công
Nhấp vào Compute Taxes Using AvaTax.
- Xem trước
Nhấp vào Preview.
- Truy cập hóa đơn trực tuyến
Khi khách hàng truy cập hóa đơn trực tuyến (qua chế độ xem cổng thông tin), lệnh gọi API sẽ được kích hoạt.
Ghi chú
Vị trí tài chính phải được đặt thành Automatic Tax Mapping (Avalara Brazil) để bất kỳ hành động nào trong số này tự động tính thuế.
Kế toán¶
Chứng từ điện tử¶
Cấu hình¶
A series number is linked to a sequence number range for electronic invoices. To configure the series number on a sales journal, follow these steps:
Go to and open the sales journal.
Enable the Use Documents? option to display the Series field.
Set the series number in the Series field.
Mẹo
If more than one series is needed, a new sales journal must be created, and a new series number must be assigned for each series.
When creating the new sales journal, ensure the Dedicated Credit Note Sequence field in the Accounting Information section is unchecked, as in Brazil, sequences between invoices, credit notes, and debit notes are shared per series number, which means per journal.
Khi phát hành hóa đơn điện tử và không điện tử, trường Type sẽ chọn loại chứng từ được sử dụng khi tạo hóa đơn.
Hóa đơn bán hàng¶
Để xử lý hóa đơn điện tử cho hàng hóa (NF-e) hoặc dịch vụ (NFS-e), hóa đơn phải được xác nhận và thuế phải được tính bởi Avalara. Các trường sau phải được điền:
Customer, với tất cả thông tin khách hàng
Phương thức thanh toán: Brazil: Chỉ định phương thức thanh toán dự kiến.
Loại chứng từ: Chọn (55) Hóa đơn điện tử (NF-e) hoặc (SE) Hóa đơn dịch vụ điện tử (NFS-e).
Tab Thông tin khác:
Vị trí tài chính được đặt là Ánh xạ thuế tự động (Avalara Brazil).
Một số trường tùy chọn phụ thuộc vào tính chất của giao dịch. Các trường này trong tab Thông tin khác không bắt buộc, vì vậy trong hầu hết các trường hợp, việc để trống chúng sẽ không dẫn đến lỗi từ chính phủ khi hóa đơn được gửi:
Mô hình vận chuyển xác định cách thức hàng hóa được lên kế hoạch vận chuyển - nội địa.
Nhà vận chuyển Brazil xác định ai đang thực hiện việc vận chuyển.
Sau đó, nhấp vào Send. Trong cửa sổ bật lên, nhấp vào Process e-invoice và bất kỳ tùy chọn nào khác, chẳng hạn như Download hoặc Email. Cuối cùng, nhấp vào Send để xử lý hóa đơn với chính phủ.
Ghi chú
Tất cả các trường có sẵn trên hóa đơn dùng để phát hành hóa đơn điện tử cũng có sẵn trên đơn bán hàng, nếu cần. Khi tạo hóa đơn đầu tiên, trường Số chứng từ được hiển thị và phân bổ làm số đầu tiên sẽ được sử dụng tuần tự cho các hóa đơn tiếp theo.
Giấy báo có¶
Nếu cần đăng ký trả hàng bán, có thể tạo phiếu bổ sung có trong Odoo và gửi đến chính phủ để xác thực.
Ghi chú
Phiếu bổ sung có chỉ khả dụng cho hóa đơn điện tử hàng hóa (NF-e).
Giấy báo nợ¶
Nếu cần bao gồm thêm thông tin hoặc cần sửa các giá trị không được cung cấp chính xác trong hóa đơn gốc, có thể phát hành phiếu bổ sung nợ.
Ghi chú
Phiếu bổ sung nợ chỉ khả dụng cho hóa đơn điện tử hàng hóa (NF-e).
Chỉ các sản phẩm có trong hóa đơn gốc mới có thể được đưa vào phiếu bổ sung nợ. Trong khi có thể thay đổi đơn giá hoặc số lượng của sản phẩm, không thể thêm sản phẩm vào phiếu bổ sung nợ. Mục đích của chứng từ này chỉ là khai báo số tiền cần thêm vào hóa đơn gốc cho cùng hoặc ít sản phẩm hơn.
Huỷ hoá đơn¶
Có thể hủy hóa đơn điện tử mà chính phủ đã xác thực.
Ghi chú
Kiểm tra xem hóa đơn điện tử có còn trong thời hạn hủy hay không, thời hạn này có thể khác nhau tùy theo luật pháp của từng tiểu bang.
E-faktury pro zboží (NF-e)¶
Để hủy hóa đơn điện tử hàng hóa (NF-e) trong Odoo, nhấp Yêu cầu hủy và thêm Lý do hủy trong cửa sổ bật lên xuất hiện. Để gửi lý do hủy này cho khách hàng qua email, bật hộp kiểm E-mail.
Ghi chú
Đây là việc hủy điện tử, có nghĩa là Odoo sẽ gửi yêu cầu đến chính phủ để hủy NF-e. Sau đó nó sẽ tiêu tốn một tín dụng IAP, vì một lệnh gọi API xảy ra.
Hóa đơn điện tử cho dịch vụ (NFS-e)¶
Để hủy hóa đơn điện tử dịch vụ (NFS-e) trong Odoo, nhấp Yêu cầu hủy. Không có quy trình hủy điện tử trong trường hợp này, vì không phải thành phố nào cũng cung cấp dịch vụ này. Người dùng cần hủy NFS-e này trên cổng thành phố theo cách thủ công. Sau khi hoàn tất bước đó, họ có thể yêu cầu hủy trong Odoo, điều này sẽ hủy hóa đơn.
Thư chỉnh sửa¶
Có thể tạo thư chỉnh sửa và liên kết với hóa đơn điện tử hàng hóa (NF-e) mà chính phủ đã xác thực.
Để thực hiện điều này trong Odoo, nhấp vào Thư Điều chỉnh và thêm Lý do điều chỉnh vào cửa sổ bật lên. Để gửi lý do điều chỉnh cho khách hàng qua email, bật hộp kiểm E-mail.
Ghi chú
Thư điều chỉnh chỉ khả dụng cho hóa đơn điện tử hàng hóa (NF-e).
Vô hiệu hóa dải số hóa đơn¶
Dải số thứ tự được gán cho nhật ký bán hàng có thể bị chính phủ vô hiệu hóa nếu chúng hiện không được sử dụng và sẽ không được sử dụng trong tương lai. Để thực hiện, truy cập , mở nhật ký, nhấp vào biểu tượng , và chọn Vô hiệu hóa Dải số (BR). Trong trình hướng dẫn Vô hiệu hóa Dải số (BR), thêm Số Đầu và Số Cuối của dải cần hủy, và nhập Lý do vô hiệu hóa.
Ghi chú
Vô hiệu hóa dải số hóa đơn chỉ khả dụng cho hóa đơn điện tử hàng hóa (NF-e).
Lịch sử trò chuyện của nhật ký ghi lại nhật ký các số đã hủy, cùng với tệp XML.
Hoá đơn mua hàng¶
Khi nhận hóa đơn từ nhà cung cấp, mã hóa hóa đơn mua trong Odoo bằng cách thêm tất cả thông tin thương mại và thông tin đặc thù Brazil giống như được ghi trên hóa đơn khách hàng.
Các trường đặc thù Brazil này là:
Phương thức thanh toán: Brazil: Chỉ định phương thức thanh toán dự kiến.
Loại Chứng từ: được sử dụng bởi nhà cung cấp
Số Chứng từ: số hóa đơn từ nhà cung cấp
Freight Model (NF-e specific): how goods are planned to be transported - domestic
Transporter Brazil (NF-e specific): who is doing the transportation.