IngatlanLulu API

API hozzáférés

Az API kulcsok portfólióhoz tartoznak. Kulcsot a Portfólió menü Beállítások részében, az API hozzáférés oldalon lehet létrehozni és visszavonni.

Hitelesítés

A kérésekhez add át az API kulcsot Bearer tokenként vagy az X-API-Key fejlécben. 

Authorization: Bearer ilulu_YOUR_API_KEY

Elérhető végpontok

MetódusVégpontLeírás
GET/Api/RealEstatesA kulcshoz tartozó portfólió aktív ingatlanjainak listája.
GET/Api/UtilityProvidersA kulcshoz tartozó portfólió közmű szolgáltató partnereinek listája.
GET/Api/ClocksA kulcshoz tartozó portfólió mérőóráinak listája.
GET/Api/ClockTimesEgy mérőórához tartozó óraállások listája.
GET/Api/ContractsA kulcshoz tartozó portfólió szerződéseinek listája.
GET/Api/ReceivablesA kulcshoz tartozó portfólió aktuális kintlévőségeinek listája.
GET/Api/FeeAssignmentsA kulcshoz tartozó portfólió aktuális díjkiírásainak listája.
GET/Api/PaymentsA kulcshoz tartozó portfólió befizetéseinek listája.
GET/Api/PayoutsA kulcshoz tartozó portfólió kifizetéseinek listája.
GET/Api/ProfileInvoicesA kulcshoz tartozó portfólió bizonylatainak listája.
GET/Api/ProfileInvoices/{id}/PdfEgy bizonylathoz tartozó generált számlakép PDF letöltése.

Ingatlan lista

URL
https://ingatlanlulu.hu/Application/Api/RealEstates
Query paraméterek
withImages és isArchived opcionális logikai értékek.

Közmű szolgáltatók

URL
https://ingatlanlulu.hu/Application/Api/UtilityProviders
Query paraméterek
realEstateId opcionális szűrő. Ha nincs megadva, a teljes portfólió Utility szerepkörű partnereit adja vissza.

Mérőórák és óraállások

Mérőórák URL
https://ingatlanlulu.hu/Application/Api/Clocks
Óraállások URL
https://ingatlanlulu.hu/Application/Api/ClockTimes
Mérőóra query paraméterek
realEstateId és subInsetId opcionális szűrők.
Óraállás query paraméterek
clockId kötelező mérőóra azonosító.

Szerződések

URL
https://ingatlanlulu.hu/Application/Api/Contracts
Query paraméterek
realEstateId, partnerId, contractType és name opcionális szűrők.

Kintlévőségek listája

URL
https://ingatlanlulu.hu/Application/Api/Receivables
Query paraméterek
startDate és endDate opcionális dátum értékek. Ha nincs endDate, az aktuális napig listáz.

Díjkiírások listája

URL
https://ingatlanlulu.hu/Application/Api/FeeAssignments
Query paraméterek
realEstateId, feeTypeId, partnerId, fromIssueDate és toIssueDate opcionális szűrők.

Be- és kifizetések listája

Befizetések URL
https://ingatlanlulu.hu/Application/Api/Payments
Kifizetések URL
https://ingatlanlulu.hu/Application/Api/Payouts
Query paraméterek
realEstateId, partnerId, budgetId, fromDate, toDate, method, currency, referenceNumber, note, amount, year és month opcionális szűrők.

Bizonylatok

Lista URL
https://ingatlanlulu.hu/Application/Api/ProfileInvoices
PDF URL
https://ingatlanlulu.hu/Application/Api/ProfileInvoices/{id}/Pdf
Lista query paraméterek
realEstateId, paymentId, payoutId, partnerId, status, invoiceNumber, paymentMode, amountMin, amountMax, currency, invoiceType, dátum szűrők, generationResult, fileId és hasFile opcionális szűrők.

Példa válaszok

GET /Api/RealEstates

{
  "realEstates": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Minta lakas",
      "realEstateCustomId": "RE-001",
      "postalCode": "1051",
      "city": "Budapest",
      "streetAddress": "Minta utca 1.",
      "building": "A",
      "level": "2",
      "door": "5",
      "parcelNumber": "12345/6",
      "plotArea": 850,
      "plotAreaType": "m2",
      "floorArea": 62,
      "realEstateType": "Flat",
      "imageBase64": null,
      "profileImageUrl": "https://ingatlanlulu.hu/images/real-estates/11111111-1111-1111-1111-111111111111.jpg",
      "profileType": "Own",
      "underMove": false,
      "isArchived": false,
      "customFields": []
    }
  ]
}

GET /Api/UtilityProviders

{
  "utilityProviders": [
    {
      "id": "22222222-2222-2222-2222-222222222222",
      "name": "Minta Kozmu Zrt.",
      "email": "ugyfelszolgalat@example.com",
      "phone": "+36 1 234 5678",
      "role": "Utility",
      "taxNumber": "12345678-2-41",
      "postalCode": "1133",
      "city": "Budapest",
      "streetAddress": "Szolgaltato utca 10."
    }
  ]
}

