Accounts Payable Document Flow

AP invoices are vendor bills with approval and payment lifecycle enforced on the ApInvoice aggregate. Status names match UI chips and filters.

Hub: Target Document Flow. Overview: Accounts Payable.

#Statuses

Match status (separate): NotMatched, Matched, MatchException, MatchOverridden. Unresolved match exception can block approval.

#Lifecycle

AP Invoice — approval path

flowchart TB
  Start((Create)) --> Draft[Draft]
  Draft -->|Submit| PendingApproval[PendingApproval]
  PendingApproval -->|Approve| Approved[Approved]
  PendingApproval -->|Reject| Rejected[Rejected]

  class Start egkStart
  class Draft egkDraft
  class PendingApproval egkActive
  class Approved egkSuccess
  class Rejected egkError

AP Invoice — payment and cancel

flowchart TB
  Approved[Approved] -->|Apply payment| PartiallyPaid[PartiallyPaid]
  PartiallyPaid -->|Full payment| Paid[Paid]
  Approved -->|Full payment| Paid

  Draft[Draft] -->|Cancel| Cancelled[Cancelled]
  PendingApproval[PendingApproval] -->|Cancel| Cancelled
  Rejected[Rejected] -->|Cancel| Cancelled

  class Approved,Paid egkSuccess
  class PartiallyPaid egkWarn
  class Draft egkDraft
  class PendingApproval egkActive
  class Rejected egkError
  class Cancelled egkTerminal

flowchart TB
  A[Actions] --> B{Status}
  B -->|Draft| C[Submit / Edit / Cancel]
  B -->|PendingApproval| D[Approve / Reject / Cancel]
  B -->|Approved / PartiallyPaid| E[Pay]
  B -->|Paid| F[Payment history]
  B -->|Rejected| G[Edit / resubmit]
  B -->|Cancelled| H[Read-only]

  class A egkActive
  class B egkDecision
  class C,D,G egkDraft
  class E egkSuccess
  class F egkSuccess
  class H egkTerminal

#Related documents

• Purchasing Document flow timeline links GRN/PO into AP.
• Payments: ApPayment — Draft, Posted, Voided, Refunded.
• Debit notes / prepayments: Draft/Applied/Cancelled, Open/Applied/Cancelled.

#Post-action sync

After Submit / Approve / Reject / Cancel / payment:

1. API updates aggregate status.
2. Grid reloads.
3. Status chips refresh.
4. Actions menu re-evaluates from the new status.

Failures leave previous status and menu intact.

#Scenarios

#Related

• Purchasing Document Flow
• General Ledger Document Flow
• ETA Document Flow