Architecture de la Plateforme & Concepts Opérationnels

Découvrez comment Digintu Pay automatise l'exécution des paiements d'entreprise, la numérisation des factures et le rapprochement du grand livre bancaire.

Architecture de Base : Convertisseurs vs. Pipelines

Une distinction opérationnelle fondamentale existe entre les Convertisseurs de format et les Pipelines automatisés.

  • Convertisseurs : Règles définissant les transformations de données (ex. mappage CSV vers ISO 20022 pain.001 ou camt.053 vers une feuille Excel). Ils s'exécutent à la demande dans la mémoire du navigateur.
  • Pipelines : Flux de traitement automatisés continus combinant un canal d'ingestion entrant, une règle de convertisseur et une destination sortante.
  • Séparation des Responsabilités : Construisez votre logique de transformation dans les Convertisseurs une seule fois, testez-la à l'aide de fixtures dynamiques, puis déployez-la dans un Pipeline headless automatisé.

Modèle de Traitement à Zéro Rétention

Digintu Pay agit strictement en tant que middleware de conversion de données transitoire.

  • Traitement en Mémoire Volatile : Les fichiers téléchargés et les instructions de paiement sont analysés entièrement dans la RAM volatile du conteneur.
  • Suppression Immédiate : Une fois transformées et livrées au SFTP bancaire ou au webhook cible, les charges utiles brutes sont purgées instantanément.
  • Non-Répudiation des Audits : Les journaux de diagnostic capturent uniquement les métadonnées (nom de fichier, horodatage, code de statut, hachage SHA-256), ne préservant aucun enregistrement financier dans les bases de données permanentes.

Configuration de l'Espace de Travail & de l'Organisation

Configurez l'identité de l'entreprise, les comptes bancaires par défaut du débiteur et les paramètres de la partie ordonnatrice.

Configuration des Détails par Défaut de l'Entreprise

Établissez des comptes débiteurs et des informations d'adresse de repli.

  • Accédez au Profil ou ouvrez une règle de Convertisseur dans le Canevas de Mappage.
  • Cliquez sur l'Onglet 2 (Configuration & Paramètres par Défaut) et localisez 'Coordonnées de l'Ordonnateur & Adresse (Débiteur)'.
  • Renseignez votre compte de débit par défaut (IBAN) et le code BIC/SWIFT de votre banque.
  • Saisissez la rue structurée, le numéro de bâtiment, le code postal, la ville et le code pays ISO-2 de votre entreprise.
  • Enregistrez les modifications. Ces valeurs par défaut remplissent automatiquement les en-têtes de groupe ISO chaque fois qu'un fichier d'entrée omet explicitement les métadonnées du débiteur.

Gestion de Multiples Espaces de Travail

Opérez de manière transparente sur plusieurs filiales ou mandats clients.

  • L'isolement de l'espace de travail garantit que les pipelines, les schémas personnalisés et les journaux d'audit restent strictement séparés.
  • Les Propriétaires peuvent renommer les espaces de travail actifs directement depuis la page de Gestion de l'Équipe.
  • Les membres de l'équipe invités à plusieurs organisations peuvent accepter des invitations d'invité sans créer d'identifiants de connexion en double.

Catalogue de Modèles & Schémas Prêts à l'Emploi

Accédez à des modèles de compensation vérifiés pour les réseaux de paiement européens et suisses.

Parcourir & Activer un Modèle

Sélectionnez des configurations testées dans la bibliothèque vérifiée.

  • Cliquez sur le bouton 'Catalogue' situé en haut à droite du tableau de bord des Convertisseurs.
  • Utilisez la barre de recherche pour filtrer par fournisseur ERP (ex. Bexio, Abacus, Dynamics), format de compensation ou banque.
  • Cliquez sur n'importe quelle carte de modèle pour inspecter ses mappages préconfigurés, ses délimiteurs et ses fixtures de test en direct.
  • Le canevas s'ouvre automatiquement avec le modèle préchargé. Renommez la règle et cliquez sur 'Enregistrer la Règle de Convertisseur' pour l'ajouter à votre espace de travail.

Canevas de Mappage Personnalisé

Créez des mappages de données personnalisés pour convertir des fichiers plats ERP, des CSV ou des charges utiles JSON en schémas ISO 20022.

1. Définition des Formats & Délimiteurs