GET /Api/Clocks

{
  "clocks": [
    {
      "id": "33333333-3333-3333-3333-333333333333",
      "profileId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "realEstateId": "11111111-1111-1111-1111-111111111111",
      "subInsetId": null,
      "clockType": "Electricity",
      "clockDirection": "Consumption",
      "reportedToProviderNeeded": true,
      "name": "Villanyora",
      "clockNumber": "EL-123456",
      "reportedMonths": "1,2,3,4,5,6,7,8,9,10,11,12",
      "reportedFromDay": 1,
      "reportedToDay": 10,
      "isDismounted": false,
      "dismountedAt": null,
      "feePerUnit": 70.5,
      "feeBase": 0,
      "feeCurrency": "HUF",
      "monthlyWarningLimit": 250,
      "monthlyAlertLimit": 400,
      "latestClockTime": {
        "id": "44444444-4444-4444-4444-444444444444",
        "clockId": "33333333-3333-3333-3333-333333333333",
        "readAt": "2026-06-01T00:00:00",
        "clockTime": 12450,
        "reportedToProvider": false
      }
    }
  ]
}

GET /Api/ClockTimes

{
  "clockTimes": [
    {
      "id": "44444444-4444-4444-4444-444444444444",
      "clockId": "33333333-3333-3333-3333-333333333333",
      "fileId": null,
      "readAt": "2026-06-01T00:00:00",
      "clockTime": 12450,
      "tags": "monthly",
      "feePerUnit": 70.5,
      "feeCurrency": "HUF",
      "calculatedAmount": 180,
      "calculatedFee": 12690,
      "calculatedPreviousReadAt": "2026-05-01T00:00:00",
      "calculatedDays": 31,
      "createdAt": "2026-06-01T09:15:00",
      "updatedAt": null,
      "reportedToProvider": false
    }
  ]
}

GET /Api/Contracts

{
  "contracts": [
    {
      "contract": {
        "id": "55555555-5555-5555-5555-555555555555",
        "name": "Berleti szerzodes",
        "contractType": "Rental",
        "status": "Active",
        "profileId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "realEstateId": "11111111-1111-1111-1111-111111111111",
        "signingDate": "2026-01-15",
        "effectiveDate": "2026-02-01",
        "expirationDate": "2027-01-31",
        "terminationDate": null,
        "feeAmount": 240000,
        "feeCurrency": "HUF",
        "feeFrequency": "Monthly",
        "paymentMethod": "BankTransfer",
        "depositAmount": 480000,
        "primaryLanguage": "hu",
        "createdAt": "2026-01-15T10:30:00",
        "updatedAt": null
      },
      "parties": [
        {
          "id": "66666666-6666-6666-6666-666666666666",
          "contractId": "55555555-5555-5555-5555-555555555555",
          "partnerId": "77777777-7777-7777-7777-777777777777",
          "partnerName": "Minta Berlo",
          "partyType": "Tenant",
          "role": "Tenant"
        }
      ],
      "reminders": [],
      "files": []
    }
  ]
}

GET /Api/Receivables

{
  "dueIncomesByPartners": [
    {
      "partnerId": "77777777-7777-7777-7777-777777777777",
      "partnerName": "Minta Berlo",
      "totalDueAmount": 240000,
      "feeAssignments": [
        {
          "id": "88888888-8888-8888-8888-888888888888",
          "partnerId": "77777777-7777-7777-7777-777777777777",
          "partnerName": "Minta Berlo",
          "status": "Open",
          "issueDate": "2026-06-01",
          "dueDate": "2026-06-10",
          "amount": 240000,
          "currency": "HUF"
        }
      ]
    }
  ],
  "dueCostsByPartners": []
}

GET /Api/FeeAssignments

{
  "feeAssignments": [
    {
      "id": "88888888-8888-8888-8888-888888888888",
      "partnerId": "77777777-7777-7777-7777-777777777777",
      "partnerName": "Minta Berlo",
      "utilityId": null,
      "utilityName": null,
      "subInsetId": null,
      "feeTypeId": "99999999-9999-9999-9999-999999999999",
      "realEstateId": "11111111-1111-1111-1111-111111111111",
      "budget": {
        "id": "12121212-1212-1212-1212-121212121212",
        "name": "2026"
      },
      "status": "Open",
      "issueDate": "2026-06-01",
      "dueDate": "2026-06-10",
      "amount": 240000,
      "currency": "HUF",
      "isManual": false,
      "note": "Juniusi berleti dij",
      "hasProforma": false,
      "proformaFileId": null,
      "feeType": {
        "id": "99999999-9999-9999-9999-999999999999",
        "name": "Berleti dij"
      },
      "paymentAllocations": [],
      "payoutAllocations": []
    }
  ]
}

GET /Api/Payments

