GetSalesOrder — Get Sales Order

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

Objet du BOD

Le BOD GetSalesOrder interroge l'ERP pour récupérer une commande de vente existante. Réponse : ShowSalesOrder (non couvert ici en propre, voir miroir avec ShowPurchaseOrder).

Structure (ApplicationArea + DataArea)

Comme tout BOD OAGIS, GetSalesOrder 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 DocumentID, période, client, statut.
• SalesOrder 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"?>
<GetSalesOrder
    xmlns="http://www.openapplications.org/oagis/10"
    releaseID="10.11" versionID="10.11">

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

  <DataArea>
    <Get>
      <Expression expressionLanguage="XPath">//SalesOrder[Status='New']</Expression>
    </Get>
    <SalesOrder>
      <SalesOrderHeader>
        <DocumentID><ID>SO-2026-019200</ID></DocumentID>
        <DocumentDateTime>2026-05-15T11:00:00Z</DocumentDateTime>
        <CustomerParty>
          <PartyIDs><ID>CUST-009912</ID></PartyIDs>
        </CustomerParty>
      </SalesOrderHeader>
      <SalesOrderLine>
        <LineNumber>1</LineNumber>
        <Item><ItemIDs><ID>RBC-2200</ID></ItemIDs></Item>
        <Quantity unitCode="EA">12</Quantity>
        <UnitPrice><Amount currencyID="EUR">11.20</Amount></UnitPrice>
      </SalesOrderLine>
    </SalesOrder>
  </DataArea>
</GetSalesOrder>

Cas d'usage

Une équipe support client a besoin du détail d'une commande mentionnée dans un ticket. GetSalesOrder avec DocumentID est envoyé à l'ERP ; le ShowSalesOrder retourné alimente directement la fiche de réponse.

É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.