Numer KSeF — UUID juridiquement contraignant

Le numer KSeF est l'identifiant unique de chaque facture validée par KSeF — un UUID de 36 caractères attribué par l'État polonais après visa réussi. Cet identifiant remplace juridiquement la séquence interne de l'émetteur et devient la référence légale pour comptabilité, audits, contentieux.

Format et structure du numer KSeF

Le numer KSeF suit un format structuré, lisible humainement, qui encode plusieurs informations métier :

text numer-ksef-format.txt

Format : NIP-DATA-IDENT-CHK

5260250274-20260519-7C8A3D4E5F0A1B2C-AA
└─────┬────┘ └───┬──┘ └───────┬──────┘ └┬┘
      │         │            │         │
      │         │            │         └── Checksum 2 chars (Luhn-like polonais)
      │         │            └── Identifiant unique 16 chars hex (UUIDv4 tronqué)
      │         └── Date de visa YYYYMMDD
      └── NIP émetteur (10 chiffres sans tiret)

NIP émetteur (10 chiffres). Identifiant fiscal du contribuable émetteur. Permet l'unicité multipartite : deux émetteurs différents peuvent générer la même séquence interne, leurs numéros KSeF restent uniques.
Date de visa (YYYYMMDD). Date à laquelle KSeF a effectivement attribué le numéro, en fuseau Europe/Warsaw. À distinguer de la Fa/P_1 (date d'émission métier).
Identifiant unique (16 caractères hex). UUIDv4 tronqué, garantit l'unicité à l'intérieur d'une journée pour un NIP donné. 16 caractères hex = 2⁶⁴ possibilités, suffisant pour 18 milliards de transactions / jour / NIP — largement au-dessus du réel.
Checksum (2 caractères). Algorithme Luhn-like adapté aux caractères ASCII, permet de détecter une corruption de saisie en lecture humaine. Vérifié par KSeF en input sur certains endpoints.

Attribution post-clearance

Le moment d'attribution est précis et juridiquement défini : l'instant où KSeF positionne le statut Zaakceptowana (acceptée) après tous les contrôles XSD, Schematron et métier.

T = soumission. ERP émet POST /api/online/Invoice/Send. Aucun numer KSeF n'est encore attribué. Le statut renvoyé est W trakcie przetwarzania (en cours).
T + 0,5-2 s = visa. KSeF complète les validations. Si OK, attribution du numer KSeF dans la base d'État, positionnement du statut Zaakceptowana, génération de l'UPO.
T + 1-10 s = mise à disposition. Le numéro est consultable par GET /api/online/Invoice/Status/{referenceNumber}. La facture est simultanément accessible au destinataire via le service de réception.

UPO — Urzędowe Poświadczenie Odbioru

L'UPO est l'attestation officielle XML signée par le ministère, délivrée après chaque attribution de numer KSeF. Elle constitue la preuve juridique primaire de l'émission, conservée par KSeF mais également téléchargeable par l'émetteur et le destinataire.

xml upo-example.xml

<?xml version="1.0" encoding="UTF-8"?>
<UPO xmlns="http://ksef.mf.gov.pl/upo/2023/12/01/">
  <Naglowek>
    <Wersja>1.0</Wersja>
    <DataWystawienia>2026-05-19T08:42:17.482Z</DataWystawienia>
  </Naglowek>

  <Faktura>
    <NumerKSeF>5260250274-20260519-7C8A3D4E5F0A1B2C-AA</NumerKSeF>
    <DataPrzeslania>2026-05-19T08:42:11Z</DataPrzeslania>
    <DataPrzyjecia>2026-05-19T08:42:17Z</DataPrzyjecia>
    <SHA>9c1185a5c5e9fc54612808977ee8f548b2258d31</SHA>
    <SystemFakturujacy>ERP X v12.4</SystemFakturujacy>
  </Faktura>

  <PodmiotWystawiajacy>
    <NIP>5260250274</NIP>
    <NazwaPelna>Spółka Sprzedaży Sp. z o.o.</NazwaPelna>
  </PodmiotWystawiajacy>

  <PodmiotOdbierajacy>
    <NIP>7010023492</NIP>
    <NazwaPelna>Klient Sp. z o.o.</NazwaPelna>
  </PodmiotOdbierajacy>

  <Signature>
    <SignedInfo>...</SignedInfo>
    <SignatureValue>aBcDeFgHiJkLmNoPqRsTuVwXyZ123456...=</SignatureValue>
  </Signature>
</UPO>

Caractéristiques techniques de l'UPO :

Signature XAdES-T. Signature XML électronique avec horodatage qualifié e-IDAS.
Certificat ministère. Émis par CenCert (autorité de certification de l'État polonais).
SHA-256 inclus. Reprend le hash de la facture FA(2) soumise — preuve d'intégrité.
Conservation 10 ans. KSeF conserve l'UPO 10 ans (ordynacja podatkowa art. 86).
Téléchargement. Via GET /api/online/Invoice/Get/{numerKSeF}.

Propagation aux registres comptables

Le numer KSeF n'est pas un identifiant temporaire — il doit être propagé dans tous les systèmes comptables et fiscaux internes du contribuable :

Comptabilité générale. Le numer KSeF devient la référence du document fournisseur / client dans le grand livre, en remplacement (ou complément) du numéro interne.
JPK_V7M. Dans le champ NrKontrahenta ou NumerWlasny selon convention de l'éditeur. Recommandation KAS : préfixer par KSeF: pour distinguer.
Comptes fournisseurs / clients. Le rapprochement bancaire et les rappels de paiement doivent citer le numer KSeF, qui sert d'identifiant universel.
Factures correctives. Toute corrective doit obligatoirement pointer le numer KSeF de la facture initiale dans FaKor/NumerKSeFFaKor.
Reporting interne et financier. ERP, BI, analytics — partout où la facture est référencée, le numer KSeF doit pouvoir être pivotal.

Cas particuliers — correctives et tryb awaryjny

Deux scénarios méritent une attention particulière pour le numer KSeF :

Factures correctives. Chaque corrective reçoit son propre numer KSeF distinct de la facture initiale, mais doit la référencer explicitement via FaKor/NumerKSeFFaKor. KSeF maintient une chaîne de modifications pour audit. Si la facture initiale n'a pas de numer KSeF (cas FA hors KSeF avant 2026), la corrective utilise alors un schéma transitoire.
Tryb awaryjny (mode dégradé). En cas d'indisponibilité KSeF, l'émetteur peut générer un numéro provisoire local et émettre la facture en PDF avec ce numéro. Dès rétablissement, il doit re-soumettre la facture à KSeF dans les 7 jours ; KSeF attribue alors le vrai numer KSeF qui doit être communiqué au destinataire et substitué dans toute la comptabilité.

Pièges courants

Confondre numer KSeF et numéro interne. Le numéro FV/2026/05/0142 est la séquence émetteur (utile pour ses besoins internes). Le numer KSeF est l'identifiant légal. Les deux coexistent dans la facture, mais juridiquement seul le numer KSeF compte.
Stockage de l'UPO oublié. Si KSeF est indisponible plus tard, ou si l'émetteur a besoin de prouver l'émission sans accès KSeF (audit, contentieux), il faut avoir conservé l'UPO localement. La conservation chez KSeF n'exonère pas le contribuable de sa propre preuve.
Citer le mauvais numéro dans les correspondances client. Une fois la facture clearance attribuée, c'est le numer KSeF qui doit figurer dans les ordres de paiement, rappels, relances. Le numéro interne peut prêter à confusion pour des destinataires multi-fournisseurs.
Régénérer le numer KSeF. Le numer KSeF est définitif et immuable. Si la facture initiale est erronée, on émet une corrective (qui reçoit son propre nouveau numer KSeF), on n'écrase jamais le premier.

Fondamentaux

Standards

Messages phares

Outils