API Documentation

Everything you need to integrate SzámlaAPI lightning fast.

Authentication

To access the API, you need the secret key sent to your email after subscribing. Include it in the 'X-Client-Secret' HTTP header with every request.

HTTP Header
X-Client-Secret: sec_your_secret_key_12345

Invoice Extraction (/extract)

Send a PDF invoice to this endpoint, and our AI will return structured JSON data in seconds.

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
    }
  }
}

Custom Accounting Rules

Dynamically configure your own rules so the AI assigns specific account numbers or categories to certain suppliers.

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.

Error Codes

401 Unauthorized
Invalid or missing secret API key. Please check your headers.
413 Payload Too Large
The uploaded file is too large. The maximum size is 10 MB.
429 Too Many Requests
Too many requests. You have reached your subscription limit.