브라질¶
더 보기
Helpful resources for the Brazilian localization, including onboarding materials and videos:
모듈¶
The following modules related to the Brazilian localization are available:
이름 |
기술적 명칭 |
설명 |
---|---|---|
브라질 - 회계 |
|
Brazilian fiscal localization package, complete with the Brazilian chart of accounts, taxes, tax report, fiscal positions, and document and identification types. |
브라질 - 회계 보고서 |
|
브라질 회계 보고서 |
AvaTax Brazil, Avatax Brazil Sale & Test SOs for the Brazilian Avatax |
|
Avalara를 통한 상품 및 서비스 세금 계산 |
Brazilian Accounting EDI |
|
Provides electronic invoicing through Avatax. |
Brazilian Accounting EDI For Sale |
|
Adds some fields to sale orders that are carried over the invoice. |
Brazilian Accounting EDI for POS |
|
Provides electronic invoicing through Avatax in the POS. |
Brazilian Accounting EDI for eCommerce |
|
Allows tax calculation and EDI for eCommerce users. |
Brazilian Accounting EDI for stock |
|
Adds delivery-related information to the NF-e. |
Brazil - Website Sale |
|
Allows tax calculation and EDI for eCommerce users. |
Brazil - Sale |
|
브라질의 판매 변경 사항 |
Brazil - Sale Subscription |
|
브라질의 판매 구독 변경 |
참고
The localization’s core modules are installed automatically with the localization. The rest can be manually installed.
현지화의 전반적인 흐름¶
The Brazilian localization package ensures compliance with Brazilian fiscal and accounting regulations. It includes tools for managing taxes, fiscal positions, reporting, and a predefined chart of accounts tailored to Brazil’s standards.
The Brazilian localization package provides the following key features to ensure compliance with local fiscal and accounting regulations:
Chart of accounts: a predefined structure tailored to Brazilian accounting standards
Taxes: pre-configured tax rates, including standard VAT, zero-rated, and exempt options.
계정과목표¶
In the chart of accounts, the accounts are mapped automatically to their corresponding taxes, and the default account payable and account receivable fields.
참고
The Brazil chart of accounts is based on the SPED CoA, which provides a baseline of the necessary accounts.
세금¶
Taxes are automatically created and configured when installing the Brazilian localization. Avalara uses some to compute taxes on sales orders or invoices.
Taxes used for services must be manually added and configured, as the rate may differ depending on the city where the service is offered.
중요
NFS-e can’t be issued for service taxes created manually. To electronically send an NFS-e, compute taxes using Avalara.
경고
세금은 삭제하지 마세요. Avatax 세금 계산에 사용됩니다. 세금을 삭제한 경우 Odoo에서 SO 또는 청구서를 이용할 경우 세금이 재생성되며 AvaTax를 통해 세금이 계산됩니다. 단, 세금 등록에 사용된 계정은 세금의 정의 탭에 있는 청구서 배분 및 환급액 배분 섹션에서 다시 설정해야 합니다.
Company and contacts¶
To use all the features of this fiscal localization, the following fields are required on the company record:
이름
주소: 도시, 지역, 우편번호, 국가
도로명 필드에는 도로명, 번호 및 추가 주소 정보를 입력합니다.
도로명 2 필드에 동 주소를 입력합니다.
식별 번호: CNPJ 또는 CPF
세금 ID: 식별 유형 관련
IE: 주 등록
IM: 시 등록
SUFRAMA 코드: 마나우스 자유무역지구 감독 - 해당될 경우 추가
전화번호
이메일
판매 및 매입 탭에서 :guilabel:`재정 정보`를 설정합니다.
Add the Fiscal Position for AvaTax Brazil.
세금 제도: 연방 세금 제도
ICMS 납세자 유형: ICMS 제도, 면세 상태 또는 :guilabel:`비과세 대상`를 나타냅니다.
주요 활동 부문
Configure the following extra Fiscal Information to issue NFS-e:
Add the Fiscal Position for AvaTax Brazil.
COFINS 세부 정보: 과세 가능, 비과세, 영세율로 과세 가능, 면제, 유예
PIS 세부 정보 과세 가능, 비과세, 영세율로 과세 가능, 면세, 유예
CSLL Taxable if the company is subject to CSLL or not
팁
If it is a simplified regime, the ICMS rate must be configured. To do so, go to Taxes section, and set the Sales Tax and Purchase Tax fields in the Default Taxes section.
, scroll down to theThe same configuration applies to the relevant contact form when using the AvaTax integration.
참고
세금 ID (CNPJ)가 연락처에 있는 경우, 회사 옵션을 선택하고, CPF가 있는 연락처인 경우 :guilabel:`개인`을 선택합니다.
AvaTax 통합¶
참고
Make sure to install the AvaTax Brazil (
l10n_br_avatax
) module.Odoo는 Avalara 브라질의 인증된 파트너입니다.
The Avalara AvaTax integration uses In-App-Purchases (IAPs) to compute taxes and handle electronic documents (e.g., NF-e, NFS-e). Each action consumes credits from the IAP credit balance. On creation, new databases receive 500 free credits.
To compute the goods and services tax and process electronic invoices, the following configurations are needed:
환경설정¶
자격 증명¶
Activate AvaTax in Odoo and, 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.
경고
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.
There are two different Brazilian Avalara Portals:
One for testing: https://portal.sandbox.avalarabrasil.com.br/
One for production: https://portal.avalarabrasil.com.br/
Odoo에서 계정을 생성하려면 환경을 정확히 선택해야 합니다. 또한 계정을 만들 때 사용한 이메일 주소는 다른 계정을 만들 때는 사용할 수 없습니다. Odoo에서 계정을 만들 때 API ID 와 API Key 를 저장해 두세요.

