Moins de ressaisie
Les informations approuvées dans Yooz sont reprises dans les factures et avoirs d’achat.
DOCUMENTATION / YOOZ × BUSINESS CENTRAL
Vos factures Yooz.
Dans votre ERP.
Développée par IH Factory, l’intégration récupère les factures et avoirs fournisseurs approuvés dans Yooz et crée les documents d’achat dans Business Central. Vos équipes contrôlent, puis comptabilisent.
01 / YOOZApprouver
→Terminer le traitement de la facture.
02 / INTÉGRATION IH FACTORYImporter
→Récupérer les données et créer le document.
03 / BUSINESS CENTRALContrôler & comptabiliser
Vérifier la facture dans votre ERP.
01 / COMPRENDRE LE FLUX
La saisie automatisée.
Le contrôle conservé.
Un utilisateur lance l’import depuis Business Central, ou une tâche planifiée l’exécute. Le connecteur lit le rapport de données Yooz page par page, vérifie le numéro Yooz pour éviter les doublons, puis crée les en-têtes et les lignes des documents d’achat.
Un import suivi
Un bilan indique les documents créés, déjà présents ou en erreur. Le Log Yooz permet d’examiner chaque résultat.
Une reprise des erreurs
Une erreur sur un document ne bloque pas les suivants. Après correction, les documents concernés sont repris lors du prochain import.
02 / AVANT LA MISE EN SERVICE
Aligner les référentiels.
Dans Yooz
- Un compte API dédié et les paramètres d’authentification fournis par Yooz.
- Un rapport de données des documents d’achat avec les informations d’en-tête et les lignes d’imputation.
- Des filtres adaptés : documents approuvés et date de fin de traitement depuis la dernière exécution.
- Des codes fournisseurs identiques aux numéros des fournisseurs dans Business Central.
Dans Business Central
- Les fournisseurs existants, avec groupes comptables, paramètres TVA et conditions de paiement.
- Les comptes généraux utilisés dans les imputations Yooz.
- Les devises nécessaires et, selon les données transmises, les codes de paiement et de TVA correspondants.
- Les autorisations d’accès aux fonctions de l’extension installée.
03 / CONFIGURER LA CONNEXION
Un paramétrage par environnement.
Ouvrez Paramétrage Yooz depuis la liste des factures achat ou le Log Yooz. La recherche Business Central permet aussi d’ouvrir token yooz setup. En présence de plusieurs lignes, cochez une seule ligne « par defaut ». Une ligne unique est utilisée même sans cette coche.
| Champ | Utilisation |
|---|---|
id, name, par defaut | Identifier la configuration et choisir celle utilisée par l’import. |
api_url, token_url | Renseigner les adresses HTTPS de l’API Yooz Rising et du serveur d’authentification. |
application_id, client_id | Identifier l’application et le client OAuth fournis par Yooz. |
client_secret, refresh_token | Saisir les secrets dans les champs masqués. Le secret client est transmis s’il est renseigné. |
data_report_id | Identifier le rapport. S’il est vide et qu’un seul rapport est disponible, son identifiant est renseigné au premier import. |
page_size | Nombre de lignes par appel. La valeur 0 utilise la valeur par défaut de Yooz. |
last_execution_datetime | Date de départ de la récupération incrémentale, actualisée seulement après une exécution entièrement réussie. |
last_yooz_number | Numéro du dernier document créé, renseigné automatiquement en lecture seule. |
Testez la connexion avec Renouveler le token avant le premier import. Cette action vérifie l’authentification sans créer de facture. Pendant l’import, le jeton d’accès est renouvelé lorsqu’il est absent ou expiré, avec une nouvelle tentative en cas de réponse 401 ou 403.
04 / UTILISER L’INTÉGRATION
Importer, vérifier, valider.
Ouvrir la liste des Factures achat
Dans le menu Accueil, retrouvez le groupe Yooz : « Importer les factures Yooz », « Log Yooz » et « Paramétrage Yooz ».
Lancer « Importer les factures Yooz »
La configuration par défaut est contrôlée. Les documents déjà présents, ouverts ou comptabilisés, sont ignorés grâce à leur numéro Yooz.
Lire le bilan et le Log Yooz
Vérifiez les compteurs de documents créés, ignorés et en erreur. Corrigez les causes signalées avant de relancer.
Contrôler les documents avant comptabilisation
Vérifiez le fournisseur, le numéro de facture, les dates, les comptes, la TVA, le total TTC, la devise et le taux de change. Remplacez toute ligne de texte signalant un compte inconnu.
Planifier les imports
Dans les Écritures file d’attente des tâches, la codeunit 50008 « ElectronicDoc job », dans la version documentée de l’extension, peut lancer la même procédure automatiquement. Configurez la récurrence et l’intervalle, puis placez la tâche au statut Prêt. Consultez ensuite le Log Yooz pour suivre le résultat.
05 / CORRESPONDANCE DES DONNÉES
Du document Yooz à la facture achat.
| Information | Règle de reprise |
|---|---|
| Fournisseur | Le code tiers Yooz doit correspondre à un fournisseur existant. Ses paramètres comptables et de paiement sont repris. |
| Type de document | Le type « Avoir » crée un avoir achat ; les autres documents créent une facture achat. |
| Dates et références | Dates du document, de comptabilisation, de réception et d’échéance ; numéro de facture et référence de commande lorsqu’ils sont fournis. |
| Devise et paiement | Les codes sont extraits des libellés. Le mode de paiement Yooz est repris si le code existe ; sinon celui du fournisseur est conservé. |
| Numéro Yooz | Conservé sur le document comptabilisé et utilisé pour éviter une nouvelle création du même document. |
| Totaux TTC et TVA | Repris sur l’en-tête pour le contrôle des montants avant comptabilisation. Le contrôle du total doit être activé dans le paramétrage achats. |
| Compte ou article | Recherche du compte général, puis de l’article. Si aucun ne correspond, une ligne de texte est créée et doit être corrigée avant comptabilisation. |
| Quantité et prix | Si la quantité ou le prix manque, la ligne utilise une quantité de 1 et le montant HT comme prix unitaire. |
| Montant de ligne | Si quantité × prix dépasse le montant Yooz, l’écart est repris en remise de ligne. |
| TVA de ligne | Le code TVA Yooz est utilisé si le couple TVA marché / produit existe ; sinon le paramétrage par défaut du compte est conservé et doit être contrôlé. |
| Descriptions | Le libellé et une description complémentaire distincte sont repris sur les lignes. |
06 / JOURNAL ET REPRISE
Comprendre le résultat.
Corriger la cause.
Le Log Yooz conserve uniquement la dernière exécution : il est vidé au début de chaque nouvel import. Une ligne « Exécution » donne le bilan ; les lignes « Document » présentent les factures traitées et les erreurs éventuelles. Consultez le journal avant de relancer.
| Catégorie | Vérification |
|---|---|
| Fournisseur | Comparer le code tiers Yooz au numéro fournisseur Business Central. Aligner les codes ou créer la fiche manquante, puis relancer. |
| Paramétrage | Contrôler les champs requis, la ligne par défaut et l’identifiant du rapport lorsqu’il y a plusieurs rapports. |
| Connexion | Vérifier les adresses et l’accès réseau à Yooz. |
| Token | Vérifier la validité du jeton et la correspondance avec le client OAuth et le serveur d’authentification. |
| API | Vérifier les droits du compte et l’existence du rapport ; examiner le code HTTP reçu. |
| Données | Contrôler le format du rapport et la présence du numéro Yooz. |
| Autre | Vérifier les groupes comptables, les devises et les dates autorisées dans Business Central. |
07 / ACCÈS ET SECRETS
Une connexion maîtrisée.
- Utilisez un compte technique dédié, limité à la lecture du rapport de données nécessaire.
- Réservez l’accès au paramétrage aux administrateurs habilités et séparez les comptes de test et de production.
- Renseignez uniquement les adresses HTTPS de votre environnement Yooz.
- Transmettez les secrets par un canal sécurisé. Aucun jeton ni secret client ne doit figurer dans un e-mail, une capture ou un ticket.
- En cas de doute, faites révoquer les secrets concernés par Yooz, remplacez-les, testez la connexion et vérifiez un import de contrôle.
Cette documentation présente le fonctionnement de l’intégration développée par IH Factory. Les champs, actions et identifiants techniques sont à vérifier avec la version de l’extension déployée dans votre environnement. Yooz est une marque de son titulaire.
Contacter IH Factory pour cette intégration ↗08 / RÉFÉRENCE TECHNIQUE
Les actions et les données,
en détail.
Où trouver les actions
| Page | Actions disponibles |
|---|---|
| Factures achat | Importer les factures Yooz, Log Yooz, Paramétrage Yooz, dans le groupe Yooz du menu Accueil. |
| token yooz setup | Renouveler le token, Importer les factures Yooz, Log Yooz. |
| Log Yooz | Même exécution, Paramétrage Yooz, Supprimer les lignes affichées. |
Rapport de données Yooz
Le rapport utilise le modèle « Lignes imputation & achat ». Prévoir au minimum les colonnes yoozNumber, thirdPartyCode, thirdPartyName, documentTypeName, YZ_NUMBER_YZ_COMMONS, YZ_DATE_YZ_COMMONS, totalAmount, taxAmount, currency et le bloc YZ_INVOICE_LINE. Les colonnes de ligne sont lues avec ou sans le suffixe _YZ_INVOICE_LINE.
Appels et ordre d’exécution
Préparer l’exécution
Vider le Log Yooz, sélectionner le paramétrage par défaut et vérifier les champs requis. Si l’identifiant du rapport est vide, appeler
GET {api_url}/dataReports: un rapport unique est retenu automatiquement ; plusieurs rapports nécessitent de renseigner l’identifiant.Obtenir le jeton
Appeler
POST {token_url}si le jeton est absent ou expiré. Le jeton d’accès est transmis dans l’en-têteAuthorization: Beareret l’identifiant d’application dansapplicationId. Un nouveau refresh token fourni par Yooz est enregistré immédiatement.Parcourir le rapport
Appeler
GET {api_url}/dataReports/data/{data_report_id}avecpageOffsetà partir de 0, puis 1, 2… jusqu’à la dernière page. AjouterpageSizesi configuré etlastExecutionDatetimesi renseigné, au formatAAAA-MM-JJThh:mm:ss.000Z.Créer puis établir le bilan
Ignorer les numéros Yooz déjà présents. Créer chaque document dans une transaction isolée pour poursuivre après une erreur. Sans erreur, la date de dernière exécution devient la date de début de l’import. Le bilan affiche les compteurs et les dix premières erreurs.
Correspondance complète de l’en-tête
| Champ Business Central | Colonne Yooz | Traitement |
|---|---|---|
| Fournisseur | thirdPartyCode | Fournisseur existant requis ; ses conditions de paiement, sa devise, ses groupes comptables et son adresse sont repris. |
| Prix TTC | — | Toujours Non : les montants Yooz sont hors taxes. |
| Date comptabilisation | YZ_ACCOUNTING_DATE_YZ_COMMONS | Reprise si renseignée. |
| Date document | YZ_DATE_YZ_COMMONS | Reprise si renseignée. |
| Date réception facture | YZ_RECEPTION_DATE_YZ_COMMONS | Reprise si renseignée. |
| Code devise | currency | Partie code du libellé ; non renseignée si identique à la devise société. |
| Mode de paiement | paymentMethod | Repris si le code existe ; sinon celui du fournisseur reste. |
| Date échéance | YZ_DUE_DATE_YZ_COMMONS | Validée après les dates et conditions de paiement pour conserver l’échéance transmise. |
| N° facture / avoir fournisseur | YZ_NUMBER_YZ_COMMONS | Selon le type de document. |
| N° commande fournisseur | YZ_PURCHASE_ORDER_NUMBER_YZ_INVOICE | Repris si renseigné. |
| Description comptabilisation | thirdPartyName + YZ_NUMBER_YZ_COMMONS | Nom du fournisseur suivi du numéro de facture. |
| Yooz Number | yoozNumber | Clé anti-doublon conservée sur le document comptabilisé. |
| Montant TTC document | totalAmount | Montant de référence pour le contrôle du total. |
| Montant TVA document | taxAmount | Montant de référence pour le contrôle de TVA. |
Correspondance complète des lignes
| Champ | Colonne Yooz | Traitement |
|---|---|---|
| Type / N° | YZ_ACCOUNT, puis YZ_ITEM_CODE | Recherche du compte général, puis de l’article ; sinon création d’une ligne de texte à corriger. |
| Quantité | YZ_QUANTITY_INVOICED | Si quantité ou prix absent : quantité 1 et prix égal au montant HT. |
| Coût unitaire direct | YZ_UNIT_PRICE | Prix transmis, ou montant HT lorsque quantité ou prix manque. |
| Montant ligne | YZ_AMOUNT | Si quantité × prix dépasse le montant transmis, l’écart devient une remise de ligne. |
| Groupe TVA produit | YZ_TAX_CODE | Partie code ; utilisée si le couple TVA marché / produit existe, sinon groupe par défaut du compte. |
| Description | YZ_LABEL | Libellé de la ligne. |
| Description 2 | YZ_DESCRIPTION | Reprise si différente du libellé. |
Un libellé de type « CODE - Libellé » est réduit à son code. Pour un compte introuvable, la description complémentaire conserve « Yooz : compte XXX, montant YYY » : le comptable remplace cette ligne par un compte général avant comptabilisation.
Lire le journal
Dans la version documentée, le Log Yooz correspond à la table 50024 et à la page 50029. La ligne « Exécution » donne le statut, le bilan, les compteurs et l’URL appelée en cas d’erreur API. Les lignes « Document » présentent le numéro Yooz, le fournisseur, la référence, le type, la date, le TTC, la devise, le document créé et l’erreur éventuelle. Les erreurs sont affichées en rouge ; les messages du journal sont limités à 1 000 caractères.
Paramètres et jetons complémentaires
Les champs techniques access_token, expires_in, scope et token_expires_at sont alimentés lors du renouvellement. Le refresh token collé est nettoyé des guillemets, espaces et retours à la ligne, puis vérifié par rapport au client et à l’émetteur configurés. Un message signale une incohérence.
La version documentée stocke les jetons dans des champs Blob ; les champs de saisie des secrets sont masqués. Le journal ne contient ni jeton ni secret client. La protection au repos dépend également de l’environnement Business Central déployé.
09 / PARCOURS DE FORMATION
S’entraîner.
Contrôler.
Être autonome.
Effectuez ces exercices dans un environnement de test, avec des fournisseurs et factures fictifs. Le parcours comptable suppose une connexion déjà paramétrée par un administrateur.
Exercice 1 — Un import réussi
- Préparer une facture fictive approuvée dans Yooz, avec un code fournisseur existant dans Business Central.
- Lancer « Importer les factures Yooz » depuis Factures achat.
- Lire le bilan et retrouver le document dans le Log Yooz.
- Contrôler fournisseur, référence, dates, lignes, TVA, TTC, devise et taux de change.
- Relancer l’import : le document déjà présent doit être ignoré.
Résultat attendu : un document ouvert, contrôlable, sans nouvelle création lors du second import.
Exercice 2 — Corriger et reprendre
- Utiliser une facture de test dont le code fournisseur n’existe pas dans Business Central.
- Lancer l’import et lire l’erreur « Fournisseur » dans le Log.
- Aligner les codes ou créer la fiche fournisseur avec ses paramètres comptables.
- Relancer l’import et vérifier que le document est créé.
- Vérifier le bilan et la date de dernière exécution.
Résultat attendu : le document en erreur est repris après correction, tandis que les documents existants sont ignorés.
Parcours administrateur
Préparer TEST et PROD
Créer les configurations avec des comptes API et secrets distincts ; sélectionner une seule configuration par défaut. Aligner fournisseurs, comptes, devises et codes TVA.
Tester la connexion
Utiliser « Renouveler le token » pour vérifier l’authentification sans importer de facture. Vérifier le rapport choisi et sa date de récupération.
Tester la planification
Configurer la codeunit 50008 « ElectronicDoc job » dans la file d’attente des tâches, avec récurrence, intervalle et statut Prêt. Consulter le Log après exécution.
Questions fréquentes
Pourquoi ma facture n’arrive-t-elle pas ?
Vérifier son approbation dans Yooz, les filtres du rapport, la date de dernière exécution et le Log. Une date future peut exclure les documents attendus.
Pourquoi une ligne de texte apparaît-elle ?
Le compte ou l’article transmis n’a pas été retrouvé. Corriger la ligne et le référentiel avant comptabilisation.
Pourquoi la date n’avance-t-elle pas ?
Au moins un document est en erreur. Corriger la cause puis relancer ; la date avance après une exécution entièrement réussie.
Le TTC ne correspond pas : que contrôler ?
Vérifier lignes, remises et groupes TVA. Activer le contrôle du total dans le paramétrage achats pour bloquer une comptabilisation dont les lignes ne correspondent pas au montant de référence.