Installer et mettre à jour la version Frisbii e-invoice

Prev Next

Les mises à jour de l’extension package Frisbii e-invoice sont disponibles en autonomie, sans passer par l'équipe Frisbii. Il vous suffit de suivre ce guide et de disposer des droits nécessaires dans Salesforce.

Version actuelle

Version actuelle : 0.34

Les liens ci-dessous pointent toujours vers la dernière version disponible du package.

Prérequis

Avant de lancer l'installation ou la mise à jour, vérifiez que vous réunissez bien les conditions suivantes.

1. Être administrateur Salesforce ou intégrateur : L'installation d'un package managé dans une organisation Salesforce requiert des droits d'administration. Si vous n'êtes pas administrateur de votre org, rapprochez-vous de votre administrateur Salesforce ou de votre intégrateur.

2. Disposer d'une licence Frisbii active : L'extension Frisbii e-invoice fait partie de l'offre Frisbii. Une licence Frisbii active sur votre organisation Salesforce est nécessaire pour que le package fonctionne correctement.

3. Attribuer le Permission Set "Frisbii E-invoicing" après installation : Une fois le package installé ou mis à jour, le permission set Frisbii E-invoicing doit être attribué aux utilisateurs qui doivent accéder aux fonctionnalités de facturation électronique. Sans cette attribution, les champs et objets de l'extension ne seront pas accessibles.

Liens d'installation

Sandbox (environnement de test)

Utilisez ce lien pour installer ou mettre à jour le package dans votre sandbox avant de le déployer en production. C'est la démarche recommandée.

👉 Installer Frisbii e-invoice en Sandbox

Production

Une fois les tests validés en sandbox, installez le package dans votre organisation de production.

👉 Installer Frisbii e-invoice en Production

Recommandation : installez et testez toujours en sandbox en premier. Une mise à jour de package en production sans phase de test préalable peut provoquer des comportements inattendus sur vos flux de facturation.

Actions suite aux montées de version

Suite à vos montées de version, voici les actions à mener :

  • Ajouter les valeurs de pick lists aux champs Frisbii e-invoice : régulièrement dans les versions récentes de Frisbii e-invoice, les listes déroulantes sont alimentées par de nouvelles valeurs conformément aux exigences de la Réforme.
    Depuis la version 0.25, un bouton permet d’ajouter automatiquement les nouvelles valeurs du package dans les listes déroulantes Frisbii e-invoice. Pour celà, recherchez l’interface de mappage depuis le menu gauffre : Einvoicing mappings, cliquez sur le bouton “Sync Picklists Values”.
    Exemple : la liste déroulante du champ “Code identifiant du schéma” sur Compte, comporte désormais 243 valeurs contre 3 valeurs sur les premières versions de Frisbii e-invoice.

  • Activer les renvois (uniquement pour les clients qui ont souscrit à l’offre PA Ecosio) : vérifier le paramètrage suivant après une montée de version. Salesforce peut désactiver ce paramétrage.
    Depuis la configuration Salesforce, rechercher les “Identifiants nommés”, cliquez sur “Ecosio Authentification”, et vérifiez si “Activer les renvois” est actif, comme ci dessous :

Étapes d'installation

Étape 1 — Cliquer sur le lien correspondant à votre environnement (sandbox ou production) Vous êtes redirigé vers la page d'installation Salesforce. Connectez-vous avec vos identifiants administrateur si ce n'est pas déjà fait.

Étape 2 — Choisir les profils d'installation Salesforce vous propose trois options :

  • Installer pour les administrateurs uniquement — recommandé pour un premier test.

  • Installer pour tous les utilisateurs — si tous vos utilisateurs doivent accéder au package.

  • Installer pour des profils spécifiques — si vous souhaitez contrôler l'accès finement.

Pour une mise à jour, choisissez la même option que lors de votre installation initiale. Généralement, installer pour tous les utilisateurs.

Étape 3 — Lancer l'installation Cliquez sur Installer. L'installation peut prendre quelques minutes. Salesforce vous envoie un e-mail de confirmation une fois l'opération terminée.

Étape 4 — Attribuer le Permission Set "Frisbii E-invoicing". Après installation (ou mise à jour), allez dans Configuration → Ensembles d'autorisations → Frisbii E-invoicing, puis attribuez-le aux utilisateurs concernés.

💡 Si vous avez déjà attribué ce permission set lors d'une installation précédente, l'attribution est conservée lors d'une mise à jour. Vérifiez simplement qu'aucun nouvel utilisateur n'a besoin d'y être ajouté.

