9 Стартові взаєморозрахунки
Введіть залишки боргів та переплат по орендарю і постачальниках послуг на дату підключення — інакше історія платежів і нарахувань буде неповною.
Навіщо це потрібно
Якщо ви підключили до системи об’єкт, який здавали й раніше, — на дату старту обліку у вас, найімовірніше, є непогашені борги чи переплати за чотирма сценаріями:
- Орендар винен вам за минулі періоди (прострочена оренда, комуналка, компенсації).
- Орендар вніс аванс або переплатив — ця сума зараховується в рахунок майбутніх нарахувань.
- Ви винні постачальнику послуг (електроенергія, вода, газ, інтернет) за минулі періоди.
- У постачальника послуг «висить» ваша переплата — вона зменшить майбутні рахунки.
Взаєморозрахунки з орендарем
Форма вводу — у картці об’єкта → розділ «Взаєморозрахунки з орендарем» → «Додати». Вкажіть суму, напрямок (орендар винен вам / ви винні орендарю) та дату, до якої належить борг. За потреби прикріпіть документ-підтвердження. Пізніше орендар може підтвердити цей запис зі свого боку — тоді він потрапить у загальний баланс без додаткових дій.
Взаєморозрахунки з постачальниками послуг
Форма вводу — у картці об’єкта → розділ «Взаєморозрахунки з постачальниками» → «Додати». Оберіть постачальника, вкажіть суму, напрямок (ви винні постачальнику / постачальник винен вам) і дату. Прикріпіть скан виписки чи рахунку, якщо він є. Внесене коригування одразу враховується в балансі об’єкта — воно зменшує або збільшує ваш борг перед цим постачальником відносно того, що розраховує система за показаннями лічильників.
Для розробників: REST API
Для інтеграцій та масового перенесення даних доступні REST-ендпоінти. Обидва повертають створений запис повністю — збережіть `id` для подальших операцій (підтвердження, прикріплення документа).
POST Створити взаєморозрахунок орендодавець–орендар
▶Створює коригування балансу між орендодавцем та орендарем об’єкта. Напрямок `tenant_owes_landlord` — орендар винен вам; `landlord_owes_tenant` — ви винні орендарю. Дата `occurred_at` визначає, до якого періоду належить запис.
POST /api/v1/properties/{id}/lt-adjustments
Заголовки:
Authorization: Bearer {token}
Content-Type: application/json
Тіло запиту:
{
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01",
"note": "Стартовая задолженность арендатора на дату подключения"
}
Відповідь (201 Created):
{
"message": "Landlord-tenant adjustment created",
"data": {
"id": "01H8...",
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01"
}
}
POST Створити взаєморозрахунок з постачальником
▶Створює коригування балансу між орендодавцем та конкретним постачальником послуг. Напрямок `landlord_owes_provider` — ви винні постачальнику; `provider_owes_landlord` — постачальник винен вам. Поле `service_provider_id` — обов’язковий `id` постачальника зі списку об’єкта.
POST /api/v1/properties/{id}/adjustments
Заголовки:
Authorization: Bearer {token}
Content-Type: application/json
Тіло запиту:
{
"service_provider_id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01",
"note": "Долг за электроэнергию до подключения"
}
Відповідь (201 Created):
{
"message": "Service provider adjustment created",
"data": {
"id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01"
}
}
Приклади cURL
▶1. Створити взаєморозрахунок орендодавець–орендар
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/lt-adjustments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01",
"note": "Starting tenant debt on go-live"
}'
2. Створити взаєморозрахунок з постачальником
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/adjustments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"service_provider_id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01",
"note": "Debt to provider on go-live"
}'