API Dokumentáció

Minden, amire szükséged van a SzámlaAPI villámgyors integrálásához.

Hitelesítés (Authentication)

Az API eléréséhez szükséged lesz a titkos kulcsodra, amit az előfizetés után e-mailben kaptál meg. Ezt minden kérésnél az 'X-Client-Secret' HTTP fejlécben kell elküldened.

HTTP Header
X-Client-Secret: sec_your_secret_key_12345

Számla adatkinyerés (/extract)

Küldj be egy PDF számlát erre a végpontra, és a mesterséges intelligencia pillanatok alatt visszaadja a strukturált JSON adatokat.

cURL / Powershell:

POST Request (cURL)
curl -X POST "https://api.szamlaapi.hu/v1/extract" \
  -H "X-Client-Secret: <A_TE_TITKOS_KULCSOD>" \
  -F "file=@szamla.pdf"

Python:

Python (requests)
import requests

url = "https://api.szamlaapi.hu/v1/extract"
headers = {
    "X-Client-Secret": "A_TE_TITKOS_KULCSOD"
}
files = {
    "file": open("szamla.pdf", "rb")
}

response = requests.post(url, headers=headers, files=files)
print(response.json())

Node.js:

Node.js (Axios)
const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('file', fs.createReadStream('szamla.pdf'));

axios.post('https://api.szamlaapi.hu/v1/extract', form, {
    headers: {
        ...form.getHeaders(),
        'X-Client-Secret': 'A_TE_TITKOS_KULCSOD'
    }
}).then(response => {
    console.log(response.data);
}).catch(error => {
    console.error(error);
});

Sikeres Válasz (Response):

Response JSON
{
  "meta": {
    "task_id": "d023b922-1573-4de7-a090-156a6e1b7a0e",
    "elapsed_ms": 17818
  },
  "result": {
    "is_valid_invoice": true,
    "error_message": null,
    "document_data": {
      "invoice_number": "DPD005778/2026",
      "invoice_date": "2026-04-23",
      "due_date": "2026-04-24",
      "payment_method": "Utánvét",
      "supplier_name": "PCX Kft.",
      "supplier_address": "1046. Budapest Knézits Károly utca 4.",
      "supplier_tax_id": "23563539-2-41",
      "customer_name": "Teszt kft",
      "customer_tax_id": "1234567-2-07",
      "total_amount_due": 66070,
      "currency": "HUF",
      "line_items": [
        {
          "description": "Tenda Router WiFi AX3000...",
          "quantity": 3,
          "unit_price": 16764,
          "net_amount": 50292,
          "vat_rate": 27,
          "vat_amount": 13579,
          "gross_amount": 63871
        }
      ],
      "accounting_analysis": {
        "suggested_expense_category": null,
        "suggested_account_number": null,
        "financial_cross_check": {
          "is_math_correct": false,
          "discrepancy_details": "The sum of line item gross amounts..."
        },
        "compliance_check": {
          "is_legally_compliant": true,
          "missing_mandatory_elements": []
        }
      },
      "overall_confidence_score": 100
    }
  }
}

Egyedi Könyvelési Szabályok

Dinamikusan beállíthatsz saját szabályokat, hogy a mesterséges intelligencia milyen főkönyvi számokat vagy kategóriákat adjon vissza bizonyos beszállítóknál.

PUT Request
curl -X PUT "https://api.szamlaapi.hu/v1/settings/accounting-rules" \
  -H "X-Client-Secret: <A_TE_TITKOS_KULCSOD>" \
  -H "Content-Type: application/json" \
  -d '{ "rules": "If vendor is Telekom, then account is 521." }'

Verziótörténet (Changelog)

v1.1.2 - Security & Performance

Legújabb

Vállalati szintű biztonsági frissítések és aszinkron skálázhatóság.

  • Kőkemény biztonság: API kulcsok SHA-256 titkosítása, szigorított CORS védelem és beépített Prompt Injection elleni pajzs a dokumentumoknál.
  • Skálázhatóság (Async): Teljesen aszinkron API végpontok, amelyek párhuzamosan akár több száz kérést is kiszolgálnak fagyás nélkül.
  • Stabilitás: Timeout védelem (25s), Magic Bytes fájlellenőrzés (kiterjesztve WEBP formátumra) és szerverszintű naplózás (Logging).

v1.1.0 - Universal Engine

A rendszer átalakult egy univerzális pénzügyi dokumentum-feldolgozóvá.

  • Több dokumentumtípus: Automatikus felismerés Számla, Nyugta/Blokk és Szállítólevél között.
  • Inline API sebesség: A válaszidő radikális csökkentése (átlagosan 8-13 másodperc teljes analitikával).
  • Könyvelői logika: Beépített áfa-bontás, kerekítési hiba és matematikai ellenőrzés a blokkoknál.

v1.0.0 - Initial Release

A SzámlaAPI első stabil, élesített verziója.

  • Strukturált számlaadat-kinyerés (JSON).
  • Dinamikus, kliensszintű könyvelési szabályok kezelése.
  • X-Client-Secret alapú hitelesítés.

Hibaüzenetek (Hibakódok)

401 Unauthorized
Érvénytelen vagy hiányzó titkos API kulcs. Ellenőrizd a fejlécet!
413 Payload Too Large
A feltöltött fájl túl nagy. A maximális méret 10 MB.
429 Too Many Requests
Túl sok kérés. Elérted az előfizetésedhez tartozó limitet.