GENRAL — General Purpose Message (D.96A)

GENRAL est le message générique d'EDIFACT, destiné à transmettre des informations textuelles entre partenaires EDI quand aucun message standard plus spécifique n'existe.

Objet du message

Selon la définition fonctionnelle UN/CEFACT, GENRAL est « a message to enable the transmission of textual information ». Le message a été conçu principalement pour :

« faciliter les premiers tests de transmission entre nouveaux partenaires EDI » ;
« diffuser à des partenaires EDI des informations sur des problèmes connus » ;
« transmettre du texte (structuré ou codé de préférence) pour compléter ou clarifier des messages EDI préalablement transmis » (par ex. signaler que des données précédentes étaient de test, ou contenaient des erreurs volontaires pour qualifier des routines) ;
« transmettre de petites quantités de texte structuré quand aucun message existant ne convient ».

Quand ne PAS utiliser GENRAL

La spécification est explicite : GENRAL ne doit pas :

« servir de substitut à un UNSM existant, en cours de développement, en période de trial ou approuvé » ;
« être utilisé pour éviter de développer un message applicatif plus spécifique » ;
« remplacer les systèmes de messagerie électronique existants ».

Concrètement : si vous transmettez régulièrement une notification de maintenance par GENRAL, c'est OK. Si vous transmettez des prix par GENRAL alors que PRICAT existe, c'est un mauvais usage. Si vous remplacez par GENRAL un APERAK applicatif, c'est également un mauvais usage.

Structure segmentaire

GENRAL D.96A est l'un des messages les plus simples du directory : un header très léger et huit groupes de segments. La table complète est dans genral_s.htm.

Au niveau du header, les segments mandataires sont UNH M et BGM M . Le segment DTM C est conditionnel au header (×1).

Groupes de segments

Huit groupes, dont un seul est mandataire :

