GetItemMaster

OAGIS BOD combining the Get verb with the ItemMaster noun. Direct canonical equivalent of EDI EDIFACT PRODAT and X12 832 messages in OAGIS 10.x's Master data domain.

BOD purpose

The GetItemMaster BOD queries an item master system (ERP, PIM, MDM) to retrieve the full record of one or more items. Richer than a Catalog, the ItemMaster includes all internal attributes (logistics, financial, quality).

Structure (ApplicationArea + DataArea)

Like every OAGIS BOD, GetItemMaster stacks an ApplicationArea technical envelope (Sender, BODID, CreationDateTime) and a business DataArea that contains the verb and the noun.

• Get verb with Expression on ItemID, classification, status.
• ItemMaster noun partial to specify return scope.

XML example

Minimal OAGIS 10.x payload for didactic purposes. Structural elements (header + at least one line) are required in any conformant implementation.

<?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>

Use case

An MES queries the ERP at production order launch: it needs the bill of materials and routings of the manufactured item. GetItemMaster is sent with a targeted ItemID; ShowItemMaster returns the complete item, including the BOM.

EDI equivalences

On an EDI gateway, this BOD typically maps to:

• EDIFACT PRODAT — EDIFACT equivalent.
• X12 832 — X12 equivalent.

Further reading

• OAGi — OAGIS 10.x — official spec page and free download.
• OAGi (OAGIS) — hub on ediverse — BOD architecture, verbs, canonical model.
• EDIFACT on ediverse — functional equivalent EDIFACT PRODAT.
• X12 on ediverse — functional equivalent X12 832.