After the account is created from Odoo, go to the Avalara Portal to set up the password:
Avalara 포털 <https://portal.avalarabrasil.com.br/Login>`_에 접속합니다.
Click Meu primeiro acesso.
Add the email address used in Odoo to create the Avalara/AvaTax account, and click Solicitar Senha.
An email will then be received with a token and a link to create a password. Click on this link and copy-paste the token to allocate the desired password.
팁
If you use AvaTax in Odoo for tax computation only, setting a password or accessing the Avalara portal is unnecessary. However, to use the electronic invoice service, access to AvaTax is needed, and the certificate must be uploaded.
참고
API credentials can be transferred. This option should be used only when an account has already been created in another Odoo instance and must be reused.
A1 인증서 업로드¶
To issue electronic invoices, a certificate must be uploaded to the AvaTax portal.
The certificate will be synchronized with Odoo as long as the external identifier number in the AvaTax portal matches, without special characters, with the CNPJ number, and the identification number (CNPJ) in Odoo matches the CNPJ in AvaTax.
중요
Some cities require the certificate to be linked within the City Portal system before issuing NFS-e from Odoo.
If an error message from the city that says Your certificate is not linked to the user is received, this process needs to be done in the city portal.
재정 위치¶
To set up the Automatic Tax Mapping (Avalara Brazil) fiscal position, enable the Detect Automatically and Use AvaTax Brazil API options.
더 보기
품목¶
To use the AvaTax integration on sales orders and invoices, enter the following information in the Sales tab of the product form under the Brazil Accounting section, based on how the product will be used.
상품용 전자 청구서 (NF-e)¶
중요
The Avalara integration works on a credit-based system, where each interaction with Avalara consumes one credit. Below are the main credit-consuming operations:
Sales application
Tax calculation on quotations and sales orders.
Accounting application
Tax calculation on invoices.
Electronic invoice submission (NF-e or NFS-e).
Occasional operations: (each step is billed separately)
참고
If taxes are calculated in the Sales app, and the invoice is later issued in the Accounting app, the calculation happens twice, consuming two credits.
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 at https://www.codigocest.com.br/.
Mercosul NCM 코드: Mercosur 일반 분류법 품목 코드
Source of Origin: origin of the product, which can be foreign or domestic, among other possible options, depending on the specific use case
SPED Fiscal Product Type: fiscal product type according to the SPED list table
Purpose of Use: intended purpose of use for this product
참고
Odoo automatically creates three products to be used for transportation costs associated with sales. These are named Freight, Insurance, and Other Costs and are already configured. If more need to be created, duplicate and use the same configuration:
Product Type Service
Transportation Cost Type: Insurance, Freight, or Other Costs
서비스용 전자 청구서 (NFS-e)¶
중요
The Avalara integration works on a credit-based system, where each interaction with Avalara consumes one credit. Below are the main credit-consuming operations:
Sales application
Tax calculation on quotations and sales orders.
Accounting application
Tax calculation on invoices.
Electronic invoice submission (NF-e or NFS-e).
Invoice status check (1 credit is consumed each time the invoice status is checked).
Occasional operations: (each step is billed separately)
참고
If taxes are calculated in the Sales app and the invoice is later issued in the Accounting app, the calculation happens twice, consuming two credits.
Example
Mercosul NCM 코드: Mercosur 일반 분류법 품목 코드
Purpose of Use: intended purpose of use for this product
서비스 코드 출처: 공급자 등록 지역의 서비스 코드
Labor Assignment: checkbox to select if the service involves labor
Transport Cost Type: type of transport costs to select
Service Codes: City Service Code where the service will be provided; if no code is added, the Service Code Origin will be used.
세금 계산¶
더 보기
견적서 및 판매주문서에 대한 세금 계산¶
다음의 방법 중에서 견적서 또는 판매 주문에 대한 세금을 자동으로 계산하도록 API 호출을 트리거하여 AvaTax로 계산합니다:
- 견적 확인
견적서를 확인하여 판매주문서로 만듭니다.
- 수동 트리거
Click Compute Taxes Using AvaTax.
- 미리 보기
Click Preview.
- Email a quotation/sales order
이메일을 통해 고객에게 견적서나 판매주문서를 보냅니다.
- 온라인 견적서 액세스 권한
고객이 온라인으로 (포털 화면을 통하여) 견적서에 액세스하면 API 호출이 트리거됩니다.
청구서에 대한 세금 계산¶
다음 방법 중에서 고객 청구서에 대한 세금을 AvaTax를 통해 자동 계산할 수 있도록 API 가 호출되도록 트리거합니다.
- 수동 트리거
Click Compute Taxes Using AvaTax.
- 미리 보기
Click Preview.
- 온라인 청구서 액세스
고객이 온라인으로 (포털 화면을 통하여) 청구서에 액세스하면 API 호출이 트리거됩니다.
회계¶
전자 문서¶
환경설정¶
연번 으로 구성된 번호는 전자 청구서의 고유 일련번호 범위에 연결됩니다. 판매 전표에서 연번을 설정하려면 연번 필드에 설정하세요. 연번 항목이 두 개 이상 필요한 경우 새 판매 전표를 생성한 후 연속된 전표에 반드시 새 연번을 지정해야 합니다.
로 이동하여Enable the Use Documents? option as the Series field will only be displayed if the Use Documents? option is selected on the journal.
When issuing electronic and non-electronic invoices, the Type field selects the document type used when creating the invoice.
참고
When creating the 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.
고객 청구서¶
To process an electronic invoice for goods (NF-e) or services (NFS-e), the invoice must be confirmed and taxes must be computed by Avalara. The following fields must be filled out:
Customer, with all customer information
Payment Method: Brazil: Specify the expected payment method.
Document Type: Select (55) Electronic Invoice (NF-e) or (SE) Electronic Service Invoice (NFS-e).
Other Info tab:
Fiscal Position set as Automatic Tax Mapping (Avalara Brazil).
Some optional fields depend on the nature of the transaction. These fields in the Other Info tab are not required, so in most cases, leaving them blank will not result in errors from the government when the invoice is submitted:
Freight Model determines how the goods are planned to be transported - domestic.
Transporter Brazil determines who is doing the transportation.
Then, click Send. In the Print & Send window, click Process e-invoice and any other options, such as Download or Email. Finally, click Send to process the invoice with the government.
참고
전자 청구서 발행애 이용되는 청구서상의 모든 필드는 필요에 따라 판매주문서에서도 활용할 수 있습니다. 첫 번째 청구서를 생성할 때 문서 번호 필드가 표시되며, 이후 후속 청구서에 순차적으로 사용될 첫 번째 번호로 지정됩니다.
대변전표¶
If a sales return needs to be registered, a credit note can be created in Odoo and sent to the government for validation.
참고
대변전표는 상품 (NF-e)에 대한 전자 청구서에만 사용할 수 있습니다.
차변전표¶
If additional information needs to be included or values that were not accurately provided in the original invoice need to be corrected, a debit note can be issued.
참고
차변전표는 상품 (NF-e)에 대한 전자 청구서에만 사용할 수 있습니다.
원래의 청구서에 있던 품목만 차변표에 포함될 수 있습니다. 품목의 단가나 수량은 변경할 수 있지만 품목을 차변표에 추가하는 것은 불가 합니다. 이 문서의 목적은 원래의 청구서에 있던 품목 수량 이하에 대해 추가 금액을 신고하는 것에 있습니다.
청구서 취소¶
It is possible to cancel an electronic invoice that the government validated.
참고
Check whether the electronic invoice is still within the cancellation deadline, which may vary according to each state’s legislation.
상품용 전자 청구서 (NF-e)¶
To cancel an e-invoice for goods (NF-e) in Odoo, click Request Cancel and add a cancellation Reason on the pop-up that appears. To send this cancellation reason to the customer via email, enable the E-mail checkbox.
참고
This is an electronic cancellation, which means that Odoo will send a request to the government to cancel the NF-e. It will then consume one IAP credit, as an API call occurs.
서비스용 전자 청구서 (NFS-e)¶
Odoo에서 서비스 전자 청구서(NFS-e)를 취소하려면 취소 요청 을 클릭합니다. 모든 지역에서 이 서비스가 지원되는 것은 아니며, 전자 취소 절차가 없을 수도 있습니다. 이 경우 사용자가 지역 포털에서 NFS-e를 직접 취소해야 합니다. 이 단계가 완료되면 Odoo에서 취소 요청을 할 수 있으며 이를 통해 청구서 취소가 완료됩니다.
정정요청서¶
A correction letter can be created and linked to an electronic invoice for goods (NF-e) that the government validated.
To do so in Odoo, click Correction Letter and add a correction Reason to the pop-up. To send the correction reason to a customer via email, enable the E-mail checkbox.
참고
정정 신청서는 상품용 전자 청구서 (NF-e)에만 사용할 수 있습니다.
Invoice number range invalidation¶
시퀀스 범위가 판매 전표에 지정된 이후 현재 미사용 중이며 동시에 향후에도 사용할 계획이 없는 경우에는 정부에서 이를 무효화할 수 있습니다. 무효화된 경우
로 이동하여 전표를 열고 (톱니바퀴) 아이콘을 클릭한 다음 ‘숫자 범위 무효 처리(BR)’ 를 선택합니다. ‘숫자 범위 무효 처리(BR)’ 마법사에서 취소할 범위에 있는 ‘시작 번호’와 ‘끝 번호’ 를 추가한 후 무효 처리 사유를 입력합니다.참고
Invoice number range invalidation is only available for electronic invoices for goods (NF-e).
The journal’s chatter records the log of the cancelled numbers, along with the XML file.
공급업체 청구서¶
When receiving an invoice from a supplier, encode the bill in Odoo by adding all the commercial information and the same Brazilian-specific information recorded on the customer invoices.
These Brazilian-specific fields are:
Payment Method: Brazil: Specify the expected payment method.
Document Type: used by the vendor
Document Number: the invoice number from the supplier
운송 모델:상품이 배송될 NF-e 전용 운송 방법 - 국내
브라질 운송업체: 운송을 담당할 NF-e 전용 운송업체
Point of sale NFC-e¶
NFC-e는 법적인 문서로서 최종 소비자에게 상품이나 물품 판매를 지원합니다. NF-e 와 마찬가지로, 전자 고객 청구서도 XML 파일 형식으로 발행되며 NFC-e 요약 이라는 보조 문서(DANFC-e)가 함께 있습니다. 이 전자 문서는 Odoo POS 에서 발행할 수 있습니다.
Its legal validity is guaranteed by the digital signature and by each Brazilian state’s SEFAZ (Secretaria da Fazenda).
중요
The Avalara integration operates on a credit-based system. Each operation that involves communication with Avalara consumes one credit. The following operations within the Point of Sale (POS) application are subject to credit consumption:
Tax calculation at the time of sale
Electronic invoice issuance (NFC-e)
참고
Each step is billed separately. For example, calculating taxes and issuing an invoice for the same POS transaction consumes two credits.
더 보기
환경설정¶
Install the Brazilian Accounting EDI for POS (l10nbr_edi_pos
)
module and make sure to activate AvaTax.
CSC details¶
Go to Taxes section. In the NFC-e configuration section, complete the following CSC (Taxpayer Security Code) fields:
and scroll to theCSC ID: The CSC ID or CSC Token is an identification of the taxpayer security code, which can have 1 to 6 digits and is available on the official website of your state’s Department of Finance (SEFAZ).
CSC Number: The CSC Number is a code of up to 36 characters that only you and the Department of Finance know. It is used to generate the QR Code of the NFC-e and ensure the authenticity of the DANFE.
참고
The information required for these fields can be generated through the SEFAZ website of each Brazilian State by the company’s accountant.
품목 설정¶
Access the relevant product form in POS, then configure the product’s Brazil Accounting fields.
Point of sale¶
Go to selected at the top of the screen. Then, scroll to the Accounting section and configure the Brazilian EDI fields:
and make sure that the relevant Point of Sale isSeries
Next number: the next NFC-e number in the sequence to be issued, for instance, if the last number issued in SEFAZ is
100
, the Next number will be101
.
업무 순서¶
Generating an NFC-e¶
To generate an NFC-e, follow these steps:
Validate the payment to calculate taxes and issue an NFC-e. The valid NFC-e appears on the right side of the screen.

