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

Pour utiliser FactoorSharp, vous avez besoin d'une clé de licence. Inscrivez-vous gratuitement – vous recevez immédiatement après une licence d'essai de 30 jours avec toutes les fonctionnalités, sans indiquer de moyen de paiement.

Vous retrouverez ensuite votre clé de licence dans l' espace client, sous « Ma licence ». Renseignez-la une seule fois au démarrage de votre application, comme dans l'exemple ci-dessous – d'autres méthodes (variable d'environnement, appsettings.json) y sont également proposées.

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