Keysproperty operations Corbelstone Residential

#387 · Invoice without ticket

done Mon 12:00 · invoice 5763

Ledger row
policy v2
The call
PUT /invoices/5763/hold
Action, tier
hold_invoice, tier 0
Decided by
rules: No matching job (job number does not exist); hold it out of the payment run.
Controller
Allowed: hold_invoice is tier 0 (just do it); within budget (2 of 40 back-office actions this minute).
authority
conditions
cooldown
budget
Definition
invoice_without_ticket v2
At stake
592 would go out in the next payment run (EUR 592)
Outcome
Invoice 5763 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": 591.58,
  "amount_at_risk": 591.58,
  "building_id": 111,
  "currency": "EUR",
  "invoice_id": 5763,
  "reason": "job number does not exist",
  "reference": "T-7922",
  "referenced_ticket_exists": false,
  "referenced_ticket_id": 7922,
  "referenced_ticket_vendor_id": null,
  "stake_note": "592 would go out in the next payment run",
  "started_at": "2026-11-02T11:23:30.498239",
  "status": "received",
  "trade": "hvac",
  "vendor": "Ruiter & Sons Heating",
  "vendor_id": 127
}

Before and after

{
  "after": {
    "messages": [
      {
        "body": "Your invoice 'T-7922' does not match a job we sent you. Please reply with the ticket number; the invoice is on hold until then.",
        "created_at": "2026-11-02T12:00:00",
        "id": 71,
        "kind": "vendor_request",
        "status": "outbox",
        "subject": "Invoice 5763: job number needed",
        "to_id": "127",
        "to_name": "Ruiter & Sons Heating",
        "to_type": "vendor"
      }
    ],
    "vendor_invoices": [
      {
        "held_at": "2026-11-02T12:00:00",
        "id": 5763,
        "paid_at": null,
        "status": "held"
      }
    ]
  },
  "before": {
    "vendor_invoices": [
      {
        "held_at": null,
        "id": 5763,
        "paid_at": null,
        "status": "received"
      }
    ]
  },
  "endpoint": "PUT /invoices/5763/hold",
  "note": "Invoice 5763 held; the vendor is asked for the job number.",
  "ok": true,
  "rollback_fn_name": "undo_hold_invoice"
}

Arguments

{
  "invoice_id": 5763
}