Turquie

Modules

Les modules suivants sont installés automatiquement avec la localisation turque :

Nom

Nom technique

Description

Turquie - Comptabilité

l10n_tr

Package de localisation fiscale de base pour la Turquie, complet avec le plan comptable turc, les taxes, les rapports financiers et les positions fiscales

Turquie - Rapports comptables

l10n_tr_reports

Rapports fiscaux et de profits et pertes spécifiques à la Turquie.

Turquie - e-Irsaliye (e-Dispatch)

l10n_tr_nilvera_edispatch

Permet la génération et le téléversement de fichiers e-Dispatch

De plus, les modules suivants doivent être installés manuellement afin d’utiliser Intégration Nilvera pour gérer les documents électroniques :

Nom

Nom technique

Description

Turquie - Nilvera

l10n_tr_nilvera

Module d’intégration permettant la communication avec Nilvera et la génération de fichiers e-Ledger

Turquie - Nilvera E-Invoice

l10n_tr_nilvera_einvoice

Pour envoyer et recevoir des factures électroniques de scénario de base vers/depuis Nilvera.

Turquie - Nilvera E-Invoice Extended

l10n_tr_nilvera_einvoice_extended

Améliore le module de facturation électronique, permettant la prise en charge de plusieurs types et scénarios de factures

Note

Dans certains cas, comme lors de la mise à niveau vers une version avec des modules supplémentaires, il est possible que les modules ne soient pas installés automatiquement. Tout module manquant peut être installé manuellement.

Vue d’ensemble de la localisation

Le package de localisation turque garantit la conformité avec les réglementations fiscales et comptables turques. Il comprend des outils pour gérer les taxes, les positions fiscales, les rapports et un plan comptable prédéfini adapté aux normes de la Türkiye.

Le package de localisation turque fournit les fonctionnalités clés suivantes pour garantir la conformité avec les réglementations fiscales et comptables locales :

Plan comptable

Dans le plan comptable, les comptes sont automatiquement mappés à leurs taxes correspondantes et aux champs par défaut des comptes fournisseurs et des comptes clients.

Note

Le plan comptable de Türkiye est basé sur les comptes 7/A de l’Administration fiscale turque (Gelir İdaresi Başkanlığı (GİB)), qui fournissent une base des comptes nécessaires. Les comptes 7/B sont archivés et peuvent être désarchivés si nécessaire.

Taxes

Les taxes sont automatiquement créées et configurées lors de l’installation de la localisation turque.

Avertissement

Ne supprimez pas les taxes, car elles sont utilisées pour les factures électroniques et les factures d’archives électroniques. Cependant, de nouvelles taxes peuvent être générées, par exemple pour les motifs de retenue à la source qui n’existent pas encore dans la base de données.

Solutions de documents électroniques

La localisation turque garantit la conformité avec les exigences du GİB pour les processus de facturation électronique, d’archivage électronique, d’expédition électronique et de grand livre électronique.

Grâce à l’intégration Nilvera, Odoo permet la transmission, la réception et la gestion automatisées des documents électroniques conformément aux normes de documents électroniques du GİB. Les principales fonctionnalités de l’intégration Nilvera incluent :

Société et contacts

Avant d’activer la localisation Türkiye, assurez-vous que les informations suivantes sont correctement configurées dans la fiche contact de votre entreprise :

Important

Pour accéder à tous ces champs, allez à la fiche de contact de l’entreprise dans l’application Contacts ou en allant à Comptabilité ‣ Clients ‣ Clients, supprimez le filtre Factures clients, et sélectionnez la fiche de contact de l’entreprise. Ceci est différent de l’accès à la fiche de l’entreprise elle-même via les paramètres généraux.

  • Nom de l’entreprise : doit correspondre à l’enregistrement GİB

  • Bureau des impôts turc : bureau des impôts d’enregistrement

  • N° de TVA : VKN/TCKN - 10 chiffres pour les entreprises, 11 pour les particuliers

  • Adresse : adresse légale complète

  • Pays : pays d’enregistrement

  • Étiquettes : saisissez le numéro Mersis comme étiquette et définissez la Catégorie sur MERSISNO.

  • Format e-facture : Türkiye (UBL TR 1.2)

  • Alias : alias obtenu auprès de Nilvera

Note

  • Le Format e-facture est défini automatiquement en fonction du pays du contact. Pour modifier ce champ, activez le mode développeur pour afficher le champ, puis ajustez-le manuellement.

  • Le champ Alias n’est visible qu’une fois que le Statut Nilvera de l’entreprise est E-facture.

Pour chaque client et fournisseur :

  • Vérifiez que l”Adresse, la Ville, la Province, le Pays, le N° de TVA, et le Format e-facture sont configurés.

  • Si le partenaire n’est pas enregistré pour la facturation électronique, Odoo bascule automatiquement vers e-Archive.

Création de taxes

Créer des motifs d’exception

