EXG-01-003 — Cycle vente devis → commande avec conversions inter-documents

Contexte du document

Cycle commercial de la prospection à la commande. Socle mature et convergent sur l’ensemble du marché étudié, ERP libres comme propriétaires (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-01) ; l’apport rare est l’UX pipeline Kanban, différenciateur identifié par l’analyse concurrentielle. Objets pivots : partner, opportunity, quotation, sales_order. Aucune reprise de code des ERP étudiés.

Restriction de livraison au Lot 0

DEC-0071 limite les traitements du Lot 0 aux articles sans gestion de stock (prestations, abonnements par exemple). Les scénarios de recette de ce lot respectent cette restriction ; les articles gérés en stock ne sont pas traités par ces parcours au Lot 0. La cible fonctionnelle générale est conservée, sans suppression des données du catalogue ni avancement implicite du stock ou de la facturation récurrente.

Exigence détaillée

• Priorité : Must
• Livraison : Lot 0 (DEC-0068). Énoncé et critères conservés, conversion et duplication du devis comprises ; les conditions métier encore ouvertes après première validation restent à arbitrer.
• Domaine : DOM-01
• Énoncé : « Elena doit enchaîner devis (quotation) → commande de vente (sales_order) avec conversion inter-documents conservant lignes, quantités et remises ; une commande ne peut concerner qu’un tiers de type client. »
• Justification : socle convergent (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §6 « cycle vente »), précisé par DEC-0033, DEC-0034 et DEC-0035. Une offre peut être saisie pour un tiers sans modifier son type ; la commande exige en revanche la qualification client. Les documents restent séparés, mais leur conversion et le contrôle des conditions commerciales sont explicitement outillés.
• Critères d’acceptation :
  • CA-01 — Un bouton « Transformer en commande » est disponible depuis une quotation et crée un sales_order distinct, sans ressaisie, uniquement si le tiers est de type client et si l’offre est validée. Au Lot 0, le parcours est brouillon → validation explicite de l’offre → transformation en commande ; la conversion depuis un brouillon est refusée, sans validation implicite. Aucun visa hiérarchique, signature électronique ou preuve obligatoire d’acceptation client supplémentaire n’est imposé par cette règle. La validation de l’offre ne valide pas la commande ni ne dispense de ses contrôles ; plusieurs conversions explicites d’une offre validée sont autorisées, même si une commande antérieure est active, annulée ou corrigée. Avant chaque conversion supplémentaire, présenter les commandes existantes et demander confirmation ; sans confirmation, aucune nouvelle commande. Conserver liens et historique sans modifier l’offre ni les commandes antérieures ; distinguer un nouvel acte commercial du rejeu d’une même demande, qui ne crée pas de doublon (DEC-0195) (DEC-0194).
  • CA-02 — Une quotation peut être saisie pour un prospect sans modifier automatiquement son type ; son acceptation ne transforme pas automatiquement le prospect en client.
  • CA-03 — La création ou la conversion en sales_order est bloquée si le tiers n’est pas de type client.
  • CA-04 — La conversion copie dans le sales_order les données nécessaires de l’offre, notamment le tiers, les lignes, les quantités, les prix et les remises applicables ; la commande conserve la référence de l’offre source. Une ligne porte ses propres valeurs, reprises de l’article au moment de la sélection et conservées par la ligne ; la référence à l’article est conservée comme provenance, non comme source permanente d’affichage, et une modification ultérieure de l’article ne modifie pas les lignes déjà saisies (DEC-0314). Le libellé repris de l’article sur une ligne est modifiable, la modification restant propre à cette ligne et à ce document, sans modifier le libellé de l’article ni aucun autre document (DEC-0315). Seules les informations descriptives reprises de l’article sont modifiables sur la ligne ; les informations qui déterminent le calcul, le stock ou la fiscalité — au premier rang desquelles le code article, l’unité de vente et la catégorie fiscale — restent celles de l’article et ne sont pas modifiables sur la ligne (DEC-0316). Une modification de l’article après la saisie d’une ligne ne modifie pas cette ligne, ni en brouillon ni après validation : aucun rattrapage automatique, la ligne ne suivant pas l’article (DEC-0317). Une ligne peut exister sans référencer d’article : elle porte alors elle-même son code, son libellé et ses valeurs, aucune fiche article n’est exigée, et elle reste hors tarif article et hors stock (DEC-0318). L’unité de vente et la catégorie fiscale d’une ligne sont celles reprises à la sélection, en brouillon comme après validation, et le chiffrage les lit sur la ligne ; re-sélectionner un article, y compris le même, remplace toutes les valeurs reprises sur cette ligne, libellé modifié compris (DEC-0327).
  • CA-05 — Les données transactionnelles de l’offre et de la commande sont indépendantes après conversion : une modification de l’un ne modifie pas l’autre ; l’offre conserve les références des commandes créées, y compris lors de conversions répétées explicites (DEC-0195).
  • CA-06 — Les numéros, statuts, dates de validation, audits et droits d’accès sont propres à chaque type de document.
  • CA-07 — Remises ligne et pied de document conservées à la conversion avec leur valeur et leur provenance au moment de la conversion.
  • CA-08 — Une commande issue d’une offre peut être entièrement modifiée tant qu’elle n’a pas été validée une première fois.
  • CA-09 — Avant cette première validation, Elena compare les conditions de la commande aux conditions actuellement applicables au client, notamment les tarifs, remises, hausses, incoterm, devise, taxes, quantités et unités concernés.
  • CA-10 — Toute divergence identifie les lignes en anomalie et bloque la validation jusqu’à la correction ou au traitement explicite et autorisé de chaque anomalie. Un prix explicitement forcé conformément aux paramètres de DEC-0102, y compris sans tarif applicable, constitue un écart accepté sans approbation supplémentaire de cet écart de prix. Les droits habituels de validation et le blocage des autres anomalies restent applicables ; le traitement est audité. Un prix seulement conservé par l’actualisation partielle ne devient pas implicitement un prix forcé (DEC-0115). Pour les autres divergences, distinguer les écarts commerciaux négociables, dont le maintien doit être explicite et audité, des incohérences de calcul, unité, devise ou fiscalité à corriger avant validation. Le forçage de prix ne les autorise pas implicitement ; le classement et la permission dédiée avec motif sont fixés dans les règles complémentaires DEC-0129, sans modification des paramètres de forçage (DEC-0126). Le forçage antérieur est recontrôlé selon la politique société courante à la première validation : interdiction du forçage ou motif devenu obligatoire bloquent jusqu’à correction explicite appropriée, sans recalcul silencieux ; le blocage explique le changement de politique (règle temporelle, DEC-0185). Un prix est forcé lorsque l’utilisateur le déclare explicitement sur la ligne ; un prix différent du tarif applicable sans cette déclaration est un écart de conditions commerciales, non un prix forcé. Un écart entre l’unité de vente ou la catégorie fiscale de la ligne et celles de l’article courant est signalé comme une incohérence d’unité ou de fiscalité (DEC-0327).
  • CA-11 — Un bouton permet de dupliquer une quotation et crée une nouvelle offre indépendante de l’offre source.
  • CA-12 — Une quotation en brouillon propose un bouton « Actualiser tout avec les conditions du client » ; toute l’offre est évaluée aux tarifs applicables au jour de l’actualisation, même si le devis porte une date antérieure. La date du devis reste inchangée (DEC-0119). L’action exige une confirmation explicite. En présence de lignes sans tarif applicable ou en conflit, un message les identifie et permet de confirmer l’actualisation dans cet état : les lignes déterminées sont actualisées, les autres conservent leurs anciens prix et leurs anomalies visibles. Sans cette confirmation, aucun prix ne change. La confirmation et les changements sont historisés. Cela ne valide pas commercialement le document, ne lève pas les anomalies restantes et ne modifie pas une commande liée (DEC-0101).
  • CA-13 — Après la première validation, hors exception d’adresse de CA-14, les corrections de prix, remise et quantité portent sur la partie restant à exécuter, avec droit de modification après validation, motif, audit auteur/date/avant-après et nouveau contrôle des conditions modifiées. Aucune réécriture automatique des expéditions ou factures déjà créées ; la correction de l’exécuté suit le parcours documentaire distinct des règles complémentaires DEC-0129. L’annulation est totale avant exécution ; après exécution partielle, elle porte uniquement sur le reliquat et conserve l’exécuté. Elle exige droit approprié et motif, sans suppression, réutilisation du numéro, modification de l’offre source ni annulation implicite des documents aval. Les documents préparés sur le reliquat doivent être traités explicitement avant son changement, selon les règles complémentaires DEC-0129 (DEC-0126). Une facture non annulée liée à la commande, même en brouillon, vaut exécution de la partie facturée : l’annulation totale est refusée tant qu’une telle facture existe, et aucune facture n’est annulée par l’annulation d’une commande (DEC-0328).
  • CA-14 — Au Lot 0, une adresse peut être corrigée explicitement sur une commande encore en cours, même déjà validée, sous les droits requis et avec audit de l’auteur, de la date, du motif et des valeurs avant/après. Aucune expédition ni facture déjà créée n’est modifiée par cette action, même en brouillon ; le contrôle d’écart propre aux factures brouillon reste applicable (DEC-0077). Les limites par usage sont définies par CA-15 à CA-17.
  • CA-15 — La correction de l’adresse de livraison est autorisée uniquement tant qu’une partie de la commande reste à livrer, sous les conditions de CA-14 et CA-17.
  • CA-16 — La correction de l’adresse de facturation est autorisée uniquement tant qu’une partie de la commande reste à facturer, sous les conditions de CA-14 et CA-17. Une commande entièrement livrée mais restant à facturer n’est éligible que pour l’adresse de facturation.
  • CA-17 — Une commande clôturée ou annulée est exclue du parcours de correction d’adresse, même si un reliquat existe (DEC-0078). La fin de la part livraison constatée après abandon du reste à livrer, distinguant « soldée » de « soldée sans livraison », n’est pas cette clôture : tant qu’une partie reste à facturer, l’adresse de facturation reste éligible selon CA-16 (DEC-0252).
• Requiert : EXG-01-002.
• Dépendances : EXG-01-001, DEC-0033, DEC-0034, DEC-0035.