Головна › Бібліотека › Коректування балансу › Коректування постачальників послуг

Коректування балансу постачальників послуг

Що таке коректування балансу постачальників послуг?

Коректування балансу постачальників послуг - це механізм для виправлення помилок у розрахунках з постачальниками комунальних послуг (електрика, газ, вода, інтернет тощо). Коректування може бути як позитивним (додаткове нарахування), так і негативним (зменшення боргу або компенсація).

Коли потрібно коректування?

  • Постачальник помилково нарахував більшу суму
  • Виявлено недоплату через помилку в показниках лічильника
  • Лічильник працював некоректно і потрібен перерахунок
  • Надано компенсацію за низьку якість послуг
  • Узгоджено знижку або бонус від постачальника

Поля коректування

Дата коректування

Дата, на яку виконується коректування

Постачальник послуг

Постачальник послуг, для якого виконується коректування

Сума

Сума коректування: негативна для зменшення боргу (компенсація), позитивна для додаткового нарахування

Валюта

Валюта суми коректування

Примітки

Опис причини коректування (необов'язкове поле)

Витрата (необов'язково)

Зв'язок з конкретною витратою (необов'язкове поле)

Договір (необов'язково)

Зв'язок з договором (необов'язкове поле)

Підтвердження коректувань

Коректування може бути підтверджено як орендодавцем, так і орендарем. Повне підтвердження отримується тільки після підтвердження обома сторонами.

Статуси підтвердження

Очікує підтвердження

Очікує підтвердження від обох сторін

Підтверджено орендодавцем

Підтверджено орендодавцем, очікує підтвердження орендарем

Підтверджено орендарем

Підтверджено орендарем, очікує підтвердження орендодавцем

Повністю підтверджено

Повністю підтверджено обома сторонами

REST API

API дозволяє керувати коректуваннями балансу програмно. Нижче наведені доступні ендпоінти з прикладами запитів та відповідей.

Примітка рівня обслуговування

GET /api/v1/properties/{id}/adjustments

Отримати список усіх коректувань балансу для об'єкта

Параметри запиту

  • page (необов'язково) - Номер сторінки (за замовчуванням: 1)
  • limit (необов'язково) - Кількість елементів на сторінці (за замовчуванням: 20, максимум: 100)

Приклад запиту

curl -X GET "https://landlordkeeper.com/api/v1/properties/1/adjustments?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

Приклад відповіді

{
  "items": [
    {
      "id": 1,
      "adjustment_date": "2026-01-28",
      "amount": -150.50,
      "currency": {
        "id": 1,
        "code": "EUR",
        "symbol": "€"
      },
      "service_provider": {
        "id": 3,
        "name": "Electric Company"
      },
      "notes": "Overbilling correction",
      "status": "fully_confirmed",
      "is_confirmed_by_landlord": true,
      "is_confirmed_by_tenant": true,
      "documents_count": 2,
      "created_at": "2026-01-28T10:30:00+00:00",
      "created_by": {
        "id": 5,
        "name": "John Landlord"
      }
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}

POST /api/v1/properties/{id}/adjustments

Створити нове коректування балансу

Тіло запиту

{
  "adjustment_date": "2026-01-28",
  "service_provider_id": 3,
  "amount": -150.50,
  "currency_id": 1,
  "notes": "Overbilling correction for January",
  "property_expense_id": 15,
  "contract_id": 5
}

Приклад відповіді

{
  "id": 1,
  "message": "Adjustment created successfully"
}

GET /api/v1/properties/{id}/adjustments/{aid}

Отримати детальну інформацію про коректування

Приклад відповіді

{
  "id": 1,
  "adjustment_date": "2026-01-28",
  "amount": -150.50,
  "currency": {
    "id": 1,
    "code": "EUR",
    "symbol": "€"
  },
  "service_provider": {
    "id": 3,
    "name": "Electric Company"
  },
  "notes": "Overbilling correction",
  "status": "fully_confirmed",
  "is_confirmed_by_landlord": true,
  "landlord_confirmed_by": {
    "id": 5,
    "name": "John Landlord"
  },
  "landlord_confirmed_at": "2026-01-28T11:00:00+00:00",
  "is_confirmed_by_tenant": true,
  "tenant_confirmed_by": {
    "id": 8,
    "name": "Jane Tenant"
  },
  "tenant_confirmed_at": "2026-01-28T12:00:00+00:00",
  "property_expense": {
    "id": 15,
    "name": "Electricity"
  },
  "contract": {
    "id": 5,
    "name": "Service Contract #5"
  },
  "documents": [
    {
      "id": 19,
      "original_name": "invoice_correction.pdf",
      "file_size": 245678,
      "comment": "Corrected invoice",
      "created_at": "2026-01-28T10:35:00+00:00"
    }
  ],
  "created_at": "2026-01-28T10:30:00+00:00",
  "created_by": {
    "id": 5,
    "name": "John Landlord"
  }
}

PUT /api/v1/properties/{id}/adjustments/{aid}

Оновити існуюче коректування

Тіло запиту

{
  "adjustment_date": "2026-01-29",
  "amount": -180.00,
  "notes": "Updated correction amount"
}

Приклад відповіді

{
  "message": "Adjustment updated successfully"
}

DELETE /api/v1/properties/{id}/adjustments/{aid}

Видалити коректування

Приклад відповіді

{
  "message": "Adjustment deleted successfully"
}

POST /api/v1/properties/{id}/adjustments/{aid}/documents

Прикріпити документ до коректування

Тіло запиту

{
  "document_id": 42,
  "comment": "Invoice copy"
}

Приклад відповіді

{
  "message": "Document attached successfully"
}

DELETE /api/v1/properties/{id}/adjustments/{aid}/documents/{did}

Відкріпити документ від коректування

Приклад відповіді

{
  "message": "Document detached successfully"
}

POST /api/v1/properties/{id}/adjustments/{aid}/confirm-landlord

Підтвердити коректування від імені орендодавця

Приклад відповіді

{
  "message": "Confirmed by landlord",
  "status": "confirmed_by_landlord"
}

POST /api/v1/properties/{id}/adjustments/{aid}/confirm-tenant

Підтвердити коректування від імені орендаря

Приклад відповіді

{
  "message": "Confirmed by tenant",
  "status": "fully_confirmed"
}

Приклади використання

Сценарій 1: Переплата за електрику

Постачальник електроенергії нарахував 200 EUR, але після перевірки виявилось, що має бути 150 EUR. Потрібно зробити коректування на -50 EUR.

  1. Створити коректування з сумою -50 EUR
  2. Вказати постачальника "Електрична компанія" та прикріпити документ-підтвердження
  3. Орендодавець підтверджує коректування
  4. Орендар підтверджує коректування - статус стає "Повністю підтверджено"

Сценарій 2: Компенсація за перебої в обслуговуванні

Інтернет-провайдер надав знижку 30 EUR за перебої в роботі мережі протягом місяця.

  1. Створити коректування з сумою -30 EUR
  2. Вказати причину "Компенсація за перебої в роботі мережі"
  3. Підтвердити обома сторонами