Budgets et dépenses

Budgets, transactions, coûts, taxes et comptes bancaires — suivez les dépenses et rapprochez-les automatiquement.

Budget

Points de terminaison

GET	/budgets	Récupère la collection de ressources Budget.
POST	/budgets	Crée une ressource Budget.
GET	/budgets/{id}	Récupère une ressource Budget.
PATCH	/budgets/{id}	Met à jour la ressource Budget.
DELETE	/budgets/{id}	Supprime la ressource Budget.
POST	/budgets/{id}/copy-plan-from-year	Crée une ressource Budget.
GET	/budgets/{id}/employee-pnl	Récupère une ressource Budget.
PUT	/budgets/{id}/plan	Remplace la ressource Budget.
GET	/budgets/{id}/pnl-by-tags	Récupère une ressource Budget.
GET	/budgets/{id}/pnl-by-tags-drilldown	Récupère une ressource Budget.

Champs de schéma

Champ	Type	Description
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.
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)

Transaction de budget

Points de terminaison

GET	/budget-transactions	Récupère la collection de ressources BudgetTransaction.
POST	/budget-transactions	Crée une ressource BudgetTransaction.
GET	/budget-transactions/{id}	Récupère une ressource BudgetTransaction.
PATCH	/budget-transactions/{id}	Met à jour la ressource BudgetTransaction.
DELETE	/budget-transactions/{id}	Supprime la ressource BudgetTransaction.

Champs de schéma

Champ	Type	Description
budget*	string (iri-reference)
transaction*	string (iri-reference)
employee	string,null (iri-reference)
amount	numbernull

Groupe de budget

Points de terminaison

GET	/budget-groups	Récupère la collection de ressources BudgetGroup.
POST	/budget-groups	Crée une ressource BudgetGroup.
GET	/budget-groups/{id}	Récupère une ressource BudgetGroup.
PATCH	/budget-groups/{id}	Met à jour la ressource BudgetGroup.
DELETE	/budget-groups/{id}	Supprime la ressource BudgetGroup.

Champs de schéma

Champ	Type	Description
name*	string

Coût

Points de terminaison

GET	/contractors	Récupère la collection de ressources Cost.
POST	/contractors	Crée une ressource Cost.
GET	/contractors/{id}	Récupère une ressource Cost.
PATCH	/contractors/{id}	Met à jour la ressource Cost.
DELETE	/contractors/{id}	Supprime la ressource Cost.
POST	/contractors/nip-validation	Crée une ressource Cost.
GET	/contractors/search	Récupère la collection de ressources Cost.
GET	/costs	Récupère la collection de ressources Cost.
POST	/costs	Crée une ressource Cost.
GET	/costs/{id}	Récupère une ressource Cost.
PATCH	/costs/{id}	Met à jour la ressource Cost.
GET	/costs/{id}/documents	Récupère une ressource Cost.
GET	/costs/payment-due/{date}	Get by path parameters
GET	/suppliers	Récupère la collection de ressources Cost.
POST	/suppliers	Crée une ressource Cost.
GET	/suppliers/{id}	Récupère une ressource Cost.
PATCH	/suppliers/{id}	Met à jour la ressource Cost.
DELETE	/suppliers/{id}	Supprime la ressource Cost.
POST	/suppliers/nip-validation	Crée une ressource Cost.
GET	/suppliers/search	Récupère la collection de ressources Cost.

Champs de schéma

Champ	Type	Description
costGroup*	string (iri-reference)
allowDuplicate	booleannull	Not persisted (no ORM\Column): an escape hatch for POST /contractors only, mirroring Client::$allowDuplicate. When true, ContractorCreateProcessor:: refuseIfDuplicate() skips the duplicate-party guard so a genuinely distinct same-name contractor can be created on purpose.
ownerEmployee	string,null (iri-reference)
tinType*	string
tin	stringnull
tinCountry	string,null (iri-reference)
cyclic	boolean
paymentDeadline	integernull
name*	string
description	stringnull
matchRegex	stringnull
requireAttachment	booleannull
taxAmount	stringnull
notIncludeInChart	boolean
eInvoicingReferenceNumber	stringnull
eInvoicingSourceXmlUrl	stringnull
eInvoicingVisualUrl	stringnull
contractorGroup	string,null (iri-reference)

Transaction

Points de terminaison

GET	/transactions	Récupère la collection de ressources Transaction.
POST	/transactions	Crée une ressource Transaction.
GET	/transactions/{id}	Récupère une ressource Transaction.
PATCH	/transactions/{id}	Met à jour la ressource Transaction.
DELETE	/transactions/{id}	Supprime la ressource Transaction.
GET	/transactions/{id}/suggestions	Récupère la collection de ressources Transaction.
POST	/transactions/{id}/suggestions/{suggestionId}/apply	Crée une ressource Transaction.
POST	/transactions/import	Crée une ressource Transaction.
GET	/transactions/search	Récupère la collection de ressources Transaction.
GET	/transactions/unassigned	Récupère la collection de ressources Transaction.
GET	/transactions/with-problems	Récupère la collection de ressources Transaction.

