브라질¶
더 보기:
브라질 현지화용 유용한 자료 (온보딩 자료 및 동영상 포함):
모듈¶
The following modules are installed automatically with the Brazilian localization:
이름 |
기술적 명칭 |
설명 |
|---|---|---|
브라질 - 회계 |
|
기본 재정 현지화 패키지 에는 일반적인 브라질 계정과목표 및 세금 항목이 문서 유형 및 식별 유형이 함께 내장되어 있습니다. |
브라질 - 회계 보고서 |
|
브라질 회계 보고서 |
브라질 Pix QR 코드 |
|
브라질의 Pix QR 코드를 구현합니다. |
브라질 - 판매 구독 |
|
Subscriptions modifications for Brazil. |
브라질 - 판매 |
|
Sales modifications for Brazil. |
브라질 - 웹사이트 판매 |
|
이커머스 사용자용 세금 계산 및 EDI 기능을 지원합니다. |
또한 다음 모듈을 수동으로설치해야 합니다:
이름 |
기술적 명칭 |
설명 |
|---|---|---|
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 브라질 서비스 판매 |
|
Sales modifications for Brazil for services |
브라질 회계 EDI & 브라질 서비스용 회계 EDI |
|
AvaTax를 통해 브라질용 상품 및 서비스에 대한 전자 청구서를 제공합니다. |
브라질 판매용 회계 EDI |
|
Adds fields to sales orders that will be carried over to the invoice. |
참고
추가 모듈이 있는 버전으로 업그레이드하는 경우와 같이 모듈이 자동으로 설치되지 않을 수 있습니다. 누락된 모듈은 수동으로설치할 수 있습니다.
현지화의 전반적인 흐름¶
브라질 현지화 패키지는 브라질 재정 및 회계 규정 준수를 보장합니다. 세금, 재정 위치, 보고 관리를 위한 도구와 브라질 표준에 맞춘 사전 정의된 계정 차트가 포함되어 있습니다.
브라질 현지화 패키지는 현지 재정 및 회계 규정 준수를 보장하기 위해 다음과 같은 주요 기능을 제공합니다:
계정과목표¶
계정 차트에서 계정은 해당 세금과 기본 지급 계정 및 수취 계정 필드에 자동으로 매핑됩니다.
참고
브라질 계정 차트는 필요한 계정의 기준을 제공하는 SPED CoA를 기반으로 합니다.
세금¶
브라질 현지화를 설치하면세금이 자동으로 생성되고 구성됩니다. Avalara는 이 중 일부를 사용하여 판매 주문 또는 인보이스의 세금을 계산합니다.
서비스에 사용되는 세금은 서비스가 제공되는 도시에 따라 세율이 다를 수 있으므로 수동으로 추가하고 구성해야 합니다.
중요
수동으로 생성된 서비스 세금에 대해서는 NFS-e를 발행할 수 없습니다. NFS-e를 전자적으로 전송하려면 Avalara를 사용하여 세금을 계산하십시오.
경고
세금은 삭제하지 마세요. Avatax 세금 계산에 사용됩니다. 세금을 삭제한 경우 Odoo에서 SO 또는 청구서를 이용할 경우 세금이 재생성되며 AvaTax를 통해 세금이 계산됩니다. 단, 세금 등록에 사용된 계정은 세금의 정의 탭에 있는 청구서 배분 및 환급액 배분 섹션에서 다시 설정해야 합니다.
품목¶
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.
참고
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.
회사 및 문의처¶
이 재정 현지화의 모든 기능을 사용하려면회사 레코드에 다음 필드가 필요합니다:
이름
주소: 도시, 지역, 우편번호, 국가
도로명 필드에는 도로명, 번호 및 추가 주소 정보를 입력합니다.
도로명 2 필드에 동 주소를 입력합니다.
식별 번호: CNPJ 또는 CPF
세금 ID: 식별 유형 관련
IE: 주 등록
IM: 시 등록
SUFRAMA 코드: 마나우스 자유무역지구 감독 - 해당될 경우 추가
전화번호
이메일
팁
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:
AvaTax 브라질의 재정 위치 를 추가합니다.
Tax Regime: Federal tax regime.
ICMS Taxpayer Type: Select ICMS regime, Exempt status, or Non-Taxpayer.
주요 활동 부문
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.
NFS-e를 발행하려면 다음의 추가적인 재정 정보 를 설정하세요:
AvaTax 브라질의 재정 위치 를 추가합니다.
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.
팁
간이 요금제인 경우 반드시 ICMS 요율을 설정해야 합니다. 이렇게 하려면 으로 이동하여 세금 섹션까지 아래로 스크롤한 후 기본 세금 섹션에서 판매세 및 구매세 필드를 설정합니다.
AvaTax 통합을 사용할 때 관련연락처양식에도 동일한 구성이 적용됩니다.
참고
세금 ID (CNPJ)가 연락처에 있는 경우, 회사 옵션을 선택하고, CPF가 있는 연락처인 경우 :guilabel:`개인`을 선택합니다.
AvaTax 통합¶
참고
AvaTax 브라질 (
l10n_br_avatax) 모듈이 :ref:`설치 <general/install>`되어 있는지 확인하세요.Odoo는 Avalara 브라질의 인증된 파트너입니다.
Avalara AvaTax 통합은인앱 구매(IAP)를 사용하여 세금을 계산하고 전자 문서(예:NF-e,NFS-e)를 처리합니다. 각 작업은 IAP 크레딧 잔액에서 크레딧을 소비합니다. 생성 시 새 데이터베이스는 500개의 무료 크레딧을 받습니다.
상품 및 서비스 세금을 계산하고 전자 인보이스를 처리하려면 다음 구성이 필요합니다:
환경 설정¶
자격 증명¶
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.
경고
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.
브라질에서는 두 가지 다른 Avalara 포털을 사용하고 있습니다:
Odoo에서 계정을 생성하려면 환경을 정확히 선택해야 합니다. 또한 계정을 만들 때 사용한 이메일 주소는 다른 계정을 만들 때는 사용할 수 없습니다. Odoo에서 계정을 만들 때 API ID 와 API Key 를 저장해 두세요.
Odoo에서 계정이 생성된 후 Avalara Portal로 이동하여 비밀번호를 설정합니다:
Avalara 포털 <https://portal.avalarabrasil.com.br/Login>`_에 접속합니다.
:guilabel:`첫 접속`을 클릭합니다.
Avalara/AvaTax 계정을 생성하기 위해 Odoo에서 사용한 이메일 주소를 추가하고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.
팁
Odoo에서 세금 계산만을 위해AvaTax를 사용하는 경우 비밀번호를 설정하거나 Avalara 포털에 액세스할 필요가 없습니다. 그러나 전자 인보이스 서비스를 사용하려면 AvaTax에 대한 액세스가 필요하며인증서를 업로드해야 합니다.
참고
API자격 증명을 전송할 수 있습니다. 이 옵션은 다른 Odoo 인스턴스에서 이미 계정이 생성되었고 재사용해야 하는 경우에만 사용해야 합니다.
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.
팁
If inconsistencies occur when submitting fiscal reform information, disable the Enable Brazilian fiscal reform option to revert to the previous communication model.
A1 인증서 업로드¶
전자 세금계산서를 발행하려면 `AvaTax 포털<https://portal.avalarabrasil.com.br/Login>`_에 인증서를 업로드해야 합니다.
AvaTax 포털의 외부 식별 번호가 특수 문자 없이 CNPJ 번호와 일치하고 Odoo의 식별 번호(CNPJ)가 AvaTax의 CNPJ와 일치하는 한 인증서는 Odoo와 동기화됩니다.
중요
일부 도시에서는 Odoo에서 NFS-e를 발행하기 전에 도시 포털 시스템 내에서 인증서를 연결해야 합니다.
인증서가 사용자에게 연결되지 않았습니다라는 도시의 오류 메시지가 수신되면 도시 포털에서 이 프로세스를 수행해야 합니다.
재정 위치¶
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 on the product form, based on how the product will be used.
상품용 전자 청구서 (NF-e)¶
중요
Avalara 통합은 크레딧 기반 시스템으로 작동하며, Avalara와의 각 상호작용은 하나의 크레딧을 소비합니다. 다음은 주요 크레딧 소비 작업입니다:
판매 애플리케이션
견적서 및 판매주문서 상의 세금 계산.
회계 애플리케이션
청구서 세금 계산하기.
전자 청구서 제출 (NF-e 또는 NFS-e).
비정기 작업: (단계별 별도 청구)
참고
판매 앱에서 세금이 계산되고 나중에 회계 앱에서 세금계산서가 발행되면 계산이 두 번 발생하여 두 개의 크레딧을 소비합니다.
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.
Mercosul NCM 코드: Mercosur 일반 분류법 품목 코드
원산지: 제품의 원산지로, 특정 사용 사례에 따라 외국산 또는 국내산 등 다른 가능한 옵션이 있습니다
SPED 회계 제품 유형: SPED 목록 테이블에 따른 회계 제품 유형
사용 목적: 본 제품의 사용 목적
참고
Odoo는 판매와 관련된 운송 비용에 사용할 세 가지 제품을 자동으로 생성합니다. 이들은운임,보험및기타 비용으로 명명되며 이미 구성되어 있습니다. 더 많이 생성해야 하는 경우 복제하고 동일한 구성을 사용하십시오:
Product Type: Service
운송비 유형: 보험, 운임 또는 기타 비용
서비스용 전자 청구서 (NFS-e)¶
중요
Avalara 통합은 크레딧 기반 시스템으로 작동하며, Avalara와의 각 상호작용은 하나의 크레딧을 소비합니다. 다음은 주요 크레딧 소비 작업입니다:
판매 애플리케이션
견적서 및 판매주문서 상의 세금 계산.
회계 애플리케이션
청구서 세금 계산하기.
전자 청구서 제출 (NF-e 또는 NFS-e).
세금계산서 상태 확인(세금계산서 상태를 확인할 때마다 1 크레딧이 소비됩니다).
비정기 작업: (단계별 별도 청구)
참고
판매 앱에서 세금이 계산되고 나중에 회계 앱에서 세금계산서가 발행되면 계산이 두 번 발생하여 두 개의 크레딧을 소비합니다.
Example
Mercosul NCM 코드: Mercosur 일반 분류법 품목 코드
사용 목적: 본 제품의 사용 목적
서비스 코드 출처: 공급자 등록 지역의 서비스 코드
인력 배정: 서비스에 작업 인력이 포함되어 있는 경우 확인란에 표시합니다
운송비 유형: 선택하려는 운송비 유형
서비스 코드: 서비스가 제공될 도시 서비스 코드입니다. 코드가 추가되지 않으면서비스 코드 원산지가 사용됩니다.
세금 계산¶
더 보기:
견적서 및 판매주문서에 대한 세금 계산¶
다음의 방법 중에서 견적서 또는 판매 주문에 대한 세금을 자동으로 계산하도록 API 호출을 트리거하여 AvaTax로 계산합니다:
- 견적 확인
견적서를 확인하여 판매주문서로 만듭니다.
- 수동 트리거
AvaTax로 세금 계산하기 를 클릭합니다.
- 미리 보기
미리보기 를 클릭합니다.
- 견적서/판매주문서 이메일 보내기
이메일을 통해 고객에게 견적서나 판매주문서를 보냅니다.
- 온라인 견적서 액세스 권한
고객이 온라인으로 (포털 화면을 통하여) 견적서에 액세스하면 API 호출이 트리거됩니다.
청구서에 대한 세금 계산¶
다음 방법 중에서 고객 청구서에 대한 세금을 AvaTax를 통해 자동 계산할 수 있도록 API 가 호출되도록 트리거합니다.
- 수동 트리거
AvaTax로 세금 계산하기 를 클릭합니다.
- 미리 보기
미리보기 를 클릭합니다.
- 온라인 청구서 액세스
고객이 온라인으로 (포털 화면을 통하여) 청구서에 액세스하면 API 호출이 트리거됩니다.
더 보기:
회계¶
전자 문서¶
환경 설정¶
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.
팁
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.
전자 및 비전자 세금계산서를 발행할 때유형필드는 세금계산서 생성 시 사용되는 문서 유형을 선택합니다.
고객 청구서¶
상품(NF-e) 또는 서비스(NFS-e)에 대한 전자 세금계산서를 처리하려면 세금계산서가 확인되어야 하고 Avalara에서 세금을 계산해야 합니다. 다음 필드를 입력해야 합니다:
고객, 모든 고객 정보가 들어 있습니다
결제 수단: 브라질: 예상되는 결제 수단을 지정합니다.
문서 유형: (55) 전자 송장 (NF-e)또는(SE) 전자 서비스 송장 (NFS-e)을 선택하세요.
기타 정보 tab:
재정 위치 를 자동 세금 매핑(Avalara 브라질) 으로 설정합니다.
일부 선택 필드는 거래의 성격에 따라 달라집니다. 기타 정보 탭의 이러한 필드는 필수가 아니므로 대부분의 경우 비워두어도 송장이 제출될 때 정부로부터 오류가 발생하지 않습니다:
운송 모델은 상품이 국내에서 어떻게 운송될 계획인지를 결정합니다.
브라질 운송업체 에서 운송 담당자를 지정합니다.
그런 다음보내기를 클릭하세요. 팝업 창에서전자 송장 처리및다운로드또는이메일과 같은 기타 옵션을 클릭하세요. 마지막으로보내기를 클릭하여 정부에 송장을 처리하세요.
참고
전자 청구서 발행애 이용되는 청구서상의 모든 필드는 필요에 따라 판매주문서에서도 활용할 수 있습니다. 첫 번째 청구서를 생성할 때 문서 번호 필드가 표시되며, 이후 후속 청구서에 순차적으로 사용될 첫 번째 번호로 지정됩니다.
대변전표¶
판매 반품을 등록해야 하는 경우, Odoo에서신용 전표를 생성하여 검증을 위해 정부에 전송할 수 있습니다.
참고
대변전표는 상품 (NF-e)에 대한 전자 청구서에만 사용할 수 있습니다.
차변전표¶
추가 정보를 포함하거나 원본 송장에서 정확하게 제공되지 않은 값을 수정해야 하는 경우차변 전표를 발행할 수 있습니다.
참고
차변전표는 상품 (NF-e)에 대한 전자 청구서에만 사용할 수 있습니다.
원래의 청구서에 있던 품목만 차변표에 포함될 수 있습니다. 품목의 단가나 수량은 변경할 수 있지만 품목을 차변표에 추가하는 것은 불가 합니다. 이 문서의 목적은 원래의 청구서에 있던 품목 수량 이하에 대해 추가 금액을 신고하는 것에 있습니다.
청구서 취소¶
정부가 검증한 전자 송장을 취소하는 것이 가능합니다.
참고
전자 송장이 여전히 취소 기한 내에 있는지 확인하세요. 취소 기한은 각 주의 법률에 따라 다를 수 있습니다.
상품용 전자 청구서 (NF-e)¶
Odoo에서 상품에 대한 전자 송장(NF-e)을 취소하려면취소 요청을 클릭하고 나타나는 팝업에 취소사유를 추가하세요. 이 취소 사유를 이메일을 통해 고객에게 보내려면이메일 체크박스를 활성화하세요.
참고
이것은 전자 취소입니다. 즉, Odoo가 NF-e를 취소하기 위해 정부에 요청을 보냅니다. IAP 호출이 발생하므로 API 크레딧 하나를 소비합니다.
서비스용 전자 청구서 (NFS-e)¶
Odoo에서 서비스 전자 청구서(NFS-e)를 취소하려면 취소 요청 을 클릭합니다. 모든 지역에서 이 서비스가 지원되는 것은 아니며, 전자 취소 절차가 없을 수도 있습니다. 이 경우 사용자가 지역 포털에서 NFS-e를 직접 취소해야 합니다. 이 단계가 완료되면 Odoo에서 취소 요청을 할 수 있으며 이를 통해 청구서 취소가 완료됩니다.
정정요청서¶
정부가 검증한 상품에 대한 전자 송장(NF-e)에 대해 수정 서신을 작성하고 연결할 수 있습니다.
Odoo에서 이를 수행하려면수정 서신을 클릭하고 팝업에 수정사유를 추가하세요. 수정 사유를 이메일을 통해 고객에게 보내려면이메일 체크박스를 활성화하세요.
참고
정정 신청서는 상품용 전자 청구서 (NF-e)에만 사용할 수 있습니다.
청구서 번호 범위 무효화¶
시퀀스 범위가 판매 전표에 지정된 이후 현재 미사용 중이며 동시에 향후에도 사용할 계획이 없는 경우에는 정부에서 이를 무효화할 수 있습니다. 무효화된 경우 로 이동하여 전표를 열고 (톱니바퀴) 아이콘을 클릭한 다음 ‘숫자 범위 무효 처리(BR)’ 를 선택합니다. ‘숫자 범위 무효 처리(BR)’ 마법사에서 취소할 범위에 있는 ‘시작 번호’와 ‘끝 번호’ 를 추가한 후 무효 처리 사유를 입력합니다.
참고
송장 번호 범위 무효화는 상품에 대한 전자 송장(NF-e)에만 사용할 수 있습니다.
분개장의 채터에는 취소된 번호의 로그가 XML 파일과 함께 기록됩니다.
공급업체 청구서¶
공급업체로부터 송장을 받을 때 모든 상업 정보와고객 송장에 기록된 것과 동일한 브라질별 정보를 추가하여 Odoo에 청구서를 입력하세요.
브라질 전용 필드는 다음과 같습니다:
결제 수단: 브라질: 예상되는 결제 수단을 지정합니다.
문서 유형: 공급업체에서 사용하는 유형입니다
문서 번호: 공급업체 청구서 번호
Freight Model (NF-e specific): how goods are planned to be transported - domestic
Transporter Brazil (NF-e specific): who is doing the transportation.