Guide étape par étape pour configurer les fichiers sources.

  • Cliquez sur 'Nouveau Convertisseur' sur la page des Convertisseurs ou choisissez 'Créer de Toutes Pièces'.
  • Entrez un nom de règle descriptif (ex., 'Exécution Fournisseur Hebdomadaire - Dynamics NAV').
  • Sélectionnez le Domaine Financier : Comptes Fournisseurs (Paiements Fournisseurs), Rapprochement Bancaire (Relevés), ou Comptes Clients (Facturation).
  • Sélectionnez votre format d'entrée source (CSV, Excel, JSON, PDF) et le schéma ISO cible souhaité (ex., pain.001.009 suisse, EPC SEPA).
  • S'il s'agit d'un tableau, spécifiez les délimiteurs de colonnes (virgule, point-virgule, barre verticale) et indiquez si la ligne 1 contient des en-têtes.

2. Extraction d'Attributs & Liaison de Champs

Découverte automatique des colonnes et liaison aux balises de paiement.

  • Dans la barre latérale gauche, localisez 'Exemple de Données Entrantes'. Cliquez sur 'Glisser-déposer un exemple' et téléchargez un exemple de feuille de calcul ou de charge utile JSON.
  • Cliquez sur 'Extraire les Attributs'. Le moteur découvre tous les en-têtes et affiche un tableau d'aperçu.
  • Naviguez vers l'Onglet 3 (Détails de Mappage de Données) et développez les groupes fonctionnels (Montants, Banque Bénéficiaire, Référence).
  • Pour chaque champ ISO cible, sélectionnez la colonne source correspondante dans le menu déroulant.
  • Pour les champs manquants, fournissez une valeur par défaut statique dans le champ de repli.

3. Modificateurs & Règles de Transformation

Application de la désinfection en ligne, des formateurs de devises et des analyseurs de dates.

  • Cliquez sur le menu déroulant de transformation à côté de n'importe quel champ mappé.
  • Sélectionnez les modificateurs : 'Supprimer les Espaces', 'Forcer les Majuscules', 'Analyser Décimale (1,000.50 -> 1000.50)', ou 'Analyser Date'.
  • Pour les blocs d'adresse, appliquez 'Décomposition Intelligente d'Adresse (Nov 2026)' pour diviser automatiquement les chaînes en rue, bâtiment et ville.
  • Plusieurs transformations s'exécutent séquentiellement de gauche à droite.

Simulation en Mémoire (Dry Runs)

Simulez les conversions en temps réel, inspectez la sortie XML et assurez zéro rejet de schéma avant la soumission en direct à la banque.

Exécution d'un Test à Blanc (Dry Run)

Test des mappages directement dans la mémoire du navigateur.

  • Ouvrez n'importe quelle règle de convertisseur et cliquez sur 'Simulation de Test (Dry Run)' dans le pied de page, ou cliquez sur 'Lancer l'Outil' sur la carte du Convertisseur.
  • Dans la boîte de dialogue, cliquez sur 'Charger l'Exemple de Données' pour remplir automatiquement la fixture de test, ou glissez un fichier test sur la zone de dépôt.
  • Cliquez sur 'Lancer le Test de Transformation'.
  • Le moteur analyse la charge utile dans la RAM volatile et présente le XML/JSON de sortie avec coloration syntaxique.
  • Vérifiez les totaux d'instructions et les codes de devise, ou cliquez sur 'Télécharger le Fichier' pour inspecter le package physique.

Mode de Diffusion en Direct vs Simulation

Les conséquences de l'activation du commutateur Mode de Diffusion en Direct.

  • Lors d'une simulation à partir d'un Pipeline automatisé, un commutateur 'Mode de Diffusion en Direct' apparaît.
  • Décoché (Par Défaut) : L'exécution génère la sortie strictement pour l'aperçu du navigateur. Aucun réseau externe n'est contacté.
  • Coché : Le fichier généré est physiquement transmis à l'endpoint sortant configuré (SFTP de la banque externe, API webhook). À utiliser avec précaution sur les routes de production.

Création d'un Pipeline Automatisé

Automatisez les routes de traitement de bout en bout avec des travailleurs planifiés ou déclenchés par événements.

Guide de l'Assistant

