Skip to content
Independent EDI conversion and validation software. Retailer names identify interoperability targets; no retailer endorsement is implied.
Shipment Sentry
Start routing

Operational EDI reference

EDI 997 Example: Read AK1, AK2, AK5 and AK9

Understand which outbound group a 997 acknowledges, whether it was accepted, and what to do when transaction or group codes disagree.

Use the free validator See batch and API plans

Direct answer

Direct answer

A 997 Functional Acknowledgement reports X12 syntax handling. AK1 identifies the acknowledged functional group and group control number. AK2 can identify a transaction set. AK5 gives a transaction response and AK9 gives the group response. An A normally indicates acceptance; E or W means accepted with errors; P means partial acceptance; R, M or X require rejection handling.

Why a parser is not enough

The useful unit is not a file that parses; it is a business document with a known decision, an owner, a source trail and a matched downstream response. This page connects the technical structure to that operating workflow.

What the control should check

  1. 01Match AK102 to the outbound GS06 control.
  2. 02Use AK202 to match a specific ST02 where present.
  3. 03Treat AK9 as the group result, not proof that business content was correct.
  4. 04Open an exception for rejected or accepted-with-errors results.
  5. 05Alert when no acknowledgement arrives inside the expected window.

Working example

AK1*SH*42~AK2*856*0001~AK5*A~AK9*A*1*1*1~

The excerpt is intentionally compact. Use the working validator or authenticated gateway with the complete interchange to obtain a decision.

Failure modes worth catching

  • A transport receipt is mistaken for business acceptance.
  • Control identifiers are regenerated between validation and submission.
  • A warning has no owner and becomes a recurring manual investigation.
  • The document is checked alone even though the truth exists in a purchase order, label or acknowledgement.

Put it into the dispatch workflow

  1. 1Validate the source document before transport.
  2. 2Block deterministic failures and assign every review item.
  3. 3Release with a recorded owner and timestamp.
  4. 4Match functional and application acknowledgements.
  5. 5Reconcile confirmed outcomes back into fixtures and rules.
Use batch validation and acknowledgement tracking

Questions

Implementation answers

Does Shipment Sentry replace my EDI provider?

No. It sits before the existing transport as a validation and evidence sidecar.

What does cleared mean?

The document has no blocking finding in the current rule pack. It is not a guarantee of trading-partner or receiving acceptance.

How are repeat requests kept safe?

The API requires an idempotency key, stores only a token hash, scopes every record to one workspace and rejects reuse with different content.

Sources and limits

Reviewed 2026-07-18. Public references cannot establish every partner-specific rule. Current implementation guides and agreements remain controlling.

Keep investigating

Related EDI controls

View the library
Add an EDI API gate without rebuilding partner operations Connect Business Central records to controlled EDI delivery Send EDI over AS2 without mistaking HTTP success for delivery proof Connect validated invoices to a certified Peppol access point Turn EDI partner testing into a versioned release gate Give EDI users reports that lead back to transaction evidence