Pour créer des motifs d’exception supplémentaires, suivez ces étapes :

  1. Activez le mode développeur et allez à Comptabilité ‣ Configuration ‣ Codes GIB.

  2. Cliquez sur le bouton Nouveau.

  3. Saisissez un Motif et un Code de motif qui correspondent aux valeurs dans la documentation de Nilvera.

  4. Sélectionner le type de code correspondant :

    • Retenue pour les raisons de retenue à la source

    • Exception pour les raisons d’exonération fiscale

    • Exception d’exportation pour les raisons d’exception d’exportation

    • Enregistrement d’exportation pour les raisons d’enregistrement d’exportation

  5. Pour les raisons de Retenue, saisir le pourcentage correspondant.

Créer des retenues à la source

  1. Aller à Comptabilité ‣ Configuration ‣ Taxes.

  2. Cliquer sur le bouton Nouveau pour créer d’abord la taxe de base.

  3. Définir le Calcul de la taxe sur Pourcentage, et définir le champ Motif de retenue à la source qui apparaît pour les taxes de ce type.

  4. Compléter les autres champs obligatoires du formulaire (Nom de la taxe, Type de taxe, Montant, etc.).

  5. Créer des taxes supplémentaires avec le Calcul de la taxe défini sur Groupe de taxes. Ces taxes de groupe doivent être composées de la taxe de base créée dans les étapes précédentes et de taxes de pourcentage supplémentaires.

Astuce

La taxe WH 20% illustre cette configuration. Pour utiliser un motif de retenue différent, dupliquer la taxe de base, mettre à jour le motif et remplacer l’ancienne taxe de base dans les taxes de groupe dupliquées.

Intégration Nilvera

Odoo s’intègre avec Nilvera, un intermédiaire de documents électroniques agréé par GİB, pour gérer les processus de facture électronique, d’archive électronique, d’envoi électronique et de grand livre électronique.

L’intégration gère :

  • la génération de données XML dans un format conforme à GİB

  • la transmission sécurisée vers Nilvera

  • la synchronisation des documents et des statuts dans Odoo.

Types de documents pris en charge

  • Facture électronique

    • Scénario de base et scénario public

      • Ventes

      • Retenue

      • Enregistré pour l’exportation

      • Exonéré de taxe

    • Scénario d’exportation

  • Facture e-Archive

    • Ventes

    • Retenue

    • Enregistré pour l’exportation

    • Exonéré de taxe

  • Bon de livraison électronique

Configuration

La documentation Nilvera fournit des instructions pour accéder au bac à sable et générer les identifiants API.

Pour configurer l’intégration Nilvera avec votre base de données, suivez ces étapes :

  1. Vérifier que le module Türkiye - Nilvera est installé.

  2. Aller à Comptabilité ‣ Configuration ‣ Paramètres et faire défiler jusqu’à la section Intégrations électroniques Türkiye.

  3. Configurer :

    • Identifiants API Nilvera (générés dans Nilvera)

    • Journal des factures entrantes (par ex. Achats)

Pour configurer les fiches de contact de vos clients afin de pouvoir leur envoyer des factures électroniques via Nilvera, suivez ces étapes :

  1. Aller à Comptabilité ‣ Clients ‣ Clients.

  2. Retirer le filtre Factures client (si nécessaire) et sélectionner le contact à joindre via Nilvera.

  3. Ouvrir l’onglet Comptabilité et cliquer sur Vérifier à côté de Statut Nilvera.

Envoyer des factures électroniques via Nilvera

La facture électronique/e-Archive est un système de facturation numérique approuvé par le gouvernement qui remplace les factures papier traditionnelles, permettant aux entreprises d’émettre, de transmettre et de stocker des factures électroniquement en conformité avec la réglementation fiscale turque. Alors que les factures électroniques sont destinées aux clients enregistrés auprès du GİB, les e-Archives peuvent être envoyées aux clients non enregistrés auprès du GİB, garantissant que les expéditeurs peuvent se conformer aux réglementations gouvernementales même lorsqu’ils traitent avec des clients étrangers ou des flux B2C.

Pour envoyer une facture électronique/archive électronique, suivre ces étapes :

  1. S’assurer que les modules Turquie - Nilvera Facture électronique et Turquie - Nilvera Facture électronique étendue sont installés.

  2. Lors de la création d’une facture client, après avoir sélectionné un Client,

    • si le Statut Nilvera du client est Archive électronique, deux champs apparaissent :

      • Exportation GIB : utilisé pour les factures d’exportation de produits vers des partenaires hors de Turquie

      • Type de facture : détermine le type de facture

    • si le Statut Nilvera du client est Facture électronique, le champ Scénario de facturation apparaît : sélectionner le scénario de la facture à envoyer au GİB.

  3. Envoyer la facture et s’assurer que par Nilvera est sélectionné pour émettre une facture électronique.

Recevoir des factures électroniques via Nilvera

Actualiser le statut Nilvera

Pour actualiser le Statut Nilvera des factures dans Odoo, suivre ces étapes :

  1. Ouvrir le Tableau de bord Comptabilité.

  2. Cliquer sur le journal Ventes.

  3. Cliquer sur l’icône (Actions), puis cliquer sur Actualiser le statut des factures électroniques. Cette action met à jour le champ Statut Nilvera de chaque facture.