참고
It is also possible to issue an NFC-e that identifies the customer by their CPF/CNPJ. To do so, click Customer, search for the customer, or create a new one.
The following are mandatory fields to issue a CPF/CNPJ identified NFC-e:
이름
City and State where the invoice is being issued
CPF/CNPJ
Click Validate. The NFC-e appears, highlighting the customer’s CPF on the print.
Click Print or Send via e-mail to deliver the invoice to the customer.
NFC-e ticket print¶
After generating and validating the NFC-e, click Print to deliver the invoice.
참고
The Odoo NFC-e feature is compatible with any thermal printer and does not require an Odoo IoT Box.
Re-issuing a PoS order with an NFC-e error¶
If the NFC-e returns an error, follow these steps:
Correct the error.
Re-issue the NFC-e by clicking the (menu) icon and selecting Orders.
Filter the list to show only Paid orders and click Details. The error is displayed.
Click Send 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 & cancellations¶
Refunds can be processed directly in Odoo, but cancellations must be performed through the official government portal.
When the process is finalized, the approved return NF-e is created, meaning the previous NFC-e is canceled.

중요
SEFAZ only allows cancellation of an NFC-e within 30 minutes of its issuance on the SEFAZ website. After this period, a manual refund must be processed, along with the issuance of a Return of Goods NF-e.