Brasilien

Einführung

Mit der brasilianischen Lokalisierung können Sie mit AvaTax (Avalara) über API-Aufrufe automatisch Umsatzsteuern berechnen und eletronische Rechnungen für Waren (NF-e) und für Dienstleistungen versenden. Außerdem können Steuern für Dienstleistungen konfiguriert werden.

Für die Umsatzsteuerberechnung und elektronische Rechnungsstellung für Waren und Dienstleistungen müssen Sie die Felder Kontakte, Unternehmen, Produkte und Ein Konto in Avatax erstellen, was in den allgemeinen Einstellungen von Odoo konfiguriert werden kann.

Die Steuern für Dienstleistungen können Sie direkt in Odoo erstellen und konfigurieren, ohne sie mit AvaTax zu berechnen.

Die Lokalisierung umfasst auch Steuern und eine Vorlage für den Kontenplan, die bei Bedarf geändert werden kann.

Konfiguration

Modulinstallation

Installieren Sie die folgenden Module, um alle Funktionen der brasilianischen Lokalisierung zu erhalten:

Name

Technische Bezeichnung

Beschreibung

Brasilien - Buchhaltung

l10n_br

Standardmäßige steuerliche Lokalisierungspaket, das den allgemeinen brasilianischen Kontenplan und Steuern sowie Belegarten und Identifikationsbelegarten enthält.

Brasilien - Buchhaltungsberichte

l10n_br_reports

Buchhaltungsberichte für Brasilien.

AvaTax Brasilien & AvaTax Brasilien für Dienstleistungen

l10n_br_avatax & l10n_br_avatax_services

Berechnung der Umsatzsteuer durch Avalara.

EDI für brasilianische Buchhaltung & EDI für brasilianische Buchhaltung für Dienstleistungen

l10n_br_edi & l10n_br_edi_services

Stellt elektronische Rechnungsstellung für Waren und Dienstleistungen in Brasilien über AvaTax zur Verfügung.

Pix-QR-Codes für Brasilien

l10n_br_pix

Implementiert Pix-QR-Codes für Brasilien.

Ihr Unternehmen konfigurieren

Um Ihre Unternehmensinformationen zu konfigurieren, gehen Sie zur App Kontakte und suchen Sie den Namen Ihres Unternehmens.

  1. Wählen Sie die Option Unternehmen oben auf der Seite. Konfigurieren Sie dann die folgenden Felder:

    • Name

    • Adresse (Stadt, Bundesland, PLZ, Land hinzufügen)

      • Geben Sie im Feld Straße den Straßennamen, die Hausnummer und zusätzliche Adressdaten an.

      • Geben Sie im Feld Straße2 die Nachbarschaft ein.

    • Identifikationsnummer: CNPJ oder CPF

    • Steuer-ID: mit der Identifikationsart verbunden

    • IE: Bundesstaatenregistrierung

    • IM: Bundesdistriktregistrierung

    • SUFRAMA-Code: (Superintendence of the Manaus Free Trade Zone - hinzufügen, wenn anwendbar)

    • Telefon

    • E-Mail

    Unternehmenskonfiguration.
  2. Konfigurieren Sie das Feld Steuerinformation im Reiter Verkauf & Einkauf:

    • Fügen Sie die Steuerposition für AvaTax Brasilien hinzu.

    • Steuerregelung: (Föderale Steuerregelung)

    • ICMS-Steuerzahlertyp: gibt die ICMS-Regelung, den Befreiungsstatus oder Nicht-Steuerzahler an

    • Hauptaktivitätssektor

    Steuerkonfiguration des Unternehmens.
  3. Konfigurieren Sie den folgenden zusätzlichen Steuerinformationen, wenn Sie NFS-e ausgeben möchten:

    • Fügen Sie die Steuerposition für AvaTax Brasilien hinzu.

    • COFINS-Details: Steuerpflichtig, Nicht Steuerpflichtig, Steuerpflichtig mit Steuersatz 0 %, Steuerbefreiung, Ausgesetzt

    • PIS-Details: Steuerpflichtig, Nicht Steuerpflichtig, Steuerpflichtig mit Steuersatz 0 %, Steuerbefreiung, Ausgesetzt

    • CSLL Steuerpflichtig Wenn das Unternehmen der CSLL unterliegt oder nicht

    Steuerkonfiguration des Unternehmens für NFSe.
  4. Laden Sie schließlich ein Unternehmenslogo hoch und speichern Sie den Kontakt.

