Bills
| Method & Path | Permission | Purpose | Side effects |
|---|---|---|---|
GET/POST bills, GET/PUT/DELETE bills/{document} | purchase.view/purchase.manage | CRUD | — |
GET bills/{document}/pdf / /history | purchase.view | PDF / history | — |
POST bills/{document}/submit | /review | /approve | /reject | /reverse | purchase.submit/review/approve/reject/reverse | Workflow | approve posts to ledger (402 usage_limit_reached at the monthly transaction cap) |
GET/POST bills/{document}/attachments | purchase.view/purchase.manage | Attachments | Stores file, audit |
Vendor Credits
Mirror of bills at vendor-credits (kind=vendor_credit). Same CRUD + workflow shape, permission purchase.*. Approving posts the reverse of a bill's entries and reduces the linked bill's outstanding balance when one is set.
Recurring Bills (recurring-bills)
Same shape as recurring journal entries — permission purchase.view/purchase.manage. A source_document_id must reference an approved and posted bill (422 otherwise).