> For the complete documentation index, see [llms.txt](https://fitek-learning.fitek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fitek-learning.fitek.com/fitek-learning-space/french-francais/sales-invoices/creer-et-envoyer-des-factures/ksef.md). # KSeF KSeF ([Krajowy System e-Faktur](https://ksef.mf.gov.pl/)) est la plateforme nationale polonaise de facturation électronique. Il s'agit d'un système central de l'État par lequel toutes les factures structurées échangées entre entreprises polonaises sont envoyées, validées et conservées. Les factures ne sont pas échangées directement entre l'acheteur et le vendeur : tout passe par KSeF, géré par l'administration fiscale polonaise, et chaque facture acceptée reçoit un numéro KSeF unique. Si vous envoyez des factures à des acheteurs polonais, KSeF est le canal à utiliser. *** ### KSeF ou Peppol KSeF sert aux **factures électroniques nationales polonaises**. Si votre acheteur est établi en Pologne et reçoit ses factures via KSeF, utilisez ce canal. Peppol est un réseau **international** de facturation électronique, utilisé en Europe et au-delà. Si votre acheteur reçoit ses factures via Peppol, consultez plutôt la page [Peppol](/fitek-learning-space/french-francais/sales-invoices/creer-et-envoyer-des-factures/peppol.md). *** ### Intégrer la facture dans Fitek Avant de pouvoir être envoyée à KSeF, une facture doit exister dans Fitek. Il existe quatre façons de l'y intégrer. #### Option 1 : créer la facture dans Fitek Vous pouvez créer une facture de vente manuellement dans l'interface de Fitek, puis l'envoyer. #### Option 2 : envoi par e-mail (Pdf2KSeF) Vous envoyez un PDF, Fitek le numérise puis l'envoie en facture électronique. **Ce que vous faites :** 1. Envoyez un e-mail à votre boîte d'envoi dédiée (par exemple `yourcompany@fitekdigi.com`). 2. Joignez la facture PDF à l'e-mail. **Ce qui se passe ensuite :** 1. Fitek reçoit l'e-mail et applique les règles de la boîte (taille maximale des fichiers, formats autorisés, notifications). 2. Le PDF passe par la reconnaissance optique (OCR) et l'extraction des données. 3. Le résultat est converti en données de facture structurées et importé dans Fitek sous forme de facture de vente. 4. Une fois la facture dans Fitek, vous pouvez l'envoyer à KSeF manuellement, ou elle est envoyée automatiquement si l'envoi automatique est activé. #### Option 3 : import via SFTP Si vous préférez les intégrations par dépôt de fichiers, ces dossiers sont pris en charge : * `/sales_input` : pour du XML structuré (format UBL ou facture électronique estonienne) ; * `/sales_digi_input` : pour des fichiers PDF qui passent par l'OCR et sont convertis en données structurées. #### Option 4 : import via l'API Si vous créez vos factures de vente dans votre ERP et souhaitez les transmettre à Fitek, utilisez l'API d'import des factures de vente. **Point de terminaison :** * Production : `https://fitekin.com/DataExchangeWebApiCore/SalesInvoice/ImportSalesInvoice.v3` * Développement : `https://dev.fitekin.com/DataExchangeWebApiCore/SalesInvoice/ImportSalesInvoice.v3` **Méthode :** POST **En-tête :** `Content-Type: application/xml` **Structure du corps** (une facture de vente par requête) : ```xml 00000000-0000-0000-0000-000000000000 00000000-0000-0000-0000-000000000000 ``` *** ### Fonctionnement de l'envoi #### Envoi manuel Lorsque vous cliquez sur **Envoyer la facture électronique** dans l'interface de Fitek, Fitek : 1. effectue une validation préalable : chaque ligne doit comporter une description, une quantité, une unité, un prix, un type de TVA et un % de TVA ; la facture doit contenir au moins une ligne et au moins un groupe de ventilation de TVA ; 2. envoie la facture à KSeF pour transmission ; 3. affiche le statut – **Envoyée** ou **Erreurs de transmission**, avec les erreurs renvoyées en cas de problème. #### Envoi automatique Si le paramètre d'entreprise **Envoyer automatiquement les factures de vente** est activé, Fitek envoie automatiquement les factures qui sont : * non envoyées ; * importées (et non créées manuellement dans l'interface). {% hint style="info" %} Les factures de vente en erreur d'import ou en erreur de transmission ne sont pas envoyées automatiquement. {% endhint %} *** ### Statut de transmission et dépannage #### Ce que vous voyez dans Fitek Lorsque vous envoyez une facture de vente, Fitek affiche l'un des résultats suivants : * **Envoyée :** la facture a été acceptée pour transmission et aucun message d'erreur n'est affiché ; * **Erreurs de transmission :** la facture n'a pas pu être transmise et un message d'erreur est affiché (par exemple, l'acheteur n'a pas été trouvé sur Peppol, ou les données de la facture présentent des erreurs de validation) ; * **Erreurs d'import :** la facture a été importée, mais des données obligatoires sont manquantes ou invalides. Ouvrez la facture, vérifiez les champs signalés et les messages d'erreur, corrigez les données, puis renvoyez-la ; * **Non envoyée :** la facture est enregistrée dans Fitek mais n'a pas encore été envoyée. Ouvrez-la, vérifiez les données et envoyez-la lorsque vous êtes prêt. Pour une vue d'ensemble des statuts de transmission et du dépannage pour KSeF et Peppol, voir [Suivre l'état de transmission et corriger les erreurs](/fitek-learning-space/french-francais/sales-invoices/creer-et-envoyer-des-factures/suivre-letat-de-transmission-et-corriger-les-erreurs.md). #### Où consulter le détail Pour chaque facture, ouvrez le détail de la facture dans Fitek pour : * vérifier si la facture a été envoyée ; * consulter l'éventuel message d'erreur de transmission ; * déterminer si la facture doit être corrigée et renvoyée. *** ### Après l'envoi à KSeF #### Statuts et numéro KSeF * Si KSeF **accepte** la facture, le statut **Envoyée** s'affiche avec une coche, et un numéro KSeF figure sur la facture (visible en ouvrant la facture).
* Si KSeF la **rejette**, le statut **Erreurs de transmission** s'affiche, avec le détail des erreurs. #### Fichiers renvoyés après acceptation Une fois la facture au statut **Envoyée**, Fitek récupère et met à disposition ces fichiers : * **UPO :** la confirmation officielle d'acceptation (uniquement pour les factures de vente) ; * **PDF avec code QR KSeF :** une version imprimable avec la référence KSeF ; * **XML FA(3) :** la facture au format natif de KSeF ; * **UBL :** le document envoyé à l'origine, conservé pour la traçabilité. *** ### Détails techniques : l'API de transmission Voici le format exact de la requête de transmission utilisée par Fitek pour envoyer à KSeF. **Point de terminaison de transmission (ventes) :** `{root_url}/fitekhub/connector/fitek/delivery/sales/v1` **Champs de la requête :** * `referenceNr` (obligatoire) * `invoiceGlobalId` (obligatoire) * `xmlBase64` : contenu XML encodé en base64 (facultatif, mais généralement utilisé) * `supplierParty` et `customerParty` (facultatifs) **Point de terminaison du retour de statut :** `{root_url}/SalesInvoice/UpdateSalesInvoiceStatus.v1` **Champs du retour de statut :** * `deliveryChannel` : KSEF * `externalId` : le numéro KSeF * `deliveryStatus` : PENDING, DELIVERED ou FAILED --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://fitek-learning.fitek.com/fitek-learning-space/french-francais/sales-invoices/creer-et-envoyer-des-factures/ksef.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.