AR/AP

Apply a customer workflow transition to an AP item

DARK — 404s unless company_subledger_flags.ar_ap_items_enabled is true. Workflow-only customer state machine (Wave 2, Option A); no money moves and no journal entry is posted. scheduled records a payment-intent date (requires scheduledPayDate); unscheduled cancels that intent; recorded_paid is a fail-closed reflection of an already-applied bank match that covers the bill (requires matchedTransactionId) and never touches the reconciled transaction. The response echoes the updated item plus its recomputed availableTransitions.

post/companies/{companyId}/ap/{id}/transitions

Request

  • Base URL: https://api.medianfi.com/api/v1
  • URL: https://api.medianfi.com/api/v1/companies/{companyId}/ap/{id}/transitions
  • Auth: HTTP bearer

Request body

to'scheduled' | 'unscheduled' | 'recorded_paid' | 'void' required
scheduledPayDatestring date

Required when to=scheduled (YYYY-MM-DD).

matchedTransactionIdstring uuid

Required when to=recorded_paid.

reasonstring nullable

Optional reason; recorded on void (terminal cancellation) and recorded_paid.

Response

Transition applied; returns the AP item (with availableTransitions). void is a terminal cancellation delegating to the FSM void edge (open/partially_paid/paid → void); no money moves and the customer is offered no re-open target.

Changes

No recorded changes to this operation across all 1 revision of this API.