DOM-14 — Intégrations & Interopérabilité (dont EDI)

Deux références distinctes (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-14) : un ERP propriétaire du marché des PME industrielles gagne l’EDI donneurs d’ordres natif (automobile GALIA/ODETTE + grande distribution) — le différenciant industriel absolu, absent des libres ; un CRM open-core récent à architecture métadonnées-driven étudié lors de l’analyse gagne l’API générée par workspace. EDI multi-formats = complexe/coûteux (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §6). L’expertise d’un partenaire EDI spécialisé guide les formats. Aucune reprise de code des ERP étudiés.

Décision validée pour la V1. L’EDI automobile GALIA/ODETTE est la filière pilote, avec appels de livraison, AVIEXP/DESADV, INVOIC, colisage SSCC et mapping paramétrable par client. La grande distribution est séquencée après cette filière.

EXG-14-001 — EDI donneurs d’ordres automobile (GALIA/ODETTE)

• Priorité : Should
• Livraison : Lot 3, selon DEC-0217, priorité et critères conservés.
• Domaine : DOM-14
• Énoncé : « Elena doit intégrer les flux EDI automobile aux standards EDIFACT/GALIA/ODETTE : expressions de besoins (DELINS/DELFOR) et appels de livraison (CALDEL/DELJIT) en entrée devenant des commandes internes ; avis d’expédition (AVIEXP/DESADV) et factures (INVOIC) en sortie. »
• Justification : le différenciant industriel absolu, pratique de référence observée chez un ERP propriétaire du marché des PME industrielles (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §6 « EDI donneurs d’ordres ») : commandes en entrée (prévisionnelles, fermes, appels de livraison), avis d’expédition et factures en sortie ; messages DELINS/DELFOR/CALDEL/DELJIT/AVIEXP/INVOIC.
• Critères d’acceptation :
  • CA-01 — Intégration des commandes fermes et prévisionnelles.
  • CA-02 — Gestion de l’« annule et remplace » et du calage avance/retard.
  • CA-03 — Génération AVIEXP (DESADV) et INVOIC depuis BL et facture.
• Dépendances : EXG-01-003 (commande), EXG-04-005 (expédition), EXG-04-006 (colisage SSCC non imposé explicitement par les critères ; arbitrage requis), EXG-06-001 (facture).

EXG-14-002 — EDI grande distribution (ORDERS/DESADV/INVOIC)

• Priorité : Should
• Livraison : Lot 3, selon DEC-0217, priorité et critères conservés.
• Domaine : DOM-14
• Énoncé : « Elena doit intégrer les flux EDI grande distribution : ORDERS en entrée, ORDRSP/DESADV/INVOIC en sortie, avec colisage alimentant le DESADV. »
• Justification : filière grande distribution, pratique de référence observée chez un ERP propriétaire du marché des PME industrielles : ORDERS (entrant), ORDRSP/DESADV/INVOIC (sortants) ; le colisage UC/UM alimente le détail de colisage du DESADV (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-14).
• Critères d’acceptation :
  • CA-01 — Accusé de commande (ORDRSP) généré depuis la commande intégrée.
  • CA-02 — DESADV portant le détail de colisage (SSCC).
  • CA-03 — Pénalité de retard DESADV documentée comme risque métier.
• Dépendances : EXG-14-001 (l’exigence cible est automobile et n’est pas définie comme socle EDI générique ; arbitrage requis).
• Co-requis : EXG-04-006 (le DESADV porte le détail SSCC, livré dans le même lot).

EXG-14-003 — API GraphQL/REST et exposition automatique des objets