Bemerkung

Wenn Sie eine vereinfachte Regelung haben, müssen Sie den ICMS-Satz unter Buchhaltung ‣ Konfiguration ‣ Einstellungen ‣ Steuern ‣ AvaTax Brasilien konfigurieren.

Avatax-Integration konfigurieren

Avalara AvaTax ist ein Anbieter von Steuerberechnungen und elektronischer Rechnungsstellung, der in Odoo integriert werden kann, um automatisch die Steuern zu berechnen, indem er die Informationen über das Unternehmen, den Kontakt (Kunden), das Produkt und die Transaktion berücksichtigt, um die korrekte Steuer zu ermitteln, die verwendet werden soll, und und die elektronische Rechnung anschließend mit der Regierung zu verarbeiten.

Die Verwendung dieser Integration erfordert In-App-Käufe (IAP) zur Berechnung der Steuern und zum Versenden von elektronischen Rechnungen. Jedes Mal, wenn Sie Steuern berechnen, einen elektronischen Beleg erstellen (NF-e, NFS-e usw.) oder einen elektronischen Arbeitsablauf durchführen (NF-e-Stornierung, Berichtigungsbrief, devalieren von Rechnungsnummerbereicht) erfolgt ein API-Aufruf, bei dem Guthaben aus Ihrem IAP-Guthaben verwendet wird.

Bemerkung

Konfiguration von Anmeldedaten

Um AvaTax in Odoo zu aktivieren, müssen Sie ein Konto erstellen. Gehen Sie dazu zu Buchhaltung ‣ Konfiguration ‣ Einstellungen ‣ Steuern, und fügen Sie im Abschnitt AvaTax Brasilien die E-Mail-Adresse der Administration im AvaTax-Portal-E-Mail hinzu, mit der Sie sich beim AvaTax-Portal anmelden möchten, und klicken Sie auf Konto erstellen.

Warnung

Beim Testen oder Erstellen einer Produktion der AvaTax-Portal-E-Mail-Integration in einer Sandbox oder Produktionsdatenbank verwenden Sie eine echte E-Mail-Adresse, da diese für die Anmeldung beim Avalara-Portal und die Einrichtung der Zertifikate benötigt wird, unabhängig davon, ob Sie diese testen oder in der Produktion verwenden möchten.

Es gibt zwei verschiedene Avalara-Portale, eines zum Testen und eines für die Produktion:

Wenn Sie das Konto in Odoo erstellen, müssen Sie die richtige Umgebung auswählen. Außerdem kann die zur Eröffnung des Kontos verwendete E-Mail nicht zur Eröffnung eines anderen Kontos verwendet werden. Speichern Sie Ihre API-ID und den API-Schlüssel, wenn Sie das Konto von Odoo aus erstellen.

API-Anmededaten einer Überweisung.

Nachdem Sie das Konto in Odoo erstellt haben, müssen Sie zum Avalara-Portal gehen, um Ihr Passwort einzurichten:

  1. Rufen Sie das Avalara-Portal auf.

  2. Klicken Sie auf Meu primeiro acesso.

  3. Fügen Sie die E-Mail-Adresse hinzu, die Sie in Odoo zur Erstellung des Avalara/AvaTax-Kontos verwendet haben, und klicken Sie dann auf Solicitar Senha

  4. Sie erhalten eine E-Mail mit einem Token und einem Link zur Erstellung Ihres Passworts. Klicken Sie auf diesen Link und fügen Sie den Token ein, um Ihr gewünschtes Passwort zu vergeben.

Tipp

Sie können AvaTax zur Steuerberechnung in Odoo verwenden, nur ohne ein Passwort zu erstellen und auf das Avalara-Portal in der Odoo-Datenbank zuzugreifen. Um den elektronischen Rechnungsservice nutzen zu können, müssen Sie jedoch auf das AvaTax-Portal zugreifen und Ihr Zertifikat dort hochladen.

