GetPurchaseOrder — Get Purchase Order

BOD OAGIS combinant le verbe Get et le noun PurchaseOrder. Équivalent canonique direct des messages EDI EDIFACT ORDERS et X12 850 dans l'écosystème Achats d'OAGIS 10.x.

Objet du BOD

Le BOD GetPurchaseOrder demande la lecture courante d'une ou plusieurs commandes existantes. Le système cible renvoie un ShowPurchaseOrder avec les données demandées, identifiées par DocumentID, plage de date ou statut.

Structure (ApplicationArea + DataArea)

Comme tout BOD OAGIS, GetPurchaseOrder 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 (filtre XPath ou critère).
• PurchaseOrder noun typiquement vide ou partiellement rempli pour préciser la maille du retour.
• ResponseCriteria — précise la profondeur du retour (header only, header + lines).

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"?>
<GetPurchaseOrder
    xmlns="http://www.openapplications.org/oagis/10"
    releaseID="10.11" versionID="10.11">

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

  <DataArea>
    <Get>
      <Expression expressionLanguage="XPath">//PurchaseOrder[Status='New']</Expression>
    </Get>
    <PurchaseOrder>
      <PurchaseOrderHeader>
        <DocumentID><ID>PO-2026-000871</ID></DocumentID>
        <DocumentDateTime>2026-05-15T10:00:00Z</DocumentDateTime>
        <BuyerParty>
          <PartyIDs><ID>4012345678901</ID></PartyIDs>
          <Name>Acme Industries</Name>
        </BuyerParty>
        <SupplierParty>
          <PartyIDs><ID>5790000123456</ID></PartyIDs>
          <Name>Northern Components</Name>
        </SupplierParty>
        <RequestedDeliveryDateTime>2026-06-04T08:00:00Z</RequestedDeliveryDateTime>
      </PurchaseOrderHeader>
      <PurchaseOrderLine>
        <LineNumber>1</LineNumber>
        <Item>
          <ItemIDs><ID>RBC-2200</ID></ItemIDs>
          <Description>Roulement à billes 22 mm</Description>
        </Item>
        <Quantity unitCode="EA">240</Quantity>
        <UnitPrice><Amount currencyID="EUR">8.40</Amount></UnitPrice>
      </PurchaseOrderLine>
    </PurchaseOrder>
  </DataArea>
</GetPurchaseOrder>

Cas d'usage

Un portail fournisseur interroge l'ERP donneur d'ordre toutes les heures pour récupérer toute nouvelle PO non encore acquittée. Un GetPurchaseOrder est émis avec un filtre Status='New', l'ERP répond avec un ShowPurchaseOrder listant les nouvelles commandes.

Équivalences EDI

En passerelle EDI, ce BOD se mappe typiquement vers :

• EDIFACT ORDERS — équivalent EDIFACT.
• X12 850 — é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 ORDERS.
• X12 sur ediverse — équivalent fonctionnel X12 850.