account`¶

Ez a dokumentáció a számlakartonok lekérdezéshez használt API végpont használatát ismerteti, különös tekintettel a Power Query alkalmazásokra.

🚀 Alapinformációk¶

Szerver: https://query.dimsql.hu
URL: GET /v1/general_ledger/account
Teljes URL: https://query.dimsql.hu/v1/general_ledger/account
Content-Type: application/json
Hitelesítés: X-Token fejléc szükséges
Célja: Főkönyvi számlakarton adatok lekérdezése megadott paraméterek alapján

🔐 Hitelesítés¶

Kötelező fejléc

X-Token: [your-api-token-here]

Az API token beszerzéséhez forduljon a Dimenzió Kft. ügyfélszolgálatához.

⚡ Adatbázis paraméterek¶

Paraméter	Típus	Leírás	Példa
`company`	string	Cég azonosító	`"ceg_neve"`
`year`	integer	Üzleti év	`2025`
`db_info`	string	Adatbázis információ (pl: Készlet)	`"db_info"`

ℹ️ A db_info paramétert csak akkor szükséges megadni, ha több adatbázis van egy cégen és éven belül, pl. készlet és főkönyv külön.

⚙️ Opcionális paraméterek¶

Paraméter	Típus	Alapértelmezett	Leírás
`account_number_from`	string	min számla	Számlatartomány kezdete
`account_number_to`	string	max számla	Számlatartomány vége
`date_from`	string (YYYY-MM-DD)	-	Dátum tartomány kezdete
`date_to`	string (YYYY-MM-DD)	-	Dátum tartomány vége
`vat_period_from`	string	-	ÁFA időszak kezdete
`vat_period_to`	string	-	ÁFA időszak vége
`period_from`	string	-	Időszak kezdete
`period_to`	string	-	Időszak vége
`side`	string	`"M"`	Könyvelési oldal (Mindkettő/Tartozik/Követel)
`opening`	string	`"N"`	Nyitó tételek összehúzása (I/N)
`cancelled`	string	`"M"`	Sztornó tételek (M/I/N)
`county_code`	integer	`0`	Megye kód
`fields`	string	összes mező	Lekérdezni kívánt mezők vesszővel elválasztott listája

Mezők szűrése Alapértelmezetten az összes mező visszaadásra kerül. Ha csak bizonyos mezőkre van szükség, akkor megadható egy vesszővel elválasztott lista:

fields=naplokod,szoveg,szamlasz,tosszeg,kosszeg

💡 Power Query példák¶

Alapvető lekérdezés

let
    url = "https://query.dimsql.hu/v1/general_ledger/account",
    headers = [
        #"X-Token" = "your-api-token-here",
        #"Content-Type" = "application/json"
    ],
    queryParams = [
        company = "your-company-id-here",
        year = "2025"
    ],
    source = Json.Document(
        Web.Contents(url, [
            Headers = headers,
            Query = queryParams
        ])
    ),
    data = source[data]
in
    data

Speciális szűrésekkel

id=__span-3-1>let url = "https://query.dimsql.hu/v1/general_ledger/account", headers = [ #"X-Token" = "your-api-token-here", #"Content-Type" = "application/json" ], queryParams = [ company = "your-company-id-here", year = "2025", account_number_from = "311", account_number_to = "31599999", date_from = "2025-01-01", date_to = "2025-12-31", fields = "naplokod,szoveg,szamlasz,tosszeg,kosszeg,egyenleg" ], source = Json.Document( Web.Contents(url, [ Headers = headers, Query = queryParams ]) ), data = source[data], toTable = Table.FromList(data, Splitter.SplitByNothing(), null, null, ExtraValues.Error), expandColumns = Table.ExpandRecordColumn(toTable, "Column1", {"naplokod", "szoveg", "szamlasz", "tosszeg", "kosszeg", "egyenleg"}, {"Napló kód", "Szöveg", "Számlaszám", "Tartozik összeg", "Követel összeg", "Egyenleg"} ) in expandColumns

Adattípusok beállítása Amennyiben magyar nyelvű a környezet, átalakítás előtt szüséges a tizedes elválasztó karakterek cseréje, hogy a Power Query helyesen értelmezze a pénzügyi mezőket.

let
    // ... előző lépések ...
    replacedValue = Table.ReplaceValue(expandColumns, ".", ",",
        Replacer.ReplaceText,{"Tartozik összeg", "Követel összeg", "Egyenleg"}
    ),

let
    // ... előző lépések ...
    changedType = Table.TransformColumnTypes(replacedValue, {
        {"Tartozik összeg", Currency.Type},
        {"Követel összeg", Currency.Type},
        {"Egyenleg", Currency.Type}
    })
in
    changedType

📄 Válasz formátum¶

Sikeres válasz

{
    "success": true,
    "status": 200,
    "error": null,
    "message": "OK",
    "data": [
        {
            "naplokod": "NYT",
            "datum1": "2025-01-15",
            "idoszaknev": "2025/01",
            "naplo": 1,
            "bizszam": "BF00001",
            "szoveg": "Nyitó forgalom",
            "szamlasz": "1110",
            "szlanev": "Pénztár",
            "tosszeg": 150000.00,
            "kosszeg": 0.00,
            "egyenleg": 150000.00,
            "partner": "TESZT001",
            "teljdatum": "2025-01-15",
            "devtipus": "HUF"
            ...
        }
    ]
}

Hibás válasz

{
    "success": false,
    "status": 400,
    "error": "Missing required parameters: company and year",
    "message": "Bad Request",
    "data": null
}

❌ Hibakezelés¶

Gyakori hibaüzenetek

HTTP Kód	Hiba	Megoldás
400	Missing required parameters	Ellenőrizze a kötelező paramétereket
400	Invalid parameter: [név]	Távolítsa el az érvénytelen paramétert
401	Missing X-Token header	Adja meg az X-Token fejlécet
401	Invalid token	Ellenőrizze az API token érvényességét
500	Database connection error	Szerver oldali hiba, próbálja újra

Power Query hibakezelés

let
    url = "https://query.dimsql.hu/v1/general_ledger/account",
    headers = [#"X-Token" = "your-api-token-here"],
    queryParams = [company = "your-company-id-here", year = "2025"],

    source = try Json.Document(
        Web.Contents(url, [
            Headers = headers,
            Query = queryParams
        ])
    ) otherwise [success = false, error = "Connection failed"],

    result = if source[success] = true
        then source[data]
        else error "API Error: " & (source[error] ?? "Unknown error")
in
    result

📊 Mezők részletes leírása¶

Főbb mezők

Mező	Típus	Leírás
`naplokod`	string	Napló kódja (NYT, BNK, SZM stb.)
`datum1`	string	Kiegyenlítéskor (fizdatum), Számlánál (hatarido) (YYYY-MM-DD)
`idoszaknev`	string	Időszak neve
`idoszak`	string	Időszak
`naplo`	integer	Napló száma
`azonosito60`	string	Vevő / Szállító számla azonosítója (60 karakter hosszú)
`bizszam60`	string	Bizonylat száma (60 karakter hosszú)
`pmbizszam60`	string	Mögöttes bizonylat száma (60 karakter hosszú)
`bizszam60_korrigalt`	string	Módosított bizonylat száma (60 karakter hosszú)
`bizsorszam`	integer	Gépi bizonylat sorszám
`tsorszam`	integer	Gépi tétel sorszám
`szoveg`	string	Tétel szövege
`szamlasz`	string	Főkönyvi számla száma
`szlanev`	string	Főkönyvi számla neve
`ellszla`	string	Ellenszámla
`ellszla_nev`	string	Ellenszámla megnevezése
`tosszeg`	decimal	Tartozik összeg
`kosszeg`	decimal	Követel összeg

Partner és azonosító mezők

Mező	Típus	Leírás
`partner`	string	Partner kódja
`partner_nev`	string	Partner neve
`padoszam`	string	Partner adószáma

Dátum mezők

Mező	Típus	Leírás
`teljdatum`	string	Teljesítés dátuma
`hatarido`	string	Határidő
`fizdatum`	string	Fizetés dátuma
`gedatum`	string	Bizonylat / Gazdasági esemény dátuma

Deviza mezők

Mező	Típus	Leírás
`devtipus`	string	Deviza típusa
`devosszeg`	decimal	Deviza összeg
`dtosszeg`	decimal	Deviza tartozik összeg
`dkosszeg`	decimal	Deviza követel összeg
`detossz`	decimal	Deviza összes tartozik forgalom
`dekossz`	decimal	Deviza összes követel forgalom
`degyenossz`	decimal	Deviza egyenleg

Egyéb mezők

Mező	Típus	Leírás
`szamla567`	string	567-es számla
`tipus`	string	Tétel típusa
`altkod`	string	Általános gyűjtő kód
`mszam1`	string	Munkaszám 1
`mszam2`	string	Munkaszám 2
`ktgkod`	string	Költséghely kód
`ertkod`	string	Értékesítési kód
`menny1`	decimal	Mennyiség 1
`menny2`	decimal	Mennyiség 2
`egyenossz`	decimal	Számla egyenlege
`etossz`	decimal	Összes tartozik forgalom
`ekossz`	decimal	Összes követel forgalom
`rogzito`	string	Rögzítő
`rogzdatum`	string	Rögzítés dátuma
`ret_megyekod`	string	Területi kód

Kompatibilitás miatt meghagyott mezők

Mező	Típus	Leírás
`bizszam`	string	Bizonylat száma
`azonosito`	string	Vevő / Szállító számla azonosítója
`pmbizszam`	string	Mögöttes bizonylat száma
`egyenleg`	decimal	Számla folyó egyenlege

🔧 Tippek Power Query használathoz¶

1. Teljesítmény optimalizáció

Használja a fields paramétert csak a szükséges mezők lekérdezéséhez
Szűkítse a dátum tartományokat amikor lehetséges
Használja a számlaszám tartomány szűrést nagy adatmennyiségnél

2. Adatfrissítés

Állítsa be az automatikus frissítést az aktuális adatokhoz
Használjon relatív dátumokat (pl. aktuális év) dinamikus lekérdezésekhez

3. Hibakezelés

Mindig alkalmazzon try-otherwise konstrukciót
Ellenőrizze a success mezőt a válaszban
Loggolja a hibákat troubleshooting céljából

📞 Támogatás¶

További kérdések esetén keresse a Dimenzió Kft. ügyfélszolgálatát az iroda@dimenzio-kft.hu e-mail címen.

📅 Utolsó frissítés: 2025-07-22 | 📝 Verzió: 1.0.0 | 👥 Fejlesztette: Dimenzió Kft.

🔌 /v1/general_ledger/account¶