Keysproperty operations Corbelstone Residential

#357 · Invoice without ticket

done Mon 09:00 · invoice 5057

Ledger row
policy v2
The call
PUT /invoices/5057/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
631 would go out in the next payment run (EUR 631)
Outcome
Invoice 5057 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": 630.75,
  "amount_at_risk": 630.75,
  "building_id": 89,
  "currency": "EUR",
  "invoice_id": 5057,
  "reason": "job belongs to another vendor",
  "reference": "Job 4158",
  "referenced_ticket_exists": true,
  "referenced_ticket_id": 4158,
  "referenced_ticket_vendor_id": 127,
  "stake_note": "631 would go out in the next payment run",
  "started_at": "2026-11-02T08:29:33.954408",
  "status": "received",
  "trade": "general",
  "vendor": "Square Property Services",
  "vendor_id": 244
}

Before and after

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

Arguments

{
  "invoice_id": 5057
}