Konfiguration des Avatax-Kontos.

Bemerkung

Sie können API-Anmeldedaten übertragen. Verwenden Sie dies nur, wenn Sie bereits ein Konto in einer anderen Odoo-Instanz erstellt haben und es wiederverwenden möchten.

A1-Zertifikatsupload

Um elektronische Rechnungen ausstellen zu können, muss ein Zertifikat im AvaTax-Portal hochgeladen werden.

Das Zertifikat wird mit Odoo synchronisiert, solange die externe Identifikationsnummer im AvaTax–Portal – ohne Sonderzeichen – mit der CNPJ-Nummer übereinstimmt und die Identifikationsnummer (CNPJ) in Odoo mit der CNPJ in AvaTax übereinstimmt.

Wichtig

Um NFS-e auszustellen, verlangen einige Städte, dass Sie das Zertifikat im Stadtportalsystem verknüpfen, bevor Sie NFS-e aus Odoo heraus ausstellen.

Wenn Sie von der Stadt die Fehlermeldung Ihr Zertifikat ist nicht mit dem Benutzer verknüpft erhalten, bedeutet dies, dass dieser Vorgang im Stadtportal durchgeführt werden muss.

Stammdaten konfigurieren

Kontenplan

Der Kontenplan wird standardmäßig als Teil des im Lokalisierungsmodul enthaltenen Datensatzes installiert. Die Konten werden automatisch in ihren entsprechenden Steuern und den Standardfeldern für Verbindlichkeiten und Forderungen abgebildet.

Bemerkung

Der Kontenplan für Brasilien basiert auf dem SPED-Kontenplan, der eine Grundlage für die in Brasilien benötigten Konten bietet.

Sie können je nach den Bedürfnissen des Unternehmens Konten hinzufügen oder löschen.

Journale

In Brasilien ist eine Seriennummer mit einem Sequenznummernbereich für elektronische Rechnungen verknüpft. Die Seriennummer kann in Odoo für ein Verkaufsjournal über das Feld Series konfiguriert werden. Wenn Sie mehr als eine Serie benötigen, müssen Sie ein neues Verkaufsjournal erstellen und ihm für jede benötigte Serie eine neue Seriennummer zuweisen.

The Use Documents field needs to be selected. When issuing electronic and non-electronic invoices, the Type field selects the document type used when creating the invoice. The Type field will only be displayed if the Use Documents field is selected on the journal.

Journal configuration with the Use Documents? field checked.

Bemerkung

When creating the journal, ensure the field Dedicated Credit Note Sequence is unchecked, as in Brazil, sequences between invoices, credit notes, and debit notes are shared per series number, which means per journal.

Steuern

Steuern werden bei der Installation der brasilianischen Lokalisierung automatisch erstellt. Die Steuern sind bereits konfiguriert, und einige von ihnen werden von Avalara bei der Berechnung der Steuern auf dem Verkaufsauftrag oder der Rechnung verwendet.

Steuern können bearbeitet werden, oder es können weitere Steuern hinzugefügt werden. Zum Beispiel müssen einige Steuern für Dienstleistungen manuell hinzugefügt und konfiguriert werden, da der Satz je nach Stadt, in der Sie die Dienstleistung anbieten, unterschiedlich sein kann.

Wichtig

If you decide to do service taxes manually, you won’t be able to issue an NFS-e. To electronically send an NFS-e, you need to compute taxes using Avalara.

Warnung

Löschen Sie keine Steuern, da sie für die AvaTax-Steuerberechnung verwendet werden. Wenn sie gelöscht werden, legt Odoo sie wieder an, wenn sie in einer Rechnung verwendet werden und die Steuern mit AvaTax berechnet werden, aber das Konto, das zur Registrierung der Steuer verwendet wird, muss im Reiter Definition der Steuer unter den Abschnitten Verteilung für Rechnungen und Verteilung für Erstattungen neu konfiguriert werden

Produkte

Um die AvaTax-Integration für Verkaufsaufträge und Rechnungen zu nutzen, geben Sie zunächst die folgenden Informationen zum Produkt je nach vorgesehner Verwendung an:

Elektronische Rechnung für Waren (NF-e)
  • CEST-Code (Code für Produkte, die der ICMS-Steuerverwendung unterliegen)

  • Mercosul NCM-Code: (Mercosur-Produktcode mit Gemeinsamer Nomenklatur)

  • Herkunftsquelle: (Gibt den Ursprung des Produkts an, der je nach Anwendungsfall ausländisch oder inländisch sein kann, neben anderen möglichen Optionen)

  • Steuerlicher SPED-Produkttyp: (Steuerlicher Produkttyp entsprechend der SPED-Tabelle)

  • Verwendungszweck: (Geben Sie den beabsichtigten Verwendungszweck dieses Produkts an)

Produktkonfiguration.

Bemerkung

Odoo erstellt automatisch drei Produkte, die für Transportkosten im Zusammenhang mit Verkäufen verwendet werden. Diese heißen Fracht, Versicherung und Andere Kosten. Sie sind bereits konfiguriert. Wenn weitere Produkte erstellt werden sollen, duplizieren Sie diese und verwenden Sie dieselbe Konfiguration (erforderliche Konfiguration: Produkttyp Dienstleistung, Transportkostentyp Versicherung, Fracht oder Sonstige Kosten).

Elektronische Rechnung für Dienstleistungen (NFS-e)
  • Mercosul NCM-Code: (Mercosur-Produktcode mit Gemeinsamer Nomenklatur)

  • Verwendungszweck: (Geben Sie den beabsichtigten Verwendungszweck dieses Produkts an)

  • Service Code Origin: City Service Code where the provider is registered

  • Service Codes: City Service Code where the service will be provided, if no code is added, the Origin City Code will be used

  • Labor Assignment: Defines if your services includes labor

Kontakte

Bevor Sie die Integration nutzen, geben Sie die folgenden Informationen zum Kontakt an:

  1. Allgemeine Informationen über den Kontakt:

    • Wählen Sie die Option Unternehmen für einen Kontakt mit einer Steuernummer (CNPJ), oder markieren Sie Einzelperson für einen Kontakt mit einem CPF.

    • Name

    • Adresse (Stadt, Bundesland, PLZ, Land hinzufügen)

      • Geben Sie im Feld Straße die Straße, die Hausnummer und zusätzliche Adressdaten an.

      • Geben Sie im Feld Straße2 die Nachbarschaft ein.

    • Identifikationsnummer: CNPJ oder CPF

    • Steuer-ID: mit der Identifikationsart verbunden

    • IE: Steueridentifikationsnummer des Bundesstaates

    • IM: Steueridentifikationsnummer des Bundesdistrikt

    • SUFRAMA-Code: SUFRAMA-Registernummer

    • Telefon

    • E-Mail

    Kontaktkonfiguration.

    Bemerkung

    Die Felder CPF, IE, IM, und SUFRAMA-Code werden ausgeblendet, bis das Land auf Brasilien eingestellt ist.

  2. Steuerinformationen über den Kontakt im Reiter Verkauf & Einkauf:

    • Steuerposition: Fügen Sie die Steuerposition von AvaTax hinzu, um die Steuern auf Verkaufsaufträge und Rechnungen automatisch zu berechnen.

    • Steuerregelung: Föderale Steuerregelung

    • ICMS-Steuerzahlertyp: Die Art des Steuerzahlers bestimmt, ob der Kontakt unter die ICMS-Regelung fällt, ob er befreit ist oder ob es sich um einen Nicht-Steuerzahler handelt.

    • Haupttätigkeitsbereich: Liste der Haupttätigkeitsbereiche des Ansprechpartners

    Steuerkonfiguration des Kontakts.
  3. Konfigurieren Sie den folgenden zusätzlichen Steuerinformationen, wenn Sie NFS-e ausgeben möchten:

    • Fügen Sie die Steuerposition für AvaTax Brasilien hinzu.

    • COFINS-Details: Steuerpflichtig, Nicht Steuerpflichtig, Steuerpflichtig mit Steuersatz 0 %, Steuerbefreiung, Ausgesetzt

    • PIS-Details: Steuerpflichtig, Nicht Steuerpflichtig, Steuerpflichtig mit Steuersatz 0 %, Steuerbefreiung, Ausgesetzt

    • CSLL Steuerpflichtig: Wenn das Unternehmen der CSLL unterliegt oder nicht

    Steuerkonfiguration des Kontakts für NFSe.

