Aller au contenu principal
FA(3) · schéma 1-0E

L'acheteur dans FA(3) : identifiant, JST et GV dans Podmiot2

La section Podmiot2 indique à qui vous facturez. Le schéma FA(3) prévoit quatre façons d'écrire l'identifiant de l'acheteur et deux marqueurs obligatoires, JST et GV, et en production KSeF vérifie en plus la clé de contrôle du NIP. Odoo choisit l'identifiant de son côté et écrit toujours les deux marqueurs de la même façon.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 5 novembre 2026

L'essentiel

Module
KSeF 2.0
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du module, version 20.0 · dans les sources citées à la fin
Lecture
3 min

Quatre façons d'identifier l'acheteur

Élément FA(3)Description dans le schémaQuand l'utiliser
NIP« Identyfikator podatkowy NIP » (identifiant fiscal NIP)Acheteur avec un NIP polonais.
KodUE + NrVatUE« Numer Identyfikacyjny VAT kontrahenta UE » (numéro de TVA de la contrepartie dans l'UE)Acheteur avec un numéro de TVA d'un autre pays de l'UE, dans les cas prévus par la loi sur la TVA.
KodKraju + NrID« Identyfikator podatkowy inny » (autre identifiant fiscal)Autre identifiant fiscal, par exemple hors UE.
BrakID« Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak » (pas d'identifiant fiscal, ou il n'apparaît pas sur la facture)Consommateur ou acheteur sans identifiant.

Le schéma vérifie seulement le format du NIP : 10 chiffres selon le motif TNrNIP. Il ne contrôle pas la clé de contrôle. KSeF la contrôle, mais uniquement en production, pour Podmiot1, Podmiot2, Podmiot3 et PodmiotUpowazniony. Dans l'environnement de test, l'en-tête X-KSeF-Feature: subject-identifier-validation active cette validation. La documentation ne précise pas avec quel code KSeF rejette une clé de contrôle erronée.

Carte de la section Podmiot2 de FA(3)
Les éléments d'identifiant de l'acheteur et les marqueurs JST et GV du schéma 1-0E.

Les marqueurs JST et GV

Les deux sont obligatoires dans Podmiot2 et prennent la valeur 1 ou 2 :

  • JST, « Znacznik jednostki podrzędnej JST. » (marqueur d'unité subordonnée d'une collectivité locale) : 1 si la facture concerne une unité subordonnée d'une collectivité locale ; Podmiot3 doit alors être renseigné avec le rôle 8 et le NIP ou l'identifiant interne de l'unité ;
  • GV, « Znacznik członka grupy VAT. » (marqueur de membre d'un groupe de TVA) : 1 si la facture concerne un membre d'un groupe de TVA ; Podmiot3 avec le rôle 10 ;
  • 2 dans l'un ou l'autre cas signifie que la facture ne les concerne pas.

Ce qu'écrivent Odoo 18, 19 et 20

Odoo choisit l'identifiant à partir du numéro de TVA du client. Un NIP polonais va dans NIP. Odoo n'écrit KodUE et NrVatUE que pour les opérations spéciales, celles portant les étiquettes de taxe OSS_Base, OSS_Tax, Triangular Sale, K_21 ou K_12 ; tout autre numéro étranger va dans KodKraju et NrID. Un client sans numéro de TVA reçoit BrakID 1.

Odoo écrit toujours JST et GV à 2. Une facture destinée à une unité subordonnée d'une collectivité locale, ou à un membre d'un groupe de TVA, ne peut donc pas être marquée depuis Odoo comme l'exige le schéma, et elle n'atteindra pas cette unité via Podmiot3.

Schéma : ce qu'Odoo 20 écrit dans Podmiot2 et ce qu'exigent le schéma et KSeF
Schéma réalisé à partir du modèle FA(3) d'Odoo 20, du schéma FA(3) 1-0E et de la documentation de KSeF ; les éléments barrés sont ceux qu'Odoo n'écrit pas.

Ce qu'il faut vérifier avant l'envoi

  1. Le numéro de TVA du client : un NIP polonais avec ou sans le préfixe PL (sans lui, Odoo prend le pays de la fiche client), avec une clé de contrôle correcte.
  2. Pour un client de l'UE : si la facture doit vraiment porter KodUE et NrVatUE, c'est-à-dire si les lignes ont la bonne taxe.
  3. Pour les clients du secteur public : si la facture doit parvenir à une unité subordonnée ; Odoo ne l'écrit pas.

Notre module vérifie-t-il le NIP de l'acheteur ?

En partie. Lorsque vous utilisez « Mark ready for KSeF upload », Poland KSeF 2.0 Validator calcule la clé de contrôle polonaise du NIP du client et, si elle ne correspond pas, signale « Partner NIP invalid » et laisse la facture en « Manual action required » : elle ne passe pas à « Ready to upload to KSeF ». Il applique cette clé à tout numéro de TVA, y compris étranger, et un numéro étranger la passe presque jamais ; pour un client avec un numéro de TVA d'un autre pays, la facture reste donc bloquée même si le numéro est correct. La validation de FlexigoTech Cloud contrôle le fichier par rapport au schéma, c'est-à-dire le format, sans la clé de contrôle.

À lire aussi

Les dates dans FA(3) : P_1, P_6 et DataWytworzeniaFaRègles de dates du schéma FA(3) 1-0E et de KSeF : P_1 en heure polonaise, P_6, DataWytworzeniaFa dès 2025-09-01. Quand elles donnent 450 et ce que fait Odoo 18-20.Codes 410 et 415 de KSeF : autorisations du vendeur et pièces jointesLe 410 et le 415 de KSeF : ce qui les déclenche dans les tests du ministère et quoi vérifier dans Odoo 18, 19 et 20.Code KSeF 450 : « Błąd weryfikacji semantyki dokumentu faktury »Le code 450 de KSeF rejette une facture FA(3) après contrôle de son contenu. Où se trouve la cause réelle, ce qu'Odoo 18, 19 et 20 n'affichent pas et comment la renvoyer.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources