Guides

User Guide

Learn how to use sinao

Onboarding & Configuration

Flux et outils pour démarrer rapidement : configuration initiale de l'entreprise, paramètres globaux et assistants guidés. Inclut la recherche d'entreprises et la configuration d'organisation nécessaire au démarrage.

Vue d’ensemble des KPI

Présentation synthétique des indicateurs financiers clés (trésorerie, chiffre d’affaires, dépenses) avec navigation vers les détails. Conseils pour interpréter les cartes KPI et exemples de scénarios d'alerte.

Guide d'onboarding et démarrage rapide

Vue d'ensemble du parcours guidé pour configurer une nouvelle entreprise : comment lancer l'assistant pas-à-pas, suivre les étapes de bienvenue, sauvegarder la progression et terminer l'initialisation pour démarrer la facturation et la comptabilité.

Facturation & Ventes

Fonctionnalités liées à la création, personnalisation, génération et envoi des devis, factures et autres documents commerciaux, y compris les PDFs/FacturX et templates. Couvre aussi la facturation récurrente et la numérotation des documents.

Gestion des comptes utilisateur & authentification

Permet aux utilisateurs de créer, mettre à jour et gérer leur compte global, de s'authentifier (incluant 2FA) et de récupérer ou changer leur mot de passe. Utile pour sécuriser l'accès, maintenir les informations de contact et gérer les sessions API.

Inscription et profil utilisateur

Guide pour créer un compte, compléter et mettre à jour les informations de profil (nom, email, autres infos de compte) et modifier le mot de passe lorsque l'utilisateur est connecté. Inclut les validations côté API, les réponses attendues et les bonnes pratiques UX pour l'inscription.

Onboarding et configuration du compte

Permet aux nouveaux utilisateurs de configurer leur entreprise (SIREN/SIRET, adresse, forme juridique, TVA, etc.) et de suivre un parcours guidé d'initialisation. Utile pour démarrer rapidement avec des données d'entreprise cohérentes et lancer la facturation et la comptabilité.

Ventes, Facturation & Documents commerciaux

Tout ce qui touche aux devis, factures, documents commerciaux, modèles, envois et facturation récurrente. Comprend l'édition des templates, génération PDF et intégrations liées à l'envoi de factures.

Gestion des organisations et établissements

Permet de créer, éditer et gérer les organisations, leurs établissements et les coordonnées (adresses, NIC, contacts). Utile pour tenir à jour les informations clients/fournisseurs utilisées dans la facturation et la comptabilité.

Navigation et accès rapides

Comment ouvrir le tableau de bord, utiliser les raccourcis vers les modules (facturation, banque, achats, catalogue) et configurer les tuiles visibles selon les droits et l’offre.

Recherche et validation SIREN / SIRET

Modalités de saisie et de validation des identifiants nationaux (SIREN/SIRET/NIC), mécanismes de recherche d'établissements via INSEE / OpenDataSoft, autocomplétion et gestion des requêtes (debounce) pour limiter les appels réseau.

Banque, Paiements & Trésorerie

Connexion et synchronisation bancaire, gestion des paiements, mandats SEPA, réconciliation et gestion des abonnements / paiements en ligne. Outils pour piloter la trésorerie.

Achats & Dépenses

Tout pour la saisie, l'automatisation et le traitement des dépenses et factures fournisseurs : import, OCR, justificatifs, notes de frais et frais kilométriques. Permet de préparer les écritures comptables relatives aux achats.

Authentification, 2FA et gestion des tokens

Explication du flux d'authentification : connexion par email/mot de passe, challenge 2FA (envoi et validation de code), obtention et utilisation des tokens JWT, rafraîchissement de token et déconnexion. Couvre aussi les contraintes liées aux limites d'envoi de codes et la sécurité des sessions.

Gestion des applications (tenants) & provisioning

Gérer la création, la configuration, la mise à l'échelle et la suppression d'instances client (apps/tenants). Utile pour administrateurs qui créent de nouveaux locataires, réinitialisent des environnements et accèdent aux informations d'une app.

Banque, Paiements & Rapprochement

Connexion et synchronisation bancaire, gestion des moyens de paiement (Stripe/PayPal/SEPA), mandats et rapprochement des transactions. Inclut les règles bancaires, exports SEPA et gestion des paiements/encaissements.

Filtres, périodes et états

Explication des filtres temporels (mois/trimestre/année), des badges d’état par période et de leur impact sur les données affichées. Bonnes pratiques pour comparer des périodes.

Informations légales et fiscales

Collecte et validation des données d'entreprise nécessaires au fonctionnement fiscal et comptable : nom, adresse, forme juridique, date de création et numéro de TVA intracommunautaire, avec indications sur les étapes obligatoires pour activer les fonctions fiscales.

Banque, Paiements & Rapprochements

Connexion bancaire, import et gestion des transactions, rapprochements automatiques/manuels, paiements, SEPA et intégration avec Stripe/PayPal. Inclut interactions avec URSSAF et traitements liés aux encaissements/décaissements.

Sauvegardes & restauration (Backups)

Gérer les sauvegardes de la plate-forme World et des apps, consulter la liste des sauvegardes, restaurer des états et télécharger des dumps SQL. Indispensable pour la continuité d'activité et la reprise après incident.

Récupération et réinitialisation du mot de passe

Procédure complète pour la récupération de mot de passe : demande de réinitialisation par email, génération et validation du token de reset, et changement sécurisé du mot de passe. Inclut les règles sur la validité du token de réinitialisation et les limites pour éviter le flood d'emails.

Achats, Notes de frais & Justificatifs

Traitement des achats, factures fournisseurs, notes de frais, indemnités et justificatifs (OCR, aperçu, comptabilisation). Conçu pour contrôler les dépenses et préparer les paiements.

Facturation & Documents commerciaux (Factures / Devis)

Créer, éditer, exporter et envoyer devis et factures. Permet la gestion complète du cycle commercial : rédaction, pièces jointes, envoi par email, demande de signature électronique et conversion en facture.

Comptabilité, Taxes & Prévision

Tenue comptable, plan comptable, exports et déclarations (TVA, URSSAF), prévisionnel et tableaux de bord financiers pour piloter la performance et respecter les obligations fiscales.

Actions rapides et synchronisation

Guide des actions exécutables directement depuis le tableau de bord (générer pièces comptables, synchroniser banque), comportement pendant la synchronisation et règles d’accès selon l’offre.

Envoi de documents & Emailing

Envoyer factures/devis par email, joindre documents, personnaliser message et suivre envoi. Permet la communication rapide auprès des clients avec suivi et confirmation.

Comptabilité, TVA & Exports

Plan comptable, génération d'écritures, exports normés (FEC, ACD, Pennylane, Agiris), déclarations TVA et outils de reporting/trésorerie. Couvre pipelines d'export et attestations légales.

Outils d'administration & opérations

Ensemble d'outils et commandes pour administrateurs : migration de données, nettoyage, synchronisations externes, génération de statistiques et opérations white‑label. Utile pour maintenir la plateforme, corriger des données massives et préparer migrations.

Disponibilité, endpoints ping et limites opérationnelles

Article technique sur les endpoints de disponibilité (ping/health), bonnes pratiques de monitoring, gestion des erreurs liées à l'authentification et recommandations pour respecter les limites opérationnelles (ex. envoi de codes 2FA, expiration des tokens). Utile pour l'intégration et le diagnostic côté client/ops.

Aide intégrée, iframes d'aide et modification post‑setup

Utilisation d'iframes d'aide et de tests chargés dynamiquement pendant l'onboarding, affichage conditionnel de la progression, et procédure pour revenir modifier les informations d'organisation après l'initialisation.

Comptabilité, Fiscalité & Conformité

Plan comptable, écritures, exports légaux (FEC), TVA, URSSAF et intégration avec outils comptables. Regroupe aussi prévisions financières, budgets et tableaux de bord comptables.

Devis (gestion commerciale)

Créer, exporter et convertir des devis en factures, gérer les modèles et l'export CSV des devis. Utile pour formaliser les propositions commerciales et suivre leur transformation.

Catalogue, Stocks & Produits

Gestion du catalogue produits/services, tarification, stocks et mouvements d'inventaire pour alimenter la facturation et suivre les quantités et coûts.

Création et édition de devis et factures

Comment créer, modifier et préparer vos devis et factures : saisir destinataire, lignes, taxes, appliquer modèles et joindre pièces depuis l'éditeur. Guide pas à pas pour enregistrer et organiser vos documents.

Produits, Catalogue & Stocks

Gestion du catalogue produits/services, tarification, stocks, mouvements d'inventaire et lien avec les documents commerciaux. Conçu pour suivre disponibilité, entrées/sorties et impact sur la facturation.

Gestion des contacts & CRM

Créer, modifier, supprimer et fusionner les fiches contacts (organisations, personnes, établissements, relations). Permet de centraliser les clients/fournisseurs, gérer établissements et mandats, et nettoyer doublons.

Création et provisioning d'une App (tenant)

Procédure pas à pas pour créer une nouvelle app (tenant) et l'organisation associée, comprendre les opérations multi‑tenant déclenchées (DB, migrations) et estimer le temps requis pour le provisioning.

Création et import d'organisations

Guide pour créer une organisation soit manuellement, soit en important les données issues des résultats INSEE. Couvre l'ouverture du dialogue de création, le remplissage du formulaire et le processus d'importation d'un établissement trouvé.

CRM, Organisations & Contacts

Gestion des contacts, organisations, établissements, fiches clients/fournisseurs et opérations CRM (fusion de doublons, plannings). Conçu pour centraliser les interlocuteurs et leurs données.

Envoi et gestion des pièces jointes

Uploader, organiser et gérer les fichiers attachés aux documents commerciaux et transactions. Permet d'attacher justificatifs de dépenses, pièces pour clients et d'utiliser des images dans signatures.

Paiements & Abonnements

Gérer moyens de paiement, paiements clients, abonnements et intégrations Stripe/PayPal. Permet d’accepter des paiements et de suivre l’état des abonnements.

Conversion, duplication et gestion du cycle

Transformer un devis en facture, dupliquer ou clore des documents, relancer des clients et suivre l'historique lié. Explications sur les références générées et le verrouillage des lignes après conversion.

Contacts, CRM & Organisations

Gestion des tiers : clients, fournisseurs, personnes, établissements et leurs relations. Inclut recherche INSEE/VIES, fusion de doublons, fiches détaillées et saisie d'adresse pour alimenter les documents commerciaux.

Facturation & documents de vente (Devis / Factures)

Créer, éditer, finaliser, télécharger et envoyer devis et factures. Gère la génération PDF/FacturX, la conversion de devis en factures, les duplications et la numérotation automatique — essentiel pour suivre la facturation clients.

Lister et consulter le détail des Apps

Comment obtenir la liste des apps dont vous êtes responsable, lire et filtrer les métadonnées, et consulter la fiche détaillée d'une app (configuration, paramètres et accès).

Gestion des établissements

Procédures pour ajouter, éditer et maintenir les établissements d'une organisation : adresses, NIC, notes et contacts. Explique les interfaces d'édition (composant d'adresse, inputs inline), la recherche et la sélection d'établissements, ainsi que la suppression avec confirmation.

Produits, Catalogue & Stocks

Gestion du catalogue produits/services, stocks, mouvements d'inventaire et historique des flux. Inclut l'export CSV et actions en masse pour gérer de larges catalogues.

Paiements, mandats SEPA et prélèvements

Gérer les modes de paiement, générer des exports SEPA (virements/prélèvements), enregistrer les coordonnées bancaires et les mandats SEPA. Essentiel pour automatiser les paiements et respecter les besoins bancaires.

Intégrations, API & Développeurs

Webhooks, clés API, intégrations tierces (paiement, compta, services publics), outils développeurs et documentation API pour automatiser et connecter la plateforme.

Banque & Reconciliation

Synchroniser comptes bancaires, consulter relevés, rapprocher mouvements et créer règles automatiques. Indispensable pour tenir la comptabilité à jour et détecter écarts.

Envoi, pièces jointes et signature électronique

Envoyer devis et factures aux destinataires, ajouter pièces jointes et modèles, et gérer les demandes de signature électronique lorsque le service est activé. Processus d'envoi et bonnes pratiques.

Intégrations, API & Webhooks

Clés API, webhooks, intégrations partenaires (Bankin, Pennylane, Stripe, YouSign, ChorusPro, URSSAF, Google Sheets, Intercom, etc.), ainsi que outils et docs pour développeurs et automations externes.

Achats & gestion des dépenses

Gérer les achats et dépenses : création, suivi, attachement de pièces, OCR, prévisualisations et génération de PDF. Utile pour centraliser factures fournisseurs, récupérer données via OCR et alimenter la comptabilité.

Réinitialisation et opérations destructrices

Guide administrateur pour déclencher un reset d'app : quoi supprime, comment reseeder, étapes de validation et garde-fous. Règles d'accès et impacts (données et fichiers supprimés).

Coordonnées et facturation

Comment gérer et modifier les coordonnées de facturation (adresses, email, téléphone) utilisées par la facturation et la comptabilité. Inclut les validations de formulaire et contraintes d'unicité potentielle pour les contacts.

Plateforme, Intégrations & Outils

Fonctionnalités transverses : API, webhooks, intégrations, administration multi‑tenant, sécurité, UI components, monitoring et utilitaires développeur. Regroupe aussi la gestion des utilisateurs, rôles et opérations d'administration.

Banque — synchronisation, rapprochement et règles

Connecter et synchroniser comptes bancaires, importer relevés, créer règles automatiques et rapprocher mouvements bancaires avec factures/achats. Cela rationalise la tenue de la trésorerie et automatise la comptabilité.

Règles, validations et suppression sécurisée

Règles métier et validations spécifiques (ex. champs selon pays, codes INSEE) ainsi que le flux sécurisé de suppression d'un établissement — confirmation, conséquences et stratégie de remplacement si l'entité est référencée ailleurs.

Administration, Sécurité & Interface

Configuration globale, gestion des utilisateurs, permissions, multi‑tenant, whitelabel, onboarding, UI composants et outils d'exploitation et monitoring.

Achats & Fournisseurs

Saisir, éditer et suivre factures fournisseurs, saisir justificatifs et réconcilier paiements. Utile pour gérer dépenses et obligations fournisseurs.

Export, impressions et facturation récurrente

Exporter listings et documents (CSV, PDF), imprimer et générer éditions comptables, et configurer la facturation récurrente. Contient aussi les limitations liées aux offres payantes pour certaines fonctions avancées.

Administration, Sécurité & Plateforme

Administration multi‑tenant, gestion des utilisateurs, sécurité (auth, JWT, SSO, 2FA), monitoring, jobs, backups, paramètres, UI, utilitaires et outils pour développeurs/ops. Regroupe aussi onboarding et aides UX.

Gestion des pièces jointes & stockage de documents

Uploader, stocker, télécharger et partager des pièces jointes liées aux documents (factures, achats, transactions). Permet d'organiser les documents de preuve et de fournir des liens publics ou archives ZIP.

Surveillance des jobs et santé de l'app

Consulter l'état des jobs par app (backups, migrations, files), suivre la file et les logs, et tester la disponibilité en pingant l'URL de l'app.

Other

Additional features

Créer et modifier un contact

Guide pas à pas pour ajouter une personne ou modifier ses informations : formulaire de création, validation du téléphone international, liaison à une organisation/établissement et enregistrement. Comprend les bonnes pratiques pour saisir prénom/nom, numéro au format international et adresse.

Composer & personnaliser l'email d'envoi

Comment rédiger et personnaliser le message d'accompagnement : utiliser la signature, insérer modèles et variables, prévisualiser le contenu et choisir les pièces jointes par défaut avant envoi. Article autonome pour préparer un email professionnel et récurrent.

Rôles, permissions et bonnes pratiques

Règles d'accès, responsabilités (administrateur/partner), recommandations de sécurité et procédures opérationnelles pour gérer la création, le reset et la suppression d'apps en toute sécurité.

Banques & synchronisation bancaire (Bankin)

Connecter des comptes bancaires via Bankin, synchroniser les mouvements, et gérer les sources de flux (cashflow sources). Indispensable pour automatiser l'import des transactions bancaires et rapprocher la comptabilité.

Catalogue de produits et services

Gérer produits/services utilisés en facturation : création, édition, suppression, gestion des stocks et association aux lignes de facture. Permet la facturation précise et la traçabilité des articles.

Fiche contact détaillée (DialogShowContact)

Présentation de la fiche contact affichée dans un dialogue (DialogShowContact) : visualiser et modifier relations, rôles (client/fournisseur/prospect), tags et notes. Exemples d'actions inline pour modifier ou supprimer une relation depuis la fiche.

Exports comptables & Intégrations

Exporter écritures et documents au format requis par outils comptables (Agiris, ACD, Pennylane, FEC) et piloter transferts vers prestataires. Utile pour transmettre les données à un expert-comptable ou à un partenaire.

Envoyer un document individuel

Procédure pas-à-pas pour envoyer une facture, un devis ou tout autre document à un destinataire unique : ouvrir le document, sélectionner destinataire(s), joindre fichiers, demander éventuellement une signature électronique et lancer l'envoi. Inclut les bonnes pratiques et les limites techniques à connaître.

Transactions bancaires & gestion du cashflow

Consulter, créer, modifier, attacher des fichiers, tagger et supprimer des mouvements bancaires importés ou créés manuellement. Ces transactions servent de base au rapprochement bancaire et au reporting cashflow.

Créer et planifier des sauvegardes

Procédure pour générer des snapshots SQL compressés de la base World ou d'une app, configurer exclusions de tables, choisir le stockage (S3/local) et connaître l'impact I/O et temporel des sauvegardes.

Stocks & mouvements d'inventaire

Gérer les entrées/sorties de stock, retours, sorties temporaires et ajustements. Indispensable pour suivre les quantités et la valeur des produits en stock.

Fusion et recherche de doublons

Procédure pour identifier les doublons, rechercher et sélectionner le contact cible, et réaliser une fusion sécurisée. Règles obligatoires et confirmation requise pour choisir le contact à conserver, plus recommandations pour préserver les données critiques.

Prévision & Forecast

Construire et visualiser des prévisions financières (turnover, dépenses, trésorerie) avec graphiques et éléments prédictifs. Aide à la planification et au pilotage budgétaire.

Envoi groupé (batch) & règles d'accès

Guide pour préparer et lancer des envois en masse : sélectionner plusieurs documents, configurer destinataires (tags, emails manuels), autorisations nécessaires selon l'offre, options de personnalisation par lot et suivi des envois. Explication des restrictions et gestion des erreurs lors d'envois groupés.

Rapprochement & paiements

Créer et gérer les rapprochements entre mouvements bancaires et documents comptables (factures/achats) : créer paiements, annuler rapprochements et exécuter rapprochements batch ou automatiques. Cela automatise la comptabilité clients/fournisseurs.

Inventaire et consultation des sauvegardes

Comment accéder et parcourir l'index des sauvegardes stocké en MongoDB, filtres et métadonnées disponibles, et procédures pour retrouver rapidement un dump à restaurer ou télécharger.

Prévision & Budgets (Forecast)

Créer, suivre et éditer des prévisions financières (CA, dépenses, trésorerie) par période; gérer éléments de prévision et budgets par catégorie. Utile pour planifier la trésorerie et suivre les indicateurs clés.

Établissements, organisations et relations liées

Gestion des établissements et des contacts liés à une organisation : lier une personne à un établissement, naviguer entre fiches organisation/personne, et implications des rôles et tags sur l'affichage et les permissions au niveau de l'établissement.

TVA & Télé-déclaration

Préparer les déclarations de TVA (périodiques/annuelles), configurer paramètres Teledec et générer fichiers de télé-déclaration. Nécessaire pour respecter les obligations fiscales.

Gestion des pièces jointes & modèles

Tout ce qu'il faut savoir sur les fichiers attachés : types de fichiers supportés (images, PDF), limites de taille et formats, ajout/suppression dans le formulaire d'envoi, définition d'attachements par défaut et utilisation de modèles de pièces jointes.

Comptabilité générale & écritures

Générer les écritures comptables à partir des factures, achats et transactions, gérer plan comptable (comptes, catégories, employés) et produire des exports comptables normalisés. Fondamental pour produire journaux et exports légaux (FEC, ACD, Agiris…).

Restauration et reprise après incident

Guide pas à pas pour restaurer un backup vers la base World ou un tenant : sélection de la sauvegarde, prérequis admin, risques d'écrasement, et conseils pour minimiser l'impact pendant la restauration.

Comptabilité — Plan comptable, comptes et écritures

Gérer le plan comptable (comptes, catégories, employés liés), créer des comptes auxiliaires et générer des écritures comptables. Essentiel pour structurer la comptabilité et produire des exports légaux.

Création & édition de devis et factures

Créer et modifier des devis et factures : lignes, taxes, remises, modèles et duplicatas. Inclut la prévisualisation, la sélection de templates et les règles de suppression impactant les documents liés.

Exports comptables & intégrations d'éditeurs

Générer et transmettre des exports comptables vers des solutions tierces (ACD Compta, Pennylane, Agiris). Permet d'automatiser l'envoi des journaux comptables aux logiciels d'expertise/comptables.

Téléchargement et gestion des dumps

Instructions pour récupérer les fichiers de backup compressés (gz), les transférer depuis S3/local, les décompresser en .sql, et vérifier l'intégrité des dumps avant usage.

Catégories comptables & Budgets

Gérer les catégories comptables, fixer budgets et taux forfaitaires, et éditer pour la prévision et le reporting. Permet d'organiser les recettes/dépenses par familles et de suivre la performance budgétaire.

Pièces jointes et prévisualisation

Gérer les pièces justificatives attachées aux documents : upload, sélection d'attachement par défaut et visualisation détaillée (zoom, rotation).

Stocks & Catalogue produits

Gérer catalogue produits/services, niveaux de stock, mouvements d’entrée/sortie et retours. Utile pour les entreprises vendant des biens physiques pour suivre inventaire et coûts.

Forecast, charts & reporting financier

Produire prévisions de trésorerie, tableaux de bord et graphiques financiers : cashflow, transactions groupées, échéanciers factures/achats et éléments de forecast par catégorie. Aide à la planification et prise de décision.

Migrations multi‑tenant

Procédures et bonnes pratiques pour exécuter des migrations sur de multiples tenants. Couvre la préparation, l'exécution sécurisée (dry‑run quand disponible), le contrôle d'impact et le rollback. Rappels sur la planification hors production pour les grosses opérations.

Exports comptables & intégrations (FEC, Agiris, Pennylane, ACD)

Exporter les données comptables vers des formats et intégrations externes (FEC, Agiris, Pennylane), suivre le statut d'export et télécharger les fichiers. Nécessaire pour transmettre les données aux experts-comptables et outils externes.

Envoi par email et signature électronique

Envoyer devis et factures individuellement ou en masse, ajouter destinataires (y compris par tags), demander une signature électronique (YouSign) et valider les envois en tenant compte des droits et coûts éventuels.

Déclarations TVA & Teledec

Calculer les montants TVA pour une période et envoyer les déclarations via les services Teledec/Teledeclaration (ex: SAP/Teledec). Permet de produire les bases TVA et d'automatiser les déclarations fiscales.

Nettoyage et consolidation des données

Outils et commandes pour identifier et corriger doublons, nettoyer contacts, pièces jointes et autres ressources. Explique les stratégies de merge/consolidation, l'usage du mode dry‑run et les précautions avant exécution en production.

TVA & télé-déclarations (Teledec)

Préparer et télé-déclarer la TVA (périodicité mensuelle, trimestrielle, semestrielle ou annuelle) et configurer les paramètres Teledec. Indispensable pour remplir les obligations fiscales TVA.

Factures récurrentes et impayées

Consulter l'historique et les totaux des factures récurrentes, gérer les factures impayées via actions rapides (paiement, relance, ouverture de lien) et utiliser les modales dédiées pour sélectionner ou agir sur des factures récurrentes.

Paiements & modes de règlement (SEPA, PayPal, Stripe)

Gérer moyens de paiement et opérations (SEPA credit transfer, direct debit, PayPal, Stripe). Création de fichiers SEPA, gestion de mandats et intégration avec prestataires de paiement pour encaissements et prélèvements.

Clonage d'apps pour développement

Instructions pour lister et cloner des bases d'applications à usage développement ou test. Inclut la commande copy_app, configuration locale, et recommandations pour anonymiser/masquer les données sensibles dans les copies.

URSSAF — préparation et envoi

Étapes d'interfaçage avec URSSAF pour la gestion de certains paiements et déclarations spécifiques; validation des erreurs éventuelles et préparation des données des prestations. Utile pour la conformité sociale et la gestion des déclarations.

Édition avancée des lignes & actions rapides

Édition en masse ou inline des comptes et allocations par ligne de vente, dialogues d'édition massifs, menus d'actions contextuels et application de modifications globales.

Modèles & Templates d’édition

Choisir et personnaliser templates d’impression pour devis/factures. Permet d’adapter l’apparence des documents à l’image de l’entreprise.

Abonnements & facturation récurrente (Stripe)

Gérer les plans, sessions de paiement, méthodes de paiement et abonnements via Stripe : checkout, ajout/suppression de sources, application de coupons et gestion des essais. Permet aux clients d'acheter/adapter leur licence.

Synchronisations externes

Guides pour synchroniser les clients et données avec des services externes (ex. Stripe, Intercom). Décrit les workflows de synchronisation, gestion des erreurs, idempotence et conseils pour tester en environnement isolé.

Créer et modifier des devis

Guide pas à pas pour créer un devis depuis le menu Catalogue/Devis, remplir les informations client, lignes et conditions, gérer les modèles et modifier des devis existants. Inclut les bonnes pratiques pour structurer prix et remises, joindre fichiers lors de la création, et sauvegarder les versions.

Paramètres et configuration de facturation

Configurer les paramètres globaux d'invoicing et comptabilité : modèles de documents, numérotation, comptes par défaut, journaux, et autres options. Indispensable pour adapter le logiciel aux règles internes et obligations légales.

Partenaires white‑label et statistiques d'app

Création et gestion de partenaires white‑label ainsi que génération de statistiques d'utilisation par application. Contient la commande interactive de création de partner, droits nécessaires, et méthodes pour extraire rapports d'utilisation par app.

Paramètres & Configuration

Configurer les paramètres globaux de l’application : comptabilité, facturation, paramètres d’export et modules tiers. Permet d’adapter l’application aux besoins juridiques et opérationnels.

Gestion des partenaires & whitelabel

Gérer les partenaires commerciaux, leurs apps associées, collaborateurs et licences en mode white‑label. Permet aux partenaires d'administrer leurs clients, d'obtenir API keys et de piloter abonnements.

Tableaux et filtrage (DataTable)

Composant serveur-driven pour afficher des tableaux de données avec tri, filtres, pagination et colonnes configurables. Permet aux utilisateurs de naviguer, trier et filtrer efficacement des listes de documents, comptes ou transactions.

Convertir un devis en facture et suivi

Procédure pour convertir un devis accepté en facture, lier les documents et suivre l'historique. Expose la traçabilité créée par la conversion, comment visualiser les factures associées et les relations entre devis et factures, et le flux recommandé après acceptation d'une offre.

Recherche & Tableaux de données

Filtrer, trier et paginer listes (documents, comptes, contacts) via une DataTable serveur-driven avec filtres avancés. Facilite la navigation et l’analyse de grands jeux de données.

Collaborateurs & accès support

Inviter et gérer collaborateurs (internes ou partenaires) avec profils d'accès et politiques d'app. Permet d'ajouter du support, déléguer des droits et accepter des invitations.

Créer et gérer les fiches Organisations et Personnes

Créer, modifier, soft‑supprimer et restaurer les fiches Organisations et Personnes. Inclut la création par national_id avec réutilisation de fiches existantes pour éviter les doublons et les bonnes pratiques d'édition.

Modales, confirmations et notifications

Interface de dialogues modaux, confirmations et toasts pour les interactions critiques (suppression, envoi, erreurs). Garanti la prévention d'actions irréversibles et fournit un feedback utilisateur immédiat.

Importer des documents pour créer des devis

Explication de l'import de documents (PDF, JPG) pour créer ou alimenter des devis : formats acceptés, étapes d'import, qualité des pièces jointes et intégration dans un devis existant. Mentionne les limitations et actions avancées qui peuvent être réservées aux plans premium.

Pièces jointes & Visualisation de documents

Uploader, afficher et manipuler pièces jointes (PDF, images), faire des rotations/aperçus et attacher justificatifs aux transactions/documents. Permet de conserver la preuve des opérations.

Invitations & politiques d'accès (User Policies)

Inviter des utilisateurs à rejoindre une app avec un profil d'accès (policy), gérer invitations, accepter et attribuer rôles. Permet de contrôler qui accède à quel tenant et avec quels droits.

Gestion des établissements et contacts associés

Gérer les établissements liés aux organisations et personnes, associer/dissocier des contacts, et maintenir la hiérarchie des entités (sièges, succursales, mandats liés aux établissements).

Éditeurs inline & popovers (modification rapide)

Composants d'édition inline et popovers pour modifier rapidement des champs (nom, email, montant, catégories, sélecteurs). Améliore la productivité en évitant d'ouvrir des formulaires complets.

Export, impression et CSV des devis

Comment exporter et imprimer des devis : exporter la liste au format CSV, configurer les colonnes, gérer l'export paginé et messages de progression, et utiliser le menu d'actions pour imprimer ou télécharger. Indique les particularités des exports avancés et restrictions selon le plan.

Règles de rapprochement bancaire

Créer et éditer règles automatiques qui associent les mouvements bancaires à des comptes/documents selon conditions (libellé, montant, regex). Permet d’automatiser le rapprochement et réduire le travail manuel.

API Keys & intégrations partenaires

Gérer clés API et installer/synchroniser des intégrations partenaires. Permet exposer l'API de l'application à des tiers ou connecter des partenaires pour automatisations.

Fusion et nettoyage des doublons

Identifier et fusionner plusieurs contacts en un contact principal, transférer historiques et propriété de documents (invoices, transactions, etc.), et supprimer massivement des contacts avec contrôles d'autorisation.

Recherche & Typeahead

Composants d'autocomplétion (typeahead) pour rechercher rapidement contacts, comptes, produits et autres ressources. Utile pour accélérer la saisie et réduire les erreurs de correspondance.

Téléversement et limites

Procédure d'ajout de fichiers aux documents et transactions : drag&drop ou bouton, retours utilisateur et contraintes (types, taille, quota). Explique les appels API déclenchés par les uploads et la gestion des toasts/feedback.

Achats - Upload justificatifs depuis transactions

Associer rapidement un justificatif d’achat (facture fournisseur) à une transaction bancaire via un uploader intégré. Simplifie le rapprochement et la tenue des pièces justificatives.

Envoi d'emails & gestion des envois de documents

Envoyer des factures/devis par email, en batch ou individuellement, avec possibilité de demande de signature, attachement du PDF ou lien de paiement. Comprend protections anti‑flood et limites selon plan.

Relations entre contacts et mandats SEPA

Gérer les relations (liens, rôles, mandats) entre contacts et consulter/générer des mandats SEPA pour un contact. Inclut création, consultation et stockage des mandats SEPA liés aux fiches.

Stockage d'images et aperçu (Rotation/Preview)

Visualiser et manipuler visuellement les images et PDF attachés (rotation, zoom) pour garantir la lisibilité des justificatifs et documents envoyés.

Organisation et gestion des pièces jointes

Comment visualiser, organiser et définir la pièce jointe par défaut pour l'envoi, ainsi que supprimer ou gérer plusieurs pièces jointes (avec confirmations et règles de conservation).

Modales, confirmations & Notifications

Système global de dialogues, confirmations et toasts pour interactions de l’utilisateur (confirmer suppression, afficher erreurs/succès). Garantit une expérience utilisateur cohérente et sécurisée.

Signature électronique (YouSign / Yousign)

Demander des signatures électroniques sur devis/factures via intégrations (YouSign / Yousign), générer liens de signature et traiter les webhooks de statut/signature. Permet de formaliser acceptations clients directement en ligne.

Création et gestion des documents

Guide pratique pour créer, modifier, supprimer et dupliquer devis et factures en mode brouillon. Comprend les champs essentiels (client, lignes, taxes) et bonnes pratiques pour préparer un document avant finalisation.

Paramètres utilisateur & profils

Gérer les profils utilisateurs, images de profil, employés liés et accès. Permet d'administrer les comptes utilisateurs et leurs attributs visibles.

Prévisualisation et édition d'images/PDF

Outils de prévisualisation intégrés : visualiser les images et PDF, faire des rotations, zoomer et parcourir les pages pour vérifier les justificatifs avant envoi.

Import / Export CSV & Catalogue

Importer et exporter listes (produits, contacts, factures) au format CSV pour intégration ou archivage. Permet des migrations de données et traitements externes.

Catalogue produits & gestion des stocks

Gérer produits et services utilisés dans la facturation, suivre les stocks et mouvements (entrées, sorties, retours). Utile pour les entreprises vendant des marchandises et souhaitant un suivi des flux de stock.

Finalisation, numérotation et conformité

Procédure de finalisation des factures : vérifications, attribution du numéro et du statut final. Explique la logique centrale de numérotation (nextnumber), la génération atomique pour éviter les collisions et les règles légales sur les factures finalisées.

Demandes hors-cycle : kilométrage et frais

Saisie et gestion des indemnités kilométriques et frais (création, duplication, envoi). Permet d’enregistrer et rembourser les frais de mission et de déplacement.

Insertion d'images dans les signatures

Guide pour intégrer des images issues des pièces jointes dans l'éditeur de signature : sélection, insertion et contraintes (format/taille) spécifiques aux signatures email.

Produits & Tarification

Gérer fiches produits/services, prix, taux de TVA et liaisons comptables. Permet d’alimenter rapidement lignes de factures et calculer totaux correctement.

Conversion devis → facture et gestion des acomptes

Transformer un devis en facture (y compris gestion de situations et acomptes), gérer les liaisons entre documents et consulter l'historique des relations (downpayments, avoirs, etc.).

Templates & personnalisation des documents

Gérer modèles d'impression (templates) pour factures et devis : lister templates disponibles, créer des templates par défaut et personnaliser l'apparence des documents générés.

Rapports & Soldes tiers

Consulter rapports (soldes clients/fournisseurs), états tiers et balances pour suivre situations individuelles. Aide à la relance et au contrôle des encours.

Coordonnées bancaires (IBAN / BIC)

Ajouter, modifier et valider les coordonnées bancaires des comptes (IBAN, BIC et champs associés). Explique le dialogue d’édition, la vérification côté formulaire et les bonnes pratiques pour maintenir des coordonnées conformes.

Tags & taxonomie pour reporting

Gérer et récupérer les tags utilisés sur documents, produits et relations pour faciliter le filtrage, le reporting et l'analyse.

Export, envoi et signature

Tout sur l'export (PDF, ZIP, FacturX), la génération d'aperçus JPEG pour signature (YouSign), l'envoi par email (simple et batch) et le téléchargement multiple. Comprend les règles d'envoi (anti‑flood, limites du plan) et le flux asynchrone de génération de fichiers.

Règles bancaires (automatisation de catégorisation)

Créer des règles qui associent automatiquement des transactions bancaires à des comptes ou catégories selon conditions (libellé, montant, etc.). Permet d’automatiser le rapprochement et la catégorisation.

Gérer les mandats SEPA

Créer, enregistrer et supprimer des mandats SEPA depuis la fiche contact. Couvre le flux de création, l’archivage, la suppression (confirmation requise) et les règles d’accès ou limitations (autorisations / fonctionnalités premium).

Onboarding Multilingue & Internationalisation

Interface disponible en français et anglais avec messages localisés (erreurs banques, URSSAF, Teledec). Permet d’utiliser l’application dans plusieurs langues et d’afficher messages adaptés.

Templates d'export & rapports partenaires (Exports Partners)

Générer des exports hebdomadaires ou périodiques destinés aux partenaires (Google Sheets ou fichiers), agréger métriques par tenant et écrire des feuilles ou générer des fichiers pour partenaires.

Gestion des achats

Créer, mettre à jour, supprimer et dupliquer des achats. Gérer les statuts, rechercher les derniers achats par employé et comprendre les contraintes d'autorisation liées au statut de l'achat ou à l'abonnement (ex. suppression globale restreinte).

Génération et export SEPA (virements & prélèvements)

Sélectionner factures/achats, configurer les paramètres obligatoires (batch booking, date limite, etc.) et générer les fichiers XML SEPA prêts à télécharger et à importer dans la banque. Inclut exigences, options et erreurs fréquentes à vérifier avant export.

Gestion des employés & collaborateurs

Ajouter et gérer employés pour la comptabilité (salaires, notes de frais) et saisir imputations sur comptes. Pratique pour intégrer les ressources humaines aux flux comptables.

Abonnements & offres (plans)

Afficher les offres, gérer la souscription, résiliation et affichage des options premium. Permet aux utilisateurs de choisir le bon plan et d'effectuer des changements d'abonnement.

OpenAI: aide comptable & reformulation

Fonctionnalités assistées par OpenAI pour suggérer comptes comptables depuis une description, estimer facturation (billing estimate) ou reformuler/rectifier du texte. Utile pour accélérer saisie et améliorer qualité des libellés.

Pièces jointes et gestion des fichiers

Attacher et détacher fichiers (factures fournisseurs), gérer le stockage et les téléchargements (origine, ZIP), et bonnes pratiques pour l'upload d'images/PDF. Inclut instructions pour récupérer les originaux et créer des archives téléchargeables.

Formulaire de prélèvement SEPA

Remplir et valider un formulaire SEPA (montant, IBAN, BIC, échéance, type de mandat). Détaille chaque champ, contrôles de validation côté client, comportements attendus et rétroactions utilisateur pour saisies invalides.

OCR et extraction de données

Lancer l'OCR sur une pièce jointe pour extraire automatiquement les données (fournisseur, montants, dates, lignes). Détail des jobs asynchrones (OCRPurchase), gestion des filesystems/S3, état du traitement et bonnes pratiques en cas d'échec.

Chorus Pro (envoi de factures au secteur public)

Envoyer des factures électroniques via Chorus Pro pour les destinataires publics et récupérer la structure de facturation. Utile pour les entreprises qui facturent les entités publiques en France.

Onboarding bancaire & Bridge (synchronisation)

Processus d’ajout/synchronisation bancaire via connecteurs (bridge) avec gestion des erreurs/OTP. Permet de récupérer automatiquement les mouvements et faciliter le rapprochement.

Export CSV paginé (exports volumineux)

Exporter des listes (ex. lignes de factures) en CSV paginé, avec feedback et indicateurs de progression. Pratique pour récupérer des volumes importants de données consommables par tableur.

Dépannage et messages d'erreur SEPA

Référentiel des erreurs courantes liées aux coordonnées bancaires, mandats et exports SEPA, avec causes probables et actions correctives. Inclut gestion des permissions, vérifications d’IBAN/BIC et étapes après échec d’import banque.

Timetable & Planning

Afficher plannings et horaires liés aux contacts ou tâches (timetable) avec détails et édition inline. Utile pour organiser rendez-vous et échéances.

URSSAF – paiment tiers & interactions

Préparer et envoyer paiements à URSSAF, enregistrer clients auprès du service URSSAF et récupérer statuts de paiement. Permet d'automatiser les obligations sociales envers URSSAF.

Aperçus, miniatures et génération de PDF

Générer des aperçus (preview/thumbnail) et PDFs à partir des pièces jointes ou de l'achat lui‑même. Expliquer le job de génération d'aperçu, la fréquence, les erreurs possibles et comment invalider/regénérer les previews.

Administration des paramètres comptables avancés

Paramétrage avancé (journaux, codes, périodes de clôture, comptes collectifs) pour adapter l’application aux besoins de l'expert-comptable et du plan comptable de l'entreprise.

Kilométrage & Frais de déplacement

Saisie et gestion des indemnités kilométriques et frais de déplacement, avec calcul automatique et gestion des tags. Aide à rembourser correctement les collaborateurs.

Synchronisation des comptes bancaires

Comment connecter et maintenir la connexion avec vos comptes bancaires : démarrer une synchronisation depuis l'espace Banque, gérer les erreurs d'identifiants ou de blocage, traiter les demandes d'authentification forte (OTP) et relancer la synchronisation.

Factures fournisseurs – collecte & réception (Admin Purchase Collector)

Permettre une ingestion centralisée de factures fournisseurs (push) via endpoint administrateur ou collecteurs, en validant la clé et stockant le fichier dans l'app correspondante. Utile pour automatiser import fournisseur.

Ventilation des charges et intégration comptable

Mettre à jour la ventilation (breakdown) des charges, affecter lignes aux comptes et préparer l'export/flux vers la comptabilité. Conseils pour harmoniser les sorties OCR avec la ventilation manuelle et règles d'autorisation liées aux statuts.

Demandes d'actions groupées (envoyer en masse, remplacer comptes)

Actions massives comme l'envoi multiple de factures, le remplacement d'un compte comptable dans tout le système et l'export en masse. Permet d'exécuter des opérations globales en une seule fois.

Importer et attacher des justificatifs

Guide pour consulter les transactions importées, uploader des justificatifs ou des justificatifs d'achats sur des mouvements bancaires et organiser les pièces jointes pour la tenue de la trésorerie.

Aides & Intégrations administratives (ChorusPro, Teledec)

Intégrations avec services administratifs tels que ChorusPro et Teledec pour récupérer informations de facturation publique et envoyer déclarations. Facilite la conformité vis-à-vis des organismes publics.

PDF & FacturX generation (Rainer)

Générer les PDF (et FacturX XML) des documents de vente (factures, devis) via le service Rainer et stocker les fichiers/aperçus. Permet de produire documents conformes et exportables.

Uploader et associer des pièces jointes

Procédure complète pour ajouter un fichier, le stocker et lier la pièce jointe à un objet métier (facture, achat, transaction). Inclut validations côté client/serveur et bonnes pratiques pour métadonnées et relations.

Support d'export / intégration tierce (ChorusPro, Teledec, Pennylane)

Interfaces pour connecter et envoyer des données vers des services externes (ChorusPro pour marchés publics, Pennylane pour experts-comptables), avec redirections et webhooks. Facilite l'échange sécurisé et standardisé de documents.

Règles d'appariement automatique

Créer, modifier et gérer l'ordre d'évaluation des règles automatiques pour apparier mouvements bancaires avec factures/achats. Explications sur le fonctionnement de l'éditeur de règles et sur les impacts des modifications.

Permissions & Premium Features

Gestion d’accès selon permissions et verrouillage de certaines fonctionnalités au statut premium. Permet de contrôler l’accès aux fonctions sensibles et de monétiser des modules avancés.

Webhooks & intégrations entrantes

Recevoir et traiter webhooks externes (Stripe, Yousign, Teledec, Teledec, PayPal) pour mettre à jour commandes, abonnements, paiements et pièces jointes automatiquement. Permet la synchronisation temps réel avec prestataires.

Télécharger une pièce jointe

Explication des mécanismes de téléchargement individuel : téléchargement direct depuis l'application ou redirection vers une URL publique gérée par le service de stockage. Inclut gestion des en-têtes, expirations et permissions.

Sécurité, authentification et autorisations

Gérer accès utilisateur, actions basées sur rôles/politiques et protections pour opérations sensibles. Assure que seules les personnes autorisées effectuent des actions spécifiques.

Rapprochement et génération d'écritures

Processus de réconciliation : sélectionner des mouvements à rapprocher, ouvrir le panneau de réconciliation, choisir ou créer le compte/de la dépense, soumettre la réconciliation et confirmer la création d'achats ou l'affectation comptable. Comprend la génération automatique d'écritures et les actions de création en masse.

Historique & Activités

Consulter l’historique d’événements (créations, modifications) et journaux d’activités liés aux objets principaux. Utile pour audit, suivi des modifications et traçabilité.

Recherche & opérations CRUD génériques

Fonctions génériques de listing, filtrage, recherche globale et actions CRUD pour de nombreux modèles via un contrôleur ResourceController et un moteur de recherche/constructeur de requêtes. Facilite l'implémentation uniforme des pages de listing et édition.

Téléchargement groupé (ZIP)

Guide pour sélectionner plusieurs pièces jointes et générer une archive ZIP côté serveur. Détails sur la préparation de l'archive, gestion des performances, limites de taille et liens de téléchargement temporaires.

Tableau de bord & reporting

Affichage d'un tableau de bord avec vues d'ensemble (cashflow, KPI, graphiques) et navigation vers modules clés. Utile pour obtenir un aperçu rapide de la santé financière.

Paramètres de notification & Tracking

Afficher messages toasts et tracer actions (GTM, Sentry). Permet d’informer l’utilisateur et collecter des événements pour analyse et debug.

Créer et modifier achats & factures

Guide pour créer, éditer et dupliquer des achats et factures fournisseurs. Explique comment remplir les lignes d'achat (fournisseur, compte, montant), dupliquer des frais récurrents (indemnités kilométriques, etc.) et utiliser l'éditeur de purchase intégré en modal pour des modifications rapides.

Notifications & synchronisation Intercom

Envoyer et synchroniser des informations d'apps/utilisateurs vers Intercom pour support, onboarding ou suivi client. Utile pour que l'équipe support ait contexte sur apps et incidents.

Liens publics et redirections

Documentation sur la génération de liens publics, redirections via services de stockage (S3, CDN), configuration des permissions et TTL des URLs signées. Comprend modèles d'URL, sécurité et meilleures pratiques pour partage externe.

Onboarding (installation guidée)

Un assistant pas à pas pour configurer votre espace : informations légales (SIREN/SIRET), adresse, comptes comptables, RIB, connexion bancaire et préférences. Utile pour démarrer rapidement et garantir que l'application est prête pour la gestion comptable et la facturation.

Joindre et gérer justificatifs

Procédure pour uploader, attacher et supprimer des pièces justificatives liées à une transaction ou un achat. Détaille les formats et tailles autorisés, la liaison des justificatifs aux achats et la gestion des documents associés.

Gestion des offres & Abonnements

Afficher plans tarifaires, options d’abonnement et permettre la résiliation. Utile pour gérer l’accès aux fonctionnalités selon plan et pour la facturation récurrente d’abonnement.

Gestion des modèles financiers & usines d'écritures

Fournit les usines (factories) qui construisent les écritures comptables à partir des transactions, factures et achats (SalesEntryFactory, PurchaseEntryFactory, TransactionEntryFactory). Utile côté utilisateur indirectement via génération fiable d'écritures.

Règles, limites et suppression de pièces jointes

Règles de gouvernance : contraintes de taille/type imposées par la configuration de stockage, politique de conservation, et processus de suppression (vérifications de dépendances, audit, suppression physique vs marquage).

Tableau de bord & Statistiques

Vues et cartes interactives présentant KPIs financiers : trésorerie, chiffre d'affaires, dépenses et graphiques. Permet de surveiller la santé financière, identifier tendances et anomalies en un coup d'œil.

Automatisation et rapprochement bancaire

Explications sur l'automatisation de la comptabilisation des achats et sur le lancement du rapprochement bancaire. Comprend l'aide à la création d'achats depuis un relevé et les règles d'automatisation pour accélérer le traitement des dépenses.

Connexion & configuration initiale (Bankin)

Guide pas-à-pas pour connecter une banque via Bankin, obtenir l'URL de connexion et compléter le funnel OAuth. Inclut la sélection des comptes à synchroniser et les vérifications d'accès nécessaires avant d'activer la synchronisation.

Recherche INSEE & données publiques

Rechercher et importer données publiques (entreprises, établissements) via INSEE/OpenData pour pré-remplir les informations d’organisation. Accélère l’entrée d’informations et améliore la qualité des données.

Création d'organisations publiques & enrichissement (Open Data / VIES)

Créer des fiches d'organisation publiques enrichies automatiquement depuis sources externes (VIES, INSEE, OpenDataSoft) et calculer numéro TVA à partir du SIREN. Facilite la saisie d'informations clients/fournisseurs.

Prévisions financières (Forecast)

Visualiser et parcourir des prévisions (turnover, dépenses, cashflow) par période pour anticiper la trésorerie et planifier budgets. Pratique pour prendre des décisions financières proactives.

Suppression, liens et contraintes

Bonnes pratiques et règles pour supprimer un achat ou un document : confirmation requise, vérification des dépendances et cas où la suppression est bloquée parce que l'achat est lié à d'autres opérations.

Édition & Prévisualisation imprimée

Gérer le template et la génération de la version imprimée/PDF des documents commerciaux (mise en page, mentions légales). Permet d’avoir des documents professionnels conformes et brandés.

Paramètres & configuration d'app

Gérer paramètres spécifiques d'une app (templates, intégrations Pennylane, settings Teledec, whitelabel override). Utile pour personnaliser comportement et intégrations d'un tenant.

Synchronisation & traitement des mouvements

Comment démarrer et surveiller les synchronisations Bankin (manuelles ou planifiées), le rôle du job BankinSynchronization, et l'impact sur le système comptable (création de transactions, lancement d'AutoReconcile).

Aide contextuelle & Infobulles

Bulles d'aide et popovers fournissant explications et guides sur les éléments d'interface. Utile pour accompagner l'utilisateur et contextualiser les champs complexes.

Gestion du catalogue

Vue d'ensemble et opérations CRUD sur les produits et services utilisés en facturation : accéder au gestionnaire, créer, éditer, supprimer et assurer la traçabilité des articles liés aux documents.

Sécurité & Authentification

Gestion de l’authentification des utilisateurs, mots de passe et permissions. Garantit l’accès sécurisé aux fonctions selon rôle.

Sécurité, middleware & contrôle d'accès

Mécanismes transverses de sécurité : middleware qui valident l'appId, contrôlent les policies, authentifient via Api-Key ou JWT, appliquent whitelabel et sanitisation XSS. Vital pour protéger les endpoints et appliquer autorisations.

Inventaire des comptes et sources de cashflow

Page dédiée à la visualisation et la gestion des comptes bancaires et des cashflow sources connectés : vérification des liaisons actives, mappage des comptes et choix des sources à inclure dans les imports automatiques.

Création et édition (DialogProduct)

Procédure pas-à-pas pour ajouter ou modifier un produit via le dialogue produit : champs requis (nom, prix, TVA, compte comptable), validations et bonnes pratiques de sauvegarde.

Recherche d’adresse & Autocomplétion

Saisie d’adresse avec autocomplétion (Google/address picker) et normalisation des champs. Facilite la saisie d’adresses précises pour établissements et facturation.

Administration des logs & monitoring des jobs

Consulter et gérer l'état des jobs artisan/queue, lister les jobs en cours pour une app, inspecter logs et statistiques d'apps. Aide à diagnostiquer et suivre le traitement asynchrone.

Navigation & menus

Navigation principale de l'application : menus d'applications, sidebar, barre mobile, menu utilisateur et sélecteur de langue pour accéder rapidement aux sections. Améliore l'accès et l'ergonomie multi-plateforme.

Édition, désactivation et suppression (opérations destructrices)

Procédures pour éditer une connexion Bankin (url_edit), désactiver l'accès ou supprimer une liaison. Expose les options de suppression en cascade (transactions, paiements, écritures comptables), précautions et conséquences irréversibles.

Clients & Contacts (CRM)

Gestion des contacts et organisations clients/fournisseurs : création, édition, profils, relations et fusion de doublons. Permet de centraliser les interlocuteurs commerciaux et faciliter la facturation/réconciliation.

Comptabilité et comptes produits

Règles et configuration du lien produit → compte comptable : comment associer un compte, exigences pour la comptabilisation automatique et impacts lors de la suppression ou modification d’un produit.

Onboarding (configuration guidée)

Un assistant pas à pas qui guide la mise en place initiale de l'espace : informations légales (SIREN/SIRET), adresse, comptes comptables, banques, modèles et options de facturation. Utile pour démarrer rapidement et garantir que l'application est pré-configurée conformément aux règles comptables et aux attentes du comptable.

Sécurité & gestion SSO pour partenaires

Fournir SSO pour partenaires, mise à jour des clés SSO et flux d'authentification partenaires. Permet d'intégrer des partenaires via single sign‑on et whitelabel.

Explorer les transactions et statistiques

Vue principale pour parcourir les mouvements bancaires importés ou créés manuellement, filtrer et trier les résultats, et consulter les statistiques agrégées liées au cashflow. Expose les implications de la pagination et du coût des calculs pour les grands volumes.

Importer / Exporter le catalogue (CSV)

Importer et exporter le catalogue au format CSV depuis le menu déroulant : format attendu, gestion des erreurs, limitations et conditions (ex. restriction aux comptes premium).

Tableau de bord & Analytique (Graphiques et prévisions)

Visualise les indicateurs financiers clés (CA, dépenses, cashflow), tableaux et prévisions avec navigation par période. Permet d'avoir une vue synthétique de la santé financière et d'accéder rapidement aux actions (p.ex. connecter une banque).

Créer, modifier et supprimer une transaction

Procédures pas-à-pas pour créer une transaction (date, montant, compte → sauvegarder), éditer les champs autorisés d'une transaction existante et supprimer une transaction en gérant les breakdowns et paiements associés. Détails sur les règles d'édition pour les transactions synchronisées depuis Bankin.

Gestion des modèles & transfos API (Transformers)

Composants qui transforment les modèles Eloquent en payloads API (Fractal Transformers). Ils définissent les structures retournées côté client et contrôlent les inclusions liées (auteur, client, balance, contenus).

Stocks et historique des mouvements

Afficher et gérer les quantités : consultation de l'historique de stock et des mouvements associés, modification des quantités liées à un produit et impact sur la facturation.

Gestion des achats (Achats / Factures fournisseurs)

Créer, éditer et suivre les factures d'achat (notes de frais, achats). Permet une saisie détaillée des lignes, comptes comptables, taxes et gestion des pièces jointes pour la justification comptable.

Facturation (devis & factures)

Créer, éditer, numéroter, convertir et envoyer des devis et factures. Permet de générer les PDF/FacturX, suivre le statut (brouillon, validé, payé), appliquer conditions de paiement et visualiser l'historique pour le client.

Gérer les pièces jointes

Comment attacher et détacher des fichiers justificatifs aux mouvements : types de fichiers supportés, upload, association à une transaction, et bonnes pratiques pour le stockage et la traçabilité.

Achats & dépenses

Importer et gérer les factures fournisseurs, les pièces jointes et la répartition comptable, avec OCR pour extraire les données automatiquement. Utile pour réduire la saisie manuelle et préparer les écritures comptables.

Achats & Notes de frais (Purchases)

Créer, éditer et gérer les factures fournisseurs et notes de frais avec ligne de ventilation, pièces jointes et export CSV. Permet suivre les dépenses et préparer les écritures comptables.

Entrées de stock

Créer et gérer les arrivées en stock : saisir quantités, coûts et dates (y compris dates de péremption) et valider les règles de date et de prix.

Vignettes & pièces jointes (Miniatures et aperçu)

Visualiser, faire pivoter et supprimer les miniatures des pièces justificatives attachées aux achats ou documents. Utile pour vérifier rapidement les scans/photos sans ouvrir un viewer complet.

Tagger et organiser les transactions

Utiliser les tags pour catégoriser les transactions et améliorer le reporting cashflow. Instructions pour ajouter ou retirer des étiquettes, impacts sur les recherches et exports, et workflow de sauvegarde des modifications de tags.

Galerie de pièces jointes & aperçu

Prévisualiser, faire pivoter et supprimer les images/PDF joints aux documents d'achat. Facilite la vérification des justificatifs et l'archivage.

Retraits et sorties

Retirer des quantités pour consommation, casse, transfert : motifs, notes et validations de disponibilité avant sortie.

Rapprochement bancaire (Reconciliation)

Associer automatiquement ou manuellement les mouvements bancaires à des ventes/achats via sélection, combinaisons et règles. Permet d'automatiser la justification des mouvements et d'identifier les doublons ou correspondances manquantes.

Comptabilité & exports d'écritures

Générer les écritures comptables à partir de ventes, achats et mouvements bancaires, et exporter ces écritures vers des formats réglementaires ou des services externes (FEC, ACD, Pennylane, Agiris). Indispensable pour la tenue comptable et les déclarations.

Rapprochement manuel et création de paiements

Procédure pas à pas pour rapprocher une transaction bancaire avec une facture ou un achat, fournir montant/date/compte et créer le paiement lié. Explique les conséquences comptables (enregistrements Payment, mise à jour des breakdowns et écritures).

Banque & Cashflow

Connexion de comptes bancaires, visualisation des flux de trésorerie, gestion des sources de cashflow et paramètres Bankin. Permet automatiser le rapprochement et suivre la trésorerie en temps réel.

Retours & sorties temporaires

Gérer les retours fournisseurs/clients et les sorties temporaires (prêts, locations) avec règles de quantité et dates de retour.

Moteur de règles bancaires

Créer, éditer et appliquer des règles automatiques qui catégorisent ou rapprochent automatiquement des transactions bancaires selon des conditions. Permet d'automatiser la justification et accélérer le traitement comptable.

Banques & rapprochement

Connecter des comptes bancaires (Bankin), synchroniser les mouvements, afficher les soldes et lancer des rapprochements automatiques. Facilite la réconciliation des paiements et le suivi de trésorerie.

Annuler une réconciliation (Unreconcile)

Étapes pour annuler une réconciliation : identifier le paiement/transaction lié, exécuter l'action d'unreconcile et restaurer l'état des breakdowns et écritures. Précautions et impacts comptables.

Historique des mouvements

Consulter l'historique des mouvements par produit pour tracer entrées, sorties, retours et sorties temporaires avec détails et dates.

Gestion de la facturation (Factures, Devis, Envoi)

Créer, visualiser, éditer et envoyer factures et devis. Gère les envois en masse, éditions par lot, règles de statut et exportations liées à la facturation.

Paiements & intégration Stripe

Gérer les paiements, rapports Stripe et réconciliation automatique des encaissements. Permet recevoir webhooks Stripe, importer factures Stripe et enregistrer paiements/payouts.

Traitements batch de rapprochement

Comment soumettre et gérer des rapprochements en masse via l'endpoint batch : format d'appel, ordonnancement, gestion des erreurs et bonnes pratiques pour la séquence de reconcilations. Inclut la gestion en background pour opérations longues.

Règles de rapprochement (Rules)

Définir et appliquer des règles automatiques pour relier des transactions bancaires à des comptes ou documents selon des critères (libellé, opérateur, conditions). Cela accélère le traitement et réduit le travail manuel.

Tableau de bord Forecast

Vue d'ensemble des prévisions : graphiques interactifs, KPIs et sélection de période. Permet d'analyser le CA, les dépenses et la trésorerie sur différentes granularités et de recalculer les séries.

Produits & stocks

Gérer catalogue produits, catégories, entrées/sorties de stock et mouvements associés aux ventes. Utile pour le suivi des quantités, la traçabilité et l'impact sur les factures.

Rapprochement automatique et gestion des journaux

Démarrer et surveiller l'AutoReconcile pour une application : mécanisme de démarrage, comportement des jobs automatiques, heuristiques utilisées (même date, même contact, combinaisons de montants) et limites pour éviter les timeouts. Guide pour visualiser et nettoyer les journaux de réconciliation automatique.

Export comptable & Intégrations (Agiris / ACD / Pennylane / Pennylane OAuth)

Exporter les données comptables vers des formats ou des outils partenaires (Agiris, ACD, Pennylane) et gérer le flux OAuth/jetons nécessaires. Permet livrer la comptabilité à des outils externes ou cabinets.

Gestion des éléments de prévision

Créer, modifier et supprimer les éléments de forecast (tags, montants, règles de propagation). Bonnes pratiques pour structurer les éléments et propager les montants sur plusieurs périodes.

URSSAF (déclarations et paiements)

Interfaces guidées pour déclarer et envoyer paiements liés à l'URSSAF (déclaration des prestations, paiements groupés). Permet d'aligner les paiements sociaux avec les factures et paiements clients.

Génération des écritures comptables

Processus de création des écritures à partir des factures, achats et transactions. Explique le job GenerateAccounting (période), l'agrégation des écritures, et les bonnes pratiques de contrôle puisqu'elles constituent la source canonique pour les exports légaux.

Contacts & CRM

Gérer les clients, fournisseurs, personnes et établissements : création, édition, fusion et gestion des relations. Utile pour centraliser les informations des tiers et les réutiliser dans factures/achats.

Pièces jointes & stockage de documents

Téléverser, stocker et servir fichiers associés aux documents (factures, achats, attestations). Fournit URLs publiques ou sécurisées et prévisualisations.

SAP - Attestations

Gérer la génération et l'envoi d'attestations SAP (documents annuels), visualiser et envoyer par email les attestations et gérer l'historique d'envoi. Utile pour satisfaire les obligations administratives liées aux marchés publics ou partenaires SAP.

Détails d'un élément et pièces associées

Consulter les données détaillées d'un élément de prévision, ses KPIs associés et les pièces justificatives. Actions possibles : revue, liaison de documents et audit des modifications.

Plan comptable (comptes & catégories)

Gestion du plan comptable : création, édition, suppression et remplacement de comptes, réorganisation entre catégories et règles de sécurité/consistance à appliquer (vérifications, remplacements avant suppression).

URSSAF (paiements et déclarations)

Flux de paiement et de déclaration URSSAF : saisie des identifiants, enregistrement des clients/paiements, envoi des paiements et suivi des statuts. Permet gérer les obligations sociales administratives.

Budgets et taux forfaitaires

Configurer et verrouiller les budgets par catégorie, définir des taux forfaitaires et règles d'application. Gestion des permissions pour verrouillage et validation des budgets.

Exports comptables & intégrations (Agiris, ACD, Pennylane, Pennylane OAuth)

Générer les exports comptables pour un mois/période dans différents formats, configurer et envoyer vers des services d'expertise comptable (Agiris, Pennylane) ou télécharger localement. Permet d'automatiser la livraison des écritures comptables.

OCR & Assistance IA

Analyser les factures fournisseurs via OCR (Mindee) et vision IA (GPT-4 Vision) pour extraire automatiquement fournisseur, dates et montants, accélérant la saisie et réduisant les erreurs.

Gestion des employés comptables

Administration des employés liés à la comptabilité (ex. indemnités de trajet), liens avec les écritures et paramètres nécessaires pour calculs et imputations comptables.

Stocks & Catalogue (Produits/Services)

Gérer le catalogue produits/services : création, édition, export CSV et suppression en masse. Utile pour centraliser les articles facturés et gérer les stocks si pertinent.

Exports et rapports

Exporter les tableaux, éléments et documents liés pour reporting externe ou archivage. Inclut export des séries temporelles, détails d'éléments et pièces justificatives.

Catalogue & Stocks (Produits et services)

Gérer le catalogue de produits et services : création, édition, visualisation détaillée, export CSV et suppression. Utile pour alimenter la facturation et la gestion des stocks.

Modèles de documents & templates

Créer et réutiliser des modèles de documents commerciaux (contenu, colonnes) et templates de mail/HTML pour personnaliser l'apparence des factures et des communications.

Exports comptables et conformité

Configurer, lancer et suivre les exports comptables mensuels (FEC, ACD, Pennylane, Agiris…). Description du flux : création d'une ExportEntity, dispatch d'un job asynchrone, formats cibles et suivi des exports par mois.

Exports CSV & Extraction de données

Exporter des listes (invoices, purchases, catalogue, etc.) en CSV paginé avec feedback utilisateur et gestion d'exports volumineux. Pratique pour reporting ou transferts vers d'autres outils.

Organisation du plan comptable

Vue d'ensemble pour créer, modifier et supprimer les comptes et structurer le plan comptable. Expliquer les catégories, la liaison aux employés et le paramétrage des budgets/forfaits. Inclut les bonnes pratiques pour la maintenance et les prérequis lors de suppression.

Profils & Paramètres de l'organisation

Modifier les informations de l'organisation (nom, logo, établissement, pays), gérer établissements et paramètres d'activité. Important pour personnaliser l'apparence, la fiscalité et les options applicatives.

Génération et gestion des exports comptables

Créer, préparer et stocker les fichiers d'export (FEC et formats spécifiques). Expliquer le cycle de création d'un ExportEntity, le job GenerateAccounting qui agrège les écritures, la génération de l'ExportFile (zip/format), le stockage et la procédure de téléchargement.

Abonnements & facturation récurrente

Gérer abonnements clients via Stripe, facturation récurrente et éléments d'usage (extras). Permet créer plans, gérer essais et prévisualiser changements de plan.

Comptes auxiliaires (clients et fournisseurs)

Guide dédié à la création et gestion des comptes auxiliaires (clients, fournisseurs) : règles de préfixe, configuration, et comment ajouter des comptes auxiliaires correctement pour assurer l'intégration avec la comptabilité principale.

Clés API & accès externe

Générer, renommer, afficher et supprimer des clés API pour accéder à l'API de manière sécurisée. Permet aux intégrateurs / partenaires d'automatiser des flux ou de connecter des applications tierces.

Clés API & intégrations partenaires

Gestion des clés API et intégrations partenaires (installation, affichage, suppression). Permet de connecter l'application à des services externes et de gérer l'accès automatisé.

Transmission aux éditeurs (ACD Compta, Pennylane, Agiris)

Processus d'envoi des exports vers les solutions tierces : sélection de destination, validations pré-transmission (format, comptes), dispatcher des jobs d'envoi spécifiques (ExportAccountingEntriesToAcdCompta / ExportAccountingEntriesToPennylane / Agiris) et gestion des statuts d'envoi.

Clés API & Webhooks

Gérer les clés API, visualiser/cacher le token, copier dans le presse-papiers et supprimer ; configurer les webhooks (URL, événements) pour recevoir des notifications externes.

Génération et validation des écritures comptables

Procédure pas à pas pour générer automatiquement des écritures sur une période donnée, contrôler et valider les résultats. Explications sur les options, vérifications préalables et implications légales et techniques.

Webhooks

Configurer des webhooks : URL de callback, sélectionner les événements à envoyer, visualiser et copier les payloads d'exemples. Utile pour intégrer Sinao avec des systèmes externes en temps réel.

Utilisateurs & gestion des accès

Inviter, gérer et appliquer des profils/politiques utilisateurs multi‑tenant. Permet contrôler les droits, inviter collaborateurs et appliquer des profils par défaut à la création d'une app.

Configuration des intégrations et gestion des identifiants

Configurer et stocker les paramètres d'intégration nécessaires (filenumber, tokens, UUID, file codes), valider ces settings via le pipeline de validation, et récupérer les identifiants exigés par ACD/Agiris pour permettre les exports automatisés.

Paiements & Abonnements (Stripe / PayPal / Checkout)

Gestion des abonnements, méthodes de paiement (carte), webhooks Stripe, configuration PayPal et flow de paiement (checkout). Permet souscrire à des offres, gérer méthodes et facturation.

Remplacement et nettoyage global des comptes

Mode d'emploi pour remplacer un compte par un autre dans tout l'historique comptable, cas d'usage, précautions et étapes (choix du compte de remplacement, lancement et contrôle). Inclut règles à suivre avant suppression définitive.

Intégrations de paiement (PayPal / Stripe)

Configurer et synchroniser les intégrations de paiement pour accepter des paiements en ligne (PayPal, Stripe), configurer clés API, webhooks et flux d'authentification nécessaires.

Notifications, emails & tracking

Envoyer des emails métier (factures, invitations, support) avec suivi (ouverture, bounce, plainte). Utile pour gérer communications et garantir la traçabilité des envois.

Opérations asynchrones, surveillance et reprise d'erreur

Détails sur l'architecture des jobs (création, génération de fichier, envois), gestion des statuts et des journaux d'erreur, règles de reprise/rejeu des jobs en cas d'échec, et procédures pour auditer et diagnostiquer les problèmes d'export.

SSO & Authentification

Flux de Single Sign-On (SSO) pour connecter des utilisateurs via un token externe ou SSO provider, gestion de session et redirections. Facilite l'intégration d'identités d'entreprise.

Soldes initiaux et ajustement de la balance

Instructions pour saisir les soldes initiaux, effectuer des écritures d'ouverture et ajuster la balance générale. Expliquer l'utilisation de l'outil, les contrôles à réaliser et les impacts sur les états financiers.

Abonnements & Paiements récurrents (Subscription)

Visualiser et gérer l'abonnement de l'application : mode de paiement, méthodes enregistrées, activation d'options supplémentaires et gestion des commandes/checkout.

Automatisation & règles

Définir règles et automatisations pour actions comptables et bancaires (autorisations, transformations, rapprochements automatiques). Permet gagner du temps sur les opérations répétitives.

Prévisions (Forecast) — création et gestion

Guide complet pour créer, configurer et persister des forecasts sur une période donnée. Détaille les paramètres de période, les ForecastElements, les règles de prorata, la persistance des modèles, et la gestion des opérations asynchrones et de la pagination pour de gros volumes.

Exports e‑invoicing (ChorusPro)

Envoyer des factures aux plateformes publiques (ex. ChorusPro) pour la facturation vers le secteur public. Valide FacturX et gère l'upload et le suivi des statuts.

Tableaux d'échéances (Timetables) — ventes & achats

Documentation dédiée aux timetables : comment générer et consulter des vues calendrier pour les échéances de ventes et d'achats, calculer factures/paiements impayés par mois et exploiter ces timetables pour le suivi et la relance.

Gérer les catégories comptables

Créer, éditer et organiser les familles de recettes et dépenses. Article centré sur l'éditeur de catégories : navigation, champs (nom, description, type) et limites opérationnelles.

Paramètres d'entreprise & Parainnage (Sponsorship)

Gérer les programmes de parrainage, générer QR codes et liens de parrainage, envoyer des invitations par email et suivre les crédits acquis. Utile pour motiver la montée en charge via recommandations.

Budgets et taux forfaitaires

Configurer des budgets par catégorie : montants fixes, taux forfaitaires (mensualisation fixe) et saisie des valeurs. Explications sur l'impact des budgets sur la prévision.

SSO & Flux d'authentification

Prise en charge des connexions SSO et flux de redirection pour authentification unique. Utile pour intégrer la gestion d'identité et permettre l'accès transparent entre apps.

Administration multi‑tenant & cycle de vie d'application

Gérer la création, sauvegarde, suppression et configuration initiale des applications (tenants). Automatisation des étapes d'initialisation (DB, seeds) et retrait des intégrations à la suppression.

Dashboards & graphiques financiers

Fiches pratiques pour créer tableaux de bord et graphiques : cashflow, état des transactions, breakdowns journaliers et visualisations par catégorie. Explique l'appel aux endpoints charts, les types de graphiques disponibles et les données agrégées prêtes pour affichage.

PayPal Integration

Configurer PayPal dans l'application : saisie des identifiants, guides vidéos et tests de synchronisation afin d'accepter les paiements via PayPal.

Types et propagation des budgets

Définir le type de catégorie et le comportement de propagation des budgets (comment les montants se répartissent dans le temps et entre sous-éléments) pour affiner prévisions et reporting.

Importateur (iframe d'import)

Page qui intègre un outil externe d'import via iframe pour charger des documents ou des lots de données. Utile pour centraliser l'import de justificatifs ou de lots clients/fournisseurs.

SEPA & mandats bancaires

Gérer les mandats SEPA, les signatures électroniques et les suivis des prélèvements. Sert aux entreprises qui débitent automatiquement via SEPA et qui doivent conserver traces et états.

Regroupement & agrégation des transactions

Règles et endpoints pour regrouper ventes et achats par compte ou catégorie, produire agrégats mensuels (invoices, purchases, transactions) et gérer les contraintes techniques (pagination, traitements asynchrones) lors d'analyses à large échelle.

Stripe Integration & Webhooks

Configurer Stripe (clés, webhook) pour gérer paiements récurrents ou ponctuels et réagir aux événements via webhooks.

Suppression et migration de catégories

Procédure sûre pour supprimer une catégorie : sélection d'une catégorie de remplacement, migration automatique des anciennes écritures et gestion des limitations liées aux règles URSSAF.

Navigation & Interface (Menu, Langue, Mobile)

Composants de navigation : menu d'apps, menu utilisateur, barre mobile, sidebar et sélecteur de langue. Ils permettent la navigation globale, la gestion du contexte d'application et le changement de langue/organisation.

Ressources administratives & logs techniques

Journaliser événements techniques, requêtes et exposer une API pour webhooks externes. Utile pour audit, debugging et intégration par partenaires.

Calcul de la TVA

Comment calculer les montants de TVA pour une période donnée : choix de la périodicité, modes de calcul (sur facturation ou sur paiement), niveau de détail (détaillé par taux/compte ou agrégé) et règles à respecter pour l'entreprise. Inclut validation des dates/périodes et contrôle des bases TVA avant télétransmission.

Webhooks & Surveillance d'événements

Configurer des webhooks pour recevoir événements internes (ex. factures créées), visualiser les payloads, copier les exemples et consulter les erreurs. Facilite l'intégration technique avec des services externes.

Aperçu — Exports comptables & intégrations

Présentation du flux global d'exports comptables : quand et pourquoi exporter, formats supportés, rôles impliqués et règles à connaître (tâches asynchrones, paramètres requis, autorisations tiers). Guide rapide pour accéder au menu et démarrer un export.

Déclarations TVA & documents légaux

Préparer et stocker déclarations TVA et documents réglementaires (ex: attestations SAP) pour les obligations fiscales et sociales.

Préparation et envoi des déclarations (Teledec/Teledeclaration)

Assembler les bases TVA et préparer le payload de télétransmission via VatTeledecService, puis exécuter l'envoi vers Teledec/SAP. Explique la composition du payload, les contrôles pré-envoi et le flux d'appel du service de télétransmission, ainsi que les exigences d'authentification et d'audit pour les envois.

Aide contextuelle & Tooltips

Composant d'aide contextuelle affichant du contenu HTML et des popovers d'aide liés à des ancres intercom. Facilite la découverte et l'apprentissage des fonctionnalités.

Recherche INSEE (SIRENE)

Rechercher des entreprises françaises via la base INSEE (SIRENE) pour remplir automatiquement les informations légales et d'adresse d'une organisation. Facilite la saisie et réduit les erreurs.

Générer et télécharger des exports (FEC, Agiris, ACD)

Mode d'emploi pas à pas pour générer des exports comptables (FEC, Agiris, ACD), sélectionner la période/journaux, lancer la génération et récupérer les fichiers dans les formats disponibles (CSV, ZIP, XML, etc.). Inclut bonnes pratiques pour les exports volumineux.

Système de tags

Ajouter et supprimer des tags sur entités (documents, contacts, transactions) pour faciliter le filtrage, la catégorisation et la recherche.

Prévisualisations & génération de fichiers

Créer en arrière-plan des PDF/JPG d'aperçus pour documents achats/ventes afin de proposer une visualisation rapide et stocker les versions pour envois et archives.

Configuration et stockage des paramètres Teledec

Configurer les paramètres nécessaires pour Teledec (identifiants, endpoints, options de déclaration) et stocker les credentials de façon sécurisée via store_settings. Détails sur le chiffrement des credentials, gestion des environnements (test/production) et bonnes pratiques de sécurité et d'audit.

Gestion des tags

Ajouter ou retirer des tags sur des entités (documents, contacts) pour organiser et filtrer facilement les éléments.

Suivi des exports et watcher (statut, polling)

Explication du mécanisme de suivi des tâches d'export : polling, états possibles, durée estimée, gestion des erreurs et recommandations pour surveiller et relancer si nécessaire. FAQs sur notifications et délai pour exports volumineux.

Export CSV paginé

Exporter de grands jeux de données en CSV avec pagination côté API, progression et feedback utilisateur. Utile pour extraire des listes clients/factures/achats au format tableur.

Configuration & templates d'email/document

Paramétrer l'apparence et le contenu des documents et emails (header/footer/style) et les utiliser lors de la génération des PDF et des notifications.

Webhooks Teledec et gestion des réponses

Traitement des callbacks de Teledec : réception d'états, erreurs et pièces jointes PDF. Démonstration du traitement des webhooks pour attacher les PDFs aux déclarations, mise à jour automatique des états, journalisation et gestion des erreurs/retransmissions.

Configuration des paramètres et mappings comptables

Guide de configuration des paramètres requis pour la génération d'exports : sélection des journaux, préfixes, mappings de comptes et règles d'exclusion. Exemples de mappings pour FEC/Agiris/ACD et impact des paramètres sur le fichier exporté.

Gestion des comptes & soldes

Consulter le solde et mouvements par compte comptable, calculer débits/crédits et produire des rapports de balance. Sert d'outil décisionnel et de contrôle.

Fichiers SEPA (virements et prélèvements)

Créer et gérer les fichiers SEPA au format XML pour les virements (credit transfer) et les prélèvements (direct debit). Expliquer la prévisualisation, les contraintes réglementaires (identifiants, dates d'exécution) et le processus de génération/téléchargement du fichier XML prêt à transmettre à la banque.

Fonctionnalités premium & contrôle d'accès

Gérer l'accès aux fonctionnalités premium ou restreintes via un garde (permission + abonnement) avec redirection vers l'offre ou notification. Permet monétiser des fonctionnalités avancées.

Composants UI génériques (Boutons, Dialogs, Inputs)

Bibliothèque de composants réutilisables (Button, Card, Dialog, InputMoney, Typeahead, Loader, Labels) qui standardise l'apparence et le comportement des interactions utilisateur à travers l'application.

Intégrations tierces : Pennylane, Agiris, ACD

Procédure pour connecter et autoriser des services externes (Pennylane, Agiris, ACD) : activer modules, configurer connexions, gérer permissions et redirections automatiques. Spécificités de Pennylane (redirection autorisée) et prérequis d'activation.

Tableaux & Listes (DataTable / Datagrid)

Composant central de listing serveur (DataTable) avec configuration spécifique par domaine (invoices, purchases, accounts, customers). Propose filtres, pagination, actions de sélection et renderers personnalisés.

Prévisions & éléments de budget

Créer des éléments de prévision budgétaire (forecast elements) et les associer à des catégories comptables pour anticiper trésorerie et budgétisation.

Mandats SEPA et validation IBAN/BIC

Gestion des mandats SEPA : création, validation et normalisation des IBAN/BIC. Décrire la saisie du mandat, les règles de validation, le stockage des références de mandat et l'état du mandat (actif/annulé).

Composants UI réutilisables (boutons, dialogues, typeahead, inputs)

Bibliothèque de composants d'interface pour actions, modales, popovers, inputs (montant/currency), typeahead et datatables. Assure une UI cohérente et réutilisable dans toute l'application.

Datatables & configuration des grilles

Composants et configurations pour afficher des tableaux serveur-driven (invoices, purchases, accounts, employees, etc.) avec colonnes dynamiques, filtres, actions et rendu mobile.

Préparer la déclaration TVA

Guide pour ouvrir le panneau TVA, choisir la période (mensuelle/trimestrielle/semestrielle/annuelle) et consulter le tableau récapitulatif. Inclut la visualisation du détail de la TVA collectée et déductible et l'usage des hovercards pour explorer chaque ligne.

Gestion des erreurs & page d'erreur

Affichage utilisateur des erreurs critiques (connexion API, timeout) avec possibilité de retry et messages contextualisés. Utile pour guider l'utilisateur quand la plateforme rencontre des problèmes réseau ou d'authentification.

Notes kilométriques & indemnités

Enregistrer déplacements professionnels et calculer indemnités kilométriques selon paramètres (puissance fiscale, type de véhicule). Facilite le remboursement des frais de transport.

Intégration PayPal

Connecter et déconnecter un compte PayPal pour encaissements. Couvrir le flux d'intégration (clientId/OAuth), le stockage sécurisé de la connexion dans les settings, et la vérification de l'état de connexion depuis l'application.

Paramètres bancaires & Sepa

Gestion des opérations liées au SEPA : export SEPA, mandats, prélèvements et export SEPA pour achats/factures. Facilite la gestion des paiements et rapprochements bancaires.

Configurer Teledec et paramètres de télétransmission

Instructions pas-à-pas pour configurer la connexion Teledec (identifiants, mot de passe, IBAN, paramètres de télétransmission) via le formulaire de réglages et vérifier la validité de la connexion avant envoi.

Administration & interface Nova (back‑office)

Interface d'administration Nova exposant ressources pour gérer comptes, documents, utilisateurs et données du système. Destinée aux administrateurs pour supervision et modifications directes en base.

Branding & Whitelabel

Personnaliser les couleurs et le bandeau partenaire (whitelabel) pour afficher logo partenaire, nom d'app et liens. Permet aux partenaires / revendeurs d'adapter l'apparence aux besoins clients.

Stripe : clients, Checkout et moyens de paiement

Gestion des clients et des moyens de paiement Stripe : lancer un Checkout, récupérer la session, gérer sources et méthodes de paiement, et utiliser Stripe pour payer des factures en attente. Inclut bonnes pratiques pour la synchronisation des objets Stripe et le traitement des webhooks.

SAP / Teledec / Services externes (Webhook Teledec, Yousign, Chorus)

Intégrations spécifiques pour envoyer ou recevoir fichiers et webhooks pour des services externes (Teledec, Yousign, Chorus Pro), incluant la gestion de webhooks entrants et la finalisation d'opérations.

Soumettre et suivre la télé‑déclaration

Procédure pour lancer la télé‑déclaration depuis l'application, suivre le statut (en file, acceptée, rejetée) et consulter l'historique d'envoi. Comprend les bonnes pratiques avant envoi et comment interpréter les statuts Teledec.

SSO / Mobile App Prompt

Affiche des prompts pour l'installation d'app mobile et gère des flux spécifiques au mobile (MobileAppUrl), ainsi que la barre mobile et menus adaptés.

Connexion bancaire & synchronisation

Permet de connecter des comptes bancaires via Bankin, d'importer automatiquement les mouvements bancaires et de les synchroniser avec votre trésorerie. Utile pour automatiser la saisie des transactions et faciliter la réconciliation bancaire.

Simulation et opérations massives (facturations à venir, pay_all)

Simuler la facturation à venir (upcoming) et documenter les endpoints qui effectuent des opérations massives (ex. pay_all). Exposer comment lancer des simulations, interpréter les résultats et les précautions/conséquences des opérations sur plusieurs factures impayées.

SSO / Gestion de session et redirection

Gestion des sessions utilisateur, intégration SSO, récupération du contexte app et basculement entre applications disponibles. Garantit un accès sécurisé et centralisé.

Validation, erreurs et corrections

Catalogue des erreurs fréquentes (formats, montants, doublons), codes explicites renvoyés par Teledec, règles de blocage et étapes pour corriger les paramètres ou les données puis relancer la télé‑déclaration.

Ventes : devis et factures

Créer, éditer, finaliser et envoyer des devis et factures, générer leurs PDF et produire FacturX (XML) pour conformité. Indispensable pour facturer vos clients et garder une traçabilité des documents commerciaux.

Plans et extras

Découvrir et gérer l'offre tarifaire : lister les plans disponibles, les extras et les métadonnées associées. Guide pour afficher les options côté UI et lier un choix de plan au flux de paiement (Checkout).

Recherche INSEE & pré-remplissage d'entreprise

Rechercher des sociétés françaises via l'API INSEE (SIRENE) pour pré-remplir automatiquement les informations de l'entreprise (dénomination, adresse) lors de l'onboarding ou création de contact. Facilite la saisie correcte des données légales.

Paramétrage comptable (Comptes, Catégories, Employés)

Configurer le plan comptable, catégories budgétaires, employés liés à la comptabilité et paramètres généraux. Nécessaire pour automatiser les écritures et respecter les plans comptables.

Configuration et authentification URSSAF

Guide pas à pas pour préparer l'accès à l'API URSSAF : ouverture du panneau, configuration des clés/API, vérification des permissions et tests d'authentification. Comprend les vérifications préalables (format des clés, URL d'endpoint) et les erreurs courantes liées à l'authentification.

Notifications & Toasts

Afficher des messages temporaires (success, error, info) pour informer l'utilisateur du résultat d'une action (import, export, save). Permet un feedback immédiat et clair lors des opérations asynchrones.

Achats & notes de frais

Gérer les factures fournisseurs, téléverser des justificatifs, effectuer la ventilation des dépenses et utiliser l’OCR pour pré‑remplir les données. Cela accélère la saisie des achats et améliore le suivi des dépenses.

Sessions Stripe Checkout

Créer et gérer des sessions de paiement Stripe Checkout (y compris off-session pour ajout de méthodes). Bonnes pratiques de création serveur-side, validation des webhooks et gestion des états après paiement.

Authentification et compte

Gérer l'accès utilisateur : création et mise à jour de comptes, connexion/déconnexion, réinitialisation de mot de passe et 2FA. Utile pour sécuriser l'accès et personnaliser l'expérience (compte, cabinet comptable).

Importateur intégré (iframe Importer)

Module d'import embarqué via iframe (importer) pour amener des fichiers/documents (factures, pièces) dans l'application. Idéal pour intégrer des outils tiers d'import.

Méthodes de paiement et sources

Ajouter, supprimer et définir la méthode de paiement par défaut des customers Stripe. Inclut le flux d'ajout off-session, précautions lors de la suppression et impacts sur la facturation et les licences.

Sélection et mapping des factures et participants

Instructions pour sélectionner les factures et les clients à déclarer à l'URSSAF, valider et mapper les champs requis (identifiants, dates de naissance, IBANs, etc.). Contient des conseils pour éviter doublons et erreurs de format avant génération du lot.

Paiements & réconciliations

Enregistrer des paiements, associer des mouvements bancaires importés aux factures/achats et effectuer des opérations de réconciliation automatique. Essentiel pour suivre le solde client/fournisseur et la trésorerie.

Préparation du lot et envoi

Procédure pour compléter les formulaires nécessaires, générer un lot d'envoi, lancer le traitement et visualiser les résultats. Inclut étapes UI (UrssafStep3), validation finale des données et conseils pour réexécution ou annulation si nécessaire.

Gestion des applications / multitenancy

Créer, lister, sélectionner et réinitialiser des applications (tenants) hébergées sur la plateforme. Utile pour administrer plusieurs comptes / entreprises depuis la même interface.

Exports comptables & passerelles (ACD / Pennylane / Agiris)

Générer des écritures comptables et exporter des fichiers au format requis par des prestataires (ACD, Pennylane, Agiris) ou pour l'archivage (FEC). Pratique pour transférer la comptabilité vers un expert‑comptable ou un service externe.

Factures et paiements

Consulter, simuler et payer les factures Stripe. Couvrir les endpoints pay, pay_all, affichage des factures à venir, et conséquences sur les soldes et licences. Procédures recommandées pour les opérations sensibles.

Utilitaires & Composables (helpers)

Collection de helpers et composables pour validations, formatage, focus, construction d'URL, toggling loader, exports CSV et autres utilitaires transverses. Ils facilitent le développement et le comportement UI/UX.

Rapports d'erreurs et corrections

Catalogue des erreurs spécifiques renvoyées par l'URSSAF, interprétation des codes et étapes de correction (ex. date de naissance invalides, IBAN, doublons, identifiants manquants). Comprend comment consulter les résultats (UrssafStep4), appliquer corrections et renvoyer les éléments rejetés.

Abonnements & Facturation (Stripe / PayPal)

Gérer l'abonnement payé d'une application : consulter l'offre, lancer les paiements, gérer moyens de paiement, coupons et sessions de checkout. Nécessaire pour activer des fonctionnalités payantes et piloter la relation commerciale.

Comptabilité : plan comptable & écritures

Gérer le plan comptable (comptes, catégories) et les salariés comptables, visualiser les écritures et lier documents aux comptes. Utile pour structurer la comptabilité interne et faciliter les exports.

Essais, coupons et extensions

Gestion des périodes d'essai et des coupons : appliquer des codes promo, simuler l'impact sur les factures futures et demander l'extension d'une période d'essai pour un tenant. Inclut règles métier et workflow d'approbation.

Conformité sociale et préparations préalables (KYC)

Bonnes pratiques pour garantir la conformité avant envoi : renseigner KYC, coordonnées complètes, formats d'identification et contrôles internes. Liste des conditions pouvant entraîner des rejets et procédures recommandées pour auditabilité et traçabilité.

Facturation récurrente

Créer et gérer des factures récurrentes planifiées (mensuelles, trimestrielles, annuelles) avec génération automatique d'invoices. Pratique pour les abonnements et prestations facturées régulièrement.

Paiements et réconciliations bancaires

Gérer les comptes bancaires connectés, les flux de caisse, la synchronisation bancaire, la réconciliation des transactions et le rapprochement avec factures/paiements. Fondamental pour tenir la trésorerie et rapprocher automatiquement les mouvements.

Profil partenaire & Apps liées

Afficher et gérer le profil d'un partner : metadata, apps qui lui sont liées et opérations sur ces apps. Cette page couvre la consultation détaillée d'un partner, comment voir les apps associées, et les implications des actions destructrices (dissociation ou suppression). Inclut bonnes pratiques pour vérification d'autorisation avant toute modification.

Gestion des applications (multi‑tenant)

Créer, lister, sélectionner et administrer des applications/tenants dans la plateforme. Utile pour gérer différentes marques, organisations ou environnements clients depuis un seul compte.

Comptabilité & exports comptables

Gérer comptes et catégories comptables, générer et télécharger des exports comptables (formats Agiris, ACD, Pennylane), et lancer la génération d'exports pour un mois. Indispensable pour l'échange avec des logiciels externes et la conformité.

Authentification SSO & Whitelabel

Instructions pour authentifier un utilisateur partner via SSO, gérer tokens et URLS d'authentification, et appliquer la configuration whitelabel selon le hostname. Explications sur la sécurité des tokens SSO, durée de vie, et recommandations pour l'exposition limitée des URLs.

Contacts & CRM (organisations, établissements, personnes)

Gérer les fiches client/fournisseur, établissements, adresses et contacts. Utile pour centraliser les données interlocuteurs et les lier aux documents commerciaux et transactions.

Vue d'ensemble des paramètres de facturation

Introduction aux paramètres globaux : où trouver le dialogue de configuration, comment naviguer entre les sections et quelles sont les règles critiques à connaître avant de modifier quoi que ce soit.

Onboarding et configuration guidée

Accompagner l'utilisateur pas à pas lors de la première configuration de l'application (onboarding). Permet d'initialiser les paramètres essentiels et de valider les étapes de mise en route.

Prévisions & tableaux de bord (Forecasts, KPIs, Charts)

Construire des prévisions financières, afficher graphiques et KPIs, et calculer budgets et pourcentages par catégorie. Utile pour piloter la trésorerie et anticiper besoins futurs.

Modèles de factures et configuration des templates

Modifier et sélectionner les templates de documents (factures, avoirs, devis). Gestion des permissions et limitations liées au plan, aperçu des variables et règles de mise en page.

Catalogue produits & stocks

Gérer produits, catégories, stocks et mouvements de stock pour suivre inventaire et lier les articles aux factures. Utile pour entreprises vendant des biens et nécessitant gestion de stock.

Clés API & intégration d'apps

Guide pour créer, récupérer et gérer les API keys pour les apps d'un partner. Explique les usages typiques (intégration partner/install), les scopes et bonnes pratiques de rotation, ainsi que les conditions d'accès liées au rôle/autorisation du partner.

Gestion des utilisateurs et collaborateurs

Inviter, assigner et gérer les collaborateurs et leurs permissions sur les applications. Permet de donner des accès ciblés, envoyer des invitations et gérer les profils d'accès.

Numérotation, journaux et comptes collectifs

Configurer la numérotation des documents, associer journaux comptables et définir les comptes collectifs par type d'opération. Exigences de conformité et règles de préfixe à respecter.

Ventes : Devis & Factures

Créer, éditer, finaliser, dupliquer, télécharger et envoyer devis et factures. Permet de produire documents commerciaux, suivre paiements et générer PDF/archives.

Pièces jointes & gestion des fichiers

Uploader, stocker et lier des fichiers (factures, justificatifs, exports) dans un stockage centralisé (S3/local). Permet d'organiser et d'archiver tous les documents liés à l'activité.

Gestion des collaborateurs & permissions

Procédure pour gérer les utilisateurs au sein d'un partner : lister les collaborateurs, ajouter un nouvel utilisateur, assigner rôles/policies et envoyer des invitations. Détails sur les rôles recommandés, délégation de droits et vérifications d'autorisation préalables.

CRM — Contacts, organisations et établissements

Gérer les contacts (personnes), organisations et établissements : adresses, téléphones, emails, relations client/fournisseur et établissements favoris. Utile pour centraliser les informations client et les utiliser sur devis/factures.

Options automatiques et mappings client/fournisseur

Activer ou désactiver les comportements automatiques (autofill référence, mapping automatique des comptes client/fournisseur) et comprendre leur impact sur la comptabilisation.

Génération PDF, modèles et aperçus

Créer des documents PDF à partir de templates HTML, générer des aperçus JPG/miniatures et injecter des numéros de pages. Sert à produire factures, devis et autres exports prêts à l'impression.

Abonnements & facturation (Stripe)

Comment piloter les abonnements pour une app d'un partner : démarrer, swapper ou annuler des plans, et synchroniser les changements avec Stripe. Inclut workflows étape par étape (sélection d'app, modification de plan, mise à jour Stripe) et considérations sur les actions irréversibles.

Documents de vente — Devis & Factures

Créer, modifier, finaliser, télécharger et envoyer devis et factures. Permet de suivre le cycle commercial, générer des PDF, créer des factures à partir de devis et gérer le statut des documents.

Paramètres d'export et de comptabilisation

Configurer les formats d'export (CSV, XML, formats comptables), règles de comptabilisation automatique et paramètres nécessaires pour l'intégration avec un ERP ou un expert-comptable.

Signature électronique

Envoyer des documents à signer électroniquement via YouSign / WiziYousign / Yousign V3 et récupérer les fichiers signés. Utile pour contrats, devis acceptés et documents légaux.

Contacts & CRM (Organisations, Personnes, Relations)

Gérer le carnet d'adresses : organisations, personnes, établissements et relations. Permet d'envoyer des documents, automatiser SEPA et fusionner doublons.

Vue d'ensemble et gouvernance des collaborateurs

Présentation du modèle de collaborateurs, rôles et règles de gouvernance. Explique qui peut assigner des collaborateurs, quelles actions entraînent la création d'invitations et les conséquences de suppression (effet en cascade sur les policies).

Achats et justificatifs (purchases)

Importer, gérer et archiver les dépenses et justificatifs (factures fournisseurs), avec OCR, aperçu et génération de PDF. Utile pour la tenue de la comptabilité et le suivi des paiements fournisseurs.

Aperçu & intégration

Présentation du composant DataTable, de son fonctionnement server-driven et des principales capacités à connaître avant d'intégrer le composant (tri, filtres, pagination, colonnes, compteurs).

Emails & envoi de documents

Composer et envoyer des emails liés aux documents (factures, devis) avec pièces jointes, signatures et suivi des envois. Utile pour communiquer officiellement avec les clients et garder un historique.

Intégrations & partenaires (Intercom, Google Sheets, Notion, Pennylane, URSSAF)

Administrer intégrations externes : synchroniser données avec Intercom, écrire dans Google Sheets, exporter vers Pennylane, envoyer déclarations URSSAF, ou récupérer/sauvegarder des données Notion. Facilite l'automatisation et l'échange d'informations avec outils tiers.

Invitations et ajout de collaborateurs

Procédure pas à pas pour inviter ou ajouter un collaborateur (interne ou partenaire) : création éventuelle de l'utilisateur, création du PartnerCollaborator et envoi d'une invitation d'accès ou de support.

Signatures électroniques (Yousign)

Générer et suivre des liens de signature électronique pour devis/factures via Yousign, et recevoir les webhooks de statut. Utile pour automatiser la collecte de signatures légales.

Filtres et validation

Guide complet sur l'utilisation des filtres : types disponibles, UX des filtres (texte, checkbox, radio), filtres financiers et de date, best practices de validation et comportement côté serveur.

Déclarations TVA & téléprocédures (Teledec)

Préparer et transmettre des déclarations TVA via le service Teledec, calculer les échéances et générer les références nécessaires. Utile pour automatiser la conformité fiscale et l'envoi des déclarations.

Acceptation d'invitation et activation des policies

Flux d'acceptation d'invitation : suivre le lien, valider le token, activer et attacher les policies pertinentes pour obtenir l'accès. Cas particuliers et erreurs fréquentes.

Prévision financière & tableaux de bord (Forecast)

Construire des prévisions (cashflow, budgets, KPIs) et visualiser des graphiques par période. Utile pour anticiper trésorerie, piloter budgets et suivre indicateurs clés.

Tri, pagination et recherche

Instructions pour activer et personnaliser le tri par colonne, la pagination serveur-side et la recherche globale. Comportement attendu lors d'un clic sur l'en-tête et interactions avec les filtres.

SEPA & virements (prélèvements/crédits)

Préparer, prévisualiser et télécharger des fichiers SEPA (prélèvements et virements) ainsi que gérer les mandats SEPA. Essentiel pour automatiser paiements fournisseurs et clients.

Prévisions & budget (forecast)

Saisir et suivre des éléments de prévision budgétaire rattachés à des catégories comptables pour anticiper trésorerie et dépenses. Aide à la planification financière et au pilotage.

Assignation et gestion des policies par application

Comment assigner ou supprimer des policies sur des applications pour un collaborateur, règles d'autorisation (administrateurs uniquement) et impacts sur le cycle de vie du collaborateur.

Colonnes & préférences utilisateur

Personnalisation des colonnes : affichage/masquage, ordre, et persistance des préférences côté client (localStorage). Inclut comment sauvegarder et restaurer la visibilité des colonnes.

URSSAF & Chorus Pro (paiements sociaux / marchés publics)

Préparer et soumettre des données pour URSSAF et Chorus Pro : authentification, prévisualisation, envoi de paiements et récupération de statuts. Utile pour la conformité sociale et l'envoi de factures publiques.

Frais kilométriques (mileage allowances)

Enregistrer les indemnités de déplacement (km), calculer les remboursements selon fiscalité et associer à des notes de frais/achats. Permet de gérer et rembourser les frais professionnels des employés.

Retirer collaborateurs et opérations en masse

Instructions pour retirer un collaborateur (suppression des policies liées puis suppression du record) et pour effectuer des suppressions en masse via identifiants. Conseils pour audit et conservation des logs.

Badges et compteurs par période

Configuration et utilisation des badges de compteurs (ex. totaux par période). Explications sur la mise à jour des compteurs selon les filtres et les périodes sélectionnées.

Utilitaires dates, périodes et devises

Fournir outils pour calculer les périodes (semaine, mois, trimestre, année) et travailler avec devises et taux de change. Utile pour filtrer rapports, générer exports et convertir montants.

Inviter des utilisateurs

Procédure pour créer et envoyer des invitations par e‑mail avec un profil d'accès, et pour visualiser les invitations en attente par application.

Utilitaires texte & normalisation

Outils de nettoyage et normalisation de chaînes (suppression d'accents, suppression de caractères spéciaux) pour homogénéiser données destinées aux exports, recherches et noms de fichiers.

Accepter une invitation et enregistrement

Flux d'acceptation d'invitation : suivi du lien, page d'enregistrement via token, création du compte et attribution automatique du policy.

Confirmations et actions critiques

Conventions et modèles pour protéger les opérations irréversibles (suppression, remplacement). Explique quand afficher DialogConfirm, comment rédiger un message explicite, utiliser des actions de confirmation distinctes (bouton à couleur d'alerte, libellé explicite) et gérer l'annulation. Inclut recommandations d'accessibilité et d'état en attente pendant l'exécution.

Toasts et notifications

Guide d'utilisation des toasts globaux pour informer l'utilisateur du résultat d'une action (succès, erreur, information). Règles de non‑blocage, durée, empilement, gestion des erreurs persistantes, liens vers des actions correctives et considérations d'accessibilité (annonce vocale).

Templates & génération de documents

Gérer les modèles de documents (PDF/web) pour factures et devis, créer des templates par défaut et retrouver les contenus pour personnaliser les documents.

Export / partage de documents & liens sécurisés

Partager et télécharger des documents via des liens tokenisés et préparer des exports (PDF, ZIP, FEC). Permet d'envoyer un accès public restreint à des factures ou d'exporter des lots pour archivage ou comptabilité.

Gestion des policies utilisateur

Créer, modifier et supprimer des politiques d'accès pour les utilisateurs sur une application, avec impacts sur les quotas et la licence.

Recherche API / Documentation (Swagger)

Fournir lecture et mapping du fichier Swagger pour documenter et retrouver les opérations API. Utile pour développeurs et intégrateurs afin de comprendre les routes exposées.

Recherche et listes (Resource / DataTable)

Rechercher, filtrer, trier et paginer les listes d'objets (invoices, purchases, contacts, produits...) via une API générique et serveur‑drive DataTable. Améliore la productivité en trouvant rapidement l'information.

Modales de workflow (édition, création, aperçu)

Patterns pour boîtes modales qui encapsulent les workflows courants : création, édition et aperçu. Traite du dimensionnement, du focus management, de la validation de formulaire dans la modale, de la sauvegarde automatique vs confirmation explicite et des interactions entre modales et toasts/confirmations.

Rapports & statistiques (Tags, Timetable, VAT)

Fournir des rapports et statistiques : tags utilisés, timetables ventes/achats, charts et calculs TVA (déclaration Teledec). Aide au pilotage et à la conformité fiscale.

Utilisation multitenant & administration d'apps

Gérer les applications locataires (tenants) : création de DB, backup, restauration et association d'utilisateurs admin. Essentiel pour centres administratifs et support dans un environnement SaaS multi‑tenant.

Administration des invitations et conformité

Outils pour administrateurs : suppression d'invitations non acceptées, revue des invitations par app et règles de conformité liées aux tokens et aux quotas.

Gestion du catalogue produit et stocks

Gérer produits, catégories, stocks et mouvements (sortie/location/retour). Permet de suivre inventaire, gérer étiquettes/tags et attacher médias aux produits.

Fenêtres premium et fonctionnalités restreintes

Comportement des dialogues qui indiquent des fonctionnalités payantes ou réservées : affichage de la fenêtre premium, message d'incitation à l'upgrade, options de fermeture ou redirection vers la page d'abonnement. Définit quand ces dialogues doivent bloquer l'accès et comment préserver l'expérience utilisateur tout en protégeant les actions réservées.

Permissions, profils & collaborateurs

Gérer les droits d'accès, inviter collaborateurs, assigner des profils (policies) et contrôler l'accès par application. Permet de travailler en équipe et de contrôler qui fait quoi.

Utilisateurs, invitations & droits

Gérer utilisateurs globaux, invitations à rejoindre une app, profils et droits (policies). Fondamental pour contrôler accès et rôles des membres d'une organisation.

Aperçu — Clés API et intégrations partenaires

Introduction au domaine : ce que permettent les clés API, comment installer et gérer des intégrations partenaires, et quelles actions spécifiques sont disponibles depuis l'interface.

Pièces jointes, stockage et visualisation

Uploader, attacher, télécharger et visualiser pièces jointes liées à documents, transactions ou contacts. Fournit gestion des fichiers, téléchargement en masse et liens publics.

Principes de l'édition inline

Introduction aux interactions de base pour modifier des valeurs en place : quand et comment ouvrir un popover ou un champ inline, types d'inputs pris en charge (texte, textarea, email, mot de passe) et comportements attendus (annuler, restaurer). Exemples d'UX et bonnes pratiques pour éviter les erreurs de saisie.

Partenaires / White-label

Gérer les partenaires whitelabel : création de partenaires, gestion SSO, synchronisation clients Stripe partenaires et actions spécifiques pour partenaires. Important pour revendeurs et intégrateurs.

Clés API & accès partenaires

Gérer clés API pour intégrations partenaires et applications tierces, permettre l'installation par partenaire et copier/cacher les clés. Nécessaire pour ouvrir l'écosystème et automatiser des flux externes.

Créer et gérer les clés API

Processus pas-à-pas pour créer, nommer, copier et lister les clés API d'une application ; instructions sur l'affichage limité des clés et la nécessité de sauvegarder la clé après création.

Popovers pour sélecteurs et typeahead

Conception et comportement des popovers contenant des sélecteurs : select simple, typeahead pour comptes/contacts, multi-select et groupes de checkboxes. Gestion du focus, navigation clavier, chargement progressif et sélection multiple dans un petit espace.

Administration système : sauvegardes & multi-tenant ops

Opérations d'administration pour gérer backups, restaurations, clones de bases, migrations et tâches globales multi-tenant. Essentiel pour maintenance, reprise après sinistre et gestion des environnements.

Abonnements & facturation de la plateforme

Sélectionner un plan, gérer le checkout (Stripe/Cashier) et consulter l'état des abonnements. Permettre aux clients de s'abonner et gérer leur facturation plateforme.

Demande de clé API pour un partenaire

Flux et règles pour qu'un partenaire demande une clé : identification, validation d'existence et vérification des droits sur l'application avant création de la clé liée.

Webhooks & intégrations (Stripe, Teledec, Yousign, ChorusPro)

Gérer les notifications entrantes d'APIs externes (paiements, attestations TVA, signatures, facturation publique) pour synchroniser l'état des documents et traitements.

Validation locale, sauvegarde asynchrone et feedback

Règles de validation locales (regex, longueurs), stratégie d'affichage d'erreurs inline, et orchestration de la sauvegarde asynchrone : états loading, verrouillage du champ, gestion des erreurs API et feedback utilisateur (toasts, messages inline). Modèles de retry et rollback en cas d'échec.

Intégrations externes & webhooks (Stripe, Teledec, Pennylane, Yousign, ChorusPro)

Recevoir et traiter webhooks et intégrer services externes (paiement, télédeclaratif, compta, signature). Permet synchronisation d'événements externes (paiement réussi, attestations, signatures) avec la plateforme.

Révocation et suppression — impacts et précautions

Comment révoquer ou supprimer une clé API, confirmation requise, effets définitifs et impacts possibles sur les intégrations dépendantes ; bonnes pratiques avant suppression.

Paramètres & configuration de l'application

Gérer paramètres globales (nom app, couleurs, email sender, fichiers, caching) et définir comportements (CORS, filesystem, queues). Utile pour administrateurs et pour adapter l'application à l'entreprise.

Champs sensibles et règles spécifiques (mot de passe)

Comportement particulier pour l'édition de champs sensibles : répétition du mot de passe, masquage/affichage, validation renforcée et recommandations de sécurité côté client avant envoi. UX pour éviter la fuite d'information et flux de confirmation.

Recherche & filtrage (Resource searcher)

Fonctionnalités de recherche globale et filtres avancés pour lister et trier entités : gestion de patterns spéciaux, construction de where/order pour requêtes paginées. Améliore la navigation et la productivité utilisateur.

Suivi emails & tracking

Traquer les emails envoyés depuis l'application (pixel, liens) et fournir une interface d'administration pour consulter les envois. Aide à savoir si les factures/devis ont été vues et cliqués.

Automatisations et tâches planifiées

Exécuter automatiquement des tâches récurrentes : facturation récurrente, rappels, clôtures, synchronisations. Permet d'automatiser le suivi client et les opérations comptables.

Envoi d'emails individuels

Guide pas à pas pour envoyer un email contenant un ou plusieurs documents à un ou plusieurs destinataires : sélection du document, composition du message, choix des destinataires et envoi. Exemples de cas d'usage et bonnes pratiques pour inclure PDF ou liens de paiement.

VAT / Déclarations (Teledec & URSSAF)

Calculer les TVA pour une période, préparer les déclarations Teledec et envoyer certaines informations à URSSAF. Facilite les obligations fiscales et les exports réglementaires.

Présentation et intégration rapide

Introduction aux composants Typeahead et guide d'intégration minimal pour ajouter rapidement une recherche autocomplétée dans un formulaire, un popover ou un dialogue. Montre l'installation, le comportement par défaut et les interactions principales pour démarrer.

Aide UI : i18n, tooltips, toasts et modaux

Fonctionnalités d'interface utilisateur qui améliorent l'expérience : traduction persistée, tooltips chargés dynamiquement, toasts de notification, popups de confirmation et modaux d'onboarding. Utile pour guider l'utilisateur et fournir retours d'action.

Archivage GED / envoi de documents externes

Envoyer des documents (PDF, pièces jointes) vers des GED/tiers via multipart HTTP (système GED). Permet d'archiver automatiquement les documents comptables chez des prestataires externes.

Envois en batch (mode batch)

Document technique et opérationnel pour lancer des envois asynchrones en masse : sélection d'une liste de documents, définition du message et des options, suivi des tâches et gestion des erreurs.

Rapports, graphiques et statistiques

Construire graphiques, tableaux de bord et extraire tags/timetables pour analyser ventes, achats, cashflow et autres indicateurs. Aide à la prise de décision et au suivi de l'activité.

Groupement et structuration des résultats

Patterns et exigences pour afficher des résultats groupés par catégorie (ex. Contacts / Comptes / Produits). Décrit le format attendu des options groupées, bonnes pratiques UX pour étiquettes et séparateurs, et exemples de données.

Fonctionnalités premium & monétisation interne

Gérer l'affichage et le gating des fonctionnalités réservées aux abonnements payants (premium). Permet d'alerter l'utilisateur et proposer upgrade pour activer des fonctions avancées.

Tagging & étiquetage

Ajouter, supprimer et manipuler des tags sur les entités (factures, achats, transactions) pour faciliter le tri, filtrage et reporting.

Pièces jointes, stockage et liens (PDF & paiement)

Explications sur les options d'envoi des documents : attachement inline du PDF généré vs insertion d'un lien vers le document stocké, et génération de liens de paiement publics pour un document à insérer dans les emails.

API Keys, partenaires & white label

Gérer les partenaires, leurs applications, les clés API et les configurations de white‑label. Permet aux partenaires d'administrer leurs clients et intégrations.

Réseau, performance et filtrage

Comportement réseau, optimisation et stratégies de filtrage : debouncing, mise en cache, filtrage côté client vs requêtes serveur, pagination et gestion des erreurs. Contient exemples de paramètres de debounce et de requêtes efficaces.

Impression & export client-side

Permettre l'impression de documents via PrintJS et la génération locale d'aperçus/exports. Utile pour fournir versions papier ou sauvegardes PDF depuis l'interface.

Stockage & gestion des médias

Gérer les fichiers stockés (S3/local), construire des noms de fichiers standardisés et obtenir les URLs publiques. Permet la centralisation et réutilisation des fichiers.

Signature électronique à la demande

Procédure pour demander une signature électronique lors de l'envoi : paramétrage de l'option, intégration du workflow de signature et conditions d'éligibilité selon le plan.

Administration & outils opérateurs (backups, migrations, maintenance)

Outils pour administrateurs système : backups, restaurations, clonage de bases, migrations multi‑tenant et opérations de nettoyage. Essentiel pour maintenir la plate‑forme et gérer les environnements.

Design, accessibilité et intégrations UI

Bonnes pratiques UI/UX et accessibilité pour les composants typeahead : utilisation d'avatars/images dans les suggestions, navigation clavier, rôle ARIA, comportement dans dialogues/popovers et option de création rapide (focusWithName).

Assistant IA (OpenAI) pour rédaction et estimation

Fonctionnalités d'aide à la rédaction : estimer lignes de facturation à partir d'une description, reformuler du texte et corriger la grammaire via l'API OpenAI. Améliore la productivité lors de la rédaction des libellés ou descriptions.

Reporting & indicateurs (KPI)

Regarder des indicateurs clés (nombre d'apps, factures validées, achats, abonnements) pour piloter l'activité. Sert au suivi de la santé commerciale et comptable.

Contrôles anti‑flood, quotas et validation des destinataires

Règles et mécanismes de protection pour prévenir l'abus : contrôle anti‑flood, quotas selon le plan, vérification/validation des destinataires et gestion des échecs d'envoi liés aux limites.

Notifications & aides contextuelles

Afficher des toasts, tooltips et confirmations à l'utilisateur pour feedback et assistance. Améliore l'expérience en fournissant retours immédiats et aides intégrées.

Photo de profil et éditeur d'image

Modifier, prévisualiser et téléverser la photo de profil : ouvrir l'éditeur depuis le profil, recadrer l'image et l'envoyer via l'endpoint d'upload.

Observabilité & analytics (GTM, Sentry)

Instrumentation pour suivi d'événements (GTM) et rapport d'erreurs (Sentry). Fournit données analytiques et monitoring pour améliorer produit et réagir aux incidents.

Logs & surveillance (Sentry / Logging)

Collecter et router les logs applicatifs via plusieurs canaux (Logtail, Slack, Sentry), pour surveiller erreurs et performances. Permettre aux équipes de support de détecter et corriger rapidement les incidents.

Demander une signature (URL de signature)

Guide pas à pas pour initier une demande de signature depuis un devis ou une facture : sélection du document, génération d'une URL de signature via SignatureController et envoi au signataire. Inclut la logique métier (validation, états) et la gestion des quotas selon le plan.

Internationalisation et paramètres régionaux

Gérer la langue de l'interface, le format monétaire et la locale de parsing/formatage pour dates et nombres. Assure affichage cohérent selon la région de l'utilisateur.

Employés comptables et attribution

Ajouter et lier des employés comptables aux comptes : choisir parmi les utilisateurs existants via le dialog dédié, rechercher avec le typeahead et respecter les limites de la liste disponible.

Outils utilitaires (formats, dates, couleur, conversion)

Fonctions utilitaires pour formater dates, monnaies, manipuler couleurs, convertir chaînes et nombres, et helpers MD5. Améliore cohérence d'affichage et traitement des saisies utilisateurs.

Webhooks Yousign et traitement des documents signés

Documentation sur la réception et le traitement des webhooks envoyés par Yousign : validation de provenance, sécurité, idempotence, attachement des documents signés au devis/facture et mise à jour des statuts.

Internationalisation & langues des documents

Gérer les traductions et métadonnées linguistiques des documents commerciaux (factures/devis) pour produire des documents dans la langue du client. Indispensable pour facturer à l'international.

Intégrations IA / OpenAI

Utiliser des services OpenAI pour reformuler des textes, estimer des lignes de facturation ou corriger automatiquement du contenu. Aide à rédiger ou structurer des descriptions et automatiser certaines opérations textuelles.

Sécurité — changement de mot de passe

Changer le mot de passe d'un compte via un popover sécurisé : règles de validation, confirmation obligatoire (répéter) et sauvegarde via le composant EditPassword.

Pages publiques & accès externalisé de documents

Fournir des liens tokenisés et accès public sécurisé aux factures ou documents (exportinvoice) pour clients ou tiers sans authentification complète.

Administration partenaires & Intercom

Gérer informations des partenaires et synchroniser données d'apps/utilisateurs vers Intercom pour support et migration. Facilite le service client et l'intégration commerciale.

Prévisualisation pour YouSign (JPEG preview)

Comment générer et vérifier des aperçus JPEG des documents destinés à Yousign : pipeline de génération (storage / Rainer), exemples d'implémentation, bonnes pratiques pour vérifier le rendu, mise en cache et gestion asynchrone.

Outils UI & plugins (GTM, Sentry, Print, utilities)

Fonctionnalités front‑end et plugins pour analytics (GTM), monitoring (Sentry), impressions et utilitaires UI (téléphone, tooltips). Améliore la traçabilité, l'observabilité et l'expérience utilisateur.

API Keys & partenaires API

Générer et valider clés API pour partenaires et intégrations afin d'autoriser accès programmatique aux ressources d'une application. Permet d'automatiser intégrations externes en respectant la sécurité.

Sécurité & authentification JWT

Gérer l'authentification API via JWT, configuration des clés, durée de vie et algorithmes. Assure des accès API sécurisés pour utilisateurs et intégrations.

Intégration partenaire Yousign et scan des tenants (white‑label)

Procédures pour les intégrations partenaires : exécution de scans de tenants pour dispositifs Yousign en mode white‑label, commandes d'administration, permissions requises et workflows de synchronisation.

Créer une indemnité kilométrique

Guide pas à pas pour saisir une nouvelle indemnité kilométrique : ouverture du dialogue, sélection de l'employé, définition de la date et de la description, saisie du montant et enregistrement. Inclut les validations de date et les filtres par profil.

Permissions & contrôle d'accès

Vérifier et appliquer les droits utilisateur sur les routes et opérations via middleware et règles basées sur Swagger/roles. Garantie que seuls les utilisateurs autorisés effectuent des actions sensibles.

Tags, notes et catégories

Organisation et enrichissement des indemnités : comment ajouter et gérer tags, notes et catégories pour faciliter le classement, les recherches et le reporting.

Administration système & déploiement

Scripts et hooks de déploiement, installation de polices, préparation de workers et migrations. Permettre la mise en production automatisée et la gestion des workers.

Catalogue produits

Gérer la fiche produit et la navigation du catalogue : création/modification, références, prix, TVA et type, liste filtrable et triable, pièces jointes (images/docs) et tags. Inclut les règles sur suppression globale (opération destructive réservée et soumise aux droits).

Exports CSV & traitement de gros volumes

Exporter des jeux de données en CSV paginés et fournir un feedback à l'utilisateur pendant l'export. Utile pour extractions comptables, listages ou transferts vers outils externes.

Duplication et import de notes de frais

Procédure pour dupliquer une indemnité existante ou créer une note de frais à partir d'un document : quand utiliser la duplication, confirmation requise et points de vigilance avant enregistrement.

Administration des bases de données & migrations

Scripts de migrations et mises à jour de schémas pour tenir la base de données à jour (ajouts de colonnes, seeders). Important pour maintenir l'intégrité des données lors des évolutions produit.

Gestion des stocks

Suivi des quantités et des mouvements : ajout d'entrées de stock (quantité, date, prix, lot), tableau des stocks par produit, actions courantes (vente, retrait, retour, destruction) et principe d'historisation via des enregistrements Movement.

Gestion des organisations et contacts (CRM)

Permet de créer, modifier et organiser les entreprises, établissements et personnes avec lesquelles vous travaillez. Utile pour centraliser les informations de facturation, adresses, lieux et relations clients/fournisseurs afin de faciliter la facturation, la réconciliation et la communication.

Calculs, propagation et remboursement

Règles de calcul des montants, propagation automatique selon les règles métier et étapes pour l'envoi et le remboursement des frais de mission et déplacement.

Achats et dépenses (factures fournisseurs)

Enregistrer, traiter et suivre les factures fournisseurs et autres dépenses. Permet l’import, la saisie manuelle, la ventilation par comptes et la préparation pour la comptabilité.

Internationalisation & configuration pays (comptabilité)

Fournir configurations spécifiques par pays (plan comptable, règles TVA, options de facturation) pour garantir conformité locale. Utile pour déployer l'application multi‑pays.

Mouvements et opérations de stock

Mode opératoire pour enregistrer et consulter chaque mouvement : sorties temporaires (rental_exit), retours (rental_back), destructions, dialogues dédiés (Return/Remove/Temporary Exit) et consultation de l'historique via la fenêtre Movements. Validation des quantités et des dates lors des opérations.

Devis, factures et documents commerciaux

Créer, éditer, envoyer et archiver devis, factures et autres documents commerciaux. Permet de gérer le cycle commercial (devis → facture), d'attacher des modèles et d'exporter en PDF pour envoi aux clients.

Résumé du planning et KPIs

Vue d'ensemble concise des plannings avec indicateurs clés (KPIs), tuiles synthétiques et liste d'éléments cliquables pour explorer les détails.

Gestion de la trésorerie & rapprochement bancaire

Suivre les mouvements bancaires, synchroniser avec les banques (Bankin) et rapprocher automatiquement transactions et documents. Utile pour garder un solde à jour et automatiser les paiements/encaissements.

Traitement asynchrone & jobs

Gérer exécution de tâches en arrière‑plan (génération PDF, OCR, synchronisation bancaire, exports comptables) via la queue. Permet de délester les opérations longues hors du cycle HTTP.

Lots, expiration et alertes

Gestion des numéros de lot, dates d'expiration et périodicité des contrôles : configuration des alertes par seuils, suivi des lots en stock, règles de validation des dates, et mention des modules premium liés aux fonctionnalités avancées.

Facturation récurrente et abonnements

Automatise la génération de factures périodiques et la gestion des abonnements clients. Utile pour les services à facturation récurrente et l'intégration avec des moyens de paiement (Stripe) pour la gestion des abonnements.

Détail du timetable (dialogue)

Fenêtre détaillée affichant le timetable complet d'un élément : agenda, échéances, historique. Gère le chargement de gros volumes (loader) et propose la fermeture/retour.

Gestion des factures et devis

Créer, éditer, visualiser et envoyer les documents commerciaux (factures, devis, avoirs). Utile pour suivre les ventes, générer des PDF/FacturX, gérer le statut des paiements et communiquer les documents aux clients.

Suggérer un compte comptable

Guide pratique pour automatiser la suggestion de comptes à partir d'une description de ligne. Contient les bonnes pratiques de prompt, exemples d'appels 'suggest', gestion des ambiguïtés et recommandations pour validation humaine avant affectation comptable.

Paiements & intégration Stripe / PayPal

Gérer les paiements clients, abonnements et réconcilier les transactions Stripe/PayPal avec la comptabilité. Permet de traiter les webhooks, créer paiements et gérer l’état des abonnements.

Achats, traitement et OCR

Gérer les factures fournisseurs, lignes d’achats, pièces jointes et extractions automatiques via OCR. Permet d’importer les factures fournisseurs, d’extraire les informations et de préparer l’entrée comptable.

Édition inline des dates et échéances

Modifier directement les dates et échéances depuis des champs éditables en ligne, avec validation, sauvegarde et retours d'état. Détaille les appels vers les endpoints de mise à jour et gestion des erreurs.

Mandats SEPA & prélèvements

Gérer les mandats SEPA des clients et exécuter prélèvements. Utile pour automatiser les collectes et garder trace des signatures électroniques et identifiants de mandat.

Facturation récurrente (Auto‑invoicing)

Gérer les factures récurrentes planifiées : création de modèles récurrents, visualisation des exécutions, planification et génération automatique. Permet d'automatiser la facturation périodique et gagner du temps.

Estimation de facturation (billing estimate)

Mode d'emploi pour produire des estimations de facturation via OpenAI : structurer les données d'entrée, composer le prompt attendu, récupérer la réponse JSON et la parser. Inclut exemples de schémas JSON, gestion des erreurs et mentions sur coûts et limites d'appels.

Paiements et rapprochement bancaire

Enregistrer paiements, lier paiements aux factures/achats et rapprocher automatiquement les transactions bancaires. Utile pour maintenir des comptes à jour et détecter paiements non lettrés.

Regroupement par contact et cartes

Affichage groupé des plannings par contact, navigation vers adresses, visualisation sur carte et obtention d'itinéraires. Explique la bascule d'affichage et interactions liées au contact.

Comptabilité & exports (FEC / fichiers comptables)

Préparer et exporter les écritures comptables pour l’expert‑comptable ou logiciels externes. Permet générer des exports par période, les stocker, et les envoyer vers des intégrateurs (Pennylane, ACD, Agiris).

Achats et frais (Overheads / Purchases)

Enregistrer, compléter et gérer les factures fournisseurs (achats), y compris l’OCR, la ventilation par comptes, l’amortissement et le rapprochement. Utile pour piloter les dépenses et préparer la comptabilité.

Reformulation et correction intelligente

Fiches sur la reformulation et la correction grammaticale pour améliorer la qualité des libellés comptables et notes. Présente le 'smart corrector', options de style, variantes proposées et workflow pour valider et choisir la meilleure reformulation.

Connexions bancaires et synchronisation (Bankin)

Connecter des comptes bancaires pour synchroniser automatiquement les transactions et soldes. Facilite l’import automatique des écritures bancaires pour la comptabilité et le rapprochement.

Aperçu des règles bancaires

Introduction aux concepts clés : à quoi servent les règles de catégorisation automatique, comment elles s'intègrent au rapprochement bancaire, et principes d'évaluation (ordre des clauses, combinaison ET/OU). Présentation des types de paramètres (texte, montant, date) et des risques liés à des règles mal conçues.

Prévisionnel & Budgets (Forecast)

Créer et consulter des prévisions de trésorerie et de comptes, établir des budgets par catégorie et visualiser des graphiques KPI. Aide à anticiper la trésorerie et piloter la performance.

Comptes comptables et plan comptable

Gérer le plan comptable : créer/modifier comptes, catégories, paramètres comptables et mappings. Indispensable pour affecter correctement ventes/achats aux comptes comptables.

Extraction et validation de JSON depuis réponses brutes

Best practices pour isoler et nettoyer des objets JSON renvoyés par les modèles : heuristiques d'extraction, robustesse face aux réponses bruitées, implémentation de parseurs et stratégie de vérification humaine. Indique les risques de consommation de crédits et la nécessité de contrôles métiers.

Mandats SEPA et paiements SEPA

Gérer les mandats SEPA pour les prélèvements et exports SEPA (création, signature électronique, historisation). Indispensable pour automatiser les prélèvements récurrents et conserver les preuves de mandat.

Éditeur de règles (interface tableau)

Guide pas à pas pour utiliser l'interface en tableau : ouvrir l'éditeur, créer/éditer des règles et clauses, activer/désactiver des règles, et vue d'ensemble des colonnes et contrôles du tableau.

Gestion du catalogue & stocks

Manage products, catégories et stocks physiques. Suivre entrées/sorties, mouvements de stock liés aux ventes/locations et gérer emplacements/quantités.

Banque et synchronisation (Banking)

Connecter ses comptes bancaires, synchroniser les mouvements et visualiser les soldes. Permet d’automatiser l’import des relevés et de disposer d’un suivi de trésorerie en temps réel.

Authentification et configuration URSSAF

Configurer et gérer l'accès OAuth à l'API URSSAF : obtenir et stocker le token, rafraîchir les credentials, et sécuriser la configuration client utilisée par l'application. Cette page explique l'endpoint d'authentification, le cycle de vie du token, les bonnes pratiques de stockage et la règle imposant un token OAuth valide pour tous les envois.

Comptabilité générale et plan comptable

Gérer le plan comptable (comptes, catégories), produire des écritures comptables et préparer des fichiers d’export comptable. Essentiel pour suivre l’état financier et fournir aux experts-comptables le format attendu.

Construire des clauses et conditions

Fiche détaillée sur la création de clauses : choisir le paramètre (libellé, montant, date...), sélectionner l'opérateur adapté, saisir la valeur correcte, et organiser l'ordre des clauses. Explications sur les types d'input selon le paramètre et sur la logique ET/OU entre clauses.

OCR & import intelligent de documents

Analyser automatiquement les factures et documents importés grâce à OCR et services externes (Mindee, GPT‑4 Vision) pour pré-remplir champs et créer entités. Réduit la saisie manuelle et accélère le traitement des factures.

Rapprochement bancaire et règles d’automatisation

Associer automatiquement ou manuellement les mouvements bancaires aux factures/achats et paiements, définir des règles d’automatisation et consulter le journal des rapprochements. Facilite la tenue de la trésorerie et réduit les tâches manuelles.

Préparation et prévisualisation des envois

Construire et vérifier le payload envoyé à l'URSSAF : sélectionner factures/quotes/contacts, générer la prévisualisation (preview), valider le format et les limites des données avant envoi. Cette page couvre les règles de structure, contrôles de conformité et conservation des réponses de prévisualisation pour audit.

Exports vers logiciels comptables externes

Envoyer les données comptables vers des services externes (Pennylane, ACD Compta, Agiris) selon leurs formats et API. Permet de synchroniser les écritures avec les outils de l’expert-comptable ou d’autres systèmes tiers.

Actions automatiques et exécution

Comment définir les actions à effectuer lorsqu'une règle est satisfaite : assigner un compte, ajouter des tags, et combiner actions. Comprend le flux pour choisir une action, sauvegarder la règle et tester son application sur des transactions réelles ou simulées.

Automatisation & Règles métiers

Créer des règles et pipelines pour automatiser traitements (catégorisation bancaire, transformations, exports). Permet appliquer des modifications automatiques en fonction d’événements et conditions prédéfinis.

Exports comptables et intégrations (ACD / Pennylane / Agiris)

Générer et envoyer les exports comptables (FEC, formats partenaires) pour la tenue comptable ou l’intégration avec des outils tiers. Permet de préparer les écritures pour expert‑comptable ou services externes.

Enregistrement des clients auprès de l'URSSAF

Processus d'enregistrement d'un customer (personne de contact) auprès de l'URSSAF : champs requis, validations, mapping entre client interne et identifiant URSSAF, et stockage des réponses de l'API pour traçabilité. Inclut exemples d'appels register_customer et erreurs communes.

Prévision financière et budgets

Planifier et visualiser les prévisions de trésorerie, les budgets et KPI via des éléments de prévision et des graphiques. Aide à anticiper les besoins de trésorerie et à suivre l’atteinte des objectifs budgétaires.

Bonnes pratiques et dépannage

Conseils pour concevoir des règles robustes, méthodes de test et d'audit pour éviter les rapprochements erronés, exemples de pièges courants et procédures pour corriger les règles problématiques.

Notifications & Emails transactionnels

Envoyer et suivre les e‑mails transactionnels (envoi de factures, invitations, mots de passe) avec suivi d’ouverture, rebonds et plaintes. Permet attacher documents et activer suivi pour mesurer engagement.

Rapprochements & paiements (Gestion des règlements)

Enregistrer, visualiser et rapprocher les paiements liés aux factures et achats. Inclut la création de paiements, l’association à mouvements bancaires, et la gestion des statuts de règlement.

Envoi par lots et suivi des statuts

Envoyer des paiements groupés à l'URSSAF, mettre à jour les factures et journaux, et interroger les statuts des demandes. Cette page décrit la sélection des demandes, l'appel send_payments, la mise à jour post-envoi des factures et logs, puis l'utilisation de get_status pour récupérer l'état des envois. Rappels sur l'obligation d'un token valide et la conservation des réponses pour audit.

Stocks et gestion d'inventaire

Gérer le catalogue de produits, stocks, mouvements (entrées/sorties) et impacts comptables sur vente/achat. Permet de suivre les quantités disponibles, les emplacements et l’historique des mouvements.

Vue d'ensemble des offres

Page principale présentant la grille tarifaire et les fonctionnalités par plan pour aider l'utilisateur à comparer et choisir le bon abonnement. Inclut l'accès aux CTA de souscription et les indications sur les éléments réservés aux plans premium.

Événements & Webhooks

Gérer les événements techniques et webhooks sortants/entrants pour intégrer des services externes. Permet envoyer des notifications HTTP, tracer les réponses et stocker les événements pour audit.

SEPA (mandats, prélèvements, virements)

Gérer les mandats SEPA, générer des fichiers de prélèvement direct et de virement (SEPA Credit Transfer) pour effectuer des règlements massifs. Permet d'automatiser les paiements fournisseurs et clients via norme SEPA.

Génération PDF & aperçus JPEG

Guide pour produire les fichiers PDF des documents de vente (factures, devis) via Rainer et générer des aperçus JPEG destinés, par exemple, à la signature ou aux vignettes d'interface.

Gestion des pièces jointes et documents

Uploader, stocker et accéder aux fichiers associés aux documents (factures, achats, contrats). Fournit des URLs publiques/privées et gère le cycle de vie des pièces jointes.

Souscription et changement de plan

Guide pas-à-pas pour souscrire à un plan, changer d'abonnement ou migrer entre plans. Explique les redirections vers des stores externes si nécessaire ainsi que le traitement au prorata lors des changements.

Pièces jointes & gestion documentaire

Uploader, stocker et accéder aux fichiers liés aux documents (factures, justificatifs) avec URL publiques et gestion des types. Permet rattacher documents aux entités et récupérer les URLs de téléchargement.

FacturX (XML embarqué) et conformité

Explication de la génération du fichier FacturX conforme et de son intégration dans le PDF généré (XML embarqué), ainsi que des règles de conformité applicables.

Envoi d’emails et modèles (Documents & Notifications)

Composer, personnaliser et envoyer des emails contenant factures ou devis, gérer templates et signatures. Facilite la communication client avec des modèles réutilisables et envoi groupé.

Emails, notifications et suivi

Envoyer des emails (factures, invitations, support), suivre les ouvertures et gérer les erreurs de délivrabilité (bounces, complaints). Utile pour communication client et preuve d’envoi.

Résiliation d'abonnement

Processus de résiliation expliqué : comment ouvrir le dialogue de résiliation, saisir le motif, confirmer la demande et connaître les conséquences (accès, facturation, délais). Précise les obligations de collecte d'information avant confirmation.

Utilisateurs, invitations et politiques d’accès

Gérer les comptes utilisateurs, inviter des collaborateurs et attribuer des profils de droits (policies). Permet contrôler l’accès aux fonctionnalités et onboarder de nouveaux utilisateurs.

Visualisation et tableaux de bord (Reports & Dashboards)

Consulter tableaux de bord et rapports (CA, dépenses, cashflow, soldes comptes, détail TVA) via graphiques et modales analytiques pour piloter l’activité et la comptabilité.

Stockage, aperçus et thumbnails

Mode de stockage des PDF, XML et aperçus (thumbnails), dépendances au disque configuré (local ou S3), et bonnes pratiques pour la conservation et la récupération des fichiers.

OCR et extraction intelligente de documents

Analyser automatiquement les images/PDF de factures fournisseurs pour en extraire les informations clés (fournisseur, montant, date) via services externes (Mindee) et IA (GPT-4 Vision). Réduit les saisies manuelles.

Facturation et options premium

Accès et gestion des paramètres de facturation et des abonnements : consulter et mettre à jour moyens de paiement, voir l'historique, activer/désactiver options premium (lorsque gérées par le store) et comprendre les fenêtres explicatives pour éléments réservés.

CRM – Contacts & Organisations

Gérer les contacts (personnes) et organisations clients/fournisseurs : création, recherche, fusion de doublons et gestion des relations. Permet centralisation des informations clients et fournisseurs.

Flux asynchrone & endpoints d'export

Détails sur le flux asynchrone de génération (jobs), endpoints d'export et méthodes pour suivre la disponibilité des fichiers, gérer les erreurs et optimiser les appels.

Templates et modèles de documents

Gérer les modèles d’apparence et de contenu pour les documents commerciaux et emails afin d’assurer cohérence et personnalisation. Utile pour appliquer charte graphique et messages standardisés.

Export comptable vers prestataires (Pennylane, ACD, Agiris)

Connecter votre comptabilité à des services externes (Pennylane, ACD Compta, Agiris) pour pousser automatiquement les écritures et fichiers exportés. Réduit le travail manuel d’intégration avec l’expert‑comptable.

Sélecteur de modèles (carousel)

Comment ouvrir et utiliser le sélecteur visuel de modèles : navigation via carousel/slider, prévisualisation des rendus et choix du modèle adapté à vos besoins. Contient les bonnes pratiques pour parcourir les slides et repérer les variantes (layout, couleurs, marges).

Visionneuse documentaire et gestion des pièces jointes

Visualiser les documents (PDF/JPG), téléverser et organiser pièces jointes pour factures et achats. Utile pour conserver la preuve documentaire et pouvoir la joindre aux emails ou aux écritures comptables.

Configuration des endpoints webhook

Guide pas-à‑pas pour enregistrer et configurer les endpoints côté prestataires (Stripe, PayPal, Yousign, Teledec), gérer les secrets et endpoints de réception afin que les événements externes pointent vers l'URL de l'application.

Déclarations TVA et obligations fiscales

Préparer, envoyer et historiser les déclarations de TVA et autres déclarations obligatoires (Teledec, URSSAF). Facilite la conformité fiscale en automatisant la préparation des paquets de données requis.

Rapports, logs et supervision

Consulter journaux techniques, logs d’import, requêtes et événements pour diagnostiquer et auditer l’activité de l’application. Utile pour support, traçabilité et conformité.

Paramètres & Configuration (Comptabilité, Facturation, Onboarding)

Configurer les paramètres globaux de l’application : numérotation, TVA, templates, intégrations externes, onboarding et options d’automatisation. Permet d’adapter l’outil aux règles comptables et à la charte de l’entreprise.

Sécurité et idempotence des webhooks

Bonnes pratiques pour sécuriser les webhooks (vérification de signature, rotation de clés), gérer le traitement asynchrone (jobs en background) et garantir l'idempotence pour éviter doublons lors de réceptions répétées.

Activer et appliquer un template

Procédure pour activer ou désactiver un template et comprendre son impact : activation pour futurs documents, sauvegarde de la configuration et règles d'application (nouveaux vs existants).

Règles d'automatisation et moteur d'événements

Définir des règles conditionnelles qui modifient automatiquement des attributs ou déclenchent des actions lors d’événements (ex. catégorisation de transactions). Permet d’automatiser les traitements répétitifs.

Importer et exporter des templates

Guide sur l'import/export de modèles (si la fonctionnalité est prévue) : formats supportés, contraintes, étapes d'importation/exportation, et sauvegarde/restauration des configurations de templates.

Outils comptables & utilitaires (soldes, remplacements de comptes)

Fonctions d’aide à la tenue comptable : calcul des soldes par compte, remplacement massif d’un compte par un autre, allowances (indemnités kilométriques). Facilite la maintenance du plan comptable.

Exports & imports (CSV, SAP, Chorus Pro)

Importer et exporter des données (CSV, SAP attestations, Chorus Pro pour facturation électronique) afin de communiquer avec des outils tiers et respecter des obligations (ex: Chorus Pro pour marchés publics).

Traitement des paiements et réconciliation

Processus métier pour gérer événements de paiement et d'abonnement (principalement Stripe et PayPal) : décodage du payload, création de purchases, mise à jour des subscriptions, génération de factures/transactions et règles de reconciliation.

Webhooks et événements

Envoyer et recevoir des événements via webhooks pour intégrer des systèmes externes et assurer une communication évènementielle. Utile pour déclencher des processus externes ou notifier des partenaires.

Personnalisation et alignement à l'image de marque

Conseils pour personnaliser un template afin qu'il reflète votre branding : couleurs, logo, typographie, blocs d'information, et utilisation de la prévisualisation pour valider le rendu final avant activation.

Gestion des modèles & templates

Créer et gérer modèles de documents et templates d’e‑mail / web pour homogénéiser la communication et la présentation des documents (en-tête, pied de page, style).

Gestion des modèles PDF & numérotation

Choisir et configurer les modèles de documents (apparence) et définir la logique de numérotation pour factures et devis. Assure cohérence de l’identité visuelle et conformité des références.

Observabilité : journaux, erreurs et reprise

Comment visualiser et diagnostiquer les webhooks côté administration : journaux d'événements, suivi des erreurs, mécanismes de retry/reprise, et gestion des pièces jointes (PDF Teledec) et statuts de signature (Yousign).

Clés API, partenaires et intégrations tierces

Gérer les clés API, partenaires et autorisations pour permettre des intégrations externes (apps partenaires, installations, flux API). Facilite la sécurisation et le contrôle des accès API pour intégrations tierces.

Aperçu et principes

Concepts clés de l'export CSV paginé : pourquoi paginer, modèles asynchrones, contraintes de timeout et feedback visuel. Idéal pour comprendre les règles d'architecture et les attentes UX avant implémentation.

Onboarding, création et suppression d’applications (multi‑tenant)

Gérer la création, le provisioning et la suppression d’instances/applications (multi‑tenant). Comprend la création de base de données, initialisation des paramètres et nettoyage lors de suppression.

Automatisations & tâches planifiées (Jobs et on‑demand)

Automatiser des actions récurrentes (synchronisations bancaires, OCR, génération d’exports comptables, envoi de relances) via jobs planifiés ou déclenchements manuels pour délester les tâches répétitives.

Introduction & architecture du ResourceController

Vue d'ensemble du contrôleur générique : rôle du ResourceController, flux de requête/response, transformation des ressources, conventions de payload et bonnes pratiques pour uniformiser listings et pages d'édition.

Configuration de l'export

Comment permettre aux utilisateurs de choisir les colonnes, définir la période, nommer le fichier et sauvegarder des presets. Bonnes pratiques UX pour des sélections claires et des noms de fichiers explicites.

Support partenaires & intégrations API partenaires

Gérer la relation avec des partenaires, leurs collaborateurs et les clefs API pour intégration. Utile pour proposer intégrations, installations partenaires et accès restreint.

Contrôle des droits & navigation (Menus, pages, politique d’accès)

Gérer l’accès aux fonctionnalités via menus, contrôles d’accès et layouts adaptés (white‑label, onboarding). Permet d’afficher ou masquer des fonctionnalités selon les droits et l’état d’onboarding.

Listings paginés, filtrage et moteur de recherche

Détail de ResourceController::list et du ResourceSearcher : construction de filtres et d'ordres, pagination, tokens spéciaux (search_specials) et conversion en clauses Eloquent pour des recherches puissantes et réutilisables.

Administration multi-tenant : création et suppression d'apps

Gérer le cycle de vie des instances applicatives (apps multi-tenant) : créer base de données dédiée, appliquer seeds et config, supprimer app et nettoyer ressources. Permet de provisionner de nouveaux clients/tenants.

Gestion des utilisateurs, invitations et politiques d'accès

Gérer les comptes utilisateurs, invitations d’accès, profils de droits et collaborations partenaires. Permet d’inviter des collaborateurs, attribuer des profils et contrôler l’accès aux fonctionnalités premium ou restreintes.

Lancer et suivre l'export

Flux d'exécution côté client : déclencher l'export, afficher toasts/badges de progression, gestion des téléchargements quand le fichier est prêt. Exemples d'états et messages utilisateur.

Recherche & filtres (interfaces de listes)

Rechercher et filtrer rapidement les listes (factures, achats, transactions, contacts) avec filtres avancés (dates, montants, comptes, clients) pour trouver et agir sur des sous‑ensembles de données.

Opérations CRUD individuelles

Processus complet pour récupérer (GET), créer (POST), mettre à jour (PUT) et supprimer une ressource : validation, persistance, transformation de sortie et gestion des checks d'abonnement/droits via le contrôleur.

Gestion des templates et modèles de documents (SalesDocumentModel)

Créer des modèles de documents (devis, factures) réutilisables pour standardiser la facturation et accélérer la création de documents.

Gestion des abonnements et facturation Stripe

Intégration avec Stripe pour gérer clients, abonnements, webhooks et synchronisation des factures Stripe vers la comptabilité. Permet d'automatiser la création d’écritures à partir d’événements Stripe.

Erreurs, relances et reprise

Procédures pour gérer les erreurs réseau, les timeouts et les interruptions ; stratégies de reprise et de relance d'export, notifications à l'utilisateur et conservation des logs d'export.

Services administratifs & tâches asynchrones (Jobs)

Suivre et déclencher des tâches de fond (jobs) pour traitements longs : OCR, génération PDF, export comptable, synchronisations bancaires, backups, et plus. Assure scalabilité et résilience des opérations intensives.

Gestion des tags et actions en masse

Tagger des documents ou contacts et appliquer des actions en masse (édition, suppression, envoi) pour faciliter l’organisation et le traitement groupé.

Opérations en batch et gestion d'erreurs partielles

Guide pour create/update/delete en masse : envoi de tableaux d'objets, stratégie de validation par élément, retours avec erreurs partielles, transactions et recommandations pour la tolérance aux erreurs.

Interface d'administration (Nova)

Interface d’administration back-office pour gérer tous les objets (comptes, factures, utilisateurs, exports). Fournit des ressources, champs, filtres et actions pour les administrateurs techniques ou comptables.

Architecture serveur et bonnes pratiques

Patrons serveur pour exporter de gros volumes : pagination/offset, cursors, jobs en arrière-plan, streaming vs batch, limites et optimisation des requêtes. Recommandations pour surveiller et sécuriser les exports.

Gestion des utilisateurs & clés API

Gérer les accès via comptes utilisateurs globaux et clés API pour intégrations partenaires. Permet aux partenaires ou outils externes d’accéder aux données via API sécurisée.

Sécurité, autorisations et middleware

Explication des règles d'accès : AppPolicies et AppConnexion, vérifications d'abonnement et de droits au niveau des endpoints, bonnes pratiques pour intégrer les contrôles d'accès dans le flux ResourceController.

Journaux techniques, audit et suivi des requêtes

Collecter et consulter les logs techniques et traces de requêtes pour le debug, l’audit et le support. Indispensable pour diagnostiquer erreurs et suivre l’historique des opérations.

Gestion des journaux et périodes de clôture

Paramétrage et gestion des journaux comptables, des codes associés et des périodes de clôture. Guide pas-à‑pas pour ouvrir le module, éditer les journaux et sauvegarder une configuration conforme aux conventions internes et légales.

Exports comptables & FEC (fichier des écritures comptables)

Préparer, vérifier et exporter les écritures au format attendu par les logiciels comptables et par l’administration (FEC), et suivre l’intégrité entre écritures et fichier exporté. Utile pour les obligations légales et les échanges avec les experts-comptables.

Gestion des modèles et outils front‑end (ViewModules, templates, couleurs)

Gérer les modules UI, assets et templates frontaux pour construire les pages : inclusion de JS/CSS, enregistrement de modules, autoload des composants et rendu des vues.

Authentification et API Keys

Méthodes d'authentification supportées (Bearer JWT et Api-Key), traitement des API Keys comme identifiants alternatifs, journalisation pour audit et bonnes pratiques d'implémentation du middleware Authenticate.

Kilométrage et indemnités

Enregistrer des indemnités kilométriques des employés avec calculs basés sur fiscal power et type de véhicule. Permet de produire des remboursements et d’intégrer les coûts en comptabilité.

Mapping des comptes collectifs pour export

Définir et maintenir le mapping des comptes collectifs destinés aux exports légaux et fiscaux. Comprend la configuration des correspondances, les règles de consolidation et les vérifications avant export.

GED & gestion des pièces jointes

Stocker, classer, transférer et lier des documents (factures, justificatifs) dans une GED et sur des paniers (baskets). Permet d’organiser les pièces pour l’archivage, la comptabilité et les échanges externes.

OCR et reconnaissance automatique des factures

Analyser automatiquement les factures fournisseurs importées via OCR pour pré-remplir les champs (montants, TVA, dates). Réduit la saisie manuelle et accélère la mise à jour des achats.

Validation d'appId et contexte multi‑tenant

Validation de l'appId entrant et initialisation du contexte multi‑tenant via AppConnexion. Processus d'initialisation de la connexion DB tenant, isolation des données et implications pour le routing des requêtes.

Partenariats, parrainage et collaborateurs partenaires

Gérer les partenaires, collaborateurs partenaires, coupons et parrainages entre apps. Utile pour gérer offres partenariat et accès de collaborateurs externes.

Remplissage automatique et référence autofil

Activer et paramétrer les options de remplissage automatique (référence autofil) pour accélérer la saisie tout en garantissant la conformité des références. Inclut l'édition des règles et leurs impacts sur les exports.

Facturation – Devis, Factures et FactureX (e-invoicing)

Créer, éditer, envoyer et exporter devis et factures, y compris génération de fichiers FactureX (XML) pour la facturation électronique. Utile pour produire des documents commerciaux conformes et automatiser les envois.

Tableau de bord (Dashboard)

Vue d'ensemble financière offrant un aperçu rapide de la trésorerie, du chiffre d'affaires, des achats et de la TVA. Utile pour suivre la santé financière du business et accéder rapidement aux sections opérationnelles.

Contrôle d'accès et AppPolicies

Enforcement des politiques d'accès par application (AppPolicies) : définition des règles, ordre d'évaluation, gestion des refus et stratégies d'audit pour garantir que seuls les appels autorisés accèdent aux ressources.

Importations et synchronisations (générales)

Importer des données depuis des services externes (Stripe, Bankin, FactureX) et synchroniser des informations entre systèmes. Automatise la collecte de données financières et documents.

Import et règles d'export spécifiques

Importer des listes de codes et des règles d'export personnalisées, valider les mappages et tester les exports. Procédure d'import, erreurs courantes, et bonnes pratiques de validation avant mise en production.

Paiements, transactions & rapprochement bancaire

Enregistrer paiements, lier transactions bancaires aux factures, effectuer le rapprochement automatique et manuel des écritures bancaires. Crucial pour suivre la trésorerie et s’assurer de la concordance banque/comptabilité.

Gestion TVA & Télé‑déclaration (Teledec)

Consulter et préparer les déclarations de TVA, visualiser la TVA collectée/déductible et configurer les paramètres de télé‑déclaration. Permet d'assurer la conformité fiscale et d'anticiper les montants à payer.

White‑label et override de configuration

Application de configurations spécifiques par hostname via le middleware WhiteLabel. Comment remplacer la configuration runtime selon le domaine/hostname, ordre de priorité et impacts sur les middlewares en aval.

Saisie et envoi des écritures comptables

Permet aux utilisateurs de créer, valider et transmettre des écritures comptables vers des services externes (ACD, Pennylane). Utile pour automatiser la tenue de comptes et garantir que les écritures sont correctement enregistrées dans les logiciels comptables partenaires.

Envoi massif de factures

Comment préparer et lancer des envois groupés de factures (par tags d'email), paramétrer les listes de destinataires, gérer les confirmations et comprendre les limites liées au plan.

Prévisions & tableaux de bord (Forecasts & Charts)

Construire des prévisions financières, tableaux de bord et graphiques (KPIs, budgets, cashflow) pour piloter l’activité. Permet d’anticiper la trésorerie et suivre des indicateurs clés.

Sanitisation XSS des entrées

Sanitisation des inputs POST/PUT pour prévenir injections XSS. Comportement du middleware XssSanitization, transformations appliquées (ex. remplacement de <br> par espaces) et recommandations pour l'équilibre sécurité/compatibilité.

Onboarding

Parcours guidé d'accueil et configuration initiale chargé dans une iframe. Permet d'accompagner les nouveaux utilisateurs pas à pas pour configurer leur compte et leurs paramètres essentiels.

Export comptable et génération de fichiers (FEC, exports)

Génère et gère des fichiers d'export comptable (FEC, fichiers d'export par période) et vérifie leur intégrité. Utile pour fournir aux experts‑comptables des fichiers conformes et réconciliés avec les écritures.

Remplacement global de comptes comptables

Procédure pour remplacer un compte comptable par un autre dans l'ensemble du système : lancement du flux DialogAccountingReplace, choix du compte de remplacement, validation, conséquences et bonnes pratiques (prévisualisation, sauvegarde, validation des droits).

Import de données (Importer)

Interface d'import pour rapatrier des données externes via une application embarquée (iframe). Utile pour migrer des clients, produits ou documents depuis d'autres sources.

Créer et éditer devis & factures

Guide complet pour créer, modifier et composer vos devis et factures : entête client, lignes produit/services, taxes, conditions et pièces jointes. Présente l'éditeur intégré (iframe ou page dédiée), les règles de validation (au moins une ligne requise) et les bonnes pratiques pour sauvegarder et conserver l'historique client.

GED / Gestion électronique de documents

Gérer l'arborescence GED, transférer des documents entre paniers et GED et attacher des pièces aux écritures. Cela facilite l'organisation et la consultation des pièces justificatives liées aux écritures comptables.

Export et génération d'écritures en lot

Guide pour exporter ou générer des écritures en masse : sélection des documents, choix du format d'export, lancement du traitement en lot, récupération des fichiers et gestion des éventuelles erreurs.

Signature électronique (YouSign / Yousign V3)

Créer des procédures de signature électronique, ajouter documents et signataires, obtenir liens de signature et télécharger documents signés. Permet de faire signer contrats, devis et factures de façon légale et traçable.

Saisie & validation d'adresse (Modal Adresse)

Formulaire modal pour rechercher et saisir une adresse postale à l'aide d'autocomplétion et champs détaillés. Utile pour renseigner établissements, siège social ou adresses de contacts.

PDF, FacturX & templates

Tout sur la génération, la prévisualisation et la gestion des PDF et FacturX : comment générer le PDF/XML, visualiser un aperçu/JPG et choisir ou configurer un template d'impression via le carrousel. Explique les cas où le PDF devient obsolète et comment régénérer/archiver correctement les documents.

Intégration Bankin (connexion bancaire)

Connecter des comptes bancaires, synchroniser les transactions et gérer les utilisateurs Bankin. Utile pour automatiser l'import bancaire et préparer le rapprochement des flux.

Supervision, quotas et sécurité des actions en masse

Informations transverses sur la supervision des traitements en masse : tableau de bord de progression, notifications de fin, règles de confirmation, contrôles d'accès, quotas selon le plan, journalisation et bonnes pratiques pour limiter les risques.

Transmission de factures au secteur public (Chorus Pro)

Rechercher structures publiques, encoder et uploader factures vers ChorusPro pour la facturation électronique des entités publiques. Facilite l’envoi conforme aux plateformes de l’administration.

Gestion d'images & Uploads (Prompt Image)

Modal permettant d'uploader une image ou de fournir une URL d'image. Pratique pour ajouter des visuels (avatar, logo) ou illustrer des documents.

Numérotation, conversion & avoirs

Règles et flux pour la numérotation automatique, la conversion de devis en facture et la gestion des avoirs/crédit-notes. Détaille le format de numérotation configurable, la génération du numéro via l'API, et les actions documentaires communes (dupliquer, finaliser, créer avoir).

Intégrations comptables (Pennylane, Agiris, etc.)

Synchroniser comptes, journaux, pièces jointes et écritures avec des prestataires comptables (Pennylane notamment). Pratique pour externaliser tenue comptable tout en gardant les données synchronisées.

Formulaires dynamiques & Prompts

Modal générique pour rendre des formulaires dynamiques côté serveur (champs générés dynamiquement). Permet de solliciter des informations contextuelles sans créer une page dédiée.

Envoi, suivi & signatures

Envoyer des documents par email (envoi unique ou en masse), suivre les ouvertures et gérer les retours (bounces/complaints). Comprend la composition de messages, attachement de PDF, demande de signature électronique et les limitations liées aux droits/plan.

Configuration des intégrations

Guide étape‑par‑étape pour activer et paramétrer les connexions tierces depuis le panneau d'intégrations : ajouter des identifiants, choisir OAuth ou clé API, et comprendre les limitations liées au plan.

Facturation (devis & factures & envoi électronique)

Créer des devis et factures, générer les documents (PDF / FactureX XML), envoyer automatiquement aux clients et vers des plateformes (ChorusPro, Yousign). Idéal pour piloter la facturation, le suivi client et les obligations légales.

ChorusPro — Recherche et envoi de factures

Fonctions dédiées à l'échange avec ChorusPro : recherche d'informations de facturation (NIC, etc.), lancement de requêtes d'envoi, suivi et vérification des résultats.

Agrégateur bancaire (Bankin) & synchronisation

Connecter des comptes bancaires via Bankin pour récupérer comptes, banques, transactions et gérer la synchronisation. Permet d’automatiser l’import des mouvements bancaires pour le rapprochement.

Compatibilité du navigateur & Aide d'accès

Écrans d'information indiquant si le navigateur est compatible ou obsolète et proposant des solutions. Permet d'assurer une expérience optimale et d'indiquer des navigateurs supportés.

Gestion en masse, récurrences & exports

Fonctions pour gérer plusieurs documents à la fois : filtres, modifications par lot, exports CSV, suppression en masse et factures récurrentes. Explique les confirmations requises, les effets des statuts sur la synchronisation et la gestion des échéances/retards.

Pennylane — Redirection et autorisation

Procédure pour connecter des comptes Pennylane : flux de redirection OAuth, gestion des clés API, bonnes pratiques pour autoriser l'accès depuis l'application et contrôle des permissions.

Contacts & CRM (organisations, personnes, établissements, adresses)

Gérer fiches clients/fournisseurs (organisations et personnes), établissements et adresses, ainsi que les relations (client/fournisseur/prospect). Utile pour centraliser les interlocuteurs et leurs coordonnées pour la facturation et la relation client.

Navigation & Layout (Topbar, Sidebar, Menu)

Composants globaux de navigation (topbar, navbar, sidebar, switcher d'entreprise). Facilitent l'accès aux sections de l'application, au changement d'entreprise et aux paramètres utilisateurs.

Créer et gérer les factures fournisseurs

Procédures pour créer, modifier et sauvegarder des achats/factures fournisseurs. Comprend le flux d'ajout d'achat, les champs principaux et les comportements automatiques liés aux account_id.

Intégration Chorus Pro (facturation publique)

Transmettre des factures vers la plateforme Chorus Pro (obligatoire pour la facturation aux entités publiques françaises). Permet d'automatiser l'envoi et le suivi du statut des factures publiques.

Webhooks — Réception et sécurité

Documentation sur la réception et le traitement des webhooks externes (Stripe, Yousign, Teledec, TeledecWebhookController, ...). Validation, sécurité (signatures, secrets), et gestion des erreurs/retransmissions.

Produits, stocks & mouvements d’inventaire

Gérer catalogue produits, catégories, stocks, mouvements (entrées/sorties) et numéros de lot/expiration. Utile pour suivre la disponibilité et le coût des marchandises.

Authentification & Gestion de session

Pages de connexion, récupération de mot de passe et déconnexion. Permet aux utilisateurs d'accéder à leur compte, de réinitialiser leurs identifiants et de gérer la sécurité.

OCR et extraction automatique des factures

Détaille le processus d'analyse OCR (Mindee + GPT-4 Vision), le job asynchrone OCRPurchase, l'application des résultats via OCREntry et comment superviser/corriger les données extraites.

Intégration Pennylane (export & synchronisation comptable)

Synchroniser comptes, journaux, pièces jointes et écritures avec Pennylane : importer comptes/journaux/fiscal years et envoyer écritures/attachements. Permet une liaison bi‑directionnelle pour tenir à jour la comptabilité externe.

Policies et contrôles d'accès

Définir et appliquer les policies qui gouvernent l'accès aux éléments de l'interface et aux actions. Explique comment les policies sont évaluées par requête, comment l'interface respecte appStore.allows(...) et comment les administrateurs gèrent ces droits depuis l'admin.

PDF, templates & exports (Rainer)

Générer des PDF à partir de templates HTML, créer aperçus JPG, vignettes et archives ZIP pour téléchargement. Permet d’obtenir des documents imprimables et des prévisualisations pour les factures et autres documents.

Contacts & Membres (Contact Cards)

Gestion des contacts et établissements : création, édition inline, suppression, fusion et gestion des adresses. Permet d'organiser les relations clients/fournisseurs et leurs points de contact.

Pièces jointes et aperçu des achats

Gestion des images et PDF de facture : téléversement, visualisation et génération d'aperçus (preview) en PDF/JPG. Explique aussi le job de génération d'aperçu et le stockage des fichiers.

Authentification et gestion des tokens

Flux d'authentification utilisateurs : pages de login, gestion des tokens via nuxt-auth, réaction aux erreurs API (401) et scénarios de réauthentification/redirects (RedirectIfAuthenticated). Comprend bonnes pratiques pour renouvellement et invalidation de sessions.

Stockage de fichiers & CDN (SinaoStorage)

Uploader, organiser et récupérer fichiers (documents, images) sur le stockage (S3 ou local), générer noms/paths et URLs publiques. Utile pour centraliser les médias et documents liés aux enregistrements.

Fiche profil personne / relation commerciale

Fiche détaillée d'une personne/tiers : informations de contact, relations commerciales (client/fournisseur/prospect), conditions de paiement, notes et données comptables. Permet de configurer la relation commerciale et suivre l'historique facturé.

Répartition comptable (breakdowns) et édition des lignes

Comment décomposer une dépense en lignes comptables, vérifier et modifier les breakdowns générés automatiquement, et sauvegarder les écritures prêtes pour la comptabilité.

URSSAF – Paiements et enregistrements des tiers

Interagir avec l'API URSSAF pour enregistrer des clients/tierces parties et déclarer des paiements. Utile pour automatiser les déclarations sociales et la communication de paiements vers l'URSSAF.

Middlewares applicatifs

Catalogue et utilisation des middlewares côté application et API : AppConnexion, AppPolicies, AppPolicyOwner, SwaggerCheckRequest, WhiteLabel, XssSanitization, VerifyCsrfToken, TrimStrings. Quand et comment les chaîner pour protéger routes et données.

Notifications & toasts (UI feedback)

Afficher des notifications/toasts pour informer l’utilisateur des réussites, erreurs ou états d’avancement (import, export, envoi). Améliore l’expérience en fournissant des retours immédiats.

Gestion des organisations (création & profil)

Création et gestion de fiches entreprise/organisation, y compris import via INSEE, adresses et informations juridiques. Utile pour centraliser les données légales et contacts d'une entreprise.

Devises, conversion et indicateurs de paiement

Gestion des factures en devises étrangères, déclenchement et logique de conversion des montants, paramétrage des dates d'échéance et affichage des indicateurs de retard de paiement.

Affichage conditionnel et boîtes premium

Règles d'interface pour masquer ou montrer actions, pages et dialogues selon les permissions et flags premium. Comporte exemples (is_superadmin, appStore.allows) et comportements utilisateur : empêcher l'action ou afficher une fenêtre 'premium'.

Mon compte (profil utilisateur & sécurité)

Gestion du profil utilisateur : identité, avatar, email de connexion et mot de passe. Permet à l'utilisateur de maintenir ses informations personnelles et sécuriser son accès.

Génération massée d'écritures

Créer les écritures comptables à partir des ventes, achats et mouvements bancaires sur une période donnée. Présente le flux GenerateAccounting (job), les transactions DB, le suivi progressif des exports partiels et les règles de rollback en cas d'erreur.

Utilitaires de données (dev utils : currency, dates, strings)

Fournir utilitaires pour conversion de devises, calcul de périodes (semaines, mois, trimestres), normalisation de chaînes pour recherche et génération de libellés. Ces outils facilitent les calculs et transformations nécessaires aux fonctionnalités métier.

Génération de PDF et gestion des modèles

Créer des PDF depuis des templates HTML, injecter numéros de pages, générer des aperçus JPEG et créer des archives ZIP de fichiers. Utile pour produire des factures, bordereaux et aperçus imprimables.

Stockage et gestion des fichiers (S3 / URLs)

Permet de nommer, uploader, télécharger et obtenir des URLs publiques pour les fichiers stockés (S3 ou disk local). Utile pour centraliser les pièces jointes, PDFs et images accessibles via l'application.

Protections serveur et endpoints sensibles (CSRF, XSS, Swagger)

Mesures serveur pour protéger opérations sensibles : gestion CSRF, sanitation XSS des entrées POST/PUT, trimming des chaînes, réponses 401 et comportements associés, verrouillage des endpoints Swagger et publiques.

Paramètres organisationnels (Organisation settings)

Édition des informations de l'entreprise (logo, établissements, informations juridiques et financières). Permet d'adapter la fiche société et sa présence sur les documents commerciaux.

Création et téléchargement des fichiers d'export

Produire les fichiers d'export réglementaires (FEC, ACD) ou destinés aux services externes (Pennylane, Agiris). Expliquer GenerateAccountingExportFile, formats générés, gestion des statuts (processing/finished/failed) et interface de téléchargement.

Recherche API & documentation (Swagger Reader)

Consulter le catalogue d’API exposées via Swagger, résoudre operationId en chemins/méthodes controller et tester les routes. Utile pour les développeurs et pour routage dynamique côté front.

Gestion des produits, stocks et mouvements

Gérer catalogue produits, catégories, stocks et mouvements d'entrée/sortie pour suivre les niveaux de stock et les retours. Utile pour facturer correctement et suivre l'inventaire.

Vue d'ensemble du tableau de bord

Présentation générale du dashboard : objectifs, composants principaux et premier parcours pour obtenir un aperçu rapide de la santé financière (CA, trésorerie, KPIs). Indique comment ouvrir la page et lire les éléments clés.

Authentification, permissions & invitations

Gérer utilisateurs, invitations, policies et accès aux apps multi-tenant, y compris l’envoi d’invitations et l’attribution de profils de droits. Permet de sécuriser l’accès et gérer le partage avec collaborateurs/expert-comptable.

Intégration PayPal

Configurer PayPal comme moyen de paiement : saisie du Client ID, chargement SDK et rendu des boutons PayPal. Permet d'accepter des paiements via PayPal pour l'abonnement ou la facturation.

Envoi vers services externes (ACD, Pennylane)

Transmettre les écritures comptables directement aux services partenaires. Décrire les services AcdComptaService et ExportAccountingEntriesToPennylane, le workflow d'envoi depuis l'export_file et les exigences d'authentification/paramétrage.

Achats et notes de frais (purchases)

Enregistrer des achats et notes de frais, gérer leurs lignes, attacher des justificatifs et suivre le paiement/comptabilisation. Utile pour gérer les dépenses et assurer la conformité fiscale.

Cartes de synthèse et widgets

Détail des tuiles et widgets : contenu des cartes (chiffre d'affaires, trésorerie, KPIs), comportements (loader pendant récupération des données), badges de statut, et règles de visibilité selon les droits utilisateur.

Onboarding & multi-app navigation

Accompagner la mise en route avec un parcours d’onboarding, inclure applications embarquées via iframes (billing, importer, charts) et proposer un menu d’apps pour naviguer entre modules. Facilite la prise en main et l’accès aux mini-apps.

Programme de parrainage (Sponsorship)

Espace pour gérer le parrainage : lister les filleuls, générer/partager un code de parrain et suivre l'état. Utile pour stimuler la croissance via des recommandations.

Contrôle d'intégrité et réconciliation FEC

Vérifier la conformité et l'intégrité des écritures exportées en les comparant au FEC final. Expliquer le processus automatique de comparaison, les types de messages d'intégrité ajoutés et comment interpréter les écarts détectés.

Paiements et encaissements

Enregistrer paiements reçus et effectués, lier aux factures ou achats, et gérer les relevés bancaires. Permet de suivre les soldes, échéances et relancer les clients si besoin.

Graphiques, forecast et KPIs

Explication des visualisations : types de graphiques disponibles, lecture des courbes de forecast, métriques KPI, interaction (zoom, survol) et navigation vers les pages détaillées via clic.

Intégration URSSAF (tiers & paiements)

Enregistrer et synchroniser des tiers URSSAF, envoyer et rechercher des paiements auprès de l’API URSSAF. Permet de déclarer / payer des cotisations sociales via un flux automatisé.

Paramètres Stripe

Interface de configuration de Stripe (clés, webhooks) et outils de synchronisation. Permet d'accepter/traiter les paiements par carte et gérer les webhooks pour réconciliation automatisée.

Visualisation des comptes et outils de gestion

Explorer les comptes, catégories et écritures générées ; gérer la maintenance des plans comptables. Documenter l'outil ReplaceAndDeleteService pour remplacer ou supprimer un compte et les impacts sur les écritures.

Prévisionnel & Reporting (Forecasts & Charts)

Construire des prévisions, visualiser des graphiques et suivre des KPIs (chiffre d'affaires, dépenses, budgets). Utile au pilotage financier, à la planification budgétaire et au suivi de performance.

Navigation et accès rapide

Comment utiliser la sidebar et les raccourcis pour accéder aux modules clés (bank/cashflow, factures, contacts), bonnes pratiques de navigation et flux entre dashboard et modules détaillés.

Système de logs, monitoring & erreurs (Sentry/Logtail)

Collecter logs applicatifs, erreurs et traces via Sentry et Logtail pour le monitoring et le debugging. Permet de détecter et analyser incidents impactant les utilisateurs.

Gestion des abonnements & Paiements

Interface de gestion d'abonnement client : sélection de plan, paiement (Stripe), ajout de moyen de paiement, extension d'essai, résiliation et traitement des factures impayées. Permet de piloter la facturation et la relation commerciale d'abonnement.

Gestion des comptes bancaires

Voir et administrer les comptes/connecteurs de trésorerie. Inclut lister les sources cashflow, connecter de nouveaux comptes via Bankin OAuth, et gérer l'état (enabled/disabled) des comptes.

Aide contextuelle, tooltips et permissions

Guide sur l'aide embarquée : tooltips, définitions des KPI, messages d'erreur/état de chargement, et gestion des droits (widgets masqués selon permissions). Comprend exemples et bonnes pratiques pour aider l'utilisateur sur place.

Recherche et enrichissement d’informations publiques (INSEE, VIES, Public Organizations)

Interroger des sources publiques (INSEE, VIES, PublicOrganization) pour enrichir les fiches entreprises (SIRET, TVA, adresses) et hydrater automatiquement les informations d’un client/fournisseur.

Édition de templates web (Web Template Editor)

Editeur HTML pour personnaliser les templates web (header/footer/style) avec un éditeur de code (Ace). Permet d'adapter l'apparence et le rendu des pages/notifications web.

Synchronisation et import Bankin

Fonctionnement de la synchronisation des mouvements depuis Bankin : lancer des synchronisations manuelles ou planifiées, comportement asynchrone, options du job et suivi des imports.

Notifications et suivi produit (Intercom)

Synchroniser des métriques organisations/utilisateurs avec Intercom pour le support, les messages ciblés et l'analyse produit. Utile pour le support client et le suivi d'adoption fonctionnelle.

Règles automatiques & catégorisation (bankin rules)

Définir et appliquer des règles de catégorisation automatique pour les transactions bancaires (ex : moteur de règles Bankin) afin d’automatiser le rapprochement et la classification comptable.

Gestion des stocks & Inventaire

Gestion complète du catalogue produits, des stocks (entrées, sorties, retours), des catégories et historique de mouvements. Permet de suivre la disponibilité, acheter du stock et générer des mouvements.

Rapprochement & AutoReconcile

Comment rapprocher automatiquement ou manuellement les mouvements avec factures/achats : principe d'AutoReconcile, déclencheurs, et actions manuelles pour créer des paiements.

Démarrage et questionnaire initial

Guide pas à pas pour lancer l'onboarding depuis le tableau de bord ou la configuration, choisir entre test ou configuration réelle et compléter le questionnaire d'accueil. Explique la navigation entre étapes (Précédent / Suivant / Ignorer) et les choix qui orientent le reste du parcours.

Gestion des utilisateurs, invitations et politiques

Inviter des utilisateurs, gérer leurs politiques/permissions et conserver des invitations expirables. Utile pour permettre aux équipes d'accéder à l'application avec des droits configurés.

Administration multi-tenant & bases de données d’application

Gérer connexions multi-tenant, basculer de base de données d’un app à l’autre, et exécuter opérations d’administration et migrations. Nécessaire pour les environnements SaaS multi-apps et le maintien opérationnel.

Identification de l'entreprise (SIREN / SIRET)

Recherche et import rapide des données d'entreprise via l'API INSEE. Montre comment rechercher par SIREN/SIRET, sélectionner un enregistrement et l'enregistrer dans l'espace. Précise les obligations par pays (ex. FR : SIREN/SIRET obligatoire).

Règles et automatisation Bankin

Créer et gérer des règles Bankin pour catégoriser et automatiser le traitement des transactions importées (bankin rules). Exemples, priorité des règles et tests.

Génération & Templates PDF (Factures, Devis, Livraisons)

Templates HTML/CSS pour générer documents PDF : factures, devis, bons de livraison, commandes, avec plusieurs thèmes. Permet d'imprimer et d'exporter des documents commerciaux conformes et personnalisables.

Administration multi‑tenants et base de données

Gérer la configuration des connexions par application (multi‑tenant), basculer les connexions et déconnecter proprement. Utile pour isoler les données par client/app et exécuter des opérations spécifiques à chaque tenant.

Adresses, RIB et connexions bancaires

Configurer l'adresse de l'entreprise via un sélecteur (Google / AddressPicker), ajouter ou sélectionner des RIB/IBAN valides et connecter vos comptes bancaires via le pont bancaire. Inclut les validations IBAN et les exigences d'autorisation externes pour la connexion bancaire.

Mailing, suivi d’emails & pièces jointes

Envoyer emails transactionnels (factures, invitations), suivre l’ouverture/clics via mail-tracker et permettre l’ajout de pièces jointes aux emails. Permet d’assurer la communication client et le suivi des envois.

Page de pricing & Sélection de plan

Affichage des offres, comparaison des fonctionnalités et sélection d'un plan avec gestion des coupons et essais gratuits. Utile pour convertir les visiteurs en abonnés et permettre le changement de plan.

Exports SEPA & Bank file generation

Exporter des paiements en fichiers SEPA (virements/crédit) et générer des fichiers compatibles pour la banque. Utile pour automatiser le paiement des fournisseurs et la transmission vers la banque.

Comptes comptables et automatisation

Configurer les comptes comptables par défaut (ventes, auxiliaires, etc.), paramétrer l'automatisation (autofill, affectation d'auxiliaires) et gérer les devises/multicurrency pour la comptabilité. Contient les étapes de sélection des comptes et de validation.

Gestion des profils & whitelabel

Personnaliser l’apparence et le domaine d’une instance (logo, couleurs, URL) et appliquer des configurations spécifiques par client (white-label). Utile pour partenaires et revente sous marque.

Gestion des modèles d'impression & footer/header

Templates et styles pour l'aspect visuel des documents imprimés et PDF : CSS spécifiques, positionnement du logo, comportement du footer et variables d'identification. Permet d'harmoniser la charte graphique des documents.

Helpers utilitaires (currency, dates, strings)

Fournir utilitaires pour conversions monétaires, périodes et normalisation de chaînes afin d'assurer cohérence des données et conversions exactes. Utile pour calculs multi-devises, génération de périodes et nettoyage texte.

Facturation, numérotation et invitations

Personnaliser la numérotation des factures (séparateur, numéro de départ) en respectant la règle comptable de continuité du dernier numéro existant. Configurer modèles/templates de documents et inviter un comptable via email depuis l'onboarding.

Export CSV & téléchargements paginés

Générer des exports CSV paginés côté serveur avec feedback utilisateur (toasts/progress) pour extraire de larges jeux de données (ex : exports comptables, listes clients).

Tableau de bord

Vue d'ensemble de l'activité de l'entreprise : indicateurs financiers, accès rapide aux modules (factures, achats, banque, contacts). Utile pour avoir une lecture immédiate de l'état de trésorerie et accéder aux fonctions principales.

Gestion des tags et métadonnées

Ajouter, supprimer et stocker des tags libres sur entités (factures, achats, transactions) pour faciliter le filtrage et l'organisation. Utile pour catégoriser rapidement et retrouver des éléments.

Vue d'ensemble du tableau de bord

Résumé visuel central des KPIs financiers : trésorerie, chiffre d'affaires, dépenses et graphiques. Présente les cartes graphiques interactives, les totaux et statistiques clés, l'aide contextuelle et les états de chargement. Idéal comme page d'accueil pour surveiller la santé financière en un coup d'œil.

Gestion des utilisateurs & Intercom (suivi client)

Synchroniser les métriques et informations d’organisation/ utilisateur vers Intercom pour le suivi client, segmentation et support. Utile pour l’équipe support et marketing afin de contextualiser les échanges.

Facturation (factures)

Créer, éditer, visualiser et envoyer des factures clients. Permet de gérer le cycle commercial (création, modulation, envoi, suivi des paiements) pour encaisser et tenir la comptabilité à jour.

Administration & opérations (déploiement, workers)

Scripts et hooks de déploiement, démarrage de workers et installations post‑déploiement (fonts, migrations). Utile pour maintenir l'application en production et automatiser les tâches d'infrastructure.

Filtres temporels et navigation

Contrôles et comportements pour sélectionner périodes et durées, appliquer filtres et naviguer dans le temps (précédent/suivant) sur les widgets Forecast. Explique la logique de rafraîchissement des graphiques après changement de période.

Gestion des employés & indemnités kilométriques

Associer employés avec comptes comptables, gérer fiscal power et indemnités kilométriques (distance, véhicule, type). Permet de suivre remboursements et imputer coûts au bon compte.

Devis & Estimations

Créer et gérer des devis, suivre leur statut et les convertir en factures. Utile pour piloter les offres commerciales et transformer facilement un devis accepté en facture.

Swagger API & découverte des opérations

Fournit la lecture et la mise en cache du fichier Swagger/OpenAPI pour découvrir les opérations disponibles et faire la correspondance operationId → contrôleur/action. Utile pour la génération dynamique d'appels API et la documentation.

CTAs conditionnels & règles d'autorisation

Comportement des boutons d'action et conditions d'affichage selon les droits organisationnels. Détaille quand afficher un CTA (ex. connecter une banque), les flux déclenchés par le clic et les règles qui masquent ou révèlent des données.

Paramètres & configuration applicative

Configurer options globales (locale, modules, runtimeConfig), services (Stripe, Pennylane, Bankin), fichiers système et comportement de l’application. Essentiel pour adapter l’app aux besoins métier et aux intégrations.

Prévisualisation & Génération PDF (Factures / Devis)

Générer et visualiser les versions PDF/JPG des documents commerciaux (factures, devis) ainsi que FacturX. Permet de produire des documents officiels prêts à l'envoi ou à l'archivage.

Détails des cartes et interactions avancées

Interactions sur chaque carte : ouverture de dialogues, aperçus facture/paiements, gestion des états pendant fetch et spécificités mobiles. Guide les concepteurs sur les transitions, spinners et contenus des modales associées aux widgets.

Envoi des documents & Signature électronique

Envoyer factures/devis par e-mail (individuellement ou en masse), joindre documents et demander une signature électronique. Permet d'automatiser la communication commerciale et sécuriser l'acceptation via signature.

Paramétrage global & whitelabel

Configurer l'apparence (logo, couleurs), les URLs d'iframe d'apps intégrées, options whitelabel et paramètres d'envoi mails. Utile pour déployer la solution sous marque blanche et adapter l'expérience selon le client.

Seeds & modèles comptables (préconfigurations)

Initialiser un nouvel environnement app avec ensembles de comptes comptables et catégories prédéfinis (filières BNC, Statrys, Ticca). Permet un démarrage rapide avec plan comptable adapté au domaine.

Gestion des rôles & profils (policies)

Maintenir des profils de droits réutilisables et assigner des politiques d'accès aux utilisateurs/applications pour contrôler l'accès aux fonctionnalités. Utile pour la sécurité et la délégation d'accès.

Navigation temporelle et sélection de période

Guide sur la sélection et la navigation entre périodes : contrôle v-model, boutons précédent/suivant, et règles de disponibilité des périodes définies par le backend. Inclut bonnes pratiques pour la pagination temporelle.

API & routing interne (gestion des routes API)

Définir la structure des routes API, conventions d’operationId via Swagger et paramètres globaux (prefix, version). Facilite le routage côté client et la découverte des endpoints disponibles.

Achats & Dépenses (factures fournisseurs)

Enregistrer, classer et traiter les factures fournisseurs, attacher justificatifs et exécuter de l'OCR pour extraire les données. Utile pour suivre les dépenses, préparer la comptabilité et faciliter la saisie via OCR.

Monitoring & logs (Sentry / Logtail)

Configurer et envoyer les logs et erreurs vers des outils de monitoring (Sentry, Logtail) pour suivre les incidents et analyser les requêtes. Utile pour détecter et corriger rapidement les problèmes en production.

Graphiques de prévisions

Présentation des graphiques de forecast (turnover, dépenses, cashflow) avec navigation par période, interactions attendues et synchronisation avec le contrôle de période.

Maintenance, déploiement & hooks

Scripts et hooks pour automatiser l’installation de polices, appliquer permissions, exécuter migrations et démarrer workers lors du déploiement. Permet d’assurer que l’infrastructure applicative est correctement configurée après déploiement.

Banques & Synchronisation des comptes

Connecter des comptes bancaires via Bankin, synchroniser automatiquement les mouvements et consulter les comptes reliés. Indispensable pour suivre flux de trésorerie et rapprocher mouvements bancaires avec factures/achats.

Import/Export & requêtes asynchrones

Gérer les requêtes d'export asynchrones vers des services tiers, traiter les réponses et stocker les erreurs. Utile pour les exports lourds et la récupération fiable de résultats.

Tableau récapitulatif et détails

Documentation sur le tableau des périodes : colonnes clés, consultabilité des lignes, et comment les actions dans le tableau émettent des événements pour mettre à jour les métriques.

Partenaires & whitelabel partners

Gérer les partenaires (partners), état de mise en ligne et paramétrage spécifique, utile pour la gestion des revendeurs et intégrations propres aux partenaires.

Rapprochement & Règlements (conciliation)

Assigner des mouvements bancaires à des factures ou achats, créer des paiements et automatiser la réconciliation. Permet de tenir la comptabilité à jour et d'identifier les factures réglées ou partiellement réglées.

Saisie d'adresse & Autocomplétion

Permet aux utilisateurs de rechercher et saisir des adresses via un champ à autocomplétion et de compléter automatiquement les champs d'adresse (n° rue, route, code postal, ville, pays). Utile pour remplir rapidement les coordonnées des établissements, contacts ou factures sans ressaisie manuelle exhaustive.

Filtres et pagination temporelle

Explications sur l'activation/désactivation des filtres, leur impact sur l'affichage des prévisions et les stratégies de pagination temporelle pour explorer de grandes plages de données.

Outils imprimables & modèles d’invoices

Fournir modèles visuels d’invoices (templates), images assets, et prévisualisations pour sélectionner et appliquer un style de facture. Permet aux utilisateurs de personnaliser l’apparence des documents envoyés aux clients.

SEPA & Paiements bancaires

Préparer et exporter des fichiers SEPA pour les paiements ou prélèvements, gérer les mandats et les détails bancaires. Utile pour automatiser les paiements fournisseurs ou envoyer des fichiers bancaires conformes.

Téléversement d'image & Import d'URL

Interface pour fournir des images soit via upload depuis l'ordinateur, soit en collant une URL. Utile pour attacher des images à des entités (documents, profils, produits) ou pour des modules de génération d'images.

Événements et propagation des métriques

Comportement des emits : formats d'événements, quand les déclencher (tableau, interactions graphiques), et comment les mises à jour se propagent au composant parent pour recalculer les totaux.

Comptabilité & Plan comptable

Gérer le plan comptable, comptes, catégories et saisir les écritures comptables. Permet d'organiser les comptes pour les exports comptables, le lettrage et le suivi financier.

Logs d’import Bankin & historique

Conserver les historiques d’import de Bankin (cron import logs), comptabiliser nouvelles transactions et vérifier l’intégrité des imports. Permet d’auditer les imports bancaires et diagnostiquer difficultés.

Aperçu et principes

Introduction au système d'aide contextuelle : objectifs, cas d'usage, principes de conception et règles globales (quand afficher une aide, contenu HTML requis, aides conditionnelles selon la configuration de l'app). Idéal pour comprendre quand et pourquoi utiliser les infobulles et popovers.

Authentification et sessions

Permet aux utilisateurs de se connecter, se déconnecter et récupérer leur mot de passe. Utile pour sécuriser l'accès à l'application et gérer les sessions utilisateur.

Exports comptables & intégrations partenaires

Générer des exports comptables (FEC, ACD, Pennylane, Agiris) et envoyer les écritures vers des services partenaires. Indispensable pour livrer les écritures au comptable ou aux plateformes d'externalisation comptable.

Vérification de navigateur / Alerte navigateur obsolète

Affiche des écrans pour vérifier la compatibilité du navigateur et informer l'utilisateur si son navigateur est obsolète, avec des liens pour télécharger des navigateurs recommandés. Utile pour garantir une expérience utilisateur correcte et prévenir les problèmes liés au navigateur.

Utilisation du composant HelpTooltip

Guide pratique pour intégrer et utiliser le composant HelpTooltip : insertion dans les formulaires, affichage de HTML d'aide, association d'icônes d'aide aux titres et champs, et exemples d'usage (ex. liens vers la documentation depuis le popover). Comprend snippets et patterns recommandés.

Profil utilisateur & Mon compte

Gère l'identité, l'avatar, les coordonnées et les paramètres personnels des utilisateurs. Utile pour personnaliser l'expérience et gérer l'accès aux fonctions liées au compte.

TVA & Télé-déclaration (Teledec)

Consulter le détail TVA et préparer les télé-déclarations (envoi aux services fiscaux). Permet de rassembler les informations TVA et d'interagir avec la télé-déclaration si connectée.

Comportement, déclencheurs et accessibilité

Détails sur les modes d'activation et fermeture des popovers (clic, survol, clavier), gestion du focus et fermeture en cliquant à l'extérieur, bonnes pratiques d'accessibilité (ARIA), et règles pour le contenu conditionnel.

URSSAF & Paiements sociaux

Outils d'intégration et soumission aux services URSSAF : enregistrement de clients, génération de paiements et envoi des factures éligibles à des traitements spécifiques. Utile pour gérer les obligations sociales et l'avance immédiate, le cas échéant.

Navigation & Layout (Topbar, Navbar, Sidebar)

Fournit la structure de navigation principale de l'application (barre supérieure, menu latéral, bascule d'applications, menus user). Permet aux utilisateurs de naviguer entre les modules, gérer leur compte et changer d'organisation.

Organisations / Profil entreprise

Permet de créer, importer, éditer et gérer les fiches d'entreprises (profil juridique, établissements, RCS, SIRET, coordonnées). Utile pour centraliser les informations de facturation et légales de la société.

Authentification (Connexion / Déconnexion / Accès refusé)

Gère la connexion des utilisateurs, la déconnexion et les écrans d'accès refusé. Indispensable pour sécuriser l'accès et rediriger les utilisateurs non authentifiés vers le formulaire de login.

Intégration et gestion centralisée des tooltips

Comment brancher les infobulles sur le store centralisé : structure des entrées, mapping d'IDs, chargement dynamique de contenu HTML, contrôle des versions et stratégie de fallback lorsque l'aide est absente. Comprend workflows pour ajouter/modifier des aides et conseils pour tester en CI.

Adresses & recherche d'adresse

Saisie assistée d'adresses via autocomplete et formulaire d'adresse détaillé. Utile pour garantir des adresses normalisées sur fiches entreprise/contacts et documents.

Paramètres & Configuration (facturation/comptabilité)

Configurer les paramètres d'émission (modèles, mentions, emails), comptes par défaut et règles comptables. Nécessaire pour personnaliser l'apparence des documents et garantir la conformité comptable.

Récupération de mot de passe

Permet à un utilisateur de demander l'envoi d'un email pour réinitialiser son mot de passe. Cela facilite la reprise d'accès en cas d'oubli.

Menu Apps et lanceur d'applications

Présentation du menu Apps (popover) accessible depuis le header : affichage de l'avatar de l'organisation, sélection d'une application et règles d'affichage selon les permissions. Explique aussi les accès réservés (ex. menu de version/beta pour les superadmins) et bonnes pratiques d'UX pour un lancement rapide d'apps.

Navigation & Interface (Topbar, Sidebar, Menus)

Composants d'interface qui permettent à l'utilisateur de naviguer dans l'application, changer d'organisation ou accéder à son compte. Ils améliorent l'accessibilité et la découverte des fonctionnalités.

Onboarding & Configuration initiale

Accompagner la configuration initiale de l'entreprise (raison sociale, SIREN/SIRET, adresse, code NAF) et étapes de démarrage. Essentiel pour configurer correctement les documents fiscaux et la facturation dès l'ouverture du compte.

Profil utilisateur & Paramètres du compte

Espace où les utilisateurs voient et modifient leurs informations personnelles (nom, prénom, avatar), changent l'email de connexion et le mot de passe. Utile pour maintenir un compte à jour et gérer l'image de profil.

Sidebar dynamique et navigation par modules

Détails sur la sidebar : structure, groupes de modules (Comptabilité, CRM, Stocks, Paramètres), comportement dynamique filtré par permissions et conseils pour organiser et prioriser les entrées selon les rôles utilisateurs.

Intégrations & Autorisations (OAuth, webhooks)

Connexion et gestion des intégrations partenaires (Pennylane, Bankin, Prestashop, Yousign) via OAuth/webhooks. Permet d'échanger token/événements et d'automatiser échanges entre la plateforme et partenaires.

Contacts / CRM (cartes contacts)

Gère la liste des contacts et leurs cartes (profil, tags, notes, relations client/fournisseur/prospect). Permet d'ajouter, éditer, fusionner et supprimer des contacts ainsi que d'accéder à des informations commerciales et comptables associées.

Barre de navigation mobile et actions rapides

Guide pour la barre de navigation inférieure sur mobile : actions rapides, choix des raccourcis, comportement adaptatif multi-plateforme et recommandations d'ergonomie pour accès fréquent aux sections clés.

Abonnements & Paiements (Stripe / PayPal)

Gérer le cycle d'abonnement : sélection de plan, paiement par carte/SEPA, intégration Stripe/PayPal, essais, extension d'essai, résiliation et historique de facturation. Utile pour souscrire, modifier ou arrêter l'abonnement de l'application.

Abonnements & Paiements récurrents

Gérer les abonnements clients et traiter les paiements récurrents via Stripe/Cashier. Permet de gérer facturation récurrente, recevoir webhooks et rapprocher paiements automatiques.

Établissements (adresses, favoris, siège)

Gère les établissements rattachés à une organisation ou à un contact : adresses, téléphones, emails, définition comme siège ou favori. Utile pour gérer plusieurs sites physiques d'une même société.

Menu utilisateur, statut et notifications

Fonctionnalités du menu utilisateur : avatar, informations du compte, gestion du profil et actions rapides. Inclut l'affichage des jours restants d'essai, la notification des factures impayées, et l'affichage de la bannière whitelabel/partenaire avec lien vers la documentation partenaire.

Facturation & Documents (Devis, Factures, Avoirs)

Création, édition et génération de documents commerciaux : devis, factures, avoirs et duplicata, avec mise en page PDF. Utile pour émettre des documents légalement valables et les exporter/consulter.

Emails système & Templates

Gérer les emails envoyés par la plateforme (invitations, mot de passe oublié, assignation support, envoi de documents). Permet personnaliser les messages et s'assurer d'une communication cohérente.

Profil de contact et relation commerciale

Affiche la fiche individuelle d'un contact / d'une entreprise avec informations commerciales, conditions de paiement, remises et détails comptables. Permet d'éditer rapidement les paramètres de facturation et la relation commerciale.

Sélecteur de langue et accessibilité

Documentation du sélecteur de langue (FR/EN) : composant LanguageMenu, comportement attendu, persistance de la préférence, et conseils pour garantir une expérience cohérente sur desktop et mobile.

Stocks / Gestion d'inventaire

Gérer les produits et services en inventaire : création, catégorisation, mouvements de stock (entrée/sortie/retours), historique et achats de stock. Utile pour suivre les quantités, achats et mouvements liés aux ventes et à la logistique.

Recherche & Listes (DataTables & filtres)

Lister, filtrer et rechercher entités (factures, achats, contacts, produits) avec filtres avancés (date, montant, typeahead). Offre une navigation rapide et des outils de sélection/tri pour gérer des volumes de données.

Banque & Rapprochement bancaire

Synchroniser comptes bancaires, importer mouvements, effectuer rapprochement et définir règles automatiques de catégorisation. Utile pour tenir la comptabilité à jour et faciliter la réconciliation.

Ajout & Création d'organisation

Permet d'ajouter une nouvelle organisation soit en la recherchant/import depuis la base INSEE, soit en la créant manuellement avec ses coordonnées et identifiants légaux. Utile pour intégrer rapidement une entreprise cliente/fournisseur.

Parcourir et rechercher les contacts

Vue principale pour consulter et filtrer l'ensemble des contacts et organisations. Explique l'utilisation du datatable (recherche, sélection, actions), les actions en masse et comment ouvrir rapidement les formulaires de création depuis la liste.

Produits/Services & Tarification

Définir produits et services vendus (référence, prix, TVA) et les associer aux factures. Utile pour standardiser la facturation et accélérer la saisie des lignes commerciales.

Créer et éditer Personnes & Organisations

Guide pas-à-pas pour créer une personne ou une organisation via la modal, remplir et valider le formulaire, et pour éditer un profil existant (informations de base, logo, notes, tags). Inclut les règles de permissions applicables lors de la création.

Prévisions & Tableaux de bord (Forecast / Cashflow)

Afficher graphiques, KPIs et budgets pour prévoir la trésorerie et suivre la performance. Utile pour piloter la santé financière et anticiper besoins de trésorerie.

Requêtes & Débogage API (Swagger, debug)

Points d'accès pour le debug et la documentation API (swagger, endpoints de test). Permet aux développeurs et administrateurs d'accéder à des ressources d'audit et de test.

Fiche profil entreprise & réglages juridiques

Affiche et permet d'éditer les informations juridiques et contacts d'une organisation : RCS, greffe, numéro SAP, établissement, coordonnées bancaires et autres métadonnées. Utile pour garder à jour les informations administratives liées à la facturation et à la conformité.

SEPA & Mandats de prélèvement

Affiche les informations et mandats SEPA liés aux clients/fournisseurs et permet d'exporter des fichiers SEPA pour les paiements. Utile pour gérer les prélèvements bancaires et les échanges financiers B2B.

Etablissements et coordonnées

Modifier et maintenir les établissements rattachés à une personne ou organisation : adresses, téléphones et emails. Décrit l'édition en ligne, l'utilisation des dialogues d'édition d'établissement et la validation des changements.

Exportations & Importations (CSV, PDF)

Exporter et importer des données (CSV pour produits/exports, PDF pour documents). Utile pour sauvegarder, migrer ou partager des données et documents.

Authentification & Gestion des utilisateurs

Gestion des utilisateurs, invitations, assignation support et mots de passe oubliés. Permet d'ajouter des collaborateurs et contrôler l'accès à l'application.

Abonnements & Gestion d'offre

Espace de gestion de l'abonnement de l'application : visualiser le plan, voir les prochaines factures, changer de plan, prolonger un essai, résilier ou gérer les paiements. Indispensable pour l'administration commerciale et le suivi de la facturation SaaS.

Relations commerciales et profilage

Gérer les rôles et relations (client, fournisseur, prospect) et utiliser les tags/notes pour le profilage. Explique comment affecter et modifier les relations, et comment ces informations impactent la facturation et la réconciliation.

Paramètres de l'application & templates web

Configurer les paramètres généraux, éditer les templates HTML pour les pages web (header/footer/style) et ajuster les options de branding. Utile pour personnaliser les emails et documents envoyés aux clients.

Sponsoring & Parrainage

Gestion du parrainage : envoyer des invitations promotionnelles et codes de parrainage. Utile pour la croissance et le suivi des recommandations.

Moyens de paiement & Intégration Stripe/PayPal

Gestion des moyens de paiement (cartes, SEPA) et intégration avec Stripe et PayPal pour les paiements et webhooks. Permet d'ajouter des cartes, configurer des webhooks et lier des comptes PayPal/Stripe.

Fusion, déduplication et restauration

Procédures pour détecter, fusionner et restaurer des contacts. Couvre l'outil de déduplication (fusion automatique et manuelle, fusion en masse), les conséquences irréversibles des merges et les actions de suppression/restauration avec confirmations nécessaires.

PayPal configuration

Configurer l'intégration PayPal en saisissant le Client ID, suivre un workflow en étapes et afficher les boutons PayPal via le SDK. Utile pour accepter des paiements via PayPal.

Tickets d'intervention & Historique (Timetable / Missions)

Afficher et gérer les plannings, interventions et feuilles de temps liées à des clients. Permet de produire des attestations, calculs de montants et préparer la facturation pour services rendus.

Facturation & Documents (Factures, Devis, Bons de livraison)

Création, affichage et génération PDF de documents commerciaux : factures, devis, bons de livraison, avec calculs de TVA, remises, acomptes et sections bancaires. Permet d'imprimer, télécharger ou envoyer ces documents aux clients.

Liste & filtres — Devis et factures

Parcourir, trier et filtrer l'ensemble des devis et factures via une datatable. Comprend l'affichage des statuts et des icônes d'état (envoyé, brouillon, impayé) et la mise en forme visuelle des documents en statut 'draft'.

Stripe configuration & Webhooks

Configurer Stripe (clé API, webhooks), gérer la synchronisation des paiements et recevoir événements via webhook. Utile pour gérer paiements par carte, abonnements et événements liés.

Notifications utilisateur & Popups de confirmation

Système de popups de confirmation et notifications toast pour valider des actions ou informer l'utilisateur d'un résultat. Garantit une expérience utilisateur claire et sécurisée pour les opérations sensibles.

Éditeur de modèle web (WebTemplate)

Interface pour éditer et gérer des modèles HTML utilisés pour générer les emails/pages/PDF (header/footer/style inclus). Utile pour personnaliser l'apparence des documents et pages exportées.

Parrainage & Codes promotionnels

Gestion du programme de parrainage : inviter des contacts, afficher codes de parrainage et partager liens. Utile pour la croissance et la fidélisation par le biais de recommandations.

Visualisation et édition d'un document

Consulter et modifier un devis ou une facture depuis DialogDocument. Inclut l'édition en ligne, duplication ou suppression (avec confirmation) et les actions rapides depuis la fiche document.

Administration & Outils techniques (migrations, commandes)

Outillage pour les administrateurs : commandes artisan pour backup/migration, endpoints de migration et scripts d'entretien. Permet gérer le cycle de vie des applications multi‑tenant et effectuer des tâches d'administration.

Envoi des documents (e‑mail individuel & en masse)

Envoyer des devis et factures par e‑mail soit individuellement, soit en masse. Gérer les sélections multiples, les confirmations nécessaires et suivre les statuts d'envoi.

Templates d'e‑mail & Notifications

Gérer et utiliser templates d'e‑mail pour notifications système : invitations, assignations de support, validations, réinitialisation de mot de passe et envoi de documents. Utile pour communiquer de manière cohérente avec les utilisateurs et clients.

Avatars & Profil utilisateur (services d'images)

Générer des avatars dynamiques à partir d'un nom et d'initiales, utilisé pour remplacer les images manquantes. Utile pour afficher une identité visuelle même sans photo utilisateur.

Historique des mouvements de stock

Affiche l'historique des mouvements de stock groupés par date et catégorie, avec panels et couleurs pour faciliter la lecture. Permet de retracer entrées / sorties et justifier les quantités.

Intégrations & exports (Chorus Pro / URSSAF)

Exporter et transmettre automatiquement les factures vers Chorus Pro ou URSSAF via des dialogues dédiés. Détails des prérequis, droits nécessaires et étapes d'export/batch.

Edition dynamique de formulaires & prompts

Fournir des modals dynamiques pour saisir des 'prompts' (texte, images, adresse) et permettre uploads ou saisies spécifiques. Utile pour collecter des inputs divers dans des flux modulaires.

Filtres & Édition en ligne (Popovers & Editables)

Édition inline et popovers pour modifier rapidement des champs (comptes, catégories, montant initial, adresses). Facilite les corrections rapides sans quitter le contexte de la liste ou fiche.

Actions avancées CSV & Mass actions

Permet d'importer et d'exporter des listes (produits, stocks) au format CSV, ainsi que d'appliquer des modifications en masse (tags, suppression, édition). Utile pour gérer de larges catalogues et effectuer des corrections en lot.

Paiements SEPA, avoirs et gestion comptable

Initier prélèvements SEPA (Direct Debit / Credit), créer avoirs/notes de crédit et gérer les comptes de facturation, tags et statuts en lot pour tenir la comptabilité à jour.

Vérification de compatibilité navigateur

Informer les utilisateurs si leur navigateur est obsolète ou non supporté et leur proposer des alternatives. Utile pour garantir une expérience utilisateur correcte et éviter des erreurs d'affichage.

Recherche localisation & Adresses

Outils d'autocomplétion d'adresses et de géocodage pour renseigner les sièges et établissements. Améliore la qualité des adresses sur les documents et fichiers de déclaration.

Sécurité & Permissions (Premium gating)

Gérer l'accès aux fonctionnalités avancées selon les permissions utilisateur et le plan premium. Utile pour contrôler les fonctionnalités payantes et afficher des CTA de montée en gamme.

Gestion d'accès API & Clés partenaires

Afficher et gérer clés API et installations partenaires (API keys, installations partenaires). Permet d'intégrer et donner accès à des applications externes via des clés et gérer leur cycle de vie.

Vue d'ensemble des factures récurrentes

Présentation de la table des factures récurrentes : colonnes essentielles (fréquence, statut, prochaine émission), navigation et filtres. Explique comment la fréquence est affichée de façon human-friendly via getFrequency et comment accéder rapidement à la liste complète.

Parrainage & Programme de Référence

Module permettant aux utilisateurs de parrainer d'autres entreprises, d'envoyer des invitations et de partager un code promotionnel. Utile pour la croissance via recommandations et gestion des récompenses.

Édition en masse

Guide pas à pas pour sélectionner plusieurs lignes, ouvrir le modal d'édition (copy/update) et appliquer des modifications groupées : mise à jour des champs, ajout de pièces jointes et envoi d'emails. Détaille la mécanique de sélection et les précautions (aperçu, validation).

Gestion des catégories & tags

Créer et organiser des catégories pour produits et documents, ainsi que gérer les tags sur entités. Utile pour organiser le catalogue et filtrer rapidement.

Comptabilité générale

Gérez le plan comptable, les comptes auxiliaires, catégories et employés comptables. Utile pour structurer les écritures comptables, contrôler les budgets et préparer les exports comptables obligatoires.

Modèles d'email & Envoi de mails transactionnels

Templates d'e-mails utilisés pour les invitations, validation d'inscription, réinitialisation de mot de passe et notifications de document. Permet d'envoyer des communications formatées et brandées aux utilisateurs et clients.

Duplication et variantes de récurrence

Comment copier une récurrence existante pour créer une variante : options de duplication, champs à adapter (fréquence, destinataires, pièces jointes) et bonnes pratiques pour maintenir l'historique. Inclut le flux 'Copier une récurrence' et l'édition spécifique des règles dupliquées.

Onboarding & Guided setup

Parcours d'accueil et configuration guidée pour initier un nouvel utilisateur ou une nouvelle organisation (onboarding steps). Utile pour accélérer la prise en main.

Génération d'écritures et exports comptables

Générez les écritures comptables à partir des documents (factures, achats, mouvements bancaires) et exportez les périodes au format requis (FEC, ACD, Pennylane, Agiris). Cela facilite la conformité fiscale et l’import dans des outils partenaires.

Génération d'avatar

Service pour générer dynamiquement une image avatar à partir d'un nom et d'initiales (image générée côté serveur). Utile comme image par défaut pour utilisateurs/organisations sans logo.

Règles de récurrence et planification des envois

Détails sur la définition et la modification des règles récurrentes : fréquence (mensuelle, trimestrielle...), date de prochaine émission, destinataires et envoi programmé des factures. Explique les implications des changements (p. ex. prochaines émissions) et comment le système traduit la fréquence en libellé lisible.

Gestion des modèles PDF & CSS

Consulter et modifier les modèles HTML/CSS utilisés pour générer les PDF de documents (multiples templates disponibles). Utile pour adapter le rendu imprimé aux exigences de branding ou légales.

Banque & synchronisation

Connectez vos comptes bancaires via Bankin, synchronisez les mouvements, et affichez les soldes et sources de flux de trésorerie. Indispensable pour rapprocher les opérations bancaires avec les documents comptables.

Intégrations bancaires & Synchronisation (Bankin, Pennylane)

Connexion et synchronisation avec des services bancaires externes (Bankin, Pennylane) pour récupérer transactions et permettre la réconciliation automatique. Facilite l'import de flux bancaires pour la comptabilité.

Vue d'ensemble & liste des Achats

Accéder à la liste des achats, filtrer et lancer les actions globales : créer un nouvel achat, exporter la liste en CSV, importer via le module Importer et appliquer des actions par lot (tags, comptes). Idéal pour les opérations quotidiennes et la préparation des exports comptables.

Gestion des modules & assets front-end (Vue, Ace, plugins)

Chargement et gestion des modules front (Vue, Ace.js, plugins d'édition) pour activer des fonctionnalités UI/UX avancées. Utile pour rendre dynamiquement des interfaces interactives.

Rapprochement bancaire

Associez automatiquement ou manuellement les mouvements bancaires aux factures/achats et créez des écritures de paiement. Permet de tenir à jour les paiements, soldes et la correspondance banque/documents.

Webhooks & API publiques (Swagger + utilitaires)

Fournit des endpoints utilitaires et des webhooks : export de Swagger, jeux de données (currencies, messages), gestion du webhook Stripe et endpoints de configuration publique. Utile pour les intégrations externes et la debugging.

Créer et éditer un Achat (PurchaseEditor)

Guide pas-à-pas pour remplir l'entête d'un achat, utiliser le PurchaseEditor, sauvegarder (onSubmit) et supprimer un achat (avec confirmation). Comprend la gestion des valeurs auto-créées (employé/compte) via les composables expense_report.

Système d'avatars dynamiques

Générer automatiquement des avatars graphiques à partir d'un nom et d'initiales. Utile pour afficher des images cohérentes quand aucune photo n'est fournie.

Règles de catégorisation (moteur de règles)

Définir des règles automatiques pour catégoriser et traiter les mouvements bancaires (conditions → actions). Utile pour automatiser le classement comptable et gagner du temps en traitement récurrent.

Recherche & Tables serveur‑pilotées (DataTable)

Tables pilotées par le serveur avec recherche, filtres, pagination, tri et templates de lignes. Utiles pour explorer de grands jeux de données (produits, contacts, factures) rapidement et efficacement.

Ventilation par lignes et règles d'équilibre (PurchaseBreakdown)

Comment ventiler un achat en lignes (compte, montant, taxe) avec PurchaseBreakdown, vérifier et corriger l'équilibre (somme des lignes = total) pour préparer les écritures comptables.

Services & Webhooks externes

Points d'entrée pour les intégrations externes et webhooks (Bankin, Stripe, Prestashop, Pennylane). Utile pour recevoir événement tiers et synchroniser l'état côté application.

OCR et reconnaissance automatique (achats)

Utiliser l’OCR pour extraire automatiquement les données des justificatifs d’achat et proposer une pré‑saisie. Accélère la saisie manuelle et diminue les erreurs de transcription.

Recherche & Tableaux (DataTable server-driven)

Requêtes de recherche et affichage de listes via un DataTable piloté côté serveur avec filtres, pagination et actions en masse. Utile pour parcourir et administrer grands ensembles de données.

Premium features & Gating

Mécanisme d'affichage/masquage des fonctionnalités premium selon le plan/utilisateur et d'invitation à souscrire. Permet de restreindre l'accès aux fonctions avancées et d'orienter vers la souscription.

Pièces jointes, galerie et aperçu

Ajouter, visualiser et gérer les pièces jointes d'un achat : uploader des fichiers, afficher des thumbnails, aperçu détaillé avec rotation, et supprimer des images depuis la galerie (suppression nécessitant une confirmation).

Paiements & abonnements (Stripe)

Gérer les paiements en ligne, abonnements et suivre les webhooks Stripe. Permet d’automatiser la facturation récurrente et d’enregistrer les transactions liées aux factures.

Recherche & Documentation API (Swagger / OpenAPI)

Fournir la spécification API (swagger.yaml) et documents associés pour découverte et développement. Utile aux intégrateurs qui souhaitent utiliser l'API publique.

Prévisualisation & Loader UI

Composants d'UI généraux pour afficher un loader global, barres de progression lors d'uploads et overlays, et pour intégrer Vue/JS dans le rendu PHP. Améliore l'expérience utilisateur lors des actions asynchrones.

Remboursements, mileage et cas spécifiques

Gérer les remboursements et frais de déplacement (mileage), cas d'usage spécifiques et leur impact sur la ventilation et les écritures comptables. Inclut l'import de pièces et règles de validation.

Modèles & mise en page de documents

Choisir et personnaliser les templates de factures/devis et éditer les contenus réutilisables (pieds de page, texte des emails). Permet d’harmoniser l’image commerciale et les documents envoyés aux clients.

Affichage multilingue & Traductions

Fournir libellés et traductions pour l'interface et documents (factures, messages Stripe, validations). Utile pour rendre l'application utilisable dans plusieurs langues.

Sponsoring & Emails promotionnels

Permet l'envoi d'emails promotionnels liés au parrainage et affiche des modèles de courriels marketing conçus pour conversion. Utile pour les campagnes de parrainage et l'acquisition.

Navigation par vignettes

Comprend l'affichage et la navigation des miniatures des pièces jointes. Explique la barre de vignettes horizontale, le comportement au survol (masquage/affichage des actions) et les bonnes pratiques pour la présentation et le défilement.

Prévisions & trésorerie (Forecast)

Visualiser les prévisions de trésorerie, chiffre d’affaires et dépenses sur différentes périodes. Aide à anticiper les besoins de trésorerie et à planifier les budgets.

Outils & utilitaires front (Progress, Loader, Toaster)

Composants d'interface pour retour utilisateur : barre de progression, overlay de chargement, toasts/notifications. Utile pour informer sur les états asynchrones et résultats d'actions.

Fichiers PDF spécifiques (SAP attestation, Stripe invoices)

Templates PDF dédiés pour besoins réglementaires ou fournisseurs (ex: attestation SAP annuelle, factures Stripe). Permet de produire des documents conformes via templates spécialisés.

Aperçu agrandi et rotation

Détaille l'ouverture du mini-apercu en vue agrandie, les contrôles disponibles (zoom/rotation) et le rendu des images/PDF. Explique le workflow pour faire pivoter une image et la gestion de l'état de chargement pendant le rendu.

Tableaux de bord & statistiques

Consulter graphiques et cartes résumant CA, dépenses, trésorerie et autres KPIs sur le tableau de bord. Donne une vue synthétique pour piloter rapidement l’activité.

Recherche & ressources statiques (currencies, tooltips, messages)

Endpoints statiques fournissant ressources front (listes de devises, messages d'événements, tooltips) et config d'app. Utile pour alimenter l'interface en contenus statiques JSON.

Traductions & Localisation

Gestion des fichiers de traduction pour les documents commerciaux et messages d'erreur (fr/en/es/it/nl/de). Assure la cohérence linguistique de l'interface et des documents PDF envoyés.

Suppression et confirmation

Explique le processus sûr de suppression d'une pièce jointe : accès à l'icône, comportement de masquage hors survol, dialogue de confirmation obligatoire, et conséquences (archivage, suppression définitive). Inclut recommandations UX pour éviter les suppressions accidentelles.

Contacts & organisations (CRM)

Gérer fiches clients/fournisseurs, établissements, adresses et contacts associés. Permet de centraliser les informations légales/commerciales pour facturation et déclarations.

Pages statiques & Welcome

Pages publiques telles que la page de bienvenue et pages pour utilisateurs non connectés. Utile pour rediriger, inscrire et présenter l'application aux visiteurs.

Services & Routes utilitaires

Regroupe des routes utilitaires et inclusions de services (scanning de dossiers services, inclusion de routes spécifiques). Permet d'étendre le système par fichiers de services modularisés.

Ajout et gestion des pièces jointes

Guide pour uploader de nouvelles pièces depuis l'éditeur d'achat, gestion des états pendant l'upload et intégration avec les vignettes et l'aperçu. Couvre la mise à jour de la galerie après upload et le feedback visuel (indicateur de chargement).

SEPA & mandats

Gérer les mandats SEPA (création, édition, suppression) pour les prélèvements automatiques. Nécessaire pour automatiser les prélèvements clients et conserver les références de mandat.

Console / Commandes CLI

Transformers & Serialisation API

Connexion et onboarding bancaire

Guide pour connecter un compte bancaire et démarrer l'onboarding. Explique le flux 'Connecter une banque', les CTA et conditions d'affichage (droits requis : app.cashflow.banks.connect), ainsi que les bons réflexes lors du premier lien avec le pont bancaire.

URSSAF & déclarations

Préparer et envoyer des paiements/déclarations vers l’URSSAF et suivre les statuts de paiement. Comprend la configuration API, la création de paiements et le suivi des réponses.

Composables & utilitaires front‑end

Events & Listeners

Transactions et rapprochement

Présentation de la liste des transactions (datatable), des outils de rapprochement automatique et des actions disponibles sur chaque transaction (export, suppression, upload). Inclut les étapes pour importer/exporter via le menu Bank et conseils pour la gestion des doublons.

Avance immédiate (enregistrement personne)

Flux d’enregistrement pour l’avance immédiate de personnes (intégration URSSAF/ImmediateAdvance). Permet d’inscrire des personnes et gérer les clés API nécessaires pour l’envoi de dossiers.

Build & configuration (Nuxt / Tailwind / Locales)

Console & CLI (Artisan commands)

Cartes Cashflow et visualisations

Explication des cartes cashflow avec graphiques : lecture des tendances, filtres temporels et indicateurs en temps réel. Montre comment interpréter les graphiques pour suivre la trésorerie et automatiser les alertes/rapprochements.

Gestion des tags & métadonnées

Ajouter, supprimer et gérer des tags sur documents, transactions et éléments pour organiser et filtrer les données. Améliore la recherche, la segmentation et les exports.

Recherche & documentation API (Swagger Reader)

Export CSV & extraction de données

Exporter les données (factures, achats, mouvements) au format CSV avec pagination et colonnes configurables. Permet d’extraire des rapports pour analyses externes ou import dans d’autres outils.

Sources de cashflow et paramètres Bankin

Configuration des sources de cashflow et des paramètres Bankin : activer/désactiver des sources, gérer la persistance de la sélection dans la configuration de l'app, et définir comptes et start-date. Comprend procédure pour modifier les sources et impacts sur les flux.

Modèles & composants UI réutilisables (enrichissement)

Sélection et recherche des mouvements

Comment charger et parcourir la liste des mouvements bancaires, utiliser le sélecteur avec recherche et effectuer des sélections multiples pour préparer un rapprochement. Conseils d'ergonomie et filtres courants.

Gestion des fichiers & miniatures

Téléverser, prévisualiser, tourner et supprimer les pièces jointes (factures, justificatifs). Améliore l’archivage visuel et l’accès rapide aux documents liés.

Automatch et correspondances automatiques

Fonctionnement de l'Automatch : détection des correspondances parfaites et recherche de combinaisons. Paramètres de tolérance (date, somme) et limites pour éviter l'explosion combinatoire.

Éditeur de texte & signatures d’email

Éditer contenu riche pour emails ou sections de documents avec insertion d’images et conversion Markdown. Permet une communication personnalisée et professionnelle.

Allocation des montants (BalanceSelector)

Répartir les montants entre lignes et mouvements : utiliser le BalanceSelector pour allouer des montants, suivre les instructions d'allocation par ligne (BalanceInstructions) et gérer les cas partiels ou surpaiements.

Recherche INSEE / identification d’entreprise

Recherche d’entités via l’API INSEE/SIRENE et formatage d’adresses pour pré‑remplir les fiches entreprises. Facilite la création de fiches clients/fournisseurs fiables.

Dialog de réconciliation, règles et logs

Interface de rapprochement (dialog), édition des transactions rapprochées, création et validation de règles automatiques (RulesSuggestion / RuleEditor). Suivi des opérations via les logs d'autoreconcile et procédures d'annulation avec confirmations.

Interface utilisateur & composants (Dialogs, Popovers, Buttons)

Composants UI réutilisables pour interactions (boutons, dialogues, popovers, loaders). Fournissent des interactions cohérentes pour toutes les fonctionnalités applicatives.

Créer une règle de rapprochement

Guide pas-à-pas pour créer une règle à l'aide de l'éditeur : définir conditions (libellé, opérateur, valeurs), rédiger l'action Then, utiliser l'aide contextuelle et les suggestions de labels/opérateurs, puis sauvegarder et activer la règle.

Navigation & accès (menu, sidebar, mobile)

Menus de navigation principaux (sidebar, mobile bar, apps menu) et gestion de la langue/versions. Permet d’accéder rapidement aux modules, changer de langue et basculer entre applications/versions.

Gérer les règles (éditer, dupliquer, supprimer)

Actions et bonnes pratiques pour maintenir vos règles : modifier une règle existante, la dupliquer pour créer des variantes, la supprimer ou la désactiver sans perdre la configuration.

Gestion des API Keys & intégrations partenaires

Créer, afficher et copier des clés API, gérer les intégrations partenaires et OAuth (Pennylane, Bankin, YouSign). Nécessaire pour activer des connecteurs et automatisations tierces.

Exécution globale des règles

Comment appliquer un jeu de règles à l'ensemble des transactions non justifiées : utiliser le bouton 'Appliquer', comprendre l'étendue de l'impact, le message d'avertissement/tooltip et étapes à suivre après l'exécution.

Internationalisation & langue

Gérer la langue de l’interface et la localisation des contenus. Permet aux utilisateurs de naviguer dans leur langue préférée.

Bonnes pratiques et sécurité

Recommandations pour éviter les erreurs : tester les règles, utiliser des libellés précis et opérateurs adaptés, stratégies de désactivation, revue d'impact et procédures de retour arrière après une exécution massive.

Aide & infobulles (HelpTooltip)

Afficher des bulles d’aide contextuelles et liens vers le centre d’aide. Permet d’assister l’utilisateur sans quitter le contexte fonctionnel.

Vue d'ensemble — Export comptable

Présentation générale des capacités d'export comptable : quels formats sont supportés, quand lancer un export, et quel comportement attendre côté interface (téléchargement automatique, exports asynchrones). Idéal pour comprendre rapidement le flux utilisateur de bout en bout.

Paramètres & administration

Configurer les paramètres d’application (nom, environnement, fichiers, features), gérer les couleurs, versions et options white‑label. Essentiel pour les administrateurs qui personnalisent et opèrent la solution.

Configuration des formats et paramètres d'export

Guide détaillé sur la configuration requise pour chaque format (Agiris, ACD, Pennylane, CSV). Inclut l'utilisation des modaux de configuration, les paramètres obligatoires (ex. comptes préfixés Pennylane) et les vérifications avant lancement d'un export.

Notifications & suivi d’état

Notifier l’utilisateur lors d’événements (succès/erreur) et afficher loaders/states durant les actions asynchrones. Garantit un retour clair sur les opérations initiées.

Intégration Pennylane — OAuth & gestion des jetons

Document consacré au flux d'authentification Pennylane : redirection vers l'OAuth, réception et stockage des jetons, et reprise de l'export après authentification. Contient les étapes UX pour rediriger l'utilisateur et relancer automatiquement l'export.

Recherche & filtres de tableaux

Filtres avancés, recherche texte et contrôles de pagination sur les datatables. Permet d’isoler rapidement les enregistrements pertinents pour traitement ou export.

Processus asynchrone, polling et récupération du fichier

Explications techniques et UX sur la génération asynchrone des exports : comment le client poll la disponibilité, gestion des erreurs et des timeouts, et déclenchement du téléchargement automatique une fois le fichier prêt.

Sécurité & session (auth)

Gérer la session utilisateur, les déconnexions et la sécurité JWT. Important pour assurer un usage authentifié et sécurisé de l’application.

Aperçu des attestations SAP

Vue générale du module d'attestations SAP : objectifs, périmètre (annuel), états des documents et indicateurs de conformité. Explique l'importance pour les grands comptes et les règles métier (documents marqués 'sent', nécessité de destinataires configurés).

Gestion d’erreurs & page d’erreur

Affichage d’une page d’erreur centralisée en cas de problème de connexion à l’API ou d’erreur applicative. Permet à l’utilisateur de relancer une tentative et d’obtenir des explications utiles.

Navigation par année et liste des documents

Comment accéder aux attestations par année via l'accordéon : choisir une année, développer l'accordéon pour afficher la liste des documents annuels et voir les actions disponibles pour chaque document.

Exports & intégrations partenaires (Pennylane, ACD, Agiris, ChorusPro)

Envoyer des exports comptables ou documents à des partenaires (Pennylane, ACD, Agiris, ChorusPro) via des jobs et APIs dédiées. Facilite l’intégration comptable externe et l’envoi normalisé.

Prévisualisation PDF et téléchargement

Guide pour prévisualiser une attestation en PDF (iframe ou viewer intégré) et pour télécharger la pièce jointe si disponible. Explique les comportements attendus, le rendu dans l'iframe et les limites (taille, affichage mobile).

Gestion des versions & bêta

Basculer entre versions d’interface, activer des fonctionnalités bêta pour un tenant ou un superadmin. Permet de tester des fonctionnalités en avant-première ou d’exposer des flags de version.

Envoi par email et gestion des destinataires

Procédure d'envoi des attestations par email : saisie et gestion des destinataires, validation requise avant envoi, bouton d'envoi, marquage du document comme 'sent' et mise à jour des indicateurs. Couverture des erreurs communes et messages d'alerte.

Export & impression de documents (PDF / FacturX)

Générer des PDF (FacturX) pour les documents de vente et permettre le téléchargement/visualisation. Assure la production de documents officiels conformes.

Configuration des identifiants URSSAF

Comment saisir et stocker en toute sécurité les identifiants URSSAF (client_id, client_secret), valider la connexion API et gérer le cycle de vie des tokens. Contient des bonnes pratiques pour la configuration Step1 et le dépannage des erreurs d'authentification.

Gestion des modèles et ressources (assets)

Gérer logos, couleurs, images et autres ressources liées au branding de l’application. Permet la personnalisation et l’affichage correct des documents et de l’interface.

Formulaire client URSSAF

Guide sur la sélection ou la création d'un client URSSAF : champs obligatoires (civilité, nom, prénom, pays de naissance), validation du téléphone pour la France via vue-tel-input, et validation finale dans Step2.

Gestion des modèles de données tabulaires (Datatables)

Configurations de tables dynamiques pour afficher et interagir avec des listes (factures, achats, clients, comptes). Permet tri, filtres, actions en masse et vues mobiles optimisées.

Configuration des lignes de paiement

Explication détaillée des lignes de paiement : nature, unité, quantité, montant unitaire, codes 'prestation', et cas où la saisie d'un Nova/SIRET est requise par ligne. Inclut validations locales et conseils pour préparer Step3 avant envoi.

Achats & Frais (Overheads)

Gérer vos dépenses, factures fournisseurs et frais (y compris notes de frais et frais kilométriques). Permet le suivi des pièces jointes, l'OCR et la préparation à la comptabilité.

Envoi groupé et suivi des paiements

Procédure d'envoi groupé des paiements à l'URSSAF, mécanismes d'optimisation des lots, et méthodes pour suivre les statuts (polling, rafraîchissement Step4). Indications sur l'interprétation des statuts et actions possibles selon l'état.

Comptabilité & Exports (FEC, ACD, Pennylane, Agiris)

Préparer et générer les exports comptables (périodes mensuelles ou annuelles) pour le dépôt ou l'envoi vers des partenaires comptables. Utile pour la clôture, transmission au comptable et conformité.

Résultats, erreurs et résolution des refus

Interpréter les retours d'URSSAF : affichage des résultats, codes d'erreur courants, raisons de refus (ex. informations obligatoires manquantes) et procédures de correction et de ré-envoi. Comprend exemples d'erreurs et étapes de dépannage.

Banques & Transactions (Synchronisation Bankin)

Connecter des comptes bancaires, synchroniser automatiquement les mouvements et concilier encaissements/décaissements. Permet d'automatiser la saisie des transactions et préparer la réconciliation.

Vue d'ensemble du catalogue

Présentation de la liste centrale des produits et services : navigation, recherche et filtres. Utile pour retrouver rapidement un article, comprendre la structure des colonnes et l'iconographie liée aux types.

Prévisions & Tableaux de bord (Cashflow, CA, Dépenses)

Visualiser la santé financière via des graphiques (cashflow, chiffre d'affaires, dépenses) et des prévisions. Utile pour planifier la trésorerie et détecter des tendances.

Créer et éditer un produit/service

Guide pas à pas pour ajouter un nouveau produit ou service via le dialog de création, remplir les champs obligatoires et sauvegarder. Comprend les bonnes pratiques pour les listes de prix et la gestion initiale du stock.

PDF & Documents (Génération et Aperçu)

Générer des PDF/JPG et fichiers FacturX pour vos documents commerciaux, les visualiser et les télécharger. Permet d'obtenir des fichiers conformes pour envoi clients ou archivage.

Fiche produit : visualisation et modification

Détails de la fiche produit (DialogShowProduct) : quelles informations sont affichées, comment interpréter les icônes de type, et comment modifier les attributs d'un article en toute sécurité.

CRM — Contacts & Relations

Gérer vos fiches clients et fournisseurs (personnes et organisations), leurs établissements et relations. Utile pour centraliser les coordonnées, modes de paiement et tags métier.

Export CSV du catalogue

Procédure pour sélectionner des lignes et exporter tout ou partie du catalogue au format CSV via le menu DropdownCatalogue. Comprend les options d'export, le format des champs et les recommandations pour l'import externe.

Fusion de doublons (Contacts)

Identifier et fusionner les contacts en doublon pour garder une base clients propre. Permet réduire des erreurs d'envoi ou de facturation liées à la duplication.

Suppression en masse et sécurité

Flux de suppression multiple d'articles : sélection des lignes, actions de suppression, et description du mécanisme de confirmation double pour éviter les suppressions accidentelles.

Fiche Personne (Profil individuel)

Consulter et modifier le profil détaillé d'une personne (client/fournisseur) : coordonnées, rôles (client/fournisseur/prospect), tags, mandats SEPA et établissements liés.

Export CSV paginé

Processus complet d'export paginé depuis une liste : déclenchement, récupération itérative des pages et assemblage du CSV. Explique la gestion des exports volumineux, la reprise et les bonnes pratiques pour respecter les limites backend.

Catalogue & Stocks (Produits & Services)

Gérer votre catalogue de produits et services : création, édition, aperçu et export. Permet d'alimenter rapidement les lignes de devis/factures et de centraliser les informations produit.

Mappage de colonnes et données imbriquées (dot-paths)

Comment définir les colonnes d'export, résoudre les clés imbriquées via dot-paths, extraire et normaliser les valeurs complexes pour produire des lignes CSV cohérentes.

Paiements & Abonnements (Stripe, PayPal, CB)

Gérer l'abonnement de l'application, les méthodes de paiement et les paiements via Stripe ou PayPal. Permet d'ajouter/supprimer cartes, payer des factures d'abonnement et activer des extras.

Téléchargement via Blob et feedback utilisateur

Techniques front-end pour créer un fichier CSV via Blob et déclencher le téléchargement, avec gestion des toasts/barres de progression et UX pendant l'export.

Mandats SEPA & Exports SEPA

Gérer les mandats SEPA et préparer des exports SEPA (virements/crédits) pour payer des fournisseurs. Permet l'export de lots de paiements et la gestion des mandats côté clients/fournisseurs.

Conversion et formatage des valeurs

Règles et exemples pour formater dates, montants et autres types avant écriture dans le CSV (localisation, décimales, formats ISO), et intégration de ces transformations dans le pipeline d'export.

Webhooks & Journal d'événements

Configurer une URL de webhook, sélectionner les événements à notifier et consulter l'historique des livraisons. Utile pour intégrer des flux d'événements vers des systèmes tiers.

Mon compte

Gérez vos informations personnelles et vos accès : photo de profil, prénom/nom, email, mot de passe et 2FA. Contient les instructions pour accéder à la page « Mon compte » et effectuer des modifications sécurisées.

Onboarding & Guide de démarrage

Accompagner les nouveaux utilisateurs pas à pas pour les configurer (création de première facture, contacts, paramétrage). Utile pour accélérer la mise en route et s'assurer des données minimales.

Organisation & logo

Centralisez la configuration de l'entreprise : nom commercial, pays, activité et logo. Explique comment mettre à jour le logo via l'uploader (ProfileThumb) et les conséquences possibles lors du changement d'activité.

Authentification & SSO (Login, 2FA)

Se connecter à l'application via compte direct, 2FA ou via SSO partenaire. Gère les redirections SSO, la récupération de session et l'affichage des formulaires de connexion.

Établissements

Gérez les sites de l'entreprise : adresses, numéros de téléphone et emails de contact. Montre comment ajouter, modifier et sauvegarder des établissements depuis la page Organisation.

Importeur (iframe d'import de données)

Importer des données via une interface embarquée (iframe) — pratique pour migrations ou intégrations externes sans quitter l'application.

Paramètres — Mon compte

Gérer les informations personnelles du compte : avatar, nom, email, mot de passe et sécurité (2FA). Utile pour maintenir vos informations de contact et sécurité à jour.

Onboarding & conformité

Flux d'onboarding contextuel pour compléter les informations manquantes (ex. national_id pour FR) et respecter les obligations de conformité. Explique les déclencheurs, les champs requis et les étapes attendues de l'utilisateur.

Paramètres — Organisation

Configurer les informations de l'entreprise/organisation : nom, logo, activité, options TVA et comptes par défaut. Utile pour personnaliser la facturation et la comptabilité.

Gérer les clés API

Créer, éditer et supprimer des clés API. Comprend la validation du nom, l'affichage/cachage du token, la copie dans le presse-papiers et la suppression avec confirmation.

Configuration des webhooks

Configurer les endpoints externes : ajouter ou modifier l'URL du webhook, choisir les événements à envoyer et sauvegarder la configuration (qui recharge l'app).

Parrainage & Référencement

Gérer le programme de parrainage : retrouver votre code, inviter par email et voir le tableau de parrainages/crédits. Utile pour promouvoir l'application et suivre les récompenses.

Journal et debugging des webhooks

Consulter les événements envoyés par webhooks avec chargement paginé, visualiser les payloads, tester les endpoints et copier payloads ou messages d'erreur pour le debug.

Gestion des fonctionnalités Premium

Afficher et déclencher des fonctionnalités réservées à certains plans (premium). Permet d'informer l'utilisateur et d'ouvrir des dialogues marketing ou d'upgrade.

Bonnes pratiques et sécurité

Recommandations sur le nommage, la gestion des tokens, la suppression, le test des webhooks et le nettoyage des payloads pour maintenir sécurité et fiabilité.

Documentation API & Swagger Explorer

Accéder à la documentation API (Swagger) et retrouver les routes/opérations exposées pour intégration ou diagnostic. Permet aux développeurs/utilisateurs avancés de connaître les endpoints disponibles.

Configuration Stripe

Configurer les clés Stripe (publishable/secret) et l'URL de webhook pour recevoir les évènements. Guide de validation et bonnes pratiques (environnement, rotation des clés, vérification des signatures).

Paramètres — Web & Locale (i18n, trackers, GTM)

Choisir la langue d'affichage, persister la locale et gérer les outils de tracking (GTM). Utile pour personnaliser l'interface et activer suivi analytique.

Paramétrage PayPal

Instructions pas-à-pas pour connecter un compte PayPal, options d'environnement (sandbox/production) et vidéos explicatives pour faciliter la configuration.

Notifications & Avertissements (Toasts)

Afficher des messages d'information, succès, erreur et alertes via toasts pour le feedback utilisateur. Permet guider l'utilisateur après actions (sauvegarde, erreurs, téléchargements).

Gestion des méthodes de paiement

Ajouter, supprimer et définir une méthode de paiement par défaut (cartes). Vue côté utilisateur et effets côté backend (synchronisation après suppression). Accès rapide depuis Billing > Subscription.

Outils & Utilitaires (Formatage, Dates, Nombres)

Ensemble d'outils pour formater les nombres, montants, dates, générer couleurs et manipuler chaînes. Ces utilitaires améliorent l'affichage et l'ergonomie côté utilisateur.

Checkout et flow de paiement

Démarrer un paiement / abonnement via le checkout, redirection vers l'URI externe de paiement et gestion du retour (URL de succès). Comportement attendu des fenêtres/popups et conseils UX pour la redirection.

SAP & Attestations (Documents légaux)

Générer et envoyer les attestations SAP/URSSAF pour une année donnée et télécharger les documents annuels. Utile pour obligations administratives et preuves de paiement.

Sessions d'achat et page de succès

Consulter les sessions d'achat, diagnostiquer les états de paiement et afficher la page de succès après le retour du checkout. Exemples de suivi et actions post-paiement (confirmation d'abonnement, facturation).

URSSAF & Déclarations sociales

Fonctions liées aux interactions avec l'URSSAF : affichage de messages, enregistrement et envoi de personnes pour dispositif d'avance. Utile pour gérer les obligations sociales liées aux employés/personnes.

Flux SSO — Vue d'ensemble

Présentation du parcours de Single Sign-On : de l'arrivée avec un token dans l'URL à la création de session, en passant par les redirections et la récupération de la session via /me.

Paramètres — Webhooks & Événements (logs)

Configurer la réception d'événements (webhooks), consulter leurs logs et copier payloads pour debug. Inclut pagination du journal et colorisation des statuts.

Paramètres — Stripe & Paiements avancés

Configurer l'intégration Stripe (setup guide, clés, vidéos d'aide) et gérer les tests de connexion et synchronisations. Nécessaire pour utiliser paiements récurrents et webhooks Stripe.

Endpoints SSO et API

Référence des endpoints utilisés pour initier et finaliser l'authentification SSO, ainsi que pour interroger la session active (/me, getSession) et orchestrer les redirections.

Jetons SSO — Validation et consommation

Règles et bonnes pratiques pour décoder, valider et consommer le token SSO fourni en URL. Ce guide couvre la sécurité, l'expiration et le passage du token à la création de session.

Gestion des Tooltips & Aide Contextuelle

Afficher et gérer les bulles d'aide/contextuelles (tooltips) avec contenu enrichi. Permet fournir des aides inline et intégrer du contenu HTML ou des liens Intercom.

Stockage et cycle de vie de la session

Comment la session est persistée localement (sessionStorage/localStorage), comment l'application charge le contexte après authentification et quelles actions déclenchent le vidage (signOut).

Plugins & Extension UX (Impression, Téléphone, Tippy)

Extensions clientes qui ajoutent des fonctionnalités UX : impression, saisie téléphonique internationale, tooltips complexes et chargement de ressources (jQuery). Ces plugins améliorent l'expérience utilisateur.

Multi-apps et redirections post-SSO

Gestion des environnements multi-applications : sélection de l'application cible, basculement via appStore.useApp et navigation vers l'URL appropriée après authentification.

Gestion d'application multi‑tenant (choix d'App, store)

Gérer le contexte d'application (App) multi‑tenant : choisir le locataire, charger sa configuration et ses templates. Utile pour les utilisateurs qui gèrent plusieurs comptes/clients depuis une même interface.

Aperçu du parrainage

Vue d'ensemble du programme de parrainage de l'entreprise : objectifs, règles clés, crédits et accès à l'interface. Idéal pour comprendre comment configurer et superviser les campagnes de recommandation.

Tracking & Analytics (GTM)

Collecter et envoyer des données de tracking via Google Tag Manager (GTM) en fonction du statut d'authentification et context app. Utile pour analyser l'usage et déclencher des événements marketing.

Liens et QR codes de parrainage

Génération et gestion des identifiants de parrainage : créer un lien unique, générer et télécharger le QR code, et proposer le partage (copie dans le presse-papiers). Comporte les comportements UI (toast, SVG) attendus.

Administration & Outils développeur (Sentry, Swagger, Jobs)

Fonctions d'administration et de monitoring (Sentry), accès à la documentation API et exécution de commandes/cron jobs. Utile aux administrateurs pour diagnostiquer et maintenir l'application.

Invitations par email

Envoyer des invitations directement depuis la plateforme : formulaire intégré, validation d'emails avant envoi et gestion des coûts en crédits selon la politique interne. Inclut bonnes pratiques et erreurs communes.

Pipelines d'exports (ACD / Agiris)

Codes de parrainage et liaison de compte

Saisie et validation des codes reçus : comment entrer un code, le valider pour lier un compte, et suivre les crédits associés. Guide pas à pas pour l'utilisateur final et le support.

Événements & Listeners

Configuration rapide de PayPal

Guide concis pour démarrer : accéder aux paramètres PayPal, saisir le client_id et suivre les étapes essentielles du flux multi-étapes pour activer les paiements.

Guide pas-à-pas et vidéos

Tutoriels détaillés avec vidéos intégrées et illustrations pour chaque étape de configuration, conseils visuels et ressources d'aide pour résoudre les cas courants.

Tests de synchronisation et diagnostic

Procédure pour lancer les tests de synchronisation, interpréter le statut d'intégration et corriger les erreurs détectées afin d'assurer la prise de paiements.

Suivi de l'état de configuration

Vue consolidée du statut multi-étapes de la configuration, indicateurs d'avancement, étapes complétées/pending et actions requises pour finaliser l'intégration.

Configuration Stripe

Comment saisir et sauvegarder vos clés publiques et privées Stripe depuis les paramètres. Inclut vérifications et notes sur le comportement au moment de la sauvegarde (reloadConfig potentiel).

Webhook : URL et configuration côté Stripe

Affichage de l’URL webhook fournie (en lecture seule) et instructions pour la copier et la configurer dans le dashboard Stripe. Conseils pour s’assurer que le webhook est accessible et recevra les événements.

Tests et statut de synchronisation

Suivi du statut de synchronisation entre votre application et Stripe, procédure pour tester la synchronisation et ressources d'aide (vidéos). Que faire en cas d'échec de réception d'événements.

Gestion des plans et extras

Créer et gérer des plans et des extras dans l'interface, plus instructions pour activer les extras via l'UI afin qu'ils soient proposés aux utilisateurs.

Configuration et activation du webhook

Guide pas à pas pour saisir l'URL du webhook, sélectionner les événements à envoyer et sauvegarder la configuration afin d'activer le webhook et recharger le contexte applicatif.

Surveillance et historique des événements

Afficher et parcourir l'historique des événements reçus avec pagination, charger plus d'éléments et ouvrir un événement pour consulter son payload.

Inspection et débogage des payloads

Visualiser les payloads JSON normalisés, copier des exemples pour tests, et utiliser l'outil 'cleanJson' pour garantir un format JSON valide avant intégration.

Erreurs, logs et reprise

Consulter les erreurs de livraison, copier les messages d'erreur pour analyse, et comprendre les comportements de reprise après modification de la configuration.

Aperçu et prise en main

Présentation du flux Recherche INSEE (SIRENE), objectifs et cas d'usage. Exemples rapides pour intégrer la recherche d'entreprises dans un formulaire d'organisation, contraintes principales (dépendance à l'API INSEE, gestion des établissements multiples) et recommandations UX pour réduire les erreurs de saisie.

Recherche et affichage des résultats

Guide d'utilisation du champ de recherche (nom / SIREN) et du rendu des résultats. Détail sur les teasers d'enregistrement (libellé, adresse courte), tri/filtrage, pagination, gestion des résultats multiples et comportements en cas d'absence de correspondance ou d'erreur API.

Formatage d'adresse lisible

Stratégies pour convertir les champs d'établissement INSEE en une adresse human-readable : ordre des composants, séparateurs, prise en compte des champs optionnels (numéro, voie, complément, code postal, commune), cas des adresses incomplètes et bonnes pratiques d'affichage dans l'interface.

Sélection, préremplissage et validation

Processus après sélection d'un résultat : mapping des champs INSEE vers le profil organisationnel, préremplissage du formulaire, gestion des conflits (données existantes), actions utilisateur (édition, annulation) et validation finale pour enregistrer l'organisation et fermer l'étape.

Aperçu et concepts

Contexte, objectifs et règles fondamentales de la gestion des tags : ce que sont les tags, sur quelles entités ils s'appliquent et les principes de synchronisation entre UI et backend.

Ajout de tags (typeahead)

Guide d'utilisation et d'implémentation du champ typeahead pour ajouter des tags : ouverture du panneau, suggestions, saisie libre et comportements attendus côté UI.

Suppression de tags et comportement UI

Comportement de suppression : interaction utilisateur, effets immédiats sur l'interface et garanties de cohérence locale en attendant la confirmation backend.

Initialisation locale et synchronisation backend

Stratégies d'initialisation de la liste locale de tags, gestion des états optimistes/pessimistes, et appels API pour persister les ajouts/suppressions et garder les données synchronisées.

Concepts & règles d'accès

Présentation des principes de contrôle d'accès pour les fonctionnalités premium : modèle permission + abonnement, interaction avec la configuration runtime (useRuntimeConfig), et règles UI à appliquer quand l'accès est refusé (classe cn_denied). Indispensable pour comprendre le comportement global avant d'implémenter.

Utiliser le composable premium_feature

Guide pas à pas pour intégrer et configurer le composable premium_feature : comment il intercepte les actions, vérifie les permissions et décide d'afficher une notification ou de rediriger vers l'offre. Exemples d'appels lors d'un clic sur une fonctionnalité verrouillée.

Messages UI, raisons de refus et classes CSS

Patterns UX pour informer l'utilisateur : messages de refus clairs, structure de raison, placement de la notification, et utilisation de la classe cn_denied pour styliser les éléments verrouillés. Comportements attendus après refus (notification vs redirection).

Hook global & enveloppe des actions premium

Implémentation du hook global pour encapsuler boutons et actions premium : comment envelopper les CTA, centraliser la logique (permission + useRuntimeConfig), et déclencher la redirection automatique vers la page d'abonnement quand nécessaire.

Composants de base : Boutons, Inputs & Éléments d'UI

Référence des composants fondamentaux réutilisables : boutons (variants, tailles, loader), champs monétaires avec sélection de devise, labels, tags, onglets et barres de progression. Exemples d'utilisation dans des formulaires et pages, configuration des props et gestion des états loading/toasts.

Cartes, Dialogs & Popovers : Structure et Composition

Guide pour créer des Card, Dialogs et Popovers réutilisables (wrappers, triggers, contenus). Bonnes pratiques d'accessibilité (focus, overlay) avec les primitives Radix, ouverture/fermeture via v-model et composition de CardContent, PopoverTrigger, TabsTrigger.

Typeahead & Command Palette : Recherche, Grouping et Sélection

Documentation du Typeahead et de la command palette : recherche en temps réel, grouping, suggestions, gestion des éléments désactivés, et récupération des valeurs sélectionnées. Inclut exemples d'intégration pour sélectionner des options dans des formulaires et menus.

Facturation & Composants Métiers Spécialisés

Ensemble des composants spécifiques à la facturation et aux menus métiers : dialogues d'édition de lignes de vente, historiques de factures récurrentes, factures impayées, dropdowns spécialisés et éditeurs inline pour catégories comptables, fiscal power et employés. Flux d'édition, prévisualisation et confirmation.

Configuration des tables (dtX) par entité

Guide pour créer et réutiliser des configurations dt (dtX) adaptées aux entités métier : clients, fournisseurs, comptes, produits, factures, achats, employés. Exemples de schémas de colonnes dynamiques, mapping des champs API, templates de colonnes réutilisables et bonnes pratiques pour maintenir plusieurs configs dans le cadre d'une application serveur-driven.

Rendu des cellules et adaptabilité mobile

Composants et patterns pour le rendu personnalisé des cellules : avatar, status, badges, actions inline et composants spécifiques pour mobile (mobile_cell_renderer). Règles de responsive pour afficher une version compacte sur petit écran tout en conservant actions et informations essentielles.

Filtres, pagination, sélection multiple et actions batch

Fonctionnalités UX et API pour filtrer et paginer les tables, sélection multiple de lignes, et exécution d'actions sur une sélection (batch). Inclut l'implémentation d'actionsOnSelection pour déclencher des dialogues (EditObject), gestion d'états de sélection et retours utilisateurs (toasts, confirmations).

Actions inline, dialogues et intégration API

Comportement des actions inline (edit, delete), ouverture de dialogues/modals, flux API et rafraîchissement des données. Règles d'intégration avec useApiFetch et setTableData, gestion des réponses, rechargement de la table après action et pattern pour ouvrir le détail en cliquant sur une ligne.

Comptes généraux

Lister, rechercher et éditer le plan comptable. Expliquer l'utilisation du dialogue DialogAccountingAccountAdd pour ajouter ou modifier un compte, les validations à respecter (numéro, type, solde) et les conséquences des changements (rafraîchissement des tables, reloadConfig).

Catégories et budgets

Gérer les catégories comptables et les budgets associés : création, regroupement, configuration des taux et règles budgétaires. Détails sur les catégories marquées « flat rate », leur impact sur le calcul des budgets et les bonnes pratiques de paramétrage.

Employés et associations comptables

Associer des employés aux comptes comptables pertinents (ex. compte 421, 6251). Procédure pour utiliser l'éditeur EditEmployee, règles de mapping, conséquences sur les écritures automatiques et contrôle de cohérence avant validation.

Paramètres comptables et export

Paramètres globaux affectant les dialogues et l'automatisation des écritures (préfixes, numérotation, taux par défaut). Procédure d'export/import de la configuration, recommandations avant export (sauvegarde, refresh) et mention des actions à prendre après modification (reloadConfig).

Page d'erreur dédiée — contenu et variantes

Conception et éléments de la page d'erreur principale : message clair, icône, tonalité, layout complet vs contenu minimal (empty layout). Indications sur le texte à afficher selon le type d'erreur et comment présenter des instructions exploitables.

Flux de retry — bouton, spinner et feedback

Comportement et ergonomie du mécanisme de réessai : bouton 'Réessayer', état actif/désactivé, animation spinner pendant la tentative, indication de la dernière tentative et messages d'échec successifs.

État de connexion et détection des erreurs réseau/API

Comment détecter et afficher l'état réseau/API : erreurs temporaires vs permanentes, classification pour l'UI, messages utilisateur adaptés et transitions entre online/offline.

Redirections conditionnelles et chemins de rétablissement

Règles de redirection après certaines erreurs (ex. erreurs d'authentification, ressources indisponibles) : destinations sûres, délais, messages avant redirection et fallback minimal si la page cible est indisponible.

Actions utilisateur et support — diagnostics et résolution

Actions proposées à l'utilisateur : consulter le message détaillé, étapes de dépannage guidées, relancer la connexion, et contacter le support avec les informations utiles (horodatage de la dernière tentative, code d'erreur).

Validations & Formatteurs

Helpers et validateurs réutilisables (email, téléphone, IBAN) et utilitaires de formatage (adresse INSEE, dates, monnaies). Les validations retournent toujours un boolean et supportent l'option 'optional'. Exemples d'utilisation et règles d'intégration dans les composants.

Composables UI & Gestion d'état

Composables centrés UI/UX : focus sur le premier champ d'un nom donné, gestion du loader global, popups de confirmation et toggles. Présentation des stores (premiumFeature, urlHistory) et des composables qui effectuent des appels API via useApiFetch en gérant loading/notify.

Export CSV & Helpers de données

Utilitaires pour exporter des données (useExportCSV paginé), génération d'avatars initiaux, transformation d'objets et conversion de types. Bonnes pratiques pour lancer des exports côté client et gérer la pagination/feedback à l'utilisateur.

URL, Config & Plugins Nuxt

Helpers pour construire app_url à partir de la configuration, rechargement de la configuration côté client (reloadConfig), et organisation des fichiers de config front (i18n.config.ts, nuxt.config.ts, package.json, locales). Documentation des plugins Nuxt (branding.js, chartjs.ts) et stratégies de chargement dynamique de SDKs.

Utilities JS & SDK loaders

Collection d'utilitaires JS généraux : md5, utilities de couleurs (stringToHSLColor, palette), loaders pour Google Maps, fonctions utilitaires diverses (formatDate, diffInMonths). Exemples d'usage côté client et intégration avec les plugins Nuxt et composables.

Connexion et 2FA

Tout ce qui concerne l'authentification primaire et la gestion de l'authentification à deux facteurs : processus de connexion, validation des codes envoyés par email/SMS, exigences 2FA et flux de récupération immédiats.

Sessions et tokens

Gestion des sessions utilisateur et des tokens JWT : obtention lors de la connexion, rafraîchissement via endpoint dédié, et terminaison de session côté client et serveur.

Création et gestion du compte

Parcours d'inscription et opérations courantes sur le profil : création de compte, modification des informations, vérification d'email et retours attendus du serveur.

Réinitialisation du mot de passe

Flux complet pour récupérer l'accès : demande de réinitialisation, envoi de lien par email, utilisation du lien et définition d'un nouveau mot de passe en respectant les contraintes de sécurité.

Sécurité, validations et bonnes pratiques

Règles et recommandations pour sécuriser les flux d'authentification : exigences 2FA, limites et validations pour actions sensibles, protection contre l'abus des endpoints (rate limiting, vérifications).

Aperçu et concepts

Présentation du modèle multi‑tenant, des notions d'application/tenant et des règles opérationnelles. Explique comment la sélection d'une application impacte le contexte global (templates, devises, configurations) et quelles opérations sont considérées comme sensibles.

Créer et configurer une application

Guide pas à pas pour créer une nouvelle application et l'organisation associée. Inclut le formulaire de création, les champs recommandés, les réglages initiaux (templates, devises, facturation) et les vérifications post‑création.

Lister, filtrer et sélectionner une application

Comment accéder à la liste des applications accessibles, utiliser les filtres et étendre les informations affichées. Explique la procédure de sélection d'une application et ce qui se charge automatiquement (templates, config, devis/factures, devises).

Administration, réinitialisation et diagnostics

Opérations d'administration pour maintenir ou dépanner une application : réinitialisation des données, suivi des jobs, et tests réseau (ping). Détaille les flux de confirmation et les exigences de permission pour les opérations destructrices, ainsi que la consultation de l'historique des tâches.

Flux d'onboarding et conception des étapes

Définir et structurer le parcours pas à pas présenté à l'utilisateur lors de la première configuration : ordre des écrans, contenu des formulaires, points de décision et indicateurs de progression. Comprend bonnes pratiques UX pour guider sans surcharger et exemples de modélisation d'un flux d'étapes.

Persistance et restauration des réponses

Stratégies pour sauvegarder l'état d'onboarding (local et serveur), gestion des échecs réseau, reprise ultérieure et restauration d'une session incomplète. Inclut schémas d'API, contrats de données et recommandations de sécurité et confidentialité.

Contrôles utilisateur : navigation, sauts et retours

Documentation des contrôles disponibles pour l'utilisateur pendant l'onboarding : précédent/suivant, bouton Ignorer, états persistés après saut, et retours pour modifier des réponses. Comportements attendus et pièges à éviter (perte de données, incohérences).

Étapes conditionnelles et logique dynamique

Comment définir et implémenter des règles conditionnelles pour afficher (ou non) certaines étapes selon le contexte métier (ex. existence de devis/factures, type d'utilisateur). Couverture des patterns côté client et serveur pour évaluer conditions, tester scenarios et maintenir lisibilité du flux.

Invitations et onboarding

Tout ce qu'il faut savoir pour inviter de nouveaux collaborateurs et les onboarder : création et envoi d'invitations par email, acceptation via token et liaison automatique au rôle/applicable. Inclut les vérifications de rôle et les limites liées à l'abonnement lors de l'envoi d'invitations.

Gestion des collaborateurs

Guide opérationnel pour lister, ajouter, modifier et supprimer des collaborateurs. Exemples de workflows pour modifier les rôles, confirmer des suppressions et maintenir une vue d'ensemble des accès.

Profils et politiques d'accès

Configuration et attribution des profils d'accès (user policies). Explique comment assigner des politiques, utiliser des profils prédéfinis, et les bonnes pratiques pour maintenir la cohérence lors des mises à jour.

Accès support temporaire et suppression en masse

Procédures pour accorder des accès de support temporaires et pour supprimer des collaborateurs en masse. Détaille le workflow d'invitation support, les autorisations requises, l'impact des suppressions (nettoyage des policies liées) et les précautions avant une suppression massive.

Gestion des contacts et organisations

Créer, modifier, supprimer et restaurer les personnes et organisations. Couvrir les champs principaux (nom, adresse, logos/images), la gestion des permissions et le stockage des images via le storage central.

Établissements et adresses géolocalisées

Gérer établissements liés à une organisation ou une personne, définir le siège/principal, et positionner des adresses géolocalisées avec autocomplétion Google quand disponible.

Emails, téléphones et pièces jointes

Gérer les listes d'emails et de téléphones (plusieurs entrées, choix du principal), attacher et détacher des fichiers aux relations, et règles de sélection du principal.

Recherche, fusion et dédoublonnage

Identifier doublons, rechercher contacts similaires et fusionner en toute sécurité : choisir le contact principal, transférer la propriété des documents liés et vérifier l'opération.

Export, mandats SEPA et hydratation depuis sources publiques

Exporter données liées (ex. mandats SEPA), obtenir exports clients/fournisseurs et hydrater une organisation depuis des données publiques via matching (VAT / national_id).

Créer et gérer des devis & factures

Tout ce qu’il faut pour créer, modifier, dupliquer et supprimer des devis et factures : saisie client/ligne, sauvegarde, règles de suppression et bonnes pratiques pour la gestion quotidienne des documents commerciaux.

Finaliser et transformer les documents

Procédures et contrôles pour finaliser un devis ou une facture, transformer un devis en facture / situation / acompte, et les actions annexes (comptabilité, numérotation, verrouillage de statut).

Génération et téléchargement des PDF

Générer les PDF de devis/factures, comprendre le traitement asynchrone et récupérer les fichiers individuellement ou en ZIP.

Envoyer par email et gérer les signatures

Envoyer devis et factures directement par email avec pièces jointes et signature électronique, composer le message, suivre l’envoi et vérifier les confirmations de réception.

Suivi commercial, statistiques et numérotation

Consulter le cycle commercial et les statuts des documents, suivre les statistiques (chiffre, nombre de devis/factures) et consulter/paramétrer les numéros suivants.

Gestion des achats

Créer, modifier, supprimer et suivre les achats fournisseurs. Gérer les statuts, consulter les statistiques et appliquer les règles d'autorisation (suppression globale, vérifications d'abonnement).

Justificatifs et pièces jointes

Importer, attacher et organiser les justificatifs (PDF / scans). Contrôles de format et taille, association automatique ou manuelle à un achat, et options de téléchargement des originaux ou d'archives.

Aperçus et OCR

Génération de vignettes et aperçus des justificatifs, lancement et forçage de l'OCR. Comportement asynchrone (file d'attente), exécution automatique ou manuelle, et affichage des previews sur demande.

Exportation et génération de PDF

Télécharger originaux, créer archives ZIP et régénérer PDF (notes de frais, indemnités kilométriques). Flux pour sélectionner achats, lancer la génération et récupérer les fichiers exportés.

Comptes et catégories comptables

Gérer le référentiel comptable : création, modification et suppression des comptes et des catégories. Expliquer les bonnes pratiques de structuration, les impacts sur les exports et comment maintenir la cohérence des données.

Création d'exports comptables mensuels

Procédure pour créer un export comptable : choix de la période et du format, vérifications préalables, règles d'éligibilité des données et lancement de la génération. Inclut les messages d'erreur fréquents (période sans données) et les exigences par format.

Intégrations et paramètres pour Agiris / ACD / Pennylane

Configuration des formats externes : quelles options sont requises pour Agiris, ACD et Pennylane (UUID, filenumber, mappings), où saisir ces paramètres, validation et stockage sécurisé. Détaille contraintes propres à chaque solution.

Génération asynchrone et suivi des jobs

Comportement asynchrone de la génération des fichiers d'export : comment déclencher un job, modèle de file d'attente, statuts possibles, notifications et comment récupérer le fichier une fois le job terminé. Inclut dépannage des jobs échoués.

Téléchargement et gestion des fichiers d'export

Récupération et gestion des fichiers générés : interface de téléchargement, format des fichiers, conservation, nommage (filenumber), et manipulation des ExportFile. Explique aussi la mise à disposition aux experts-comptables.

Générer et consulter un forecast

Étapes pour lancer le calcul d'un forecast (cashflow, budgets, KPIs) sur une période donnée, visualiser les tableaux et graphiques générés et comprendre les règles d'agrégation et de remplissage des périodes.

Configurer éléments et catégories de forecast

Guide pour créer, mettre à jour et organiser les lignes et catégories de forecast ; appliquer des éléments aux catégories pour structurer vos prévisions.

Visualisation & export des graphiques

Initialisation et personnalisation des graphiques (Chart.js), bonnes pratiques d'affichage par période et options pour exporter ou télécharger les visuels et tableaux.

Statistiques, budgets et règles de persistance

Comment obtenir statistiques clés (invoices unpaid, purchases unpaid, average payment), enregistrer budgets et pourcentages, et comprendre la persistance côté serveur des modifications de budgets.

Vue d'ensemble des comptes bancaires

Liste et état des comptes connectés (Bankin), navigation rapide vers les actions de connexion, désynchronisation ou suppression. Expose les conséquences possibles (suppression en cascade) et bonnes pratiques pour la gestion quotidienne des comptes.

Connexion et gestion des flux Bankin

Guide pas à pas du funnel Bankin : connecter un compte, sélectionner les comptes à synchroniser, éditer et valider les flux. Inclut les erreurs fréquentes et comment vérifier les permissions et l'état de connexion.

Synchronisation et jobs asynchrones

Importer et synchroniser les transactions bancaires : lancer une synchronisation, suivre l'exécution des jobs asynchrones (Bankin) et consulter les logs/états. Explique les délais possibles et comment réagir aux échecs.

Rapprochement et gestion des transactions

Procédures pour rapprocher automatiquement ou manuellement les transactions : sélectionner une transaction, lier au paiement/facture, annuler un rapprochement et gérer les cas ambigus nécessitant intervention humaine.

Sources de cashflow et impacts comptables

Créer, modifier et supprimer les sources de cashflow utilisées pour catégoriser les flux bancaires. Détaille les conséquences comptables des modifications et les précautions à prendre en cas de suppression (cascade sur transactions/écritures).

Créer et gérer les paiements

Guide pour créer des transactions et paiements, enregistrer règlement(s) et comprendre les effets comptables. Inclut bonnes pratiques, droits requis et contrôle des modifications de transaction.

Rapprochement manuel et annulation

Procédure pas-à-pas pour rapprocher manuellement une transaction avec un document (facture/achat) et pour annuler un rapprochement existant en toute sécurité, en tenant compte des conséquences sur les écritures.

Traitement par lots (batch)

Comment importer, exécuter et vérifier des lots de rapprochements en batch. Règles de cohérence (montants, devises) et gestion des erreurs pour un traitement séquentiel fiable.

Breakdowns et allocation de paiements

Explication des breakdowns pour allouer un paiement sur plusieurs factures/achats, règles d'affectation, validation des montants et impacts sur les transactions.

Reporting et recette de paiement

Génération de recettes de paiement et rapports pour le suivi des rapprochements, vérification des batchs et export comptable. Inclut modèles de rapports et listes de contrôles.

Vue d'ensemble & plans

Page d'introduction pour consulter l'état d'abonnement actuel et explorer les offres disponibles. Expose les informations de facturation essentielles (statut, période, limites) et aide l'utilisateur à choisir un plan adapté.

Stripe Checkout — démarrer, échanger, annuler

Procédures et contraintes pour lancer des abonnements via Stripe Checkout, échanger de plan ou annuler. Explique le parcours utilisateur (sélection du plan → lancement du Checkout → finalisation du paiement), les statuts retournés par Stripe et les règles de proration ou facturation immédiate.

Sources et méthodes de paiement

Gestion des moyens de paiement : ajout, sauvegarde, configuration de la méthode par défaut et suppression de sources. Précise les flux techniques pour enregistrer une carte ou autre méthode et l'impact sur l'accès aux fonctionnalités si une source est retirée.

Factures, paiements impayés & simulations

Paiement des factures (y compris règlement global 'Payer tout'), gestion des tentatives de recouvrement et outils de simulation (upcoming) pour prévoir l'impact d'un changement de plan ou l'application d'un coupon. Inclut la marche à suivre pour appliquer coupons et tester une facture à venir.

Intégration PayPal

Connexion et déconnexion du compte PayPal pour acceptation des paiements. Détaille la configuration (ClientId), le processus de connexion et les vérifications d'état nécessaires pour activer PayPal comme source de paiement.

Partager via lien sécurisé

Comment générer et partager un lien tokenisé pour permettre l'accès restreint à une facture. Guide pas‑à‑pas pour obtenir le lien, options de personnalisation (durée, destinataires) et bonnes pratiques d'envoi.

Accès et validation des tokens

Mécanismes de déchiffrement et de validation des tokens côté serveur, logique métier pour afficher les données et règles d'autorisation. Journalisation et traitement des accès refusés.

Téléchargements PDF et archives ZIP

Procédures pour générer et télécharger des factures au format PDF, produire des archives ZIP et gérer les exports utilisateurs (sélection, génération, récupération). Indications sur le suivi et l'UX pour exports volumineux.