• Priorité : Must
• Domaine : DOM-14
• Énoncé : « Elena doit exposer les objets métier natifs et automatiquement les objets personnalisés via GraphQL pour les lectures et REST pour les écritures, sans développement supplémentaire d’API pour un objet custom ; permissions et audit s’appliquent identiquement aux deux régimes. »
• Justification : séparation de protocoles validée par DEC-0016 ; référence de génération automatique : un CRM open-core récent à architecture métadonnées-driven étudié lors de l’analyse expose une API générée par workspace depuis les métadonnées, tout objet custom étant immédiatement exposé. Inspiré du concept, jamais du code (licences AGPL/Enterprise).
• Critères d’acceptation :
  • CA-01 — Les lectures de tout objet métier sont disponibles par GraphQL, avec pagination et filtres.
  • CA-02 — Les créations, modifications et suppressions sont disponibles par REST.
  • CA-03 — Un objet ou champ custom créé (EXG-15-001) est exposé automatiquement par les protocoles applicables.
  • CA-04 — Authentification par clé/token, RBAC (EXG-13-002) et audit (EXG-13-006) identiques pour les objets natifs et personnalisés.
• Dépendances : EXG-13-002, EXG-15-001 (métadonnées-driven).

EXG-14-004 — Webhooks et connecteurs (banque, e-commerce, messagerie)

• Priorité : Should
• Livraison : Lot 3, selon DEC-0217. Le DWT est séparé dans EXG-14-007 à EXG-14-011, Must au Lot 0 selon DEC-0219, sans avancer les webhooks ni les autres connecteurs.
• Domaine : DOM-14
• Énoncé : « Elena doit émettre des webhooks signés sur événements métier et fournir des connecteurs banque et import/export. »
• Justification : convergence (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-14). Webhooks signés + connecteur d’automatisation tiers observés chez le CRM open-core métadonnées-driven étudié lors de l’analyse ; Dolibarr webhooks + import/export + paiement en ligne (pirates:analyses/erp/dolibarr/fiche.md §8).
• Critères d’acceptation :
  • CA-01 — Webhooks configurables par objet/événement, signés.
  • CA-02 — Import/export paramétrable des objets métier hors du parcours DWT désormais porté par EXG-14-007 à EXG-14-011. Identifiant conservé pour ce périmètre résiduel ; le téléchargement des rejets DWT relève d’EXG-14-011, pas d’un export générique anticipé au Lot 0.
• Conditionne : EXG-15-003 (action webhook des automatisations).
• Dépendances : EXG-14-003.

EXG-14-005 — Mapping EDI paramétrable par client

• Priorité : Should
• Livraison : Lot 3, selon DEC-0217, priorité et critères conservés.
• Domaine : DOM-14
• Énoncé : « Elena doit fournir un mapping EDI paramétrable par client (équivalent des dossiers techniques/critères) pour absorber la variabilité des sous-versions GALIA/ODETTE et des filières. »
• Justification : pratique de référence observée chez un ERP propriétaire du marché des PME industrielles : mapping paramétrable par client (dossier technique par client, critères de regroupement/identification) pour absorber la variabilité des sous-versions GALIA/ODETTE (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-14). La configuration EDI est gérée hors de la fiche Tiers, conformément à DEC-0027.
• Critères d’acceptation :
  • CA-01 — Chaque article porte zéro à plusieurs correspondances EDI (code interne ↔ code client/EAN) dans une structure dédiée à la configuration EDI, sans champ external_id sur Article.
  • CA-02 — Critères de regroupement/identification configurables par client.
  • CA-03 — Support de plusieurs sous-versions d’un même message.
• Périmètre de la fiche Tiers : les références article, versions, formats, mappings, critères, identifiants par partenaire et historiques EDI sont gérés dans une configuration EDI dédiée et ne sont pas des champs de la fiche partner (DEC-0027).
• Dépendances : EXG-14-001, EXG-01-002 (références externes article), EXG-15-001, DEC-0037.

EXG-14-006 — Automatisation des échanges EDI

• Priorité : Could
• Livraison : Lot 3, selon DEC-0217, priorité et critères conservés.
• Domaine : DOM-14
• Énoncé : « Elena devrait automatiser l’intégration des commandes/appels de livraison et la génération des avis d’expédition/factures selon un ordonnanceur. »
• Justification : pratique de référence observée chez un ERP propriétaire du marché des PME industrielles : un ordonnanceur d’alertes automatise l’intégration des flux entrants et la génération des messages sortants (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-14).
• Critères d’acceptation :
  • CA-01 — Traitement programmé des dépôts de fichiers EDI entrants.
  • CA-02 — Génération automatique des messages sortants sur événement.