Récupérer les PDF des factures électroniques

Il existe deux méthodes pour récupérer les PDF des factures électroniques :

  1. Depuis la vue liste des factures :

    1. Aller à Comptabilité ‣ Clients ‣ Factures.

    2. Sélectionner une ou plusieurs factures.

    3. Cliquer sur Récupérer le PDF Nilvera

  2. Depuis le formulaire de facture : une fois que le Statut Nilvera indique Réussi, cliquer sur le bouton Récupérer le PDF Nilvera.

Recevoir les factures électroniques d’achat

Pour récupérer les factures électroniques générées dans Nilvera et reçues par votre entreprise :

  1. Ouvrir le Tableau de bord Comptabilité.

  2. Cliquer sur le journal Achats.

  3. Cliquer sur l’icône (Actions), puis cliquer sur Récupérer les factures électroniques. Les factures électroniques reçues sont créées en tant que factures fournisseurs avec le statut Brouillon.

Récupérer les PDF des factures générées dans Odoo

Pour les factures fournisseurs créées dans Odoo, la récupération des PDF fonctionne de la même manière que pour les factures clients :

  1. Aller dans Comptabilité ‣ Fournisseurs ‣ Factures.

  2. Sélectionner une ou plusieurs factures fournisseurs.

  3. Cliquer sur le bouton Récupérer le PDF Nilvera.

Générer le grand livre électronique

Le grand livre électronique est un système électronique qui permet aux entreprises de stocker et de soumettre numériquement leurs registres comptables au gouvernement à des fins de conformité fiscale et réglementaire. Dans Odoo, les utilisateurs peuvent générer le grand livre électronique sous forme de fichier CSV compressé et transmettre les enregistrements de l’entreprise de manière transparente via l’intégration Nilvera.

  1. Aller dans Comptabilité ‣ Reporting ‣ Grand livre général.

  2. Cliquer sur l’icône (Actions).

  3. Cliquer sur Générer le grand livre électronique pour générer le fichier et le télécharger sur votre ordinateur.

Gérer les fichiers e-Dispatch

Générer les fichiers e-Dispatch

Le e-Dispatch est un document électronique qui remplace les bons de livraison papier traditionnels, permettant aux entreprises d’émettre, de transmettre et de suivre numériquement les détails d’expédition des marchandises en transit. Dans Odoo, les utilisateurs peuvent générer des documents e-Dispatch au format XML et les télécharger via l’intégration Nilvera, garantissant ainsi des opérations de livraison conformes et traçables.

  1. Aller dans Inventaire ‣ Opérations ‣ Livraisons.

  2. Ouvrir un bon de livraison existant ou en créer un nouveau.

  3. Une fois qu’une Adresse de livraison est sélectionnée, remplir les informations nécessaires dans l’onglet e-Dispatch qui apparaît.

  4. #. Once the delivery order is validated, click the Generate GİB e-Dispatch (XML) button that appears to generate the XML file.

  5. Télécharger le fichier généré joint au bon de livraison et le transférer vers Nilvera pour traitement.

Transférer des fichiers e-Dispatch

  1. Télécharger le XML e-Dispatch reçu depuis Nilvera.

  2. Accéder à Inventaire ‣ Opérations ‣ Réceptions.

  3. Cliquer sur le bouton Transférer e-Receipt (XML) et sélectionner le fichier téléchargé.

Informations de conformité obligatoires

Les règles suivantes sont obligatoires pour tous les utilisateurs de l’intégration de localisation turque. Le respect de ces exigences est essentiel pour la validité légale des e-Documents émis via le GİB par l’intermédiaire de Nilvera.

Structure de numérotation des documents

  • Toutes les factures et bons de livraison générés doivent suivre une structure de numérotation spécifique : trois caractères alphanumériques + année du document + numéro séquentiel.

    Example

    INV/2025/00001

  • La numérotation doit être unique, séquentielle et continue. Chaque document doit avoir un identifiant distinct.

  • Une fois qu’un fichier a été soumis, même s’il retourne une erreur, le même numéro de séquence ne peut pas être utilisé ; un nouveau document doit être créé.

Écarts de numéros séquentiels

  • Si un numéro de séquence est omis, les numéros manquants précédents doivent être émis dans un délai de 7 jours.

    Example

    Si INV/2025/00002 est émis avant INV/2025/00001, INV/2025/00001 doit être émis dans un délai de 7 jours.

  • Aucun numéro de séquence ne peut rester non émis au-delà de cette période.

Règles de remise

  • Les remises globales (remises affichées comme une ligne de facture séparée) ne peuvent pas être émises.

  • Toutes les remises doivent être appliquées au niveau de la ligne de produit dans la facture.

Conformité e-Ledger

  • La première facture émise doit représenter le solde d’ouverture pour la période comptable.

  • Toutes les factures suivantes doivent suivre le schéma de numérotation séquentielle :

    Example

    INV/2025/00001, INV/2025/00002, INV/2025/00003, etc.

  • La numérotation séquentielle doit être maintenue de manière cohérente dans l’e-Ledger pour garantir l’intégrité des données et la conformité.