Création complète d'un pipeline automatisé de toutes pièces.

  • Naviguez vers 'Pipelines' dans le menu principal et cliquez sur 'Nouveau Pipeline de Compensation'.
  • Étape 1 (Détails) : Attribuez un nom de route, activez la vérification des fichiers en double (SHA-256) et configurez les destinataires des notifications par e-mail.
  • Étape 2 (Entrant) : Choisissez comment les données entrent (API REST Provisionnée, SFTP Dédié, Google Drive, ou Boîte aux Lettres E-mail).
  • Étape 3 (Convertisseur) : Liez la règle de mappage préconstruite responsable de la transformation des fichiers ingérés.
  • Étape 4 (Sortant) : Sélectionnez où les fichiers ISO 20022 transformés sont livrés (SFTP Bancaire, Webhook Externe, Dépôt SFTP Digintu, ou E-mail).
  • Cliquez sur 'Déployer le Pipeline'. Vos identifiants et endpoints se généreront instantanément.

Canaux Entrants (API, SFTP, Drive, E-mail)

Spécifications détaillées de connexion pour tous les protocoles d'ingestion sources pris en charge.

Ingestion API REST Provisionnée

Spécifications HTTP POST directes.

  • Endpoint Cible : Publiez multipart/form-data ou des charges utiles brutes vers https://api-pay-dev-1.digintu.ch/api/v1/pipelines/execute/api.
  • Authentification d'En-tête : Fournissez votre clé de canal générée via l'en-tête X-API-Key.
  • Réponse : Renvoie HTTP 200 avec les métadonnées de livraison en cas d'analyse réussie, ou HTTP 400 avec les détails d'erreur de diagnostic.

Dossiers de Dépôt SFTP Provisionnés

Connexion des exportations de fichiers en arrière-plan de l'ERP via SFTP.

  • Serveur : Connectez-vous à ftps-pay.digintu.ch sur le port 2222.
  • Authentification : Utilisez le nom d'utilisateur provisionné et le mot de passe secret, ou téléchargez votre clé publique SSH d'entreprise pour une connexion sans mot de passe.
  • Répertoire : Déposez les fichiers dans le dossier racine /uploads. Le travailleur en arrière-plan interroge l'écriture complète des fichiers et les traite immédiatement.

Google Drive & Ingestion par E-mail

Surveillance automatisée des dossiers et interrogation des boîtes de réception.

  • Google Drive : Fournissez un e-mail de compte Google d'entreprise autorisé. Digintu provisionne un dossier partagé chiffré et écoute les nouveaux téléchargements.
  • Boîte aux Lettres E-mail : Transférez les pièces jointes comptables vers l'adresse d'ingestion unique attribuée (ex., pay-in+key@digintu.tech). Les pièces jointes sont analysées et vérifiées instantanément.

Livraison Sortante & Webhooks

Transmettez les messages ISO 20022 validés directement aux systèmes hôte à hôte de la banque ou aux endpoints de trésorerie.

Configuration des Webhooks Externes

Diffusion du JSON/XML converti vers les endpoints en amont.

  • Dans l'assistant Pipeline (Étape 4), choisissez 'API Utilisateur'.
  • Fournissez l'URL de destination cible (ex., https://erp.company.com/webhooks/payments).
  • Entrez les en-têtes d'autorisation personnalisés (jetons Bearer, clés API) ou les en-têtes de métadonnées personnalisés.
  • Activez la signature HMAC si votre serveur de réception nécessite une vérification cryptographique de la charge utile.

Transmission SFTP Bancaire Externe

Livraison des instructions de paiement directement aux serveurs bancaires.

  • Sélectionnez 'SFTP Externe' comme destination sortante.
  • Entrez le nom d'hôte de la banque, le port (généralement 22), le nom d'utilisateur et le chemin du dossier de destination (ex., /clearing/inbound/).
  • Choisissez le Type de Connexion : Normal (Mot de passe) ou Clé (Collez votre clé privée SSH autorisée par votre banque).
  • Les fichiers transformés sont diffusés directement vers la passerelle bancaire hôte à hôte dès l'achèvement du pipeline.

HMAC, Listes Blanches IP & Clés SSH

Sécurisez les endpoints contre les requêtes non autorisées, les attaques par rejouo et les intrusions réseau.

Configuration des Listes Blanches IP (CIDR)

Restriction de l'entrée aux adresses IP statiques d'entreprise désignées.

  • Ouvrez les paramètres de votre pipeline et naviguez vers Sécurité Entrante.
  • Entrez les adresses IP publiques de sortie de votre entreprise au format CIDR (ex., 195.141.22.0/24, 84.115.10.4).
  • Enregistrez les modifications. Les tentatives de connexion provenant d'adresses non listées sont rejetées en périphérie avec HTTP 403 Forbidden.