• Dépendances : EXG-14-001, EXG-15-003.

DWT — capacités individualisées du Lot 0

DEC-0219 sépare le DWT de l’import/export générique et le rend Must au Lot 0 sur confirmation explicite de Yannic. Les règles et critères détaillés de l’inventaire DWT complètent les critères ci-dessous ; ses constats applicatifs datés ne valent pas recette actuelle. Les objets importables sont ceux disponibles dans le lot : ce découpage n’avance aucun domaine métier futur et ne crée aucune donnée external_id (DEC-0063). Les droits, l’audit, l’accessibilité et les messages FR/EN acquis restent applicables.

EXG-14-007 — DWT : préparation et lecture du fichier

• Priorité : Must
• Livraison : Lot 0 (DEC-0219).
• Domaine : DOM-14
• Énoncé : « Elena doit permettre de préparer un import CSV ou Excel sur une ressource autorisée et de vérifier la source effectivement lue avant de poursuivre. »
• Justification : parité DWT, DEC-0150 à DEC-0153 et DEC-0178, règles acquises sans extension aux autres connecteurs ; la limite de taille du fichier déposé est prescrite par DEC-0313.
• Critères d’acceptation :
  • CA-01 — La préparation libre permet de choisir la ressource, le fichier, la feuille Excel et les réglages de lecture applicables (séparateur, encodage, en-têtes et début des données). L’aperçu présente les données lues, signale sa troncature et permet de consulter les colonnes horizontalement ; un catalogue vide est distingué d’un refus d’accès.
  • CA-02 — Changer le fichier, la feuille ou les réglages de lecture bloque immédiatement la poursuite jusqu’à la relecture réussie de la sélection courante. Échec, réponse tardive, retour d’étape ou restauration ne valident pas l’ancien aperçu à la place de la nouvelle source (DEC-0150/0151/0153).
  • CA-03 — Toutes les lignes définies par les réglages entrent dans le traitement, sans choix de limitation volontaire. Aperçu tronqué, taille de lot et protection technique ne deviennent pas une troncature silencieuse de l’import ; rejets et arrêt à la première erreur restent applicables (DEC-0178).
  • CA-04 — La taille maximale d’un fichier déposé est unique, paramétrée par instance et annoncée avant le dépôt ; un fichier qui la dépasse est refusé par un message explicite, distinct d’une panne technique, sans import partiel ni troncature. Un fichier dans la limite n’est jamais refusé par une limite d’infrastructure inférieure (DEC-0313).
• Requiert : EXG-13-002 (droits objet/action), EXG-15-001 (ressources et champs).
• Conditionne : EXG-14-008 (correspondances).
• Co-requis : aucun.

EXG-14-008 — DWT : correspondances et résolution explicite des anomalies

• Priorité : Must
• Livraison : Lot 0 (DEC-0219).
• Domaine : DOM-14
• Énoncé : « Elena doit permettre de proposer, ajuster et conserver les correspondances entre colonnes et champs, sans remplacement silencieux des choix ni des références devenues indisponibles. »
• Justification : parité DWT A1/A2 et section B ; DEC-0154 à DEC-0157, DEC-0159 et DEC-0179.
• Critères d’acceptation :
  • CA-01 — La matrice horizontale montre cinq valeurs d’aperçu par colonne, les champs et types, les obligations, les scores de confiance disponibles et les doublons de cible. L’utilisateur associe ou ignore explicitement les colonnes et peut demander le recalcul des propositions.
  • CA-02 — À source inchangée, retours et restauration conservent les associations manuelles et exclusions ; les remplacer exige un recalcul explicitement confirmé. Un échec conserve les choix mais exige de relancer le recalcul ou de choisir explicitement de continuer avec les choix précédents valides (DEC-0154/0159).
  • CA-03 — Une clé enregistrée indisponible bloque sans repli par défaut. Un champ cible disparu ou une colonne source attendue absente reste signalé jusqu’à résolution explicite, sans effacement par une proposition automatique ni contournement des champs obligatoires. Dans « Utiliser », seule l’adaptation du mapping est permise ; corriger la clé nécessite édition ou duplication puis nouvelle utilisation (DEC-0155/0156/0157/0179).
