Opłaty za media

Czym są opłaty za media?

Opłaty za media pozwalają śledzić koszty usług: energii elektrycznej, wody, gazu, ogrzewania, internetu i innych wydatków związanych z nieruchomością. Każdy wydatek jest powiązany z typem wydatku i może mieć wiele liczników do automatycznego śledzenia zużycia.

Przepływ pracy: Typy wydatków → Opłaty

Ceny strefowe

System taryfowy wielostrefowy umożliwia ustawianie różnych cen dla różnych okresów czasu:

Jak skonfigurować

Tworzenie opłat

Opłaty oparte na licznikach tworzone są automatycznie lub ręcznie:

Prosta opłata

Najprostsza opcja - używanie strefy TOTAL z jedną ceną. System oblicza różnicę między poprzednim a obecnym odczytem, mnoży przez cenę i tworzy jedną opłatę.

Przykład

Period: January 1-31, 2026
Service: Internet
Quantity: 1 unit
Price: €45.00 per unit
Total: €45.00

Opłata wielostrefowa

Dla liczników z różnymi strefami taryfowymi (dzień/noc lub szczyt/półszczyt/noc) system tworzy oddzielne pozycje opłaty dla każdej strefy. To dokładnie odzwierciedla zużycie po różnych taryfach.

• Licznik
• Odczyty
• Zużycie
• Cena
• Kwota

Przykład

Counter: Main meter (two-zone)
Period: January 1-31, 2026

Item 1 - DAY zone:
Previous reading: 500.00 kWh
Current reading: 600.00 kWh
Consumption: 100.00 kWh
Price: €0.15 per kWh
Amount: €15.00

Item 2 - NIGHT zone:
Previous reading: 200.00 kWh
Current reading: 250.00 kWh
Consumption: 50.00 kWh
Price: €0.08 per kWh
Amount: €4.00

Total charge: €19.00

Odczyty liczników

Odczyty liczników są podstawą do automatycznego obliczania opłat:

Ręczne tworzenie opłat (UI)

Dla wydatków z typem zużycia "W miarę występowania" lub okresem obliczeniowym "MANUAL" możesz tworzyć opłaty ręcznie przez interfejs webowy.

Automatyczne generowanie

System może automatycznie tworzyć opłaty za media na podstawie odczytów liczników:

Okresy obliczeniowe

Okresy obliczeniowe

Okres obliczeniowy określa, jak często tworzone są opłaty:

Zarządzanie dokumentami

Dokumenty można dołączać na dwóch poziomach w module wydatków, każdy z nich służy innemu celowi:

REST API

Główne punkty końcowe API dla wydatków na media:

Uwaga dotycząca warstwy usługowej

API typów wydatków

GET    /api/v1/properties/{propertyId}/expenses              # List expenses
POST   /api/v1/properties/{propertyId}/expenses              # Create expense
GET    /api/v1/properties/{propertyId}/expenses/{id}         # Expense details
PUT    /api/v1/properties/{propertyId}/expenses/{id}         # Update expense
DELETE /api/v1/properties/{propertyId}/expenses/{id}         # Delete expense
POST   /api/v1/properties/{propertyId}/expenses/{id}/toggle  # Toggle active/inactive
POST   /api/v1/properties/{propertyId}/expenses/refresh-all  # Refresh all charges
POST   /api/v1/properties/{propertyId}/expenses/{id}/refresh # Refresh single expense

Opłaty

GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/charges             # List charges
POST   /api/v1/properties/{propertyId}/expenses/{expenseId}/charges             # Create charge
GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/unlinked-readings   # Get unlinked readings
GET    /api/v1/properties/{propertyId}/charges/{id}                             # Charge details
PUT    /api/v1/properties/{propertyId}/charges/{id}                             # Update charge
DELETE /api/v1/properties/{propertyId}/charges/{id}                             # Delete charge
POST   /api/v1/properties/{propertyId}/charges/{id}/confirm                     # Confirm charge

API dokumentów opłat

Zarządzanie dokumentami dołączonymi do opłat za wydatki (paragony, faktury, umowy).

GET    /api/v1/properties/{propertyId}/charges/{chargeId}/documents           # List charge documents
POST   /api/v1/properties/{propertyId}/charges/{chargeId}/documents           # Upload document to charge
GET    /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Document details
PUT    /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Update document comment
DELETE /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Remove document from charge

Prześlij paragon dla opłaty za wydatki

POST /api/v1/properties/1/charges/42/documents
Content-Type: multipart/form-data
Authorization: Bearer <token>

file: (binary)
document_type_id: 1
comment: "Invoice for January 2026"

API dokumentów typu wydatku

Dołączaj, przeglądaj i zarządzaj dokumentami (umowy z kontrahentami, harmonogramy taryfowe) bezpośrednio w konfiguracji typu wydatku.

GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents           # List expense documents
POST   /api/v1/properties/{propertyId}/expenses/{expenseId}/documents           # Upload document to expense
GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Document details
PUT    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Update document comment
DELETE /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Remove document from expense

Przykład API: Prześlij dokument do typu wydatku

POST /api/v1/properties/1/expenses/3/documents
Content-Type: multipart/form-data
Authorization: Bearer <token>

file: (binary)
document_type_id: 1
comment: "Contractor agreement for heating service"

Przykład API

POST /api/v1/properties/1/expenses/3/charges
Content-Type: application/json
Authorization: Bearer <token>

{
  "charge_date": "2026-01-31",
  "period_start": "2026-01-01",
  "period_end": "2026-01-31",
  "charged_to_user_id": 5,
  "items": [
    {
      "counter_id": 5,
      "zone_code": "DAY",
      "previous_value": "500.00",
      "current_value": "600.00",
      "unit_price": "0.15"
    },
    {
      "counter_id": 5,
      "zone_code": "NIGHT",
      "previous_value": "200.00",
      "current_value": "250.00",
      "unit_price": "0.08"
    }
  ]
}

Typy wydatków

Opłaty jednorazowe

Jak to działa

1. Przejdź do strony wydatków nieruchomości
2. Kliknij przycisk "Opłata jednorazowa"
3. Wypełnij kwotę, datę, okres rozliczeniowy i opcjonalne uwagi
4. Opłata zostanie automatycznie utworzona i oznaczona jako potwierdzona

Charakterystyka

• Typ zużycia: Według zużycia
• Jednostka: opłaty
• Specjalny znacznik: Kod typu wydatku ONE_TIME (nie dostawca — nie jest on wyświetlany dla tego kontenera)
• Widoczność: Ukryte na regularnych listach wydatków
• Automatyczne tworzenie opłat: Nie - opłaty tworzone tylko ręcznie

Trasy

Ta trasa to formularz sesji WWW (wymaga logowania i tokenu CSRF), a nie wywołanie API JSON z tokenem bearer.

Pola formularza

• Data* — Data wystąpienia wydatku
• Okres rozliczeniowy* — Wybierz okres rozliczeniowy dla celów księgowych
• Kwota* — Całkowita kwota do naliczenia (wymagane)
• Uwagi — Opcjonalny opis lub wyjaśnienie