브라질

소개

With the Brazilian localization you can automatically compute sales taxes for goods using AvaTax (Avalara) through API calls, also configure taxes for services.

For the goods tax computation part, you need to configure the contacts, company, products, and create an account in Avatax from the Odoo general settings.

서비스 관련 세금의 경우 AvaTax에서 계산하지 않고 Odoo에서 직접 생성 및 설정할 수 있습니다.

현지화에는 필요한 경우 수정할 수 있는 세금 및 계정과목표 서식도 들어 있습니다.

환경 설정

모듈 설치

다음 모듈을 :ref:`설치 <general/install>`하면 브라질 현지화 기능을 모두 사용할 수 있습니다.

이름

기술적 명칭

설명

브라질 - 회계

l10n_br

Default fiscal localization package - adds accounting characteristics for the Brazilian localization, which represent the minimum configuration required for a company to operate in Brazil. The module’s installation automatically loads: the chart of accounts, taxes, and required fields to properly configure the contact.

브라질 - 회계 보고서

l10n_br_reports

Adds a simple tax report that helps check the tax amount per tax group in a given period of time. Also adds the P&L and BS adapted for the Brazilian market.

Avatax 브라질

l10n_br_avatax

Add Brazilian tax calculation via Avatax and all necessary fields needed to configure Odoo in order to properly use Avatax and send the needed fiscal information to retrieve the correct taxes.

Avatax for SOs in Brazil

l10n_br_avatax_sale

Same as the l10n_br_avatax module with the extension to the sales order module.

회사 설정하기

회사 정보를 설정하려면 연락처 앱으로 이동하여 회사 이름을 검색합니다.

  1. 페이지 상단에서 회사 옵션을 선택합니다. 선택한 후, 다음 내용을 입력합니다.

    • 이름

    • Address (add City, State, Zip Code, Country)

    • Tax ID (CNPJ)

    • IE (State Registration)

    • IM (Municipal Registration)

    • SUFRAMA code (Superintendence of the Manaus Free Trade Zone - add if applicable)

    • 전화번호

    • 이메일

    회사 환경 설정
  2. 판매 및 매입 탭에서 :guilabel:`재정 정보`를 설정합니다.

    • :ref:`Avatax Brazil <brazil/fiscal-positions>`에 대해 :guilabel:`재정 위치`를 추가합니다.

    • Tax Regime (Federal Tax Regime)

    • ICMS Taxpayer Type (indicates ICMS regime, Exempt status, or Non-Taxpayer.)

    • 주요 활동 부문

    회사 재정 환경 설정
  3. 마지막으로 회사 로고를 업로드한 후 연락처를 저장합니다.

참고

단순화된 정책을 사용하고 있는 경우 :menuselection:`회계 –> 환경 설정 –> 설정 –> 세금 –>Avatax Brazil `에서 ICMS 요율 설정을 해야 합니다.

AvaTax 통합 설정

Avalara AvaTax is a tax calculation provider that can be integrated in Odoo to automatically compute taxes by taking into account the company, contact (customer), product, and transaction information to retrieve the correct tax to be used.

Odoo is a certified partner of Avalara Brazil, which means that Avalara experts reviewed workflows covered within the scope of the integration.

Using this integration requires In-App-Purchases (IAPs) to compute taxes. Every time you compute taxes, an API call is made, using credits from your IAP credits balance.

자격 증명 설정

To activate AvaTax in Odoo, you need to create an account. To do so, go to Accounting ‣ Configuration ‣ Settings ‣ Taxes, and, in the AvaTax Brazil section, add the email address you want to use to log in to the AvaTax portal, and click on Create account. This email is used as the administrator email address in AvaTax.

Odoo에서 계정을 생성한 후 Avalara 포털로 이동하여 비밀번호를 설정해야 합니다:

  1. Access the Avalara portal

  2. Click on Meu primeiro acesso

  3. Add the email address you used in Odoo to create the Avalara/Avatax account, and then click Solicitar Senha

  4. 토큰과 비밀번호를 생성할 수 있는 링크를 이메일로 받게 됩니다. 이 링크를 클릭한 후 복사한 토큰을 붙여넣어 원하는 비밀번호를 설정합니다.

경고

If you intend first to try the integration on a testing or sandbox database, using an alternate email address is recommended, as you won’t be able to re-use the same email address on your production database.

You can start using AvaTax in Odoo without creating a password and accessing the Avalara Portal; for Odoo, the only requirement to start using the Avalara Tax Computation Engine is to create an account from the settings page.

Avatax 계정 환경 설정.

참고

You can transfer API credentials. Use this only when you have already created an account in another Odoo instance and wish to reuse it.

마스터 데이터 설정하기

계정과목표

The chart of accounts is installed by default as part of the data set included in the localization module. The accounts are mapped automatically in their corresponding taxes, and the default account payable and account receivable fields.

참고

브라질의 계정과목표는 브라질에서 필요한 계정의 기준선을 제공하는 SPED CoA를 기반으로 합니다.

회사의 필요에 따라 계정을 추가하거나 삭제할 수 있습니다.

세무