En cas de problème

Si l'installation échoue ou si vous rencontrez une erreur lors de la mise à jour, voici les vérifications à effectuer en premier :

  • Vérifiez que votre version Frisbii app est bien ≥ 3.247 (prérequis de l'extension e-invoice).

  • Vérifiez que vous êtes bien connecté en tant qu'administrateur Salesforce sur l'org cible.

  • Si l'erreur persiste, contactez le support Frisbii via l’ouverture d’un ticket support en indiquant le message d'erreur exact affiché par Salesforce et l'environnement concerné (sandbox ou production).

Nouveautés entre les versions

Vous trouverez ci-dessous les fonctionnalités mises en place pour chaque version majeure de Frisbii e-invoice. Cette liste n'est pas exhaustive mais rassemble les principales évolutions afin de pouvoir vous guider dans les versions.

Fonctionnalités nouvelles entre 0.32 et 0.34

Fonctionnalités

Description

Corrections sur le batch de génération XML

Le batch de génération XML a été corrigé afin d’éviter le renvoi de factures qui pourront être considéré comme doublon.

Accès au fichier XML e-reporting

Suite à une limitation Salesforce, le XML e-reporting sera uniquement présent sur l’enregistrement de Dépôt (et non plus sur Facture).

Création de l’interface de mappage des flux e-reporting pour les champs personnalisés

Création de l’interface de mappage EReporting mappings.

Nouveaux BT sur Einvoicing Mapping

Les BT suivants ont été rendus disponibles sur l’interface de mappage :

  • BT-73 : Date de début de période de facturation

  • BT-74 : Date de fin de période de facturation

Fonctionnalités nouvelles entre 0.27 et 0.31

Fonctionnalités

Description

Personnalisation du motif d’exonération de TVA

La balise qui recense le motif d'exonération est disponible au mappage : BT-121​

L'admin Salesforce peut créer un champs formule pour stocker la lettre du code VATEX en fonction du motif d'exonération.

Nouveaux BT sur Einvoicing Mapping

Les BT suivants ont été rendus disponibles sur l’interface de mappage :

  • BT-14 : Identifiant d'un bon de commande de vente

  • BT-140 : motif de la remise applicable à la ligne

  • BT-41 : point de contact vendeur

  • BT-42 : numéro de téléphone du contact vendeur

  • BT-43 : email du contact vendeur

  • BT-8 : date d’exigibilité de la TVA

  • BT-134 : Date de début de la période de la ligne

  • BT-135 : Date de fin de la période de la ligne

  • BT-X-21 : N° de Bon de commande de la ligne de facture

  • BT-11 : Référence du projet

  • BT-80 : code du pays de livraison

Fonctionnalités nouvelles entre 0.25 et 0.26

Fonctionnalités

Description

Actions pour compléter les valeurs de pick list

Régulièrement, les listes déroulantes sont alimentées par de nouvelles valeurs, conformément aux exigences de la Réforme.
Depuis la version 0.25, un bouton permet d’ajouter automatiquement les nouvelles valeurs du package dans les listes déroulantes Frisbii e-invoice. Pour celà, recherchez l’interface de mappage depuis le menu gauffre : Einvoicing mappings, cliquez sur le bouton “Sync Picklists Values”.

Joindre automatiquement toutes les PJ à la facture électronique

Activer l’option AutoAttachNotesAndAttachments, tous les documents enregistrés dans “Notes et pièces jointes” depuis l’enregistrement de Facture d’origine seront automatiquement inclus en tant que BT-125, en base64, et rattachés aux XML de factures électronique générées.

Inclure les codes BT à la facture électronique

Activer l’option IncludeXmlBusinessTermComments, un indicateur visuel affiche le code BT correspondant à la donnée. Cet indicateur n’invalide pas les fichiers, il s’agit simplement d’une aide visuelle pour faciliter vos tests.

Prise en comptes des bloc Tiers Payeurs

Ajout des bloc Tiers Payeurs dans la facture électronique

Prise en compte du Membre Assujetti à la TVA

Ajout des bloc Membre Assujetti à la TVA dans la facture électronique

Générer et envoyer des factures électroniques depuis la vue de liste

Les boutons d’actions suivants ont été ajoutés depuis la vue de liste Facture :

  • E-invoice XML

  • Envoyer à Ecosio (uniquement valable pour les clients qui ont souscrit à l’offre Ecosio)

pour vous permettre de sélectionner plusieurs factures en vue de liste.

Connecteur GtoB (uniquement pour les clients du secteur public)

Connexion API vers notre connecteur Chorus GtoB et ajout du bouton d’action “Envoyer à Chorus” depuis Facture et la vue de liste.

Fonctionnalités nouvelles entre 0.23 et 0.24

Fonctionnalités

Description

Correctifs des BT

Les BT suivants ont été corrigés :

  • BT-154 : Description de l’article

  • BT-146 : Prix net de l’article

  • BT-110 : Montant total de TVA

  • BT-72 : Date effective de livraison

Actions pour compléter les valeurs de pick list

Régulièrement, les listes déroulantes sont alimentées par de nouvelles valeurs, conformément aux exigences de la Réforme.
Depuis la version 0.25, un bouton permet d’ajouter automatiquement les nouvelles valeurs du package dans les listes déroulantes Frisbii e-invoice. Pour celà, recherchez l’interface de mappage depuis le menu gauffre : Einvoicing mappings, cliquez sur le bouton “Sync Picklists Values”.

Nouveaux BT sur Einvoicing Mapping

Les BT suivants ont été rendus disponibles sur l’interface de mappage :

  • BT-26 : Date de facture antérieure

  • BT-10 : Code de service

  • BT-13 : Numéro bon de commande

Prise en compte des lignes négatives sur une facture électronique

Les lignes de facture aux montants négatifs, comme des remises… sont désormais prises en compte dans la facture XML.

Fonctionnalités nouvelles entre 0.21 et 0.22

Fonctionnalités

Description

Mise à disposition du e-reporting

Le module e-reporting est disponible sur Frisbii pour Salesforce : une nouvelle catégorie dédiée vient d'être publiée dans notre centre d'aide. Elle explique ce qu'est le e-reporting et sa différence avec l'e-invoicing, présente les 4 flux de données concernés (transactions et paiements, B2B international et B2C), et vous guide pas à pas dans la configuration (factures, raison sociale, règlements). Vous y trouverez aussi le calendrier de dépôt par régime de TVA... De quoi vous accompagner de bout en bout dans cette obligation réglementaire.

Fonctionnalités nouvelles entre 0.18 et 0.21

Fonctionnalités

Description

Déploiement des API vers la PA Ecosio

Pré-requis :

  • Acceptation du mandat par Ecosio

  • Inscription de l’entreprise sur l’annuaire PEPPOL

  • Ouverture de la sandbox Ecosio

  • Configuration de Frisbii pour établir la connexion entre l’organisation Salesforce et Ecosio.

L’ouverture des API va vous permettre de réaliser votre phase de recettage et de déposer vos factures électroniques sur la PA Ecosio.
La connexion au PPF n’est pas accessible depuis une sandbox, en d’autres termes, la facture électronique est reçue et traitée par Ecosio mais non transmis à vos clients et ni à l’administration fiscale.

Déposer manuellement une facture électronique sur Ecosio

Un bouton d’action “Envoyer à Ecosio” est disponible depuis Facture pour permettre un dépôt manuel vers la plateforme Ecosio.

Gestion des arrondis (écart de 0,01€)

Afin de pallier aux problématiques d’écart d’arrondis entre la facture PDF et la facture électronique XML, les BT suivants ont été mis à jour avec les champs précis Frisbii :

  • BT-109 : Montant HT précis après toutes remises

  • BT-110 : Montant TVA précis

  • BT-112 : Total VA précis après toutes remises

  • BT-131 : Montant HT précis

Les champs précis Frisbii sont des champs existants qui utilisent 4 décimales (au lieu de 2) pour réaliser les calculs de TVA.

Correction sur le Prix net de l’article (BT-146)

Correction appliquée sur le BT-146, le champs Prix unitaire après remise est pris en compte (et non le prix unitaire multiplié par la quantité).

Fonctionnalités nouvelles entre 0.16 et 0.17

Fonctionnalités

Description

Création d’un enregistrement de “Dépôt” pour chaque facture électronique générée

Dès qu'une facture électronique est générée, Frisbii crée automatiquement un enregistrement de Dépôt. Il vous permet de suivre, en un coup d'œil, où en est chaque facture dans son parcours vers la plateforme agréée.

L’objet Dépôt retrace le statut de la facture et son état (Acceptée, Rejetée, Payée…).

Rapports packagés de suivi des factures

Frisbii met à votre disposition un dossier de rapports préconfigurés, prêt à l'emploi, pour piloter votre facturation et repérer rapidement les anomalies.

3 rapports sont disponibles : 

  • Factures rejetées

  • Factures en erreur de dépôt

  • Factures par état du cycle de vie

Fonctionnalités nouvelles entre 0.14 et 0.16

Fonctionnalités

Description

Création des champs “Adresse de facturation électronique”

Création des champs “Adresse de facturation électronique” sur Compte, Donnée Comptable et Raison sociale.
BT-34 = adresse de facturation électronique de la raison sociale.

BT-49 = adresse de facturation électronique de la DC, puis du Compte (par ordre de priorité).

Champs disponible depuis l’interface de mappage Einvoicing mappings.

Pouvoir dupliquer des BT depuis EInvoicing mappings

Les BT suivants sont disponibles au clonage :

  • BT-21 et BT-22 : Note de la facture

  • BT-127 : Note de la Ligne de facture

  • BT-160 et BT-161 : Attribut d’un article

permet de dupliquer les BT et avoir plusieurs champs en entrées.

Renseigner une valeur fixe depuis EInvoicing mappings

Depuis l’interface de mappage, il est désormais possible de renseigner des valeurs par défaut dans le XLM : zone de texte “Valeur fixe” depuis EInvoicing mappings.

Fonctionnalités nouvelles entre 0.10 et 0.13

Fonctionnalités

Description

Remplissage automatique du SIRET de la Raison sociale émettrice

Si le pays de la raison sociale est France, et que le SIREN est renseigné sur la RS, alors le BT-29 : SIRET du vendeur est automatiquement renseigné via les 9 premiers chiffres du SIREN.
L’algorithme de Luhn vérifie le SIREN.

Valeur par défaut BT-23 = S1

A partir de la version 0.13, la balise BT-23 est automatiquement renseignée par défaut avec la valeur S1, correspondant au dépôt d’une facture de prestation de service.
La valeur de cette balise sera prochainement dynamique.

Correctif Type de profil du XML

Adaptation du Type de profil attendu par la Réforme.

Valeur par défaut BT-122 = 916

A partir de la version 0.13, la balise BT-23 est automatiquement renseignée par défaut avec la valeur 916.

Notification de fin de batch

Notification Salesforce lorsque le batch de génération en masse est terminé.

Fonctionnalités nouvelles entre 0.06 et 0.09

Fonctionnalités

Description

Création des nouveaux champs sur l’objet Dépôt

Réutilisation de l’objet Dépôt existant dans le core package Sofacto.
Ajout des champs fiix__ propre à la dématérialisation des factures.

Création de l’interface de mappage pour les champs personnalisés

Création de l’interface de mappage EInvoicing mappings.

CRUD EInvoicing mappings

Droit d’accès uniquement aux utilisateurs Admin Frisbii.

Fonctionnalités nouvelles entre 0.05 et 0.07

Fonctionnalités

Description

Ajout du PDF de la facture en base 64

Ajout du PDF de la facture émise en base 64, balise BT-125-1

Enregistrement du XML dans Fichier de Salesforce

Après enregistrement, la facture électronique est automatiquement stockée dans Fichier de Salesforce

Ajout des valeurs SIREN, SIRET et TVA intra dans le XML

Ajout des balises suivantes :

  • BT-46 : SIREN de l’acheteur

  • BT-47 : SIRET de l’acheteur

  • BT-48 : TVA intracommunautaire de l’acheteur

Fonctionnalités nouvelles entre 0.01 et 0.04

Fonctionnalités

Description

Création de l’extension package Frisbii e-invoice

Création d’une nouvelle extension package Frisbii e-invoice portant la génération des factures électroniques françaises.
Ce package est compatible avec les versions 3.247 et supérieure du core package Frisbii, en raison de la fonctionnalité Exonération de TVA présente à partir de cette version 3.247.

Création du XML CII - Facturation BtoB

Mapping des champs sofactoapp__ et fiix__ avec les balises du XML CII EXTENDED.

Création du bouton “E-invoice XML” sur Facture

Ajout du bouton “E-invoice XML” permettant la génération manuelle d’une facture électronique depuis un enregistrement de Facture.

Méthode Apex pour générer en masse le XML

Création de la méthode Apex, nommée Generate XMLs from Invoice records to Files, permettant de générer en masse les factures électroniques.