• Requiert : EXG-14-007 (source courante), EXG-13-002 (droits).
• Conditionne : EXG-14-010 (validation/exécution).
• Co-requis : aucun.

EXG-14-009 — DWT : configurations réutilisables et brouillons dédiés

• Priorité : Must
• Livraison : Lot 0 (DEC-0219).
• Domaine : DOM-14
• Énoncé : « Elena doit distinguer import ponctuel, utilisation, édition et duplication d’une configuration, sans sauvegarde ni remplacement implicites. »
• Justification : parité A5, DEC-0149/0152/0179/0193.
• Critères d’acceptation :
  • CA-01 — En préparation libre, sauvegarder une configuration réutilisable est facultatif ; son nom n’est requis que pour cette sauvegarde. L’import ponctuel n’ajoute pas une configuration à la liste réutilisable.
  • CA-02 — « Utiliser » depuis une ligne ouvre un nouvel onglet dédié sans autre brouillon ni sélecteur de configuration ; la préparation reste bloquée jusqu’au chargement réussi. Seuls le nouveau fichier, son mapping et le mode à blanc/réel sont adaptables. Les autres réglages sont verrouillés également côté serveur ; aucune sauvegarde de configuration n’est proposée ou déclenchée (DEC-0152/0179).
  • CA-03 — Éditer ou dupliquer ouvre un brouillon dédié sans import ni sauvegarde automatique. La ressource reste fixe ; aucun fichier initial n’est imposé. Un fichier de travail est nécessaire pour reconstruire le mapping depuis des colonnes ou vérifier une lecture, sans import automatique. Enregistrer valide les réglages et sauvegarde atomiquement ; l’échec conserve le brouillon (DEC-0193).
  • CA-04 — La duplication conserve réglages et mapping mais ni fichier, ni historique, ni résultats ; seul l’enregistrement avec un nom crée la nouvelle configuration. Quitter un brouillon modifié demande confirmation, sans altérer l’original, les autres onglets ni les traitements lancés.
  • CA-05 — Une édition ultérieure n’affecte ni un import lancé ni les réglages déjà chargés dans « Utiliser » ; une nouvelle utilisation reçoit les nouveaux réglages. Les droits sont vérifiés côté serveur ; dupliquer exige accès à l’original et droit de créer, pas nécessairement droit de modifier l’original. Aucune gestion supplémentaire des éditions concurrentes n’est déduite de ce critère (R7 de DEC-0193 différé).
• Requiert : EXG-13-002 (droits), EXG-14-007 (lecture), EXG-14-008 (mapping).
• Conditionne : aucune.
• Co-requis : aucun.

EXG-14-010 — DWT : récapitulatif, validation à blanc et import réel

• Priorité : Must
• Livraison : Lot 0 (DEC-0219).
• Domaine : DOM-14
• Énoncé : « Elena doit permettre de vérifier la préparation, simuler sans écriture métier et lancer explicitement un import réel sous les contrôles métier courants. »
• Justification : parité section B ; DEC-0160 à DEC-0162, DEC-0173 à DEC-0177.
• Critères d’acceptation :
  • CA-01 — Le récapitulatif affiche ressource, fichier, clé, réglages, trois premières associations, leur nombre et les colonnes ignorées nommément. Il annonce la politique effective de poursuite ou d’arrêt ; en réel seulement, il indique que les lignes déjà importées restent enregistrées même après arrêt sur erreur, sans annoncer le rejet de tout un lot (DEC-0173/0174).
  • CA-02 — Mode à blanc et système source sont conservés au retour et à la restauration selon DEC-0160/0161. Le système source reste verrouillé dans « Utiliser » ; son absence lorsqu’il est obligatoire bloque. La simulation n’écrit aucune donnée métier ; le passage au réel depuis le récapitulatif nécessite de désactiver explicitement le mode à blanc.
  • CA-03 — Annuler au récapitulatif demande confirmation avant d’effacer uniquement le brouillon de cet onglet ; refuser ou fermer conserve la préparation. Aucun import ni aucune configuration réutilisable n’est supprimé ou lancé par cet abandon (DEC-0162).
  • CA-04 — Au bilan d’une validation terminée, « Importer les lignes valides » lance directement un import distinct, sans nouvel upload ni retour imposé dans l’assistant. Seules les lignes validées sont candidates, les rejets et non-traitées sont exclus ; aucun lancement sans ligne valide. Le clic constitue le consentement explicite (DEC-0175).
  • CA-05 — L’import réel recontrôle droits et règles courantes, sans étape utilisateur supplémentaire. Toute ligne devenue invalide est rejetée ; poursuite/arrêt et conservation des lignes déjà enregistrées suivent la politique acquise. Suivi et résultats réels sont distincts du bilan à blanc (DEC-0176).
  • CA-06 — Un même bilan ne permet qu’un seul import réel par cette action ; après lancement, rechargement ou réouverture, l’action retrouve son suivi dans tous ses états plutôt que de relancer. Lien validation/import conservé dans le suivi et l’audit (DEC-0177).
