Budgetten & uitgaven

Budgetten, transacties, kosten, belastingen en bankrekeningen — volg uitgaven en verzoen automatisch.

Budget

Endpoints

GET	/budgets	Haalt de verzameling Budget-resources op.
POST	/budgets	Maakt een Budget-resource aan.
GET	/budgets/{id}	Haalt een Budget-resource op.
PATCH	/budgets/{id}	Werkt de Budget-resource bij.
DELETE	/budgets/{id}	Verwijdert de Budget-resource.
POST	/budgets/{id}/copy-plan-from-year	Maakt een Budget-resource aan.
GET	/budgets/{id}/employee-pnl	Haalt een Budget-resource op.
PUT	/budgets/{id}/plan	Vervangt de Budget-resource.
GET	/budgets/{id}/pnl-by-tags	Haalt een Budget-resource op.
GET	/budgets/{id}/pnl-by-tags-drilldown	Haalt een Budget-resource op.

Schema-velden

Veld	Type	Beschrijving
name*	string
type*	string
granularity*	string
budgetGroup	string,null (iri-reference)
attributeSet	string,null (iri-reference)
dateFrom	string,null (date-time)
dateTo	string,null (date-time)
displayPricePerSqm	boolean	Opt-in flag for the P&L-by-tags preview's price-per-sqm column. When true, the costsByProject section is expected to surface a surface-aware price view in addition to absolute amounts. The actual surface lookup (Project -> assigned Property/Asset -> surface AttributeValue) lands after the post-Horizon-2026-04-30 co-design pass; this flag is the persistent toggle so the option exists today.
displayCurrency	string,null (iri-reference)	PRESENTATION currency — what this budget is READ in (#3434). Not what any amount IS: that is transaction currency, and it lives on the row ({@see \App\Entity\Budget\InitialBudgetItem::$currency}, #3432). The IAS 21 split, kept apart deliberately: one rate policy serves both asks only while the two concepts stay separate.
outgoingTags	array	Tag-mode filter (outgoing/income side). OR semantics — an invoice matches if it carries at least one of these tags. Replaces the legacy single $outgoingTag ManyToOne (kept as a virtual property for backwards-compat during the FE rollout window).
incomingTags	array
amountStrategy*	string
actualMode	string
planningMode	stringnull
viewMode	stringnull	Explicit planning-vs-observation intent, decoupled from planningMode (the scope). Null on legacy budgets: BudgetNormalizer::resolveViewMode() falls back to inferring the mode from plan artifacts when this is unset, so existing budgets are unchanged. Write-only groups — the read value is emitted by BudgetNormalizer, which honours this field first.
planSource*	string
config	array
includePeopleCosts	booleannull
includeEmployeeCosts	booleannull
includePeopleIncome	booleannull
outgoingTag	string,null (iri-reference)	Legacy single-tag alias — read returns the first element of $outgoingTags (or null). Write REPLACES the collection with a single-element array (or empty when null). Exists only to keep the still-deployed old frontend working through PR 3's rollout.
incomingTag	string,null (iri-reference)

Budgettransactie

Endpoints

GET	/budget-transactions	Haalt de verzameling BudgetTransaction-resources op.
POST	/budget-transactions	Maakt een BudgetTransaction-resource aan.
GET	/budget-transactions/{id}	Haalt een BudgetTransaction-resource op.
PATCH	/budget-transactions/{id}	Werkt de BudgetTransaction-resource bij.
DELETE	/budget-transactions/{id}	Verwijdert de BudgetTransaction-resource.

Schema-velden

Veld	Type	Beschrijving
budget*	string (iri-reference)
transaction*	string (iri-reference)
employee	string,null (iri-reference)
amount	numbernull

Budgetgroep

Endpoints

GET	/budget-groups	Haalt de verzameling BudgetGroup-resources op.
POST	/budget-groups	Maakt een BudgetGroup-resource aan.
GET	/budget-groups/{id}	Haalt een BudgetGroup-resource op.
PATCH	/budget-groups/{id}	Werkt de BudgetGroup-resource bij.
DELETE	/budget-groups/{id}	Verwijdert de BudgetGroup-resource.

Schema-velden

Veld	Type	Beschrijving
name*	string

Kosten

Endpoints

GET	/contractors	Haalt de verzameling Cost-resources op.
POST	/contractors	Maakt een Cost-resource aan.
GET	/contractors/{id}	Haalt een Cost-resource op.
PATCH	/contractors/{id}	Werkt de Cost-resource bij.
DELETE	/contractors/{id}	Verwijdert de Cost-resource.
POST	/contractors/nip-validation	Maakt een Cost-resource aan.
GET	/contractors/search	Haalt de verzameling Cost-resources op.
GET	/costs	Haalt de verzameling Cost-resources op.
POST	/costs	Maakt een Cost-resource aan.
GET	/costs/{id}	Haalt een Cost-resource op.
PATCH	/costs/{id}	Werkt de Cost-resource bij.
GET	/costs/{id}/documents	Haalt een Cost-resource op.
GET	/costs/payment-due/{date}	Get by path parameters
GET	/suppliers	Haalt de verzameling Cost-resources op.
POST	/suppliers	Maakt een Cost-resource aan.
GET	/suppliers/{id}	Haalt een Cost-resource op.
PATCH	/suppliers/{id}	Werkt de Cost-resource bij.
DELETE	/suppliers/{id}	Verwijdert de Cost-resource.
POST	/suppliers/nip-validation	Maakt een Cost-resource aan.
GET	/suppliers/search	Haalt de verzameling Cost-resources op.

Transactie

Endpoints

GET	/transactions	Haalt de verzameling Transaction-resources op.
POST	/transactions	Maakt een Transaction-resource aan.
GET	/transactions/{id}	Haalt een Transaction-resource op.
PATCH	/transactions/{id}	Werkt de Transaction-resource bij.
DELETE	/transactions/{id}	Verwijdert de Transaction-resource.
GET	/transactions/{id}/suggestions	Haalt de verzameling Transaction-resources op.
POST	/transactions/{id}/suggestions/{suggestionId}/apply	Maakt een Transaction-resource aan.
POST	/transactions/import	Maakt een Transaction-resource aan.
GET	/transactions/search	Haalt de verzameling Transaction-resources op.
GET	/transactions/unassigned	Haalt de verzameling Transaction-resources op.
GET	/transactions/with-problems	Haalt de verzameling Transaction-resources op.

Schema-velden

Veld	Type	Beschrijving
id	string
bankAccount	string (iri-reference)
employeeOwner	string,null (iri-reference)
hash	string
source	stringnull	Where this row came from. Written at creation by whichever importer or creator made it — NEVER inferred from the row's shape.
type	string
cost	string,null (iri-reference)
counterparty	string,null (iri-reference)
counterpartyRole	stringnull
statementNumber	integer
operationNumber	stringnull
description	string
currency	string
amount	number
endingBalance	number
orderDate	string (date-time)
execDate	string (date-time)
relatedDate	string,null (date-time)
ignored*	integer
note	stringnull
hasDetectedProblems	booleannull
transactionAttachments	array
additionalAttachments	array	Inverse of TransactionAttachment.additionalTransactions: invoice documents this transaction is linked to as an ADDITIONAL payment (one invoice paid across several payments). Lets the transaction recognize the link for completeness, same as a primary attachment.
invoiceTransactions	array
properties	array
budgetTransactions	array
projectTransactions	array
employeeTransactions	array
createdAt	string (date-time)
updatedAt	string (date-time)
contractor	string,null (iri-reference)
connectedMonth	string (date-time)
relatedEmployee	string,null (iri-reference)

Bankrekening

Endpoints

GET	/bank-accounts	Haalt de verzameling BankAccount-resources op.
POST	/bank-accounts	Maakt een BankAccount-resource aan.
GET	/bank-accounts/{id}	Haalt een BankAccount-resource op.
PATCH	/bank-accounts/{id}	Werkt de BankAccount-resource bij.
DELETE	/bank-accounts/{id}	Verwijdert de BankAccount-resource.

Schema-velden

Veld	Type	Beschrijving
bank	string,null (iri-reference)
type*	string
default	boolean
hidden	boolean
name*	string
number	stringnull
prefix	stringnull
currency*	string,null (iri-reference)
defaultImportFormat*	string

Belastinggroep

Endpoints

GET	/tax-groups	Haalt de verzameling TaxGroup-resources op.
POST	/tax-groups	Maakt een TaxGroup-resource aan.
GET	/tax-groups/{id}	Haalt een TaxGroup-resource op.
PATCH	/tax-groups/{id}	Werkt de TaxGroup-resource bij.

Schema-velden

Veld	Type	Beschrijving
name*	string
isDefault	boolean

Valuta

Endpoints

GET	/currencies	Haalt de verzameling Currency-resources op.
GET	/currencies/{!sourceCurrency}/rates/{!targetCurrency}/{date}	Haalt de verzameling Currency-resources op.
GET	/currencies/{id}	Haalt een Currency-resource op.

Schema-velden

Veld	Type	Beschrijving
id*	string

Initieel budget

Endpoints

GET	/initial-budgets	Haalt de verzameling InitialBudget-resources op.
POST	/initial-budgets	Maakt een InitialBudget-resource aan.
GET	/initial-budgets/{id}	Haalt een InitialBudget-resource op.
PATCH	/initial-budgets/{id}	Werkt de InitialBudget-resource bij.
DELETE	/initial-budgets/{id}	Verwijdert de InitialBudget-resource.
POST	/initial-budgets/{id}/analyze-sheet	Parse a budget spreadsheet into Budzet wstepny candidates. Persists nothing.
POST	/initial-budgets/{id}/apply-sheet-rows	Write the Budzet wstepny lines the operator confirmed after previewing a spreadsheet.
GET	/initial-budgets/{id}/contract-comparison	Haalt een InitialBudget-resource op.
GET	/initial-budgets/{id}/contract-comparison/{tagDefinitionId}/breakdown	Haalt een InitialBudget-resource op.

Schema-velden

Veld	Type	Beschrijving
id	string
project	string (iri-reference)
name	string
notes	stringnull
currency	string (iri-reference)	Presentation currency the planned total is read in (#3432). Nullable in PHP only for the moment between `new InitialBudget()` and the defaulting listener's prePersist — {@see InitialBudgetFxPinListener} — filling it from `Project.currency`/org default; the column itself is NOT NULL, so a persisted row always has one.
items	array
createdAt	string (date-time)
updatedAt	string (date-time)

Initiële budgetpost

Endpoints

GET	/initial-budget-items	Haalt de verzameling InitialBudgetItem-resources op.
POST	/initial-budget-items	Maakt een InitialBudgetItem-resource aan.
GET	/initial-budget-items/{id}	Haalt een InitialBudgetItem-resource op.
PATCH	/initial-budget-items/{id}	Werkt de InitialBudgetItem-resource bij.
DELETE	/initial-budget-items/{id}	Verwijdert de InitialBudgetItem-resource.

Schema-velden

Veld	Type	Beschrijving
id	string
name	string
plannedAmount	stringnull
plannedBilledAmount	stringnull
currency	string (iri-reference)	The line's OWN currency — transaction currency, not presentation currency (that is `InitialBudget.currency`). Nullable in PHP only until {@see \App\Listener\Doctrine\InitialBudgetFxPinListener} defaults it (item → InitialBudget.currency → Project.currency → org default); the column is NOT NULL.
fxRate	numbernull	The rate that converts `plannedAmount` (in `currency`) into `InitialBudget.currency`, PINNED at pin time — see the class docblock.
fxRateDate	string,null (date-time)	The date `fxRate` was pinned on — not an economic-event date (this line has none), a record of when the pin happened, so "500 MYR @ 0,9123 as of 2026-08-12" is inspectable and reproducible.
tagDefinition	string,null (iri-reference)
unit	stringnull
quantity	stringnull
sortOrder	integer
periods	array	The month-by-month breakdown of this line's planned cost (#3559).
convertedPlannedAmount	stringnull	`plannedAmount` expressed in `InitialBudget.currency`, grosze, as a decimal string to match `plannedAmount`'s own type.
convertedPlannedBilledAmount	stringnull	`plannedBilledAmount` expressed in `InitialBudget.currency` — same policy as {@see getConvertedPlannedAmount()}, same pinned rate.
plannedMargin	stringnull	`plannedBilledAmount - plannedAmount`, in the line's OWN currency — null unless BOTH sides are non-null. A one-sided line (cost only, or billed only) carries no margin; that is a real state, not a gap (see the class docblock and `flowtly-design`'s archetype, #3441).
convertedPlannedMargin	stringnull	`getPlannedMargin()` expressed in `InitialBudget.currency` — the same pinned rate applied to the already-derived native margin, not a second conversion policy. See the class docblock.

Budgetperiode

Endpoints

GET	/budget-periods	Haalt de verzameling BudgetPeriod-resources op.
POST	/budget-periods	Maakt een BudgetPeriod-resource aan.
GET	/budget-periods/{id}	Haalt een BudgetPeriod-resource op.
PATCH	/budget-periods/{id}	Werkt de BudgetPeriod-resource bij.
DELETE	/budget-periods/{id}	Verwijdert de BudgetPeriod-resource.

Schema-velden

Veld	Type	Beschrijving
id	string
periodKey	string
baseAmount	stringnull
linearGrowth	stringnull
exponentialGrowthBps	integernull
unitGrowth	stringnull
plannedIncome	stringnull

Budgetmedewerker

Endpoints

GET	/budget-employees	Haalt de verzameling BudgetEmployee-resources op.
POST	/budget-employees	Maakt een BudgetEmployee-resource aan.
GET	/budget-employees/{id}	Haalt een BudgetEmployee-resource op.
PATCH	/budget-employees/{id}	Werkt de BudgetEmployee-resource bij.
DELETE	/budget-employees/{id}	Verwijdert de BudgetEmployee-resource.

Schema-velden

Veld	Type	Beschrijving
id	string
budget*	object
employee*	string (iri-reference)
position	string
positionName	string

Budgetcontract

Endpoints

GET	/budget-contracts	Haalt de verzameling BudgetContract-resources op.
POST	/budget-contracts	Maakt een BudgetContract-resource aan.
GET	/budget-contracts/{id}	Haalt een BudgetContract-resource op.
DELETE	/budget-contracts/{id}	Verwijdert de BudgetContract-resource.

Schema-velden

Veld	Type	Beschrijving
id	string
contract	string (iri-reference)

Budgetleverancier

Endpoints

GET	/budget-contractors	Haalt de verzameling BudgetContractor-resources op.
POST	/budget-contractors	Maakt een BudgetContractor-resource aan.
GET	/budget-contractors/{id}	Haalt een BudgetContractor-resource op.
DELETE	/budget-contractors/{id}	Verwijdert de BudgetContractor-resource.

Schema-velden

Veld	Type	Beschrijving
budget*	string (iri-reference)
contractor*	string (iri-reference)

Budgetfactuur

Endpoints

GET	/budget-invoices	Haalt de verzameling BudgetInvoice-resources op.
POST	/budget-invoices	Maakt een BudgetInvoice-resource aan.
GET	/budget-invoices/{id}	Haalt een BudgetInvoice-resource op.
DELETE	/budget-invoices/{id}	Verwijdert de BudgetInvoice-resource.

Schema-velden

Veld	Type	Beschrijving
budget*	string (iri-reference)
invoice*	string (iri-reference)
amountNet	stringnull

Budgetproject

Endpoints

GET	/budget-projects	Haalt de verzameling BudgetProject-resources op.
POST	/budget-projects	Maakt een BudgetProject-resource aan.
GET	/budget-projects/{id}	Haalt een BudgetProject-resource op.
DELETE	/budget-projects/{id}	Verwijdert de BudgetProject-resource.

Schema-velden

Veld	Type	Beschrijving
id	string
budget*	object
project*	string (iri-reference)
createdAt	string (date-time)

Budgetactiviteitpost

Endpoints

GET

/budget-activity

Schema-velden

Veld	Type	Beschrijving
type	string
state	string
direction	string
label	string
amount	string	The figure in the budget's currency — NULL when the row could not be priced (#3986).
unconvertible	boolean	True when no rate existed for this row's currency on its own date.
originalAmount	number	What the source record says, in its own currency — never converted.
originalCurrency	stringnull	Null when the figure was already in the budget's currency.
unconvertibleReason	stringnull	Names the pair and the date, so the reader can act. "Could not convert" on its own sends a user back to retry the same failure.
date	stringnull

Budgetwaarschuwingspost

Endpoints

GET

/budget-alerts

Schema-velden

Veld	Type	Beschrijving
key	string
type	string
severity	string
title	string
description	string
period	stringnull
dismissed	boolean

Kostenplaats

Endpoints

GET	/cost-groups	Haalt de verzameling CostGroup-resources op.
POST	/cost-groups	Maakt een CostGroup-resource aan.
GET	/cost-groups/{id}	Get cost group chart
PATCH	/cost-groups/{id}	Werkt de CostGroup-resource bij.
GET	/cost-groups/{id}/chart	Get cost group chart
POST	/cost-groups/{id}/merge	Merge cost groups
POST	/cost-groups/assign-icons-ai	Assign cost group icons via AI
GET	/cost-groups/chart	Get cost groups chart

Schema-velden

Veld	Type	Beschrijving
id	integer
type*	string
name*	string
description	stringnull
icon	stringnull
accoutancy_reference	stringnull
costs	array
createdAt	string (date-time)
updatedAt	string (date-time)
possibleTypes	string

Belastingregel

Endpoints

GET	/tax-rules	Haalt de verzameling TaxRule-resources op.
POST	/tax-rules	Maakt een TaxRule-resource aan.
GET	/tax-rules/{id}	Haalt een TaxRule-resource op.
PATCH	/tax-rules/{id}	Werkt de TaxRule-resource bij.
DELETE	/tax-rules/{id}	Verwijdert de TaxRule-resource.

Schema-velden

Veld	Type	Beschrijving
id	string
country*	string (iri-reference)
taxAmount*	string

Bank

Endpoints

GET	/banks	Haalt de verzameling Bank-resources op.
POST	/banks	Maakt een Bank-resource aan.
GET	/banks/{id}	Haalt een Bank-resource op.
PATCH	/banks/{id}	Werkt de Bank-resource bij.

Schema-velden

Veld	Type	Beschrijving
name	string
swift*	string

Transactiebijlage

Endpoints

GET	/transaction-attachments	Haalt de verzameling TransactionAttachment-resources op.
POST	/transaction-attachments	Maakt een TransactionAttachment-resource aan.
GET	/transaction-attachments/{id}	Haalt een TransactionAttachment-resource op.
PATCH	/transaction-attachments/{id}	Werkt de TransactionAttachment-resource bij.
DELETE	/transaction-attachments/{id}	Verwijdert de TransactionAttachment-resource.
POST	/transaction-attachments/{id}/apply-suggestion	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/apply-supplier-suggestion	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/approve	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/cascade-preview	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/detach	Maakt een TransactionAttachment-resource aan.
GET	/transaction-attachments/{id}/documents	Haalt een TransactionAttachment-resource op.
POST	/transaction-attachments/{id}/manual-match	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/mark-manual-paid	Maakt een TransactionAttachment-resource aan.
GET	/transaction-attachments/{id}/match-candidates	Haalt de verzameling TransactionAttachment-resources op.
POST	/transaction-attachments/{id}/prefill-project-allocations	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/prefill-project-allocations-by-cascade	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/prefill-project-allocations-by-meter	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/reject	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/replace-project-allocations	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/settle-without-transaction	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/submit-for-approval	Maakt een TransactionAttachment-resource aan.
GET	/transaction-attachments/{id}/suggestions	Haalt de verzameling TransactionAttachment-resources op.
GET	/transaction-attachments/{id}/suggestions-debug	Haalt een TransactionAttachment-resource op.
POST	/transaction-attachments/{id}/suggestions/{suggestionId}/apply	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/suggestions/accept-all	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/unlink-transaction	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/unmark-manual-paid	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/unsettle-without-transaction	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/{id}/withdraw-approval	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/create	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/create-base64	Maakt een TransactionAttachment-resource aan.
POST	/transaction-attachments/create-without-document	Maakt een TransactionAttachment-resource aan.
GET	/transaction-attachments/pending-approval	Haalt de verzameling TransactionAttachment-resources op.
GET	/transaction-attachments/search	Haalt de verzameling TransactionAttachment-resources op.

Schema-velden

Veld	Type	Beschrijving
id	integer
amount	integernull
name	string	The DISPLAY name — the filename the user uploaded (#3381).
invoiceNumber	stringnull	The purchase document number, when one is known (#3381).
receivedAt	string (date-time)
status	string

Transactiebijlage factuurregel

Endpoints

POST	/transaction-attachment-invoice-lines	Maakt een TransactionAttachmentInvoiceLine-resource aan.
PATCH	/transaction-attachment-invoice-lines/{id}	Werkt de TransactionAttachmentInvoiceLine-resource bij.
DELETE	/transaction-attachment-invoice-lines/{id}	Verwijdert de TransactionAttachmentInvoiceLine-resource.

Schema-velden

Veld	Type	Beschrijving
id	integer
transactionAttachment	string (iri-reference)
position	integer
description	stringnull
quantity	stringnull
unitPrice	stringnull
amount	stringnull
taxRate	stringnull
currency	stringnull
project	string,null (iri-reference)
createdAt	string (date-time)
updatedAt	string (date-time)