SG1 (C, ×10) — RFF + DTM : références (au message d'origine si GENRAL est un complément).
SG2 (C, ×2) — NAD + LOC + SG3 RFF/DTM + SG4 CTA/COM : parties prenantes émettrices (avec leurs lieux, références internes, contacts).
SG5 (M, ×100) — FTX + SG6 NAD/LOC + SG7 RFF/DTM + SG8 CTA/COM : le cœur du message. Le segment FTX M est obligatoire à l'intérieur du groupe : c'est lui qui porte le texte transmis. Les sous-groupes permettent d'associer à chaque bloc texte des parties destinataires, des références et des contacts spécifiques.

Le message se clôt par UNT M .

Obligatoire / conditionnel

Strictement mandataires dans tout GENRAL D.96A :

UNH, UNT — encadrent le message.
BGM — type et numéro du document général (qualifier libre selon convention bilatérale).
SG5 FTX — au moins une occurrence du segment FTX, à l'intérieur du groupe 5 mandataire. C'est la spécificité de GENRAL : sans FTX, il n'y a pas de message.

Tout le reste — y compris les parties NAD, le DTM et les références — est conditionnel. La concision est volontaire : GENRAL n'impose aucune sémantique métier.

Exemple réel

Notification opérationnelle envoyée par une centrale d'achat à un fournisseur, pour annoncer une fenêtre de maintenance EDI :

edifact genral-d96a-example.edi

UNB+UNOC:3+5410000000123:14+5410000000456:14+260513:0900+CTRL000301'
UNH+1+GENRAL:D:96A:UN'
BGM+999+NOTICE-2026-WK19+9'
DTM+137:20260513:102'
NAD+SE+5410000000123::9++BUYING GROUP SA'
NAD+BY+5410000000456::9++ACME SUPPLY GMBH'
CTA+IC+EDI001:Jane Doe'
COM+jane.doe@buyinggroup.example:EM'
FTX+AAI+++MAINTENANCE WINDOW PLANNED 2026-05-17 22:00 UTC TO 2026-05-18 04:00 UTC.'
FTX+AAI+++NO ORDERS WILL BE ACKNOWLEDGED DURING THIS WINDOW.'
FTX+AAI+++FALLBACK CONTACT: ops@buyinggroup.example - +33 1 23 45 67 89.'
UNT+11+1'
UNZ+1+CTRL000301'

BGM+999+NOTICE-2026-WK19+9 — qualifier 999 (autre — pas de code dédié pour les notices), numéro NOTICE-2026-WK19, statut 9 (original).
DTM+137 — date du document.
NAD+SE / NAD+BY — émetteur (Sender) et destinataire (Buyer / partenaire EDI).
CTA+IC — Information Contact (qualifier IC = Information Contact), nom du contact technique.
COM+...:EM — coordonnées de communication, EM = email.
Trois FTX+AAI — Free text qualifier AAI (General Information). Chaque FTX porte une ligne de la notice.
UNT+11+1 — 11 segments dans le message.

Erreurs fréquentes

FTX au header au lieu de SG5 — GENRAL n'autorise pas de FTX au header (contrairement à ORDERS, QUOTES, INVOIC). Le texte doit être dans le groupe 5 obligatoire. Mettre FTX entre BGM et NAD fait planter les contrôleurs syntaxiques stricts.
BGM avec code non négocié — la liste 1001 de codes BGM est très longue. À défaut d'accord bilatéral, utiliser 999 (autre / other) est l'option par défaut.
FTX dépassant 70 caractères — chaque composant texte est limité (composite C108 = 5 × 70 caractères). Pour des messages longs, multiplier les FTX, ne pas dépasser dans un composant unique.
Encodage UNOA — UNOA ne supporte que A-Z, 0-9, espace et ponctuation basique. Pour du français accentué, utiliser UNOC en UNB[0].
Usage à la place d'un UNSM existant — voir la section « Quand ne PAS utiliser GENRAL » : si un message standard couvre votre cas, l'utiliser ; GENRAL n'est pas un fourre-tout.

Messages liés

GENRAL ne s'inscrit dans aucun flux normalisé ; il complète tout flux EDIFACT au besoin :

CONTRL D.96A — acquittement syntaxique de GENRAL (et de tout EDIFACT).
APERAK D.96A — pour transmettre des erreurs applicatives (à préférer à GENRAL dans ce cas).
Si vous transmettez du prix, préférez PRICAT ; si vous transmettez du forecast, préférez DELFOR ; etc.

Équivalent JSON

Projection JSON de la notice ci-dessus :

json genral-d96a-equivalent.json

{
  "interchange": {
    "controlRef": "CTRL000301",
    "from": { "id": "5410000000123", "qualifier": "14" },
    "to": { "id": "5410000000456", "qualifier": "14" },
    "datetime": "2026-05-13T09:00:00Z",
    "syntax": { "id": "UNOC", "version": "3" }
  },
  "message": {
    "ref": "1",
    "type": "GENRAL",
    "version": { "syntax": "D", "release": "96A", "agency": "UN" }
  },
  "notice": {
    "number": "NOTICE-2026-WK19",
    "function": "999",
    "status": "9",
    "documentDate": "2026-05-13",
    "parties": {
      "sender": { "gln": "5410000000123", "name": "BUYING GROUP SA" },
      "recipient": { "gln": "5410000000456", "name": "ACME SUPPLY GMBH" }
    },
    "contact": {
      "qualifier": "IC",
      "code": "EDI001",
      "name": "Jane Doe",
      "email": "jane.doe@buyinggroup.example"
    },
    "messages": [
      "MAINTENANCE WINDOW PLANNED 2026-05-17 22:00 UTC TO 2026-05-18 04:00 UTC.",
      "NO ORDERS WILL BE ACKNOWLEDGED DURING THIS WINDOW.",
      "FALLBACK CONTACT: ops@buyinggroup.example - +33 1 23 45 67 89."
    ]
  }
}

Fondamentaux

Standards

Messages phares

Outils