• Requiert : EXG-14-008 (mapping valide), EXG-13-002 (droits), EXG-13-006 (audit).
• Conditionne : EXG-14-011 (suivi et rapports).
• Co-requis : aucun.

EXG-14-011 — DWT : suivi, bilan et rapport des rejets réimportable

• Priorité : Must
• Livraison : Lot 0 (DEC-0219).
• Domaine : DOM-14
• Énoncé : « Elena doit restituer les résultats effectifs du traitement et permettre de télécharger après sa fin tous les rejets dans un fichier corrigeable et réimportable. »
• Justification : parité A7/A8/A9 ; DEC-0163 à DEC-0172 et règles courantes de ventilation des créations/modifications.
• Critères d’acceptation :
  • CA-01 — En réel, créations, mises à jour, rejets et lignes non traitées sont distincts, y compris à la réouverture. À blanc, le bilan affiche « Lignes valides », « Lignes en erreur » et « Aucune donnée enregistrée », sans présenter de créations effectives. Les non-traitées ne sont ni des rejets ni des exclusions volontaires (DEC-0171/0172).
  • CA-02 — Statuts et erreurs par champ sont lisibles et localisés FR/EN ; une interruption de suivi est visible, sa reprise retrouve le même import sans le relancer. L’onglet Erreurs ouvert s’actualise pendant le traitement puis une dernière fois à sa fin ; une erreur de lecture n’est pas une absence de rejets (DEC-0163).
  • CA-03 — Le téléchargement est indisponible avant la fin confirmée, en UI comme côté serveur. Après fin, il contient tous les rejets, même au-delà du plafond ou des pages consultées ; un échec de traitement n’interdit pas à lui seul le rapport. Aucun fichier incomplet n’est présenté comme complet (DEC-0164/0165).
  • CA-04 — Chaque ligne rejetée figure une seule fois avec les colonnes originales métier dans leur ordre, y compris non associées, et une seule colonne __dwt_errors regroupant ses diagnostics. Les lignes source distinctes restent distinctes ; les non-traitées ne sont pas exportées. Après correction, le fichier est réimportable sans restructuration ni suppression de la colonne de diagnostic (DEC-0166/0172).
  • CA-05 — __dwt_errors est strictement réservé dans tout fichier entrant : visible comme colonne réservée ignorée, jamais associable, anciens diagnostics sans effet. Le nouvel export la remplace par les nouveaux diagnostics sans accumulation (DEC-0167/0168).
  • CA-06 — Le rapport est toujours CSV UTF-8 ; il reprend le séparateur de lecture d’une source CSV et utilise le point-virgule pour Excel. Les valeurs survivent à la relecture, notamment accents, guillemets, séparateurs, retours à la ligne et cellules vides ; aucun classeur n’est reconstitué (DEC-0169/0170).
• Requiert : EXG-14-010 (traitement), EXG-13-002 (droits).
• Conditionne : aucune.
• Co-requis : aucun.