브라질 현지화를 설치할 때 세금은 자동으로 생성됩니다. 세금은 환경 설정이 이미 완료되어 있으며, 일부는 판매주문서 또는 청구서 관련 세금을 계산할 때 Avalara에서 사용합니다.

세금을 편집하거나, 세금을 더 추가할 수 있습니다. 예를 들어, 서비스가 제공되는 도시에 따라 세율이 다를 수 있으므로 서비스에 사용되는 일부 세금은 직접 추가하고 설정해야 합니다.

중요

서비스에 부과되는 세금은 AvaTax에서 계산되지 않습니다. 재화에 대한 세금만 계산됩니다.

서비스에 부과된 세금이 최종 가격에 포함되도록 설정하는 경우 (품목 가격에 세금을 더하거나 빼지 않는 경우) 세금 계산`을 :guilabel:`세금 포함가 비율`로 설정하고 :guilabel:`고급 옵션 탭에서 가격에 포함 옵션에 표시합니다.

For more information on configuring taxes to fit your needs better, please go to the taxes functional documentation.

세금 환경 설정

경고

Avatax 세금 계산에 사용되므로, 세금을 삭제하지 마세요. 삭제할 경우, Odoo에서 |판매주문서| 또는 청구서에서 사용할 때 세금을 다시 생성하고 AvaTax로 세금을 계산하지만 세금을 등록하는 데 사용되는 계정은 세금의 정의 탭의 청구서용 배포환불용 배포 섹션에서 다시 설정해야 합니다.

품목

판매주문서 및 청구서에 AvaTax 통합을 사용하려면 먼저 품목에 다음 정보를 지정합니다:

  • CEST Code (Code for products subject to ICMS tax substitution)

  • Mercosul NCM Code (Mercosur Common Nomenclature Product Code)

  • Source of Origin (Indicates the 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 SPED list table)

  • Purpose of Use (Specify the 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. They are already configured, if more need to be created, duplicate and use the same configuration (configuration needed: Product Type Service, Transportation Cost Type Insurance, Freight, or Other Costs)

연락처

연동 기능을 사용하기 전에 연락처에 다음 정보를 지정합니다.

  1. 연락처에 대한 일반 정보입니다:

    • 세금 ID (CNPJ)가 연락처에 있는 경우, 회사 옵션을 선택하고, CPF가 있는 연락처인 경우 :guilabel:`개인`을 선택합니다.

    • 이름

    • Address: Zip Code is a required field to compute taxes properly.

    • Tax ID or CPF: Use CPF for individuals and Tax ID (CNPJ) for companies

    • IE: 주 세금 식별 번호

    • IM: municipa tax identification number

    • SUFRAMA 코드: SUFRAMA 등록 번호

    • 전화번호

    • 이메일

    연락처 환경 설정

    참고

    CPF, IE, IMSUFRAMA 코드 필드는 :guilabel:`국가`가 `브라질`로 설정될 때까지 숨겨져 있습니다.

  2. Fiscal information about the contact under the Sales & Purchase tab:

    • Fiscal Position: add the AvaTax fiscal position to automatically compute taxes on sale orders and invoices automatically.

    • 세금 제도: 연방 조세 제도

    • ICMS Taxpayer Type: taxpayer type determines if the contact is within the ICMS regime, if it is exempt, or if it is a non-taxpayer.

    • 주요 활동 분야: 연락처의 주요 활동 분야 목록입니다.

    연락처 재정 환경 설정

재정 위치

To compute taxes on sale orders and invoices, it is necessary to have a Fiscal Position with the Detect Automatically and the Use AvaTax API options enabled.

:guilabel:`재정 위치`는 연락처에서 설정하거나 판매주문서나 청구서를 생성할 때 선택할 수 있습니다.

재정 상태 설정

작업 흐름

This section provides an overview of the actions that trigger API calls for tax computation.

경고

Please note that each API call incurs a cost. Be mindful of the actions that trigger these calls to manage costs effectively.

Tax calculations on quotation / sales orders

Trigger an API call to calculate taxes on a quotation or sales order automatically with AvaTax in any of the following ways:

  • 견적 확인

    견적서를 확인하여 판매주문서로 만듭니다.

  • 수동 트리거

    :guilabel:`Avatax를 사용하여 세금 계산`을 클릭합니다.

  • 미리 보기

    미리 보기 버튼을 클릭합니다.

  • 견적서/판매주문서를 이메일로 보내기

    이메일을 통해 고객에게 견적서나 판매주문서를 보냅니다.

  • 온라인 견적서 접근 권한

    When a customer accesses the quotation online (via the portal view), the API call is triggered.

청구서에 대한 세금 계산

Trigger an API call to calculate taxes on a customer invoice automatically with AvaTax any of the following ways:

  • 수동 트리거

    :guilabel:`AvaTax를 사용하여 세금 계산`을 클릭합니다.

  • 미리 보기

    미리 보기 버튼을 클릭합니다.

  • 온라인 청구서 액세스

    When a customer accesses the invoice online (via the portal view), the API call is triggered.

참고

세금을 자동으로 계산하려면 반드시 :guilabel:`재정 위치`가 `자동 세금 매핑 (Avalara 브라질)`로 설정되어 있어야 이와 같이 작업을 수행할 수 있습니다.