Champs de schéma

Champ	Type	Description
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)

Compte bancaire

Points de terminaison

GET	/bank-accounts	Récupère la collection de ressources BankAccount.
POST	/bank-accounts	Crée une ressource BankAccount.
GET	/bank-accounts/{id}	Récupère une ressource BankAccount.
PATCH	/bank-accounts/{id}	Met à jour la ressource BankAccount.
DELETE	/bank-accounts/{id}	Supprime la ressource BankAccount.

Champs de schéma

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

Groupe fiscal

Points de terminaison

GET	/tax-groups	Récupère la collection de ressources TaxGroup.
POST	/tax-groups	Crée une ressource TaxGroup.
GET	/tax-groups/{id}	Récupère une ressource TaxGroup.
PATCH	/tax-groups/{id}	Met à jour la ressource TaxGroup.

Champs de schéma

Champ	Type	Description
name*	string
isDefault	boolean

Devise

Points de terminaison

GET	/currencies	Récupère la collection de ressources Currency.
GET	/currencies/{!sourceCurrency}/rates/{!targetCurrency}/{date}	Récupère la collection de ressources Currency.
GET	/currencies/{id}	Récupère une ressource Currency.

Champs de schéma

Champ	Type	Description
id*	string

Budget initial

Points de terminaison

GET	/initial-budgets	Récupère la collection de ressources InitialBudget.
POST	/initial-budgets	Crée une ressource InitialBudget.
GET	/initial-budgets/{id}	Récupère une ressource InitialBudget.
PATCH	/initial-budgets/{id}	Met à jour la ressource InitialBudget.
DELETE	/initial-budgets/{id}	Supprime la ressource InitialBudget.
GET	/initial-budgets/{id}/contract-comparison	Récupère une ressource InitialBudget.
GET	/initial-budgets/{id}/contract-comparison/{tagDefinitionId}/breakdown	Récupère une ressource InitialBudget.

Champs de schéma

Champ	Type	Description
project	string (iri-reference)
name	string
notes	stringnull

Poste de budget initial

Points de terminaison

GET	/initial-budget-items	Récupère la collection de ressources InitialBudgetItem.
POST	/initial-budget-items	Crée une ressource InitialBudgetItem.
GET	/initial-budget-items/{id}	Récupère une ressource InitialBudgetItem.
PATCH	/initial-budget-items/{id}	Met à jour la ressource InitialBudgetItem.
DELETE	/initial-budget-items/{id}	Supprime la ressource InitialBudgetItem.

Champs de schéma

Champ	Type	Description
id	string
name	string
plannedAmount	stringnull
tagDefinition	string,null (iri-reference)
unit	stringnull
quantity	stringnull
sortOrder	integer

Période budgétaire

Points de terminaison

GET	/budget-periods	Récupère la collection de ressources BudgetPeriod.
POST	/budget-periods	Crée une ressource BudgetPeriod.
GET	/budget-periods/{id}	Récupère une ressource BudgetPeriod.
PATCH	/budget-periods/{id}	Met à jour la ressource BudgetPeriod.
DELETE	/budget-periods/{id}	Supprime la ressource BudgetPeriod.

Champs de schéma

Champ	Type	Description
id	string
periodKey	string
baseAmount	stringnull
linearGrowth	stringnull
exponentialGrowthBps	integernull
unitGrowth	stringnull
plannedIncome	stringnull

Employé du budget

Points de terminaison

GET	/budget-employees	Récupère la collection de ressources BudgetEmployee.
POST	/budget-employees	Crée une ressource BudgetEmployee.
GET	/budget-employees/{id}	Récupère une ressource BudgetEmployee.
PATCH	/budget-employees/{id}	Met à jour la ressource BudgetEmployee.
DELETE	/budget-employees/{id}	Supprime la ressource BudgetEmployee.

Champs de schéma

Champ	Type	Description
id	string
budget*	object
employee*	string (iri-reference)
position	string
positionName	string

Contrat du budget

Points de terminaison

GET	/budget-contracts	Récupère la collection de ressources BudgetContract.
POST	/budget-contracts	Crée une ressource BudgetContract.
GET	/budget-contracts/{id}	Récupère une ressource BudgetContract.
DELETE	/budget-contracts/{id}	Supprime la ressource BudgetContract.

Champs de schéma

Champ	Type	Description
id	string
contract	string (iri-reference)

Prestataire du budget

Points de terminaison

GET	/budget-contractors	Récupère la collection de ressources BudgetContractor.
POST	/budget-contractors	Crée une ressource BudgetContractor.
GET	/budget-contractors/{id}	Récupère une ressource BudgetContractor.
DELETE	/budget-contractors/{id}	Supprime la ressource BudgetContractor.

Champs de schéma

Champ	Type	Description
budget*	string (iri-reference)
contractor*	string (iri-reference)

Facture du budget

Points de terminaison