Signature de Charge Utile HMAC-SHA256

Vérification cryptographique de l'intégrité du message.

  • Vérification Entrante : Exigez que les webhooks entrants passent une signature HMAC calculée à l'aide de votre secret de canal.
  • Signature Sortante : Digintu signe les charges utiles HTTP sortantes et joint le condensé dans l'en-tête configuré (par défaut : X-Signature).
  • La falsification de la charge utile en transit invalidera la signature, provoquant le rejet sécurisé de la transmission par la passerelle de réception.

Novembre 2026 Adresses Structurées

Préparez-vous à l'échéance obligatoire des adresses structurées SIX suisse et EPC européen.

Présentation du Mandat : Rejet des Adresses Non Structurées

Pourquoi les anciens blocs d'adresse de 7 lignes échoueront à la compensation.

  • Mandat Réglementaire : Les réseaux de compensation européens et suisses exigent l'élimination complète des éléments d'adresse non structurés (AdrLine) d'ici novembre 2026.
  • Pénalités de Non-Conformité : Les instructions de paiement comportant des adresses non structurées seront automatiquement rejetées par les processeurs de compensation bancaire.
  • Exigence : Toutes les adresses des créanciers et débiteurs doivent être décomposées en Nom de Rue (StrtNm), Numéro de Bâtiment (BldgNb), Code Postal (PstCd), Nom de Ville (TwnNm) et Pays (Ctry).

Moteur de Fractionnement Automatique d'Adresse

Comment Digintu Pay nettoie et analyse les champs d'adresse.

  • Dans votre Canevas de Mappage de Convertisseur, mappez votre chaîne d'adresse complète source à rawUnstructuredAddress.
  • Appliquez le modificateur : 'Décomposition Intelligente d'Adresse (Nov 2026)'.
  • Le moteur analyse les préfixes de rue, les numéros de maison, les suffixes de bâtiment et les codes postaux à travers les formats européens.
  • Le fichier ISO 20022 pain.001 compilé produit des balises XML propres et entièrement structurées correspondant aux schémas de validation officiels.

Rapprochement de Relevés CAMT.053

Analysez les relevés de solde bancaire de fin de journée et exportez des flux CSV/Excel propres pour le rapprochement du grand livre.

Analyse des Écritures CAMT.053

Extraction des soldes d'ouverture et de clôture, des dates de valeur et des lignes d'écriture.

  • Déposez le fichier XML CAMT.053 de votre banque dans un outil de conversion ou automatisez l'ingestion via SFTP.
  • L'analyseur extrait les soldes comptables d'ouverture et de clôture, les dates de valeur des écritures, les indicateurs de crédit/débit (CRDT/DBIT) et les montants des transactions.
  • Les descriptions de versement et les références créancier (SCOR / QRR) sont normalisées en colonnes tabulaires propres.
  • Téléchargez le résultat sous forme de classeur de rapprochement Excel standardisé ou acheminez-le directement dans votre grand livre cloud.

QR-Bills Suisses & ZUGFeRD / Factur-X

Générez des bulletins de versement QR suisses officiels et des factures électroniques Factur-X européennes.

Règles de Génération de la QR-Bill

Validation des QR-IBAN et des numéros de référence structurés à 27 chiffres.

  • Dans le Canevas de Convertisseur, sélectionnez le domaine Facturation avec le format cible 'QR-Facture Client (PDF)'.
  • Entrez votre Compte Créancier officiel (QR-IBAN commençant par CH ou LI).
  • Si les numéros de référence sont manquants dans les enregistrements de facturation source, activez 'Calcul Automatique des Références de Paiement Manquantes'.
  • Le moteur génère des parties de paiement PDF conformes et imprimables comportant la croix suisse et le code QR officiel.

Profils XML ZUGFeRD / Factur-X

