Frisbii e-invoice génère des factures au format XML CII (Cross Industry Invoice) Extended, le standard retenu par Frisbii parmi les 3 formats du socle de la réforme. Si vous choisissez votre propre Plateforme Agréée, assurez-vous qu'elle accepte bien ce format — et familiarisez-vous avec sa structure pour vos tests. Ce guide couvre les deux méthodes disponibles : la génération manuelle depuis une facture, et la génération en masse via Apex ou Flow.
Prérequis avant de générer
Avant de pouvoir utiliser les fonctionnalités e-invoice, vérifiez les points suivants :
L'extension package Frisbii e-invoice est installée dans votre organisation Salesforce.
Votre version Frisbii app est ≥ 3.247.
Le Permission Set "Frisbii E-Invoicing" est attribué aux utilisateurs concernés (voir ci-dessous).
Votre base de données clients est qualifiée : SIREN, SIRET, adresse électronique de facturation, type de client…
Les listes de sélections Régions/Pays (Territoires) sont activées sur votre organisation Salesforce.
Attribuer le Permission Set Frisbii E-Invoicing
Le permission set Frisbii E-Invoicing contrôle l'accès aux fonctionnalités de facturation électronique. Il doit être attribué à chaque utilisateur qui doit générer ou visualiser des factures électroniques.
Pour l'attribuer :
Allez dans Configuration → Ensembles d'autorisations.
Sélectionnez Frisbii E-Invoicing.
Cliquez sur Gérer les attributions → Ajouter des attributions.
Sélectionnez les utilisateurs concernés et enregistrez.
⚠️ Sans ce permission set, le bouton de génération et les champs e-invoice ne seront pas visibles pour l'utilisateur, même si le package est installé.
Conditions de génération du CII
Pour pouvoir générer une facture XML depuis Frisbii, voici les conditions préalables :
La facture doit être émise
La facture doit comporter au moins une Ligne de Facture
Un SIREN valide doit être présent sur le Compte client et sur la Raison sociale émettrice
Les listes de sélection Régions/pays (Territoires) doivent être activées sur votre organisation Salesforce
Méthode 1 — Génération manuelle depuis une facture (bouton)
C'est la méthode la plus simple, adaptée à une utilisation au cas par cas ou pour vos premiers tests.
Ajouter le bouton E-Invoice XML à votre présentation de page Facture
Le bouton de génération n'est pas ajouté automatiquement à votre page de mise en page lors de l'installation. Il faut l'ajouter manuellement une fois.
Depuis n'importe quelle facture Frisbii, cliquez sur l'icône Configuration (⚙️) dans la barre d'en-tête de la page, puis sélectionnez Modifier la page.
Cliquez sur la barre latérale des boutons d’action et cliquez sur Ajouter une action.
Dans la liste des actions, recherchez et sélectionnez E-Invoice XML.
Cliquez sur Enregistrer, puis assurez-vous que la page est bien activée pour vos profils d'utilisateurs. Sans activation, le bouton ne sera pas visible.
Générer le CII depuis une facture
Une fois le bouton en place :
Ouvrez la facture Frisbii pour laquelle vous souhaitez générer le XML.
Cliquez sur le bouton E-Invoice XML dans le bandeau d'actions.
Le fichier XML CII est généré et attaché automatiquement à la facture dans la section Notes et pièces jointes.
💡 Vous pouvez télécharger le fichier XML depuis les Notes et pièces jointes et l'ouvrir dans un éditeur texte pour vérifier les données. C'est particulièrement utile lors de vos phases de test.
Méthode 2 — Génération en masse via Apex
Pour traiter un volume important de factures en une seule opération, Frisbii e-invoice expose une méthode Apex dédiée.
La méthode Apex
fiix.EInvoicingService.saveXmlsAsFilesFromInvoiceIds(invoicesIds, isPdfToAttach);Arguments
Paramètre | Type | Description |
|---|---|---|
|
| Liste des identifiants Salesforce des factures à traiter |
|
| Si |
Ce que la méthode fait
Pour chaque facture de la liste, la méthode :
Génère le fichier XML CII correspondant.
L'enregistre en tant que ContentDocument (Fichier Salesforce).
Lie le fichier à l'enregistrement de facture dans sa liste Notes et pièces jointes.
Notes importantes sur le traitement
⚠️ Traitement asynchrone (batch) au-delà de 25 factures. Si la liste d'entrée contient plus de 25 factures, le traitement bascule automatiquement en mode asynchrone par batch. La limite est fixée par la plateforme Salesforce en contexte batch avec QueryLocator.
⚠️ Traitement batch dès 8 factures en cas de mappages custom. Si vous avez défini des mappages personnalisés dans la page EInvoicing Mappings, le batch s'active dès 8 factures ou plus en entrée.
⚠️ En cas d’erreur, le lot de factures n’est bloquée. Seule la facture en erreur est isolée et passe son enregistrement de dépôts au statut “Failed” mais les autres factures continuent d’être générées.
Exemple d'appel depuis la console développeur
List<Id> ids = new List<Id>{
'a0XXXXXXXXXXXXXXX',
'a0YYYYYYYYYYYYYYY'
};
fiix.EInvoicingService.saveXmlsAsFilesFromInvoiceIds(ids, true);Méthode 3 — Génération en masse via Flow (méthode Invocable)
L'équivalent de la méthode Apex est disponible pour les Flow Salesforce, sans nécessiter de code.
Dans votre Flow, ajoutez un élément de type Action et recherchez l'action :
Generate e-invoicing XMLs from Invoice records to FilesLes paramètres sont identiques à la méthode Apex : la liste des enregistrements de factures et le booléen pour l'attachement du PDF.
Depuis ce flow, vous allez pouvoir définir vos conditions d’entrée, comme par exemples :
le e-invoicing ne concerne que les factures BtoB entre assujetti France, de ce fait, seules les factures dont le pays de facturation est égal à France doivent être générées (il s’agit d’un exemple, vous pouvez choisir un autre critère, comme la présence d’un SIREN/SIRET sur le Compte…)
ne pas inclure le e-reporting, si une facture a le champs E-reporting Category Code, alors il ne faut pas générer de XML pour cette facture
ne pas inclure les Factures de type Avoir interne. La Réforme précise qu’en cas de refus ou rejet de la facture électronique, un Avoir interne devra être émis mais non déposé sur la PA, il s’agit uniquement d’une pièce comptable interne.
💡 Cette méthode est idéale pour automatiser la génération des CII à chaque changement de statut d'une facture (ex : déclenchement automatique lorsqu'une facture passe à l'état "Finalisée" ou "Émise").
Tester votre facture électronique
Avant de raccorder votre PA ou en attendant le déploiement de l'interconnexion avec Ecosio, vous pouvez valider vos fichiers CII générés directement depuis un outil en ligne.
Vérifier vos factures électroniques sur le validateur en ligne Ecosio
Le validateur Ecosio permet de valider un fichier XML CII, sans avoir besoin d'une PA.
Comment tester :
Générez un CII depuis une facture de test dans votre sandbox Frisbii (méthode manuelle via le bouton).
Téléchargez le fichier XML depuis les Notes et pièces jointes de la facture.
Rendez-vous sur https://ecosio.com/fr/validateur-documents-xml-factures-electroniques-peppol/
Choisissez le format suivant : “France Extended CTC CII 1.4”
Importez ou glisser-déposez votre fichier XML.
La validateur en ligne Ecosio analyse le fichier et indique les erreurs ou avertissements de conformité.
💡 C'est l'outil à utiliser pendant votre phase de recette, avant de brancher votre PA. Chaque erreur signalée par le validateur Ecosio correspond à un champ manquant ou mal renseigné dans votre facture ou votre base de données Salesforce. Vous pouvez nous signaler les erreurs rencontrées via l’ouverture d’un ticket support Frisbii.