Бюджети та видатки

Бюджети, транзакції, витрати, податки та банківські рахунки — відстежуйте витрати та звіряйте дані автоматично.

Бюджет

Endpoints

GET	/budgets	Отримує колекцію ресурсів Budget.
POST	/budgets	Створює ресурс Budget.
GET	/budgets/{id}	Отримує ресурс Budget.
PATCH	/budgets/{id}	Оновлює ресурс Budget.
DELETE	/budgets/{id}	Видаляє ресурс Budget.
POST	/budgets/{id}/copy-plan-from-year	Створює ресурс Budget.
GET	/budgets/{id}/employee-pnl	Отримує ресурс Budget.
PUT	/budgets/{id}/plan	Замінює ресурс Budget.
GET	/budgets/{id}/pnl-by-tags	Отримує ресурс Budget.
GET	/budgets/{id}/pnl-by-tags-drilldown	Отримує ресурс Budget.

Поля схеми

Поле	Тип	Опис
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)

Транзакція бюджету

Endpoints

GET	/budget-transactions	Отримує колекцію ресурсів BudgetTransaction.
POST	/budget-transactions	Створює ресурс BudgetTransaction.
GET	/budget-transactions/{id}	Отримує ресурс BudgetTransaction.
PATCH	/budget-transactions/{id}	Оновлює ресурс BudgetTransaction.
DELETE	/budget-transactions/{id}	Видаляє ресурс BudgetTransaction.

Поля схеми

Поле	Тип	Опис
budget*	string (iri-reference)
transaction*	string (iri-reference)
employee	string,null (iri-reference)
amount	numbernull

Група бюджету

Endpoints

GET	/budget-groups	Отримує колекцію ресурсів BudgetGroup.
POST	/budget-groups	Створює ресурс BudgetGroup.
GET	/budget-groups/{id}	Отримує ресурс BudgetGroup.
PATCH	/budget-groups/{id}	Оновлює ресурс BudgetGroup.
DELETE	/budget-groups/{id}	Видаляє ресурс BudgetGroup.

Поля схеми

Поле	Тип	Опис
name*	string

Витрата

Endpoints

GET	/contractors	Отримує колекцію ресурсів Cost.
POST	/contractors	Створює ресурс Cost.
GET	/contractors/{id}	Отримує ресурс Cost.
PATCH	/contractors/{id}	Оновлює ресурс Cost.
DELETE	/contractors/{id}	Видаляє ресурс Cost.
POST	/contractors/nip-validation	Створює ресурс Cost.
GET	/contractors/search	Отримує колекцію ресурсів Cost.
GET	/costs	Отримує колекцію ресурсів Cost.
POST	/costs	Створює ресурс Cost.
GET	/costs/{id}	Отримує ресурс Cost.
PATCH	/costs/{id}	Оновлює ресурс Cost.
GET	/costs/{id}/documents	Отримує ресурс Cost.
GET	/costs/payment-due/{date}	Get by path parameters
GET	/suppliers	Отримує колекцію ресурсів Cost.
POST	/suppliers	Створює ресурс Cost.
GET	/suppliers/{id}	Отримує ресурс Cost.
PATCH	/suppliers/{id}	Оновлює ресурс Cost.
DELETE	/suppliers/{id}	Видаляє ресурс Cost.
POST	/suppliers/nip-validation	Створює ресурс Cost.
GET	/suppliers/search	Отримує колекцію ресурсів Cost.

Поля схеми

Поле	Тип	Опис
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)

Транзакція

Endpoints

GET	/transactions	Отримує колекцію ресурсів Transaction.
POST	/transactions	Створює ресурс Transaction.
GET	/transactions/{id}	Отримує ресурс Transaction.
PATCH	/transactions/{id}	Оновлює ресурс Transaction.
DELETE	/transactions/{id}	Видаляє ресурс Transaction.
GET	/transactions/{id}/suggestions	Отримує колекцію ресурсів Transaction.
POST	/transactions/{id}/suggestions/{suggestionId}/apply	Створює ресурс Transaction.
POST	/transactions/import	Створює ресурс Transaction.
GET	/transactions/search	Отримує колекцію ресурсів Transaction.
GET	/transactions/unassigned	Отримує колекцію ресурсів Transaction.
GET	/transactions/with-problems	Отримує колекцію ресурсів Transaction.

Поля схеми

Поле	Тип	Опис
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)

Банківський рахунок

Endpoints

GET	/bank-accounts	Отримує колекцію ресурсів BankAccount.
POST	/bank-accounts	Створює ресурс BankAccount.
GET	/bank-accounts/{id}	Отримує ресурс BankAccount.
PATCH	/bank-accounts/{id}	Оновлює ресурс BankAccount.

Поля схеми

Поле	Тип	Опис
bank	string,null (iri-reference)
type*	string
default	boolean
hidden	boolean
name*	string
number	stringnull
prefix	stringnull
currency*	string,null (iri-reference)
defaultImportFormat*	string

Податкова група

Endpoints

GET	/tax-groups	Отримує колекцію ресурсів TaxGroup.
POST	/tax-groups	Створює ресурс TaxGroup.
GET	/tax-groups/{id}	Отримує ресурс TaxGroup.
PATCH	/tax-groups/{id}	Оновлює ресурс TaxGroup.

Поля схеми

Поле	Тип	Опис
name*	string
isDefault	boolean

Валюта

Endpoints

GET	/currencies	Отримує колекцію ресурсів Currency.
GET	/currencies/{!sourceCurrency}/rates/{!targetCurrency}/{date}	Отримує колекцію ресурсів Currency.
GET	/currencies/{id}	Отримує ресурс Currency.

Поля схеми

Поле	Тип	Опис
id*	string

Початковий бюджет

Endpoints

GET	/initial-budgets	Отримує колекцію ресурсів InitialBudget.
POST	/initial-budgets	Створює ресурс InitialBudget.
GET	/initial-budgets/{id}	Отримує ресурс InitialBudget.
PATCH	/initial-budgets/{id}	Оновлює ресурс InitialBudget.
DELETE	/initial-budgets/{id}	Видаляє ресурс InitialBudget.
GET	/initial-budgets/{id}/contract-comparison	Отримує ресурс InitialBudget.
GET	/initial-budgets/{id}/contract-comparison/{tagDefinitionId}/breakdown	Отримує ресурс InitialBudget.

Поля схеми

Поле	Тип	Опис
project	string (iri-reference)
name	string
notes	stringnull

Позиція початкового бюджету

Endpoints

GET	/initial-budget-items	Отримує колекцію ресурсів InitialBudgetItem.
POST	/initial-budget-items	Створює ресурс InitialBudgetItem.
GET	/initial-budget-items/{id}	Отримує ресурс InitialBudgetItem.
PATCH	/initial-budget-items/{id}	Оновлює ресурс InitialBudgetItem.
DELETE	/initial-budget-items/{id}	Видаляє ресурс InitialBudgetItem.

Поля схеми

Поле	Тип	Опис
id	string
name	string
plannedAmount	stringnull
tagDefinition	string,null (iri-reference)
unit	stringnull
quantity	stringnull
sortOrder	integer

Період бюджету

Endpoints

GET	/budget-periods	Отримує колекцію ресурсів BudgetPeriod.
POST	/budget-periods	Створює ресурс BudgetPeriod.
GET	/budget-periods/{id}	Отримує ресурс BudgetPeriod.
PATCH	/budget-periods/{id}	Оновлює ресурс BudgetPeriod.
DELETE	/budget-periods/{id}	Видаляє ресурс BudgetPeriod.

Поля схеми

Поле	Тип	Опис
id	string
periodKey	string
baseAmount	stringnull
linearGrowth	stringnull
exponentialGrowthBps	integernull
unitGrowth	stringnull
plannedIncome	stringnull

Працівник бюджету

Endpoints

GET	/budget-employees	Отримує колекцію ресурсів BudgetEmployee.
POST	/budget-employees	Створює ресурс BudgetEmployee.
GET	/budget-employees/{id}	Отримує ресурс BudgetEmployee.
PATCH	/budget-employees/{id}	Оновлює ресурс BudgetEmployee.
DELETE	/budget-employees/{id}	Видаляє ресурс BudgetEmployee.

Поля схеми

Поле	Тип	Опис
id	string
budget*	object
employee*	string (iri-reference)
position	string
positionName	string

Договір бюджету

Endpoints

GET	/budget-contracts	Отримує колекцію ресурсів BudgetContract.
POST	/budget-contracts	Створює ресурс BudgetContract.
GET	/budget-contracts/{id}	Отримує ресурс BudgetContract.
DELETE	/budget-contracts/{id}	Видаляє ресурс BudgetContract.

Поля схеми

Поле	Тип	Опис
id	string
contract	string (iri-reference)

Підрядник бюджету

Endpoints

GET	/budget-contractors	Отримує колекцію ресурсів BudgetContractor.
POST	/budget-contractors	Створює ресурс BudgetContractor.
GET	/budget-contractors/{id}	Отримує ресурс BudgetContractor.
DELETE	/budget-contractors/{id}	Видаляє ресурс BudgetContractor.

Поля схеми

Поле	Тип	Опис
budget*	string (iri-reference)
contractor*	string (iri-reference)

Рахунок бюджету

Endpoints

GET	/budget-invoices	Отримує колекцію ресурсів BudgetInvoice.
POST	/budget-invoices	Створює ресурс BudgetInvoice.
GET	/budget-invoices/{id}	Отримує ресурс BudgetInvoice.
DELETE	/budget-invoices/{id}	Видаляє ресурс BudgetInvoice.