Steuerpositionen

Um Steuern zu berechnen und elektronische Rechnungen auf Verkaufsaufträge zu versenden, muss eine Steuerposition mit den Optionen Automatisch erkennen und AvaTax-API verwenden aktiviert sein.

Die Steuerposition kann im Kontakt konfiguriert oder beim Erstellen eines Verkaufsauftrags oder einer Rechnung ausgewählt werden.

Konfiguration der Steuerposition

Arbeitsabläufe

Dieser Abschnitt gibt einen Überblick über die Aktionen, die API-Aufrufe für die Steuerberechnung auslösen, zusammen mit einer Anleitung, wie Sie elektronische Rechnungen für Waren (NF-e) und Dienstleistungen (NFS-e) zur Überprüfung durch die Regierung versenden können.

Warnung

Bitte beachten Sie, dass jeder API-Aufruf mit Kosten verbunden ist. Achten Sie auf die Aktionen, die diese Aufrufe auslösen, um die Kosten effektiv zu verwalten.

Steuerberechnung

Steuerberechnung auf Angeboten und Verkaufsaufträgen

Lösen Sie einen API-Aufruf aus, um Steuern auf ein Angebot oder einen Verkaufsauftrag automatisch mit AvaTax auf eine der folgenden Arten zu berechnen:

  • Angebotsbestätigung

    Bestätigen Sie ein Angebot, damit es zu einem Verkaufsauftrag wird.

  • Manueller Auslöser

    Klicken Sie auf Steuern mit Avatax berechnen.

  • Vorschau

    Klicken Sie auf die Schaltfläche Vorschau.

  • Ein Angebot/Verkaufsauftrag per E-Mail versenden

    Versenden Sie ein Angebot oder Verkaufsauftrag per E-Mail an einen Kunden.

  • Online-Angebotszugriff

    Wenn ein Kunde online auf das Angebot zugreift (über die Portalansicht), wird der API-Aufruf ausgelöst.

Steuerberechnung auf Rechnungen

Lösen Sie einen API-Aufruf aus, um Steuern auf einer Kundenrechnung automatisch mit AvaTax auf eine der folgenden Arten zu berechnen:

  • Manueller Auslöser

    Klicken Sie auf Steuern mit Avatax berechnen.

  • Vorschau

    Klicken Sie auf die Schaltfläche Vorschau.

  • Online-Rechnungszugriff

    Wenn ein Kunde online auf die Rechnung zugreift (über die Portalansicht), wird der API-Aufruf ausgelöst.

Bemerkung

Die Steuerposition muss auf Automatische Steuerzuordnung (Avalara Brasilien) gesetzt werden, damit eine dieser Aktionen die Steuern automatisch berechnet.

Elektronische Dokumente

Kundenrechnungen

To process an electronic invoice for goods (NF-e) or services (NFS-e), the invoice needs to be confirmed and taxes need to be computed by Avalara. Once that step is done, click on the Send & Print button in the upper left corner. In the pop-up that appears, click on Process e-invoice and any of the other options - Download or Email. Finally, click on Send & Print to process the invoice with the government.

Before sending the electronic invoice for goods (NF-e) or services (NFS-e), some fields need to be filled out on the invoice:

  • Kunde, mit allen Kundendaten.

  • Zahlungsmethode: Brasilien: Wählen Sie, wie die Rechnung bezahlt werden soll.

  • Steuerposition, eingestellt auf Automatische Steuerzuordnung (Avalara Brasilien)

  • Document Type set as (55) Electronic Invoice (NF-e) or (SE) Electronic Service Invoice (NFS-e)

There are some other optional fields that depend on the nature of the transaction. These fields are not required, so no errors will appear from the government if these optional fields are not populated for most cases:

  • Freight Model determines how the goods are planned to be transported - domestic

  • Transporter Brazil determines who is doing the transportation

