Türkei¶
Module¶
Die folgenden Module werden automatisch mit der türkischen Lokalisierung installiert:
Name |
Technische Bezeichnung |
Beschreibung |
|---|---|---|
Türkei - Buchhaltung |
|
Türkisches Basis-Fiskalpaket komplett mit türkischem Kontenplan, Steuern, Finanzberichten und Steuerpositionen |
Türkei - Buchhaltungsberichte |
|
Türkei-spezifische Steuer- und Gewinn- und Verlustberichterstattung. |
Türkiye - e-Irsaliye (e-Dispatch) |
|
Ermöglicht die Erstellung und den Upload von e-Dispatch-Dateien. |
Zusätzlich müssen die folgenden Module manuell installiert werden, um das Nilvera-Integration für die Verwaltung elektronischer Dokumente zu verwenden:
Name |
Technische Bezeichnung |
Beschreibung |
|---|---|---|
Türkiye - Nilvera |
|
Integrationsmodul zur Kommunikation mit Nilvera und zur Erstellung von e-Ledger-Dateien |
Türkiye - Nilvera E-Invoice |
|
Zum Senden und Empfangen elektronischer Rechnungen im Basisszenario an/von Nilvera. |
Türkiye - Nilvera E-Invoice Extended |
|
Erweitert das E-Invoice-Modul und ermöglicht die Unterstützung mehrerer Rechnungstypen und -szenarien. |
Bemerkung
In einigen Fällen, z. B. beim Upgrade auf eine Version mit zusätzlichen Modulen, ist es möglich, dass Module nicht automatisch installiert werden. Fehlende Module können manuell installiert werden.
Lokalisierungsübersicht¶
Das türkische Lokalisierungspaket gewährleistet die Einhaltung der türkischen Steuer- und Buchhaltungsvorschriften. Es umfasst Werkzeuge zur Verwaltung von Steuern, Steuerpositionen, Berichten und einen vorkonfigurierten Kontenplan, der auf die Standards der Türkiye zugeschnitten ist.
Das türkische Lokalisierungspaket bietet die folgenden Hauptfunktionen zur Einhaltung der lokalen Steuer- und Buchhaltungsvorschriften:
Kontenplan: eine vordefinierte Struktur, die auf türkische Buchhaltungsstandards zugeschnitten ist
Steuern: vorkonfigurierte Steuersätze, einschließlich Standardmehrwertsteuer, Nullsatz und befreite Optionen
Steuerpositionen (Steuer- und Kontenzuordnung): automatisierte Steueranpassungen basierend auf dem Registrierungsstatus von Kunden oder Lieferanten.
Elektronische Dokumentenlösungen: Integration mit Nilvera zur Erfüllung der Vorschriften für elektronische Dokumente
Kontenplan¶
Im Kontenplan werden Konten automatisch den entsprechenden Steuern und den Standardfeldern für Verbindlichkeiten und Forderungen zugeordnet.
Bemerkung
Der türkische Kontenplan basiert auf den 7/A-Konten der türkischen Steuerverwaltung (Gelir İdaresi Başkanlığı (GİB)), die eine Grundlage der erforderlichen Konten bieten. 7/B-Konten sind archiviert und können bei Bedarf dearchiviert werden.
Steuern¶
Steuern werden automatisch erstellt und konfiguriert, wenn die türkische Lokalisierung installiert wird.
Warnung
Löschen Sie keine Steuern, da sie für E-Rechnungen und E-Archiv-Rechnungen verwendet werden. Es können jedoch neue Steuern erstellt werden, z. B. für Quellensteuergründe, die in der Datenbank noch nicht vorhanden sind.
Elektronische Dokumentenlösungen¶
Die türkische Lokalisierung stellt die Einhaltung der Anforderungen des GİB für E-Rechnungs-, E-Archiv-, E-Versand- und E-Ledger-Prozesse sicher.
Durch die Nilvera-Integration ermöglicht Odoo die automatisierte Übermittlung, den Empfang und die Verwaltung von E-Dokumenten gemäß den elektronischen Dokumentenstandards des GİB. Die Hauptfunktionen der Nilvera-Integration umfassen:
Erstellen und Validieren von E-Archiven und E-Rechnungen direkt aus Odoo
Speichern übermittelter XML- und PDF-Versionen für Prüfzwecke
Erstellen und Hochladen von E-Versand-XML zu und von Nilvera
Unternehmen und Kontakte¶
Stellen Sie vor der Aktivierung der türkischen Lokalisierung sicher, dass die folgenden Informationen im Kontaktdatensatz Ihres Unternehmens korrekt konfiguriert sind:
Wichtig
Um auf alle diese Felder zuzugreifen, gehen Sie zum Kontaktdatensatz des Unternehmens in der Kontakte-Anwendung oder über , entfernen Sie den Filter Kundenrechnungen und wählen Sie den Kontaktdatensatz des Unternehmens aus. Dies unterscheidet sich vom Zugriff auf den Unternehmensdatensatz selbst über die allgemeinen Einstellungen.
Unternehmensname: muss mit der GİB-Registrierung übereinstimmen.
Türkisches Finanzamt: registriertes Finanzamt
Steuer-ID: VKN/TCKN - 10 Ziffern für Unternehmen, 11 für Einzelpersonen
Adresse: vollständige rechtliche Adresse
Land: registriertes Land
Tags: Geben Sie die Mersis-Nummer als Tag ein und setzen Sie die Kategorie auf MERSISNO.
E-Rechnungsformat: Türkei (UBL TR 1.2)
Alias: von Nilvera erworbener Alias
Bemerkung
Das eInvoice format wird automatisch basierend auf dem Land des Kontakts festgelegt. Um dieses Feld zu bearbeiten, aktivieren Sie den Entwicklermodus, um das Feld anzuzeigen, und passen Sie es dann manuell an.
Das Feld Alias ist erst sichtbar, sobald der Nilvera Status des Unternehmens auf E-Invoice gesetzt ist.
Für jeden Kunden und Lieferanten:
Stellen Sie sicher, dass Address, City, State, Country, Tax ID und eInvoice format konfiguriert sind.
Wenn der Partner nicht für die elektronische Rechnungsstellung registriert ist, verwendet Odoo automatisch e-Archive.
Steueranlage¶
Ausnahmegründe anlegen¶
Um zusätzliche Ausnahmegründe anzulegen, gehen Sie wie folgt vor:
Aktivieren Sie den Entwicklermodus und navigieren Sie zu .
Klicken Sie auf die Schaltfläche New.
Geben Sie einen Reason und einen Reason Code ein, die mit den Werten in der Nilvera-Dokumentation übereinstimmen.
Wählen Sie den entsprechenden Code-Typ aus:
Withholding für Quellensteuergründe
Exception für steuerbefreite Gründe
Export exception für Exportausnahmegründe
Export registration für exportregistrierte Gründe
Geben Sie bei Withholding-Gründen den entsprechenden Prozentsatz ein.
Quellensteuern anlegen¶
Navigieren Sie zu .
Klicken Sie auf die Schaltfläche New, um zunächst die Basissteuer anzulegen.
Setzen Sie die Steuerberechnung auf Prozentsatz und legen Sie das Feld Grund für Quellensteuer fest, das für Steuern dieses Typs erscheint.
Vervollständigen Sie die anderen Pflichtfelder des Formulars (Steuername, Steuerart, Betrag usw.).
Erstellen Sie zusätzliche Steuern mit Steuerberechnung, die auf Steuergruppe gesetzt ist. Diese Steuergruppen sollten aus der in den vorherigen Schritten erstellten Basissteuer und zusätzlichen prozentualen Steuern bestehen.
Tipp
Die Steuer WH 20% veranschaulicht diese Konfiguration. Um einen anderen Quellensteuergrund zu verwenden, duplizieren Sie die Basissteuer, aktualisieren Sie den Grund und ersetzen Sie die alte Basissteuer in den duplizierten Steuergruppen.
Nilvera-Integration¶
Odoo ist in Nilvera integriert, einen von GİB zugelassenen elektronischen Dokumentenvermittler, um E-Rechnung-, E-Archiv-, E-Versand- und E-Hauptbuch-Prozesse zu verwalten.
Die Integration verarbeitet:
XML-Datengenerierung in einem GİB-konformen Format
sichere Übertragung an Nilvera
Synchronisierung von Dokumenten und Status innerhalb von Odoo.
Unterstützte Dokumenttypen¶
E-Rechnung
Basisszenario und öffentliches Szenario
Verkauf
Einbehaltung
Für Export registriert
Steuerbefreit
Exportszenario
E-Archivrechnung
Verkauf
Einbehaltung
Für Export registriert
Steuerbefreit
E-Versandschein
Konfiguration¶
Die Nilvera-Dokumentation enthält Anleitungen für den Zugriff auf die Sandbox und die Generierung der API-Anmeldedaten.
Um die Nilvera-Integration mit Ihrer Datenbank zu konfigurieren, führen Sie folgende Schritte aus:
Stellen Sie sicher, dass das Modul Türkiye - Nilvera installiert ist.
Navigieren Sie zu und scrollen Sie zum Abschnitt Türkiye Electronic Integrations.
Konfigurieren Sie:
Nilvera API credentials (in Nilvera generiert)
Incoming Invoices Journal (z. B. Purchases)
Um Ihre Kundenkontaktdatensätze so zu konfigurieren, dass Sie ihnen E-Rechnungen über Nilvera senden können, folgen Sie diesen Schritten:
Navigieren Sie zu .
Entfernen Sie den Filter Customer Invoices (falls erforderlich) und wählen Sie den Partner aus, der über Nilvera kontaktiert werden soll.
Öffnen Sie den Tab Buchhaltung und klicken Sie auf Verify neben Nilvera Status.
E-Rechnungen über Nilvera senden¶
E-Invoice/e-Archive ist ein staatlich genehmigtes digitales Rechnungssystem, das traditionelle Papierrechnungen ersetzt und es Unternehmen ermöglicht, Rechnungen elektronisch auszustellen, zu übermitteln und zu speichern, in Übereinstimmung mit den türkischen Steuervorschriften. Während E-Invoices für Kunden bestimmt sind, die beim GİB registriert sind, können E-Archives an Kunden gesendet werden, die nicht beim GİB registriert sind. Dies stellt sicher, dass Absender die staatlichen Vorschriften einhalten können, auch wenn sie mit ausländischen Kunden oder B2C-Workflows zu tun haben.
Um eine E-Invoice/E-Archive zu senden, folgen Sie diesen Schritten:
Stellen Sie sicher, dass die Module Türkiye - Nilvera E-Invoice und Türkiye - Nilvera E-Invoice Extended installiert sind.
Wenn Sie eine Kundenrechnung erstellen, nachdem Sie einen Kunden ausgewählt haben,
falls der Nilvera Status des Kunden e-Archive ist, erscheinen zwei Felder:
Is GIB Export: wird für Produktexportrechnungen an Partner außerhalb der Türkei verwendet
Invoice Type: bestimmt den Typ der Rechnung
falls der Nilvera Status des Kunden e-Invoice ist, erscheint das Feld Invoice Scenario: Wählen Sie das Szenario der Rechnung aus, die an den GİB gesendet werden soll.
Senden Sie die Rechnung und stellen Sie sicher, dass by Nilvera ausgewählt ist, um eine E-Rechnung auszustellen.
E-Rechnungen über Nilvera empfangen¶
Nilvera-Status aktualisieren¶
Um den Nilvera-Status von Rechnungen in Odoo zu aktualisieren, folgen Sie diesen Schritten:
Öffnen Sie das Buchhaltungs-Dashboard.
Klicken Sie auf das Journal Verkauf.
Klicken Sie auf das Symbol (Aktionen) und dann auf E-Rechnungs-Status aktualisieren. Diese Aktion aktualisiert das Feld Nilvera-Status für jede Rechnung.
E-Rechnungs-PDFs abrufen¶
Es gibt zwei Methoden, um PDFs von E-Rechnungen abzurufen:
Aus der Rechnungslistenansicht:
Gehen Sie zu .
Wählen Sie eine oder mehrere Rechnungen aus.
Klicken Sie auf Nilvera-PDF abrufen
Aus einer Rechnungsformularansicht: Sobald der Nilvera-Status auf Erfolgreich steht, klicken Sie auf die Schaltfläche Nilvera-PDF abrufen.
Einkaufs-E-Rechnungen empfangen¶
Um in Nilvera erstellte und von Ihrem Unternehmen empfangene E-Rechnungen abzurufen:
Öffnen Sie das Buchhaltungs-Dashboard.
Klicken Sie auf das Journal Einkauf.
Klicken Sie auf das Symbol (Aktionen) und dann auf E-Rechnungen abrufen. Die empfangenen E-Rechnungen werden als Lieferantenrechnungen im Status Entwurf erstellt.
PDFs von in Odoo erstellten Rechnungen abrufen¶
Für Lieferantenrechnungen, die in Odoo erstellt wurden, funktioniert der PDF-Abruf genauso wie bei Kundenrechnungen:
Gehen Sie zu .
Wählen Sie eine oder mehrere Lieferantenrechnungen aus.
Klicken Sie auf die Schaltfläche Nilvera-PDF abrufen.
e-Hauptbuch generieren¶
Das e-Hauptbuch ist ein elektronisches System, das es Unternehmen ermöglicht, ihre Buchhaltungsunterlagen digital zu speichern und zur Steuer- und Regulierungskonformität an die Regierung zu übermitteln. In Odoo können Benutzer das e-Hauptbuch als gezippte CSV-Datei generieren und Unternehmensdaten nahtlos über die Nilvera-Integration melden.
Navigieren Sie zu .
Klicken Sie auf das Symbol (Aktionen).
Klicken Sie auf e-Hauptbuch generieren, um die Datei zu generieren und auf Ihren Computer herunterzuladen.
e-Dispatch-Dateien verwalten¶
e-Dispatch-Dateien generieren¶
Der e-Dispatch ist ein elektronisches Dokument, das traditionelle Papierlieferscheine ersetzt und es Unternehmen ermöglicht, Versanddetails für Waren im Transit digital auszustellen, zu übermitteln und zu verfolgen. In Odoo können Benutzer e-Dispatch-Dokumente als XML generieren und über die Nilvera-Integration hochladen, um konforme und nachvollziehbare Liefervorgänge sicherzustellen.
Navigieren Sie zu .
Öffnen Sie einen vorhandenen Lieferauftrag oder erstellen Sie einen neuen.
Sobald eine Lieferadresse ausgewählt ist, füllen Sie die erforderlichen Informationen im angezeigten Tab e-Dispatch aus.
Sobald der Lieferauftrag bestätigt ist, klicken Sie auf die angezeigte Schaltfläche GİB e-Dispatch (XML) generieren, um die XML-Datei zu generieren.
Laden Sie die generierte Datei herunter, die dem Lieferauftrag angehängt ist, und laden Sie sie zur Verarbeitung zu Nilvera hoch.
e-Dispatch-Dateien hochladen¶
Laden Sie die empfangene e-Dispatch-XML von Nilvera herunter.
Navigieren Sie zu .
Klicken Sie auf die Schaltfläche e-Empfang (XML) hochladen und wählen Sie die heruntergeladene Datei aus.
Verpflichtende Compliance-Informationen¶
Die folgenden Regeln sind für alle Benutzer der Türkei-Lokalisierungsintegration verpflichtend. Die Einhaltung dieser Anforderungen ist für die rechtliche Gültigkeit von e-Dokumenten, die über GİB via Nilvera ausgestellt werden, unerlässlich.
Dokumentnummerierungsstruktur¶
Alle erstellten Rechnungen und Versanddokumente müssen einer bestimmten Nummerierungsstruktur folgen:
drei alphanumerische Zeichen+Dokumentjahr+fortlaufende Nummer.Example
INV/2025/00001
Die Nummerierung muss eindeutig, fortlaufend und lückenlos sein. Jedes Dokument muss eine eindeutige Kennung haben.
Sobald eine Datei eingereicht wurde, kann dieselbe Sequenznummer nicht mehr verwendet werden, auch wenn ein Fehler zurückgegeben wird. Es muss ein neues Dokument erstellt werden.
Lücken in der fortlaufenden Nummerierung¶
Wenn eine Sequenznummer übersprungen wird, müssen die fehlenden Nummern innerhalb von 7 Tagen ausgestellt werden.
Example
Wenn INV/2025/00002 vor INV/2025/00001 ausgestellt wird, muss INV/2025/00001 innerhalb von 7 Tagen ausgestellt werden.
Keine Sequenznummer darf über diesen Zeitraum hinaus unausgestellt bleiben.
Rabattregeln¶
Globale Rabatte (Rabatte, die als separate Rechnungszeile angezeigt werden) können nicht ausgestellt werden.
Alle Rabatte müssen auf Produktzeilenebene innerhalb der Rechnung angewendet werden.
e-Ledger-Konformität¶
Die erste ausgestellte Rechnung muss den Eröffnungssaldo für die Abrechnungsperiode darstellen.
Alle nachfolgenden Rechnungen müssen dem fortlaufenden Nummerierungsmuster folgen:
Example
INV/2025/00001, INV/2025/00002, INV/2025/00003, usw.
Die fortlaufende Nummerierung muss im gesamten e-Ledger konsistent eingehalten werden, um Datenintegrität und Compliance sicherzustellen.