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:

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

   

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

   

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

   

4. Laden Sie schließlich ein Unternehmenslogo hoch und speichern Sie den Kontakt.

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.

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:

• Sandbox: https://portal.sandbox.avalarabrasil.com.br/

• Produktion: https://portal.avalarabrasil.com.br/

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.

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.

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.

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.

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.

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.

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)

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

   

   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

   

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

   

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.

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.

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.

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

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.

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.

Rechnungsstornierung¶

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

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.

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.

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 cancelled, and enter an invalidation Reason.

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.