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

Корректировки баланса поставщиков услуг

Что такое корректировки баланса поставщиков услуг?

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

Когда нужна корректировка?

  • Поставщик ошибочно начислил бóльшую сумму
  • Обнаружена недоплата из-за ошибки в показаниях счётчика
  • Счётчик работал некорректно и нужен перерасчёт
  • Предоставлена компенсация за низкое качество услуг
  • Согласована скидка или бонус от поставщика

Поля корректировки

Дата корректировки

Дата, на которую выполняется корректировка

Поставщик услуг

Поставщик услуг, для которого выполняется корректировка

Сумма

Сумма корректировки: отрицательная для уменьшения долга (компенсация), положительная для дополнительного начисления

Валюта

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

Примечания

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

Затрата (необязательно)

Связь с конкретным расходом (необязательное поле)

Договор (необязательно)

Связь с договором (необязательное поле)

Подтверждение корректировок

Корректировки могут быть подтверждены как арендодателем, так и арендатором. Полное подтверждение получается только после подтверждения обеими сторонами.

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

Ожидает подтверждения

Ожидает подтверждения от обеих сторон

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

Подтверждено арендодателем, ожидает подтверждения арендатором

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

Подтверждено арендатором, ожидает подтверждения арендодателем

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

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

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. Подтвердить обеими сторонами