Invoice information needed to process an electronic invoice. Process electronic invoice pop-up in Odoo.

Bemerkung

All of the fields available on the invoice used to issue an electronic invoice are also available on the sales order, if needed. When creating the first invoice, the field Document Number is displayed, allocated as the first number to be used sequentially for subsequent invoices.

Gutschriften

If a sales return needs to be registered, then a credit note can be created in Odoo to be sent to the government for validation.

Bemerkung

Credit notes are only available for electronic invoices for goods (NF-e).

Lastschriften

If additional information needs to be included, or values need to be corrected that were not accurately provided in the original invoice, a debit note can be issued.

Bemerkung

Debit notes are only available for electronic invoices for goods (NF-e).

Only the products included in the original invoice can be part of the debit note. While changes can be made to the product’s unit price or quantity, products cannot be added to the debit note. The purpose of this document is only to declare the amount that you want to add to the original invoice for the same or fewer products.

Rechnungsstornierung

Es ist möglich, eine elektronische Rechnung zu erstellen, die von der Regierung erstellt wurde.

Bemerkung

Prüfeb Sie, ob die elektronische Rechnung immer noch in der Stornierungsfrist liegt, die entsprechend der Gesetzgebung jedes Staates variieren kann.

Elektronische Rechnungen für Waren (NF-e)

Stornieren Sie eine elektronische Rechnung für Waren (NF-e) in Odoo, indem Sie auf Storno anfordern klicken und einen Stornierungsgrund Grund in das erscheinende Pop-up-Fenster eingeben. Wenn Sie diesen Stornogrund per E-Mail an den Kunden senden möchten, aktivieren Sie das Kontrollkästchen E-Mail.

Grund für Rechnungsstornierung in Odoo

Bemerkung

Dies ist eine elektronische Stornierung, d. h. Odoo sendet eine Anfrage an die Regierung, um die NF-e zu stornieren, und verbraucht dann ein IAP-Guthaben, da ein API-Aufruf erfolgt.

Elektronische Rechnungen für Dienstleistungen (NFS-e)

Cancel an e-invoice for services (NFS-e) in Odoo by clicking Request Cancel. In this case, there is no electronic cancellation process, as not every city has this service available. The user needs to manually cancel this NFS-e on the city portal. Once that step is completed, they can request the cancellation in Odoo, which will cancel the invoice.

Correction letter

A correction letter can be created and linked to an electronic invoice for goods (NF-e) that was validated by the government.

This can be done in Odoo by clicking Correction Letter and adding a correction Reason on the pop-up that appears. To send this correction reason to a customer via email, activate the E-mail checkbox.

Correction letter reason in Odoo.

Bemerkung

Correction letters are only available for electronic invoices for goods (NF-e).

Invalidate invoice number range

A range of sequences that are assigned to sales journals can be invalidated with the government if they are not currently used, and will not be used in the future. To do so, navigate to the journal, and click the ⚙️ (gear) icon ‣ Invalidate Number Range (BR). On the Invalidate Number Range (BR) wizard, add the Initial Number and End Number of the range that should be canceled, and enter an invalidation Reason.

Number range invalidation selection in Odoo. Number range invalidation wizard in Odoo.

Bemerkung

Invalidate invoice number range documents are only available for electronic invoices for goods (NF-e).

Bemerkung

The log of the canceled numbers along with the XML file are recorded in the chatter of the journal.

Lieferantenrechnungen

On the vendor bills side, when receiving an invoice from a supplier, you can encode the bill in Odoo by adding all the commercial information together with the same Brazilian specific information that is recorded on the customer invoices.

Diese Felder spezifisch für Brasilen sind:

  • Zahlungsmethode: Brasilien: Wählen Sie, wie die Rechnung bezahlt werden soll.

  • Dokumenttyp: vom Lieferanten verwendet

  • Dokumentnummer: die Rechnungsnummer von Ihrem Lieferanten

  • Frachtmodell: NF-e-spezifisch, wie Waren transportiert werden sollen – national

  • Transporter Brazil: NF-e specific who is doing the transportation.