Compilation de PDF de facture hybrides conformes à la norme EN16931.

  • Sélectionnez le format cible 'Client ZUGFeRD (PDF)' ou 'Hybride QR + ZUGFeRD'.
  • Choisissez votre profil de conformité : BASIC (B2B standard), EN16931 (mandat du gouvernement de l'UE), ou EXTENDED.
  • Le document PDF/A-3 résultant contient des pages de mise en page lisibles par l'homme ainsi que du XML intégré lisible par machine.

Gestion d'Équipe & Rôles (Propriétaire vs Membre)

Modèle de permissions, changement de contexte d'invité et invitations d'équipe.

Permissions des Rôles : PROPRIÉTAIRE vs MEMBRE

Exécution opérationnelle vs gouvernance de facturation.

  • Rôle PROPRIÉTAIRE : Autorité administrative complète. Gère les abonnements Stripe, les allocations de sièges, les invitations d'équipe, la rotation des identifiants et la suppression de l'espace de travail.
  • Rôle MEMBRE : Autorité opérationnelle. Peut créer et modifier des Convertisseurs, déclencher des exécutions manuelles de pipelines, inspecter les journaux d'audit et télécharger les fichiers transformés.
  • Frontière de Sécurité : Les membres ne peuvent pas consulter les secrets API sensibles, faire pivoter les mots de passe SFTP ou accéder aux portails de facturation.

Changement d'Espace de Travail Invité

Comment les membres de l'équipe opèrent de manière transparente dans les environnements clients invités.

  • Lorsqu'un utilisateur existant accepte une invitation d'équipe vers un autre espace de travail, il y entre en tant que Membre Invité opérationnel.
  • Sa propre organisation, son abonnement et ses pipelines restent actifs en arrière-plan.
  • Pour retourner à leur environnement domestique à tout moment, les utilisateurs cliquent sur 'Quitter l'Espace de Travail' dans leurs paramètres de Profil.

Facturation, Capacité & Crédits de Transaction

Compréhension des quotas de transactions, des compléments d'extension et des niveaux d'abonnement.

Comment les Crédits sont Comptabilisés

Consommation mesurée par instruction validée.

  • Transactions : Chaque instruction de paiement individuelle dans un fichier pain.001 ou ligne d'écriture dans un relevé bancaire consomme 1 Crédit de Transaction.
  • Niveau Gratuit : Comprend 10 crédits gratuits chaque mois. Idéal pour les tests ad-hoc et la validation mensuelle de petits lots.
  • Niveau Standard : Comprend 250 transactions/mois, 1 pipeline automatisé actif et 1 siège utilisateur.
  • Niveau Avancé : Comprend 1 000 transactions/mois, 3 pipelines automatisés et 3 sièges d'équipe.

Mise à l'Échelle de la Capacité (Pipelines, Sièges & Packs de Crédits)

Mises à niveau au prorata via la Facturation Stripe.

  • Les propriétaires de forfaits Avancés peuvent adapter dynamiquement les ressources sans changer de niveau.
  • Naviguez vers Profil > Capacité de l'Espace de Travail > Gérer la Capacité.
  • Ajustez les compteurs pour les sièges d'équipe supplémentaires (+EUR 9/mois), les pipelines automatisés (+EUR 35/mois), ou les packs de 100 transactions (+EUR 15/pack).
  • Les frais ou crédits au prorata s'appliquent automatiquement à votre cycle de facturation actuel.

Pistes d'Audit & Résolution des Erreurs

Inspectez les journaux d'exécution, vérifiez la déduplication cryptographique et diagnostiquez les transferts rejetés.

Examen des Journaux d'Audit d'Exécution

Inspection des horodatages, du nombre d'enregistrements traités et des codes de statut.

  • Sur le tableau de bord des Pipelines, cliquez sur 'Actions' > 'Voir les Journaux d'Audit' à côté de n'importe quel canal.
  • Un grand livre chronologique affiche toutes les exécutions récentes, les noms de fichiers d'origine, les horodatages d'exécution et les statuts de réussite/échec.
  • Cliquez sur n'importe quel enregistrement de journal pour copier le nom de fichier d'origine et afficher le nombre de transactions ou les avertissements d'analyse.

Protection contre les Doublons & Idempotence

Comment la génération d'empreintes SHA-256 empêche les doubles paiements.

  • Si 'Autoriser les Fichiers en Double' est désactivé dans vos paramètres de pipeline, le système calcule un hachage SHA-256 de chaque charge utile entrante.
  • Si un fichier identique est soumis dans une fenêtre de 30 jours, l'exécution s'arrête immédiatement avec une alerte de collision de doublon.
  • Cela élimine les paiements fournisseurs en double accidentels causés par des exportations ERP répétées.