AcknowledgePayment

OAGIS BOD combining the Acknowledge verb with the Payment noun. Direct canonical equivalent of EDI EDIFACT PAYMUL and X12 820 messages in OAGIS 10.x's Finance domain.

BOD purpose

The AcknowledgePayment BOD confirms the recording of a ProcessPayment on the recipient side (e.g. accounting ERP). Application status, per-line exceptions, assigned internal references.

Structure (ApplicationArea + DataArea)

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

• PaymentHeader with application Status.
• PaymentLine with accepted or rejected status.

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

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

  <DataArea>
    <Acknowledge/>
    <Payment>
      <PaymentHeader>
        <DocumentID><ID>PAY-2026-441020</ID></DocumentID>
        <DocumentDateTime>2026-05-15T16:00:00Z</DocumentDateTime>
        <TotalAmount currencyID="EUR">2400000.00</TotalAmount>
      </PaymentHeader>
      <PaymentLine>
        <SettledInvoice><ID>INV-2026-552190</ID></SettledInvoice>
        <SettledAmount currencyID="EUR">1999.20</SettledAmount>
      </PaymentLine>
    </Payment>
  </DataArea>
</AcknowledgePayment>

Use case

The accounting ERP receives a ProcessPayment of 87 invoices, validates 85, rejects 2 (invoices already double-settled). AcknowledgePayment is returned to the treasury module with the 2 exception lines.

EDI equivalences

On an EDI gateway, this BOD typically maps to:

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