Keysproperty operations Corbelstone Residential

#249 · Invoice without ticket

done Wed 15:00 · invoice 4612

Ledger row
policy v2
The call
PUT /invoices/4612/hold
Action, tier
hold_invoice, tier 0
Decided by
rules: No matching job (job belongs to another vendor); hold it out of the payment run.
Controller
Allowed: hold_invoice is tier 0 (just do it); within budget (0 of 40 back-office actions this minute).
authority
conditions
cooldown
budget
Definition
invoice_without_ticket v2
At stake
719 would go out in the next payment run (EUR 719)
Outcome
Invoice 4612 held; the vendor is asked for the job number.
Undo
Release the hold.

Undo

Restores the before-snapshot below and writes a new row.

Evidence

{
  "amount": 719.25,
  "amount_at_risk": 719.25,
  "building_id": 13,
  "currency": "EUR",
  "invoice_id": 4612,
  "reason": "job belongs to another vendor",
  "reference": "Job 4434",
  "referenced_ticket_exists": true,
  "referenced_ticket_id": 4434,
  "referenced_ticket_vendor_id": 165,
  "stake_note": "719 would go out in the next payment run",
  "started_at": "2026-10-28T14:37:17.277249",
  "status": "approved",
  "trade": "general",
  "vendor": "Ferreira & Sons Property Services",
  "vendor_id": 239
}

Before and after

{
  "after": {
    "messages": [
      {
        "body": "Your invoice 'Job 4434' does not match a job we sent you. Please reply with the ticket number; the invoice is on hold until then.",
        "created_at": "2026-10-28T15:00:00",
        "id": 41,
        "kind": "vendor_request",
        "status": "outbox",
        "subject": "Invoice 4612: job number needed",
        "to_id": "239",
        "to_name": "Ferreira & Sons Property Services",
        "to_type": "vendor"
      }
    ],
    "vendor_invoices": [
      {
        "held_at": "2026-10-28T15:00:00",
        "id": 4612,
        "paid_at": null,
        "status": "held"
      }
    ]
  },
  "before": {
    "vendor_invoices": [
      {
        "held_at": null,
        "id": 4612,
        "paid_at": null,
        "status": "approved"
      }
    ]
  },
  "endpoint": "PUT /invoices/4612/hold",
  "note": "Invoice 4612 held; the vendor is asked for the job number.",
  "ok": true,
  "rollback_fn_name": "undo_hold_invoice"
}

Arguments

{
  "invoice_id": 4612
}