9 Bilanse początkowe
Wprowadź zaległe długi i nadpłaty najemcy oraz dostawców usług na dzień startu — w przeciwnym razie historia płatności i naliczeń będzie niekompletna.
Dlaczego to ważne
Jeśli podłączasz nieruchomość, która była już wynajmowana — na dzień startu prawdopodobnie masz nierozliczone długi lub nadpłaty w czterech scenariuszach:
- Najemca jest ci winien za poprzednie okresy (zaległy czynsz, media, rekompensaty).
- Najemca wpłacił zaliczkę lub nadpłacił — kwota zostanie zaliczona na poczet przyszłych naliczeń.
- Jesteś winien dostawcy usług (prąd, woda, gaz, internet) za poprzednie okresy.
- U dostawcy usług masz nadpłatę — pomniejszy przyszłe rachunki.
Rozliczenia z najemcą
Formularz znajduje się w karcie nieruchomości → «Rozliczenia z najemcą» → «Dodaj». Podaj kwotę, kierunek (najemca winien wynajmującemu / wynajmujący winien najemcy) oraz datę, do której odnosi się dług. W razie potrzeby dołącz dokument potwierdzający. Najemca może później potwierdzić wpis ze swojej strony — wtedy trafia on do wspólnego bilansu bez dodatkowych działań.
Rozliczenia z dostawcami usług
Formularz znajduje się w karcie nieruchomości → «Rozliczenia z dostawcami» → «Dodaj». Wybierz dostawcę, podaj kwotę, kierunek (właściciel winien dostawcy / dostawca winien właścicielowi) i datę. W razie potrzeby dołącz skan wyciągu lub faktury. Korekta jest natychmiast uwzględniana w bilansie nieruchomości — zwiększa lub zmniejsza twój dług wobec tego dostawcy w stosunku do tego, co system wylicza z odczytów liczników.
Dla programistów: REST API
Do integracji i masowego importu danych udostępniamy końcówki REST. Obie zwracają pełny utworzony rekord — zachowaj `id` do dalszych operacji (potwierdzenie, załączenie dokumentu).
POST Utwórz rozliczenie właściciel–najemca
▶Tworzy korektę bilansu między właścicielem a najemcą nieruchomości. Kierunek `tenant_owes_landlord` — najemca winien tobie; `landlord_owes_tenant` — ty winien najemcy. `occurred_at` określa, do jakiego okresu należy wpis.
POST /api/v1/properties/{id}/lt-adjustments
Nagłówki:
Authorization: Bearer {token}
Content-Type: application/json
Treść żądania:
{
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01",
"note": "Стартовая задолженность арендатора на дату подключения"
}
Odpowiedź (201 Created):
{
"message": "Landlord-tenant adjustment created",
"data": {
"id": "01H8...",
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01"
}
}
POST Utwórz rozliczenie z dostawcą usług
▶Tworzy korektę bilansu między właścicielem a wskazanym dostawcą usług. Kierunek `landlord_owes_provider` — jesteś winien dostawcy; `provider_owes_landlord` — dostawca jest winien tobie. `service_provider_id` to wymagane `id` dostawcy ze słownika nieruchomości.
POST /api/v1/properties/{id}/adjustments
Nagłówki:
Authorization: Bearer {token}
Content-Type: application/json
Treść żądania:
{
"service_provider_id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01",
"note": "Долг за электроэнергию до подключения"
}
Odpowiedź (201 Created):
{
"message": "Service provider adjustment created",
"data": {
"id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01"
}
}
Przykłady cURL
▶1. Utwórz rozliczenie właściciel–najemca
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. Utwórz rozliczenie z dostawcą usług
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"
}'