Keysproperty operations Corbelstone Residential

#362 · Invoice without ticket

done Mon 10:00 · invoice 5301

Ledger row
policy v2
The call
PUT /invoices/5301/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 (1 of 40 back-office actions this minute).
authority
conditions
cooldown
budget
Definition
invoice_without_ticket v2
At stake
716 would go out in the next payment run (EUR 716)
Outcome
Invoice 5301 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": 716.43,
  "amount_at_risk": 716.43,
  "building_id": 112,
  "currency": "EUR",
  "invoice_id": 5301,
  "reason": "job belongs to another vendor",
  "reference": "Job 1296",
  "referenced_ticket_exists": true,
  "referenced_ticket_id": 1296,
  "referenced_ticket_vendor_id": 134,
  "stake_note": "716 would go out in the next payment run",
  "started_at": "2026-11-02T09:28:17.328301",
  "status": "received",
  "trade": "plumbing",
  "vendor": "Summit Plumbers",
  "vendor_id": 40
}

Before and after

{
  "after": {
    "messages": [
      {
        "body": "Your invoice 'Job 1296' 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-02T10:00:00",
        "id": 56,
        "kind": "vendor_request",
        "status": "outbox",
        "subject": "Invoice 5301: job number needed",
        "to_id": "40",
        "to_name": "Summit Plumbers",
        "to_type": "vendor"
      }
    ],
    "vendor_invoices": [
      {
        "held_at": "2026-11-02T10:00:00",
        "id": 5301,
        "paid_at": null,
        "status": "held"
      }
    ]
  },
  "before": {
    "vendor_invoices": [
      {
        "held_at": null,
        "id": 5301,
        "paid_at": null,
        "status": "received"
      }
    ]
  },
  "endpoint": "PUT /invoices/5301/hold",
  "note": "Invoice 5301 held; the vendor is asked for the job number.",
  "ok": true,
  "rollback_fn_name": "undo_hold_invoice"
}

Arguments

{
  "invoice_id": 5301
}