Поля схеми

Поле	Тип	Опис
budget*	string (iri-reference)
invoice*	string (iri-reference)
amountNet	stringnull

Проєкт бюджету

Endpoints

GET	/budget-projects	Отримує колекцію ресурсів BudgetProject.
POST	/budget-projects	Створює ресурс BudgetProject.
GET	/budget-projects/{id}	Отримує ресурс BudgetProject.
DELETE	/budget-projects/{id}	Видаляє ресурс BudgetProject.

Поля схеми

Поле	Тип	Опис
id	string
budget*	object
project*	string (iri-reference)
createdAt	string (date-time)

Позиція діяльності бюджету

Endpoints

GET

/budget-activity

Поля схеми

Поле	Тип	Опис
type	string
state	string
direction	string
label	string
amount	number
date	stringnull

Позиція сповіщення бюджету

Endpoints

GET

/budget-alerts

Поля схеми

Поле	Тип	Опис
key	string
type	string
severity	string
title	string
description	string
period	stringnull
dismissed	boolean

Група витрат

Endpoints

GET	/cost-groups	Отримує колекцію ресурсів CostGroup.
POST	/cost-groups	Створює ресурс CostGroup.
GET	/cost-groups/{id}	Get cost group chart
PATCH	/cost-groups/{id}	Оновлює ресурс 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

Поля схеми

Поле	Тип	Опис
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

Податкове правило

Endpoints

GET	/tax-rules	Отримує колекцію ресурсів TaxRule.
POST	/tax-rules	Створює ресурс TaxRule.
GET	/tax-rules/{id}	Отримує ресурс TaxRule.
PATCH	/tax-rules/{id}	Оновлює ресурс TaxRule.
DELETE	/tax-rules/{id}	Видаляє ресурс TaxRule.

Поля схеми

Поле	Тип	Опис
id	string
country*	string (iri-reference)
taxAmount*	string

Банк

Endpoints

GET	/banks	Отримує колекцію ресурсів Bank.
POST	/banks	Створює ресурс Bank.
GET	/banks/{id}	Отримує ресурс Bank.
PATCH	/banks/{id}	Оновлює ресурс Bank.

Поля схеми

Поле	Тип	Опис
name	string
swift*	string

Вкладення транзакції

Endpoints

GET	/transaction-attachments	Отримує колекцію ресурсів TransactionAttachment.
POST	/transaction-attachments	Створює ресурс TransactionAttachment.
GET	/transaction-attachments/{id}	Отримує ресурс TransactionAttachment.
PATCH	/transaction-attachments/{id}	Оновлює ресурс TransactionAttachment.
DELETE	/transaction-attachments/{id}	Видаляє ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/apply-suggestion	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/apply-supplier-suggestion	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/approve	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/cascade-preview	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/detach	Створює ресурс TransactionAttachment.
GET	/transaction-attachments/{id}/documents	Отримує ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/manual-match	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/mark-manual-paid	Створює ресурс TransactionAttachment.
GET	/transaction-attachments/{id}/match-candidates	Отримує колекцію ресурсів TransactionAttachment.
POST	/transaction-attachments/{id}/prefill-project-allocations	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/prefill-project-allocations-by-cascade	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/prefill-project-allocations-by-meter	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/reject	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/replace-project-allocations	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/settle-without-transaction	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/submit-for-approval	Створює ресурс TransactionAttachment.
GET	/transaction-attachments/{id}/suggestions	Отримує колекцію ресурсів TransactionAttachment.
GET	/transaction-attachments/{id}/suggestions-debug	Отримує ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/suggestions/{suggestionId}/apply	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/suggestions/accept-all	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/unlink-transaction	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/unmark-manual-paid	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/unsettle-without-transaction	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/{id}/withdraw-approval	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/create	Створює ресурс TransactionAttachment.
POST	/transaction-attachments/create-base64	Створює ресурс TransactionAttachment.
GET	/transaction-attachments/pending-approval	Отримує колекцію ресурсів TransactionAttachment.
GET	/transaction-attachments/search	Отримує колекцію ресурсів TransactionAttachment.

Поля схеми

Поле	Тип	Опис
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

Позиція рахунку у вкладенні транзакції

Endpoints

POST	/transaction-attachment-invoice-lines	Створює ресурс TransactionAttachmentInvoiceLine.
PATCH	/transaction-attachment-invoice-lines/{id}	Оновлює ресурс TransactionAttachmentInvoiceLine.
DELETE	/transaction-attachment-invoice-lines/{id}	Видаляє ресурс TransactionAttachmentInvoiceLine.

Поля схеми

Поле	Тип	Опис
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)