{
  "payments": [
    {
      "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "payerPartnerId": "77777777-7777-7777-7777-777777777777",
      "partnerName": "Minta Berlo",
      "realEstateId": "11111111-1111-1111-1111-111111111111",
      "utilityId": null,
      "utilityName": null,
      "paymentDate": "2026-06-05",
      "method": "BankTransfer",
      "amount": 240000,
      "currency": "HUF",
      "referenceNumber": "TRX-2026-0001",
      "note": "Juniusi berleti dij",
      "paymentAllocations": [
        {
          "feeAssignmentId": "88888888-8888-8888-8888-888888888888",
          "amount": 240000
        }
      ],
      "bankTransaction": null,
      "hasInvoice": true,
      "invoiceFileId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
    }
  ]
}

GET /Api/Payouts

{
  "payouts": [
    {
      "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
      "payeePartnerId": "22222222-2222-2222-2222-222222222222",
      "partnerName": "Minta Kozmu Zrt.",
      "realEstateId": "11111111-1111-1111-1111-111111111111",
      "utilityId": "22222222-2222-2222-2222-222222222222",
      "utilityName": "Minta Kozmu Zrt.",
      "payoutDate": "2026-06-12",
      "method": "BankTransfer",
      "amount": 18500,
      "currency": "HUF",
      "referenceNumber": "OUT-2026-0001",
      "note": "Villanyszamla",
      "payoutAllocations": [
        {
          "feeAssignmentId": "dddddddd-dddd-dddd-dddd-dddddddddddd",
          "amount": 18500
        }
      ],
      "bankTransaction": null
    }
  ]
}

GET /Api/ProfileInvoices

{
  "profileInvoices": [
    {
      "id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
      "profileId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "realEstateId": "11111111-1111-1111-1111-111111111111",
      "partnerId": "77777777-7777-7777-7777-777777777777",
      "paymentId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "advancePaymentId": null,
      "profileInvoiceProviderId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
      "referenceProfileInvoiceId": null,
      "feeAssignmentIds": [
        "88888888-8888-8888-8888-888888888888"
      ],
      "isProforma": false,
      "isPaid": true,
      "status": "Generated",
      "invoiceNumber": "LULU-2026-0001",
      "invoiceName": "Minta Berlo",
      "invoiceType": "Invoice",
      "currency": "HUF",
      "paymentMode": "BankTransfer",
      "amount": 240000,
      "amountNet": 188976.38,
      "amountVat": 51023.62,
      "amountGross": 240000,
      "invoiceDate": "2026-06-05",
      "completionDate": "2026-06-05",
      "paymentDeadlineDate": "2026-06-12",
      "invoiceCountry": "HU",
      "invoiceCity": "Budapest",
      "invoicePostalCode": "1051",
      "invoiceStreetAddress": "Minta utca 1.",
      "invoiceHutaxNumber": null,
      "invoiceNote": "Koszonjuk a fizetest.",
      "cultureKey": "hu-HU",
      "validationErrors": null,
      "generationResult": "Success",
      "generatedAt": "2026-06-05T11:20:00",
      "isNotificationSent": true,
      "notificationSentAt": "2026-06-05T11:25:00",
      "createdAt": "2026-06-05T11:10:00",
      "updatedAt": null,
      "fileId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "hasFile": true,
      "items": [
        {
          "id": "abababab-abab-abab-abab-abababababab",
          "profileInvoiceId": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
          "feeAssignmentId": "88888888-8888-8888-8888-888888888888",
          "productCode": "RENT",
          "itemName": "Berleti dij",
          "itemNote": "2026. junius",
          "netUnitPrice": 188976.38,
          "vatpercent": 27,
          "grossUnitPrice": 240000,
          "quantity": 1,
          "netPrice": 188976.38,
          "vat": 51023.62,
          "grossPrice": 240000
        }
      ]
    }
  ]
}

GET /Api/ProfileInvoices/{id}/Pdf

Content-Type: application/pdf
Content-Disposition: attachment; filename="LULU-2026-0001.pdf"

%PDF-1.7
...

Példa kérések

Ingatlan lista cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/RealEstates" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Közmű szolgáltatók cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/UtilityProviders" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Mérőórák cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/Clocks" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Óraállások cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/ClockTimes?clockId=CLOCK_ID" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Szerződések cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/Contracts" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Kintlévőségek cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/Receivables" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Díjkiírások cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/FeeAssignments" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Befizetések cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/Payments" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Kifizetések cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/Payouts" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Bizonylatok cURL

curl -X GET "https://ingatlanlulu.hu/Application/Api/ProfileInvoices" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY"

Bizonylat PDF cURL

curl -L "https://ingatlanlulu.hu/Application/Api/ProfileInvoices/{id}/Pdf" \
  -H "Authorization: Bearer ilulu_YOUR_API_KEY" \
  -o invoice.pdf

JavaScript

const response = await fetch('https://ingatlanlulu.hu/Application/Api/ProfileInvoices', {
  headers: {
    Authorization: 'Bearer ilulu_YOUR_API_KEY'
  }
});

const data = await response.json();