Bien démarrer avec FactoorSharp

Avec FactoorSharp, vous créez, lisez et validez des factures électroniques (ZUGFeRD, XRechnung, EN16931) en quelques minutes.

Ce guide vous accompagne pas à pas jusqu'à votre première facture fonctionnelle.

À l'issue de ce guide de démarrage rapide, vous saurez :

• créer une facture en C#
• l'exporter au format XML EN16931 / ZUGFeRD
• l'intégrer, en option, dans un PDF/A‑3
• valider le résultat

Installation

Installez FactoorSharp via NuGet :

Ou via le Gestionnaire de package :

La bibliothèque prend en charge : .NET 6+, .NET Framework 4.6, .NET Framework 4.8 (selon la plateforme cible)

Obtenir une licence

TODO : inscription et récupération

Créer votre première facture

Dans l'exemple suivant, vous créez une facture minimale conforme EN16931.
Commençons par les données d'en-tête de la facture avec l'identification du vendeur et de l'acheteur. Cela inclut également les informations de livraison :

Ajoutons ensuite une position :

Et le bloc des totaux, avec les conditions de paiement :

Export au format XML (EN16931 / XRechnung / ZUGFeRD)

Une fois votre facture construite, vous pouvez l'exporter au format XML :

Les profils habituellement utilisés pour ZUGFeRD sont :

Comfort/ EN16931

Norme pour l'UE

Extended

Le profil le plus détaillé et le plus utilisé en Allemagne

Valider une facture

Pour vous assurer que toutes les informations nécessaires sont présentes, vous pouvez valider votre facture avec l'outil de validation de l'espace client sur factoorsharp.de.
Cela permet aux destinataires de la facture de la traiter sans difficulté.

Créer un PDF/A‑3 avec facture intégrée (ZUGFeRD)

Si vous disposez déjà d'un fichier PDF, par exemple issu d'un générateur de rapports ou de votre ERP, vous pouvez intégrer directement les informations ZUGFeRD dans ce PDF :

Résultat : un PDF lisible visuellement au format PDF/A‑3, contenant également le fichier XML lisible par machine intégré au document PDF.

Lire des factures existantes

FactoorSharp peut également analyser des factures existantes, que vous lisiez un fichier XML :

ou que vous deviez extraire le fichier XML d'un fichier PDF :

Migration depuis ZUGFeRD-csharp

FactoorSharp est le successeur de ZUGFeRD-csharp.

Si vous travaillez déjà avec :

• L'API a volontairement été conservée similaire
• Votre logique existante peut généralement être reprise telle quelle
• Remplacez InvoiceDescriptor par FacturXInvoice, et InvoicePdfProcessor par FacturXInvoicePdfProcessor. C'est tout.
• Nouveautés : meilleure validation, nouvelles fonctionnalités