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"
}'