GetItemMaster — Get Item Master

BOD OAGIS combinant le verbe Get et le noun ItemMaster. Équivalent canonique direct des messages EDI EDIFACT PRODAT et X12 832 dans l'écosystème Données maître d'OAGIS 10.x.

Objet du BOD

Le BOD GetItemMaster interroge un système maître des articles (ERP, PIM, MDM) pour récupérer la fiche complète d'un ou plusieurs articles. Plus riche qu'un Catalog, l'ItemMaster inclut tous les attributs internes (logistiques, financiers, qualité).

Structure (ApplicationArea + DataArea)

Comme tout BOD OAGIS, GetItemMaster empile une ApplicationArea d'enveloppe technique (Sender, BODID, CreationDateTime) et une DataArea métier qui contient le verbe et le noun.

• Get verbe avec Expression sur ItemID, classification, statut.
• ItemMaster noun partiel pour préciser scope de retour.

Exemple XML

Payload OAGIS 10.x minimal, à titre didactique. Les éléments structurants (en-tête + au moins une ligne) sont obligatoires dans toute implémentation conforme.

<?xml version="1.0" encoding="UTF-8"?>
<GetItemMaster
    xmlns="http://www.openapplications.org/oagis/10"
    releaseID="10.11" versionID="10.11">

  <ApplicationArea>
    <Sender>
      <LogicalID>ERP-CENTRAL-EU</LogicalID>
      <ComponentID>Master dataModule</ComponentID>
      <ConfirmationCode>OnError</ConfirmationCode>
    </Sender>
    <CreationDateTime>2026-05-15T10:15:00Z</CreationDateTime>
    <BODID>5a8f7d2e-2b15-4c1a-9e6f-getitemmaster-2026-0014</BODID>
  </ApplicationArea>

  <DataArea>
    <Get>
      <Expression expressionLanguage="XPath">//ItemMaster[Status='New']</Expression>
    </Get>
    <ItemMaster>
      <ItemMasterHeader>
        <ItemIDs><ID>RBC-2200</ID></ItemIDs>
        <Description>Roulement à billes 22 mm</Description>
        <Status>Active</Status>
      </ItemMasterHeader>
      <Classification>
        <CodeListID>UNSPSC</CodeListID>
        <Code>31171511</Code>
      </Classification>
    </ItemMaster>
  </DataArea>
</GetItemMaster>

Cas d'usage

Un MES interroge l'ERP au moment du lancement d'un OF : il a besoin de la nomenclature et des routings de l'article fabriqué. GetItemMaster est envoyé avec ItemID ciblé ; ShowItemMaster renvoie l'article complet, y compris la nomenclature.

Équivalences EDI

En passerelle EDI, ce BOD se mappe typiquement vers :

• EDIFACT PRODAT — équivalent EDIFACT.
• X12 832 — équivalent X12.

Pour aller plus loin

• OAGi — OAGIS 10.x — page officielle de la spec et téléchargement libre.
• OAGi (OAGIS) — hub sur ediverse — architecture BOD, verbes, modèle canonique.
• EDIFACT sur ediverse — équivalent fonctionnel EDIFACT PRODAT.
• X12 sur ediverse — équivalent fonctionnel X12 832.