GET	/budget-invoices	Récupère la collection de ressources BudgetInvoice.
POST	/budget-invoices	Crée une ressource BudgetInvoice.
GET	/budget-invoices/{id}	Récupère une ressource BudgetInvoice.
DELETE	/budget-invoices/{id}	Supprime la ressource BudgetInvoice.

Champs de schéma

Champ	Type	Description
budget*	string (iri-reference)
invoice*	string (iri-reference)
amountNet	stringnull

Projet du budget

Points de terminaison

GET	/budget-projects	Récupère la collection de ressources BudgetProject.
POST	/budget-projects	Crée une ressource BudgetProject.
GET	/budget-projects/{id}	Récupère une ressource BudgetProject.
DELETE	/budget-projects/{id}	Supprime la ressource BudgetProject.

Champs de schéma

Champ	Type	Description
id	string
budget*	object
project*	string (iri-reference)
createdAt	string (date-time)

Poste d'activité du budget

Points de terminaison

GET

/budget-activity

Champs de schéma

Champ	Type	Description
type	string
state	string
direction	string
label	string
amount	number
date	stringnull

Poste d'alerte du budget

Points de terminaison

GET

/budget-alerts

Champs de schéma

Champ	Type	Description
key	string
type	string
severity	string
title	string
description	string
period	stringnull
dismissed	boolean

Groupe de coûts

Points de terminaison

GET	/cost-groups	Récupère la collection de ressources CostGroup.
POST	/cost-groups	Crée une ressource CostGroup.
GET	/cost-groups/{id}	Get cost group chart
PATCH	/cost-groups/{id}	Met à jour la ressource CostGroup.
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

Champs de schéma

Champ	Type	Description
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

Règle de taxe

Points de terminaison

GET	/tax-rules	Récupère la collection de ressources TaxRule.
POST	/tax-rules	Crée une ressource TaxRule.
GET	/tax-rules/{id}	Récupère une ressource TaxRule.
PATCH	/tax-rules/{id}	Met à jour la ressource TaxRule.
DELETE	/tax-rules/{id}	Supprime la ressource TaxRule.

Champs de schéma

Champ	Type	Description
id	string
country*	string (iri-reference)
taxAmount*	string

Banque

Points de terminaison

GET	/banks	Récupère la collection de ressources Bank.
POST	/banks	Crée une ressource Bank.
GET	/banks/{id}	Récupère une ressource Bank.
PATCH	/banks/{id}	Met à jour la ressource Bank.

Champs de schéma

Champ	Type	Description
name	string
swift*	string

Pièce jointe de transaction

Points de terminaison

GET	/transaction-attachments	Récupère la collection de ressources TransactionAttachment.
POST	/transaction-attachments	Crée une ressource TransactionAttachment.
GET	/transaction-attachments/{id}	Récupère une ressource TransactionAttachment.
PATCH	/transaction-attachments/{id}	Met à jour la ressource TransactionAttachment.
DELETE	/transaction-attachments/{id}	Supprime la ressource TransactionAttachment.
POST	/transaction-attachments/{id}/apply-suggestion	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/apply-supplier-suggestion	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/approve	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/cascade-preview	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/detach	Crée une ressource TransactionAttachment.
GET	/transaction-attachments/{id}/documents	Récupère une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/manual-match	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/mark-manual-paid	Crée une ressource TransactionAttachment.
GET	/transaction-attachments/{id}/match-candidates	Récupère la collection de ressources TransactionAttachment.
POST	/transaction-attachments/{id}/prefill-project-allocations	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/prefill-project-allocations-by-cascade	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/prefill-project-allocations-by-meter	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/reject	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/replace-project-allocations	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/settle-without-transaction	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/submit-for-approval	Crée une ressource TransactionAttachment.
GET	/transaction-attachments/{id}/suggestions	Récupère la collection de ressources TransactionAttachment.
GET	/transaction-attachments/{id}/suggestions-debug	Récupère une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/suggestions/{suggestionId}/apply	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/suggestions/accept-all	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/unlink-transaction	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/unmark-manual-paid	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/unsettle-without-transaction	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/{id}/withdraw-approval	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/create	Crée une ressource TransactionAttachment.
POST	/transaction-attachments/create-base64	Crée une ressource TransactionAttachment.
GET	/transaction-attachments/pending-approval	Récupère la collection de ressources TransactionAttachment.
GET	/transaction-attachments/search	Récupère la collection de ressources TransactionAttachment.

Champs de schéma

Champ	Type	Description
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

Ligne de facture de pièce jointe de transaction

Points de terminaison

POST	/transaction-attachment-invoice-lines	Crée une ressource TransactionAttachmentInvoiceLine.
PATCH	/transaction-attachment-invoice-lines/{id}	Met à jour la ressource TransactionAttachmentInvoiceLine.
DELETE	/transaction-attachment-invoice-lines/{id}	Supprime la ressource TransactionAttachmentInvoiceLine.

Champs de schéma

Champ	Type	Description
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)