GetCustomerParty

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

BOD purpose

The GetCustomerParty BOD queries a master system to retrieve the complete record of a customer. Response: ShowCustomerParty.

Structure (ApplicationArea + DataArea)

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

• Get verb with Expression on PartyID.
• CustomerParty 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"?>
<GetCustomerParty
    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-getcustomerparty-2026-0014</BODID>
  </ApplicationArea>

  <DataArea>
    <Get>
      <Expression expressionLanguage="XPath">//CustomerParty[Status='New']</Expression>
    </Get>
    <CustomerParty>
      <CustomerPartyHeader>
        <PartyIDs><ID>CUST-009912</ID></PartyIDs>
        <Name>ACME Manufacturing</Name>
      </CustomerPartyHeader>
      <Location>
        <Address>
          <Street>12 rue de la Paix</Street>
          <City>Paris</City>
          <PostalCode>75002</PostalCode>
          <Country>FR</Country>
        </Address>
      </Location>
    </CustomerParty>
  </DataArea>
</GetCustomerParty>

Use case

An e-commerce portal asks the ERP for the complete record of a customer before proposing an optimised check-out: GetCustomerParty with PartyID. The ShowCustomerParty response pre-fills shipping address and terms.

EDI equivalences

On an EDI gateway, this BOD typically maps to:

• EDIFACT PARTIN — EDIFACT equivalent.
• X12 838 — 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 PARTIN.
• X12 on ediverse — functional equivalent X12 838.