card_list`¶

Ez a dokumentáció a készlet karton lista 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/stock/card_list
Teljes URL: https://query.dimsql.hu/v1/stock/card_list
Content-Type: application/json
Hitelesítés: X-Token fejléc szükséges
Célja: Készlet karton lista 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	Kötelező
`company`	string	Cég azonosító	`"ceg_neve"`	Igen
`year`	integer	Üzleti év	`2025`	Igen
`db_info`	string	Adatbázis információ (pl: Készlet)	`"db_info"`	Nem

ℹ️ 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
`date_from`	string (YYYY-MM-DD)	-	Dátum tartomány kezdete
`date_to`	string (YYYY-MM-DD)	-	Dátum tartomány vége
`item_group_from`	string	-	Cikkcsoport tartomány kezdete
`item_group_to`	string	-	Cikkcsoport tartomány vége
`item_number_from`	string	-	Cikkszám tartomány kezdete
`item_number_to`	string	-	Cikkszám tartomány vége
`movement_name_from`	string	-	Mozgás név tartomány kezdete
`movement_name_to`	string	-	Mozgás név tartomány vége
`movement_type_from`	string	-	Mozgás típus tartomány kezdete
`movement_type_to`	string	-	Mozgás típus tartomány vége
`warehouse`	string	-	Raktár azonosító
`gl_account_from`	string	-	Főkönyvi számla tartomány kezdete
`gl_account_to`	string	-	Főkönyvi számla tartomány vége
`show_zero_quantity`	string	`"N"`	Nulla mennyiségű tételek mutatása (I/N)
`use_positional_search`	string	`"N"`	Pozicionális keresés használata (I/N)
`inactive_items`	integer	`1`	Inaktív cikkek belefoglalása (0/1)
`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=cikksz,cikknev,menny,ar,osszeg

💡 Power Query példák¶

Alapvető lekérdezés

id=__span-2-1>let url = "https://query.dimsql.hu/v1/stock/card_list", headers = [ #"X-Token" = "your-api-token-here", #"Content-Type" = "application/json" ], queryParams = [ company = "your-company-id-here", year = "2025", db_info = "your-db-info-here-if-needed" ], source = Json.Document( Web.Contents(url, [ Headers = headers, Query = queryParams ]) ), data = source[data] in data

Speciális szűrésekkel

let
    url = "https://query.dimsql.hu/v1/stock/card_list",
    headers = [
        #"X-Token" = "your-api-token-here",
        #"Content-Type" = "application/json"
    ],
    queryParams = [
        company = "your-company-id-here",
        year = "2025",
        date_from = "2025-01-01",
        date_to = "2025-12-31",
        item_group_from = "A",
        item_group_to = "Z",
        show_zero_quantity = "N",
        fields = "cikksz,cikknev,menny,ar,osszeg,mnev"
    ],
    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",
        {"cikksz", "cikknev", "menny", "ar", "osszeg", "mnev"},
        {"Cikkszám", "Cikk neve", "Mennyiség", "Ár", "Összeg", "Mozgás neve"}
    )
in
    expandColumns

Adattípusok beállítása Amennyiben magyar nyelvű a környezet, átalakítás előtt szüksé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,{"Mennyiség", "Ár", "Összeg", "Kumulált mennyiség", "Kumulált összeg"}
    ),

let
    // ... előző lépések ...
    changedType = Table.TransformColumnTypes(replacedValue, {
        {"Mennyiség", Number.Type},
        {"Ár", Currency.Type},
        {"Összeg", Currency.Type},
        {"Kumulált mennyiség", Number.Type},
        {"Kumulált összeg", Currency.Type}
    })
in
    changedType

📄 Válasz formátum¶

Sikeres válasz

{
    "success": true,
    "status": 200,
    "error": null,
    "message": "OK",
    "data": [
        {
            "cikksz": "ABC001",
            "cikknev": "Termék ABC",
            "rakazon": "R001",
            "bizszam": "BF00001",
            "mnev": "Beszerzés",
            "jelleg": "B",
            "menny": 100.00,
            "ar": 1500.00,
            "osszeg": 150000.00,
            "kmenny": 100.00,
            "kosszeg": 150000.00,
            "tszamla": "1510",
            "kszamla": "4540",
            "bizdatum": "2025-01-15",
            "szamla567": null,
            "altkod": null,
            "mszam1": null,
            "mszam2": null,
            "ertkod": null,
            "ktgkod": null,
            "hiv_tsorszam": null
        }
    ]
}

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/stock/card_list",
    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
`cikksz`	string	Cikkszám
`cikknev`	string	Cikk megnevezése
`rakazon`	string	Raktár azonosító
`bizszam`	string	Bizonylat száma
`bizdatum`	string	Bizonylat dátuma (YYYY-MM-DD)
`mnev`	string	Mozgás neve
`jelleg`	string	Mozgás jellege [(+) Beszerzés, (-) Eladás]
`menny`	decimal	Mennyiség
`ar`	decimal	Egységár
`osszeg`	decimal	Összeg
`kmenny`	decimal	Kumulált mennyiség
`kosszeg`	decimal	Kumulált összeg

Számla és dátum mezők

Mező	Típus	Leírás
`tszamla`	string	Tartozik számla
`kszamla`	string	Követel számla
`szamla567`	string	567-es számla

Kiegészítő mezők

Mező	Típus	Leírás
`altkod`	string	Általános gyűjtő kód
`mszam1`	string	Munkaszám 1
`mszam2`	string	Munkaszám 2
`ertkod`	string	Értékesítési kód
`ktgkod`	string	Költséghely kód
`hiv_tsorszam`	integer	Hivatkozási tétel sorszám

🔧 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 cikkcsoport és cikkszám szűrést nagy készletek esetén
Állítsa be a show_zero_quantity = "N" paramétert, ha nem szükségesek a nulla mennyiségű tételek

2. Adatfrissítés

Állítsa be az automatikus frissítést az aktuális készletadatokhoz
Használjon relatív dátumokat (pl. aktuális hónap) 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

4. Készlet specifikus tippek

A kmenny és kosszeg mezők mutatják a kumulált készletállományt
A jelleg mező segít megkülönböztetni a különböző mozgástípusokat
Készlet nyilvántartáshoz szűrje a dátumokat a lekérdezés időpontjáig

📞 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-25 | 📝 Verzió: 1.0.0 | 👥 Fejlesztette: Dimenzió Kft.

🔌 /v1/stock/card_list¶