Automatikus Számlázás BillX API-val

Kapcsold össze webshopod, CRM-ed vagy egyéb rendszered a BillX számlázóval

API Kulcs megszerzése

Az API kulcsodat a Dashboard oldalon találod meg bejelentkezés után.

Használat: A kulcsot a Authorization: Bearer YOUR_API_KEY headerben kell elküldeni minden API kéréshez.
Teszt API Kulcs (Fejlesztéshez)

Teszteléshez használható fix API kulcs, ami nem hoz létre valódi számlákat:

test_billx_api_key_demo_12345678
Mit csinál: ✅ Validálja a kéréseket, ✅ Visszaad példa adatokat, ✅ Számol összegeket
Mit NEM csinál: ❌ Nem hoz létre számlát, ❌ Nem küld NAV-hoz, ❌ Nem érinti a fiókodat

Mi ez és mire jó?

A BillX API egy automatikus számlázó csatorna, amivel más rendszerek (webshop, CRM, foglalási rendszer stb.) tudnak automatikusan számlákat kiállítani nálad.

Automatizálás

Ne kelljen kézzel beírni minden számlát - az rendszered csinálja helyetted!

Biztonság

Az API titkosított kapcsolaton keresztül kommunikál, csak te férsz hozzá.

Hatékonyság

Spórolj időt és csökkentsd a hibalehetőséget az automatizálással!

Mire használhatom?

Webshop integráció

WooCommerce, Shopify, Shoprenter vagy egyéni webshop esetén automatikusan kiállítható a számla minden megrendelés után.

Példa: Vásárló rendelést ad le → Webshop API hívást küld → BillX kiállítja a számlát
Foglalási rendszer

Szállásfoglalás, edzések, szolgáltatások foglalása esetén automatikus számlakiállítás.

Példa: Vendég lefoglal egy szobát → Foglalási rendszer értesít → Számla kiállítva
CRM / Ügyfélkezelő

Projektmenedzsment vagy CRM rendszerből közvetlenül számla generálás.

Példa: Projekt lezárása → CRM összesíti az órákat → Számla automatikusan
Fuvarozás / Logisztika

Fuvarlistából automatikus számlakiállítás (mint a Fuvarbörze integráció).

Példa: Fuvar teljesítve → Rendszer küldi az adatokat → Számla készen van
Előfizetéses szolgáltatások

Havi/éves előfizetések automatikus számlázása ismétlődő tételekkel.

Példa: Hónap eleje → Automatikus cron job → Számlák kiállítva minden előfizetőnek

Hogyan kezdjem el?

1️⃣ API Kulcs másolása

Jelentkezz be a BillX Dashboard-ra és másold ki az API kulcsodat. Ez azonosít téged a rendszerben.

2️⃣ Fejlesztő keresése (ha kell)

Ha nem vagy programozó, kérj meg egy webfejlesztőt/IT szakembert, hogy integrálja a rendszered a BillX API-val. Add át neki:

  • Az API kulcsodat (Dashboard-ról)
  • Ezt a dokumentációs oldal URL-jét
  • Milyen rendszerbe kell integrálni (WooCommerce, Laravel stb.)
BillX Fejlesztői Szolgáltatás

Nincs fejlesztőd? A BillX csapata is vállalja az API bekötést!

  • Óradíj: 10.000 Ft / óra
  • Átlagos idő: 1-3 óra (rendszertől függően)
  • Mit csinálunk: Bekötjük az API-t a rendszeredbe, tesztelünk, dokumentálunk

Érdeklődsz? Hívj minket: +36 70 303 4868

3️⃣ Integráció készítése

A fejlesztő beépíti a rendszeredbe az API hívásokat. Ez általában 1-3 óra munkát jelent tapasztalt fejlesztőnek.

4️⃣ Tesztelés

Próbáld ki a rendszert teszt adatokkal! Készíts egy próba rendelést/foglalást, nézd meg, hogy megjelenik-e a számla itt a BillX-ben.

5️⃣ Éles használat

Ha minden rendben működik, kapcsold be élesen! Ezután automatikusan készülnek a számlák.

Fejlesztői Információk

Ha te vagy a fejlesztő, vagy át szeretnéd adni a technikai dokumentációt a programozódnak, itt találod az összes szükséges információt:

API Dokumentáció

Teljes API referencia endpoint-okkal, példákkal

README.md megnyitása
Kód példák

PHP, Python, JavaScript integráció példák

Példák megtekintése
API URL:
https://billx.hu/api/billx
Autentikáció:
Bearer Token
Formátum:
JSON

Gyors példa: Számla létrehozás

Így néz ki egy egyszerű API hívás, amivel számla készül (ez csak szemléltetés, a fejlesztőd fogja implementálni): 

// PHP példa
$data = [
    'customer_id' => 1,
    'invoice_type' => 'invoice', // 'invoice', 'proforma', vagy 'draft'
    'block_id' => 1, // Opcionális: számlatömb ID (ha nincs megadva, alapértelmezett)
    'fulfillment_date' => '2025-01-20',
    'due_date' => '2025-01-27',
    'payment_method' => 'transfer',
    'currency' => 'HUF',
    'items' => [
        [
            'name' => 'Webfejlesztés',
            'unit' => 'óra',
            'quantity' => 10,
            'unit_price' => 15000,
            'vat_rate' => 27
        ]
    ]
];

$ch = curl_init('https://billx.hu/api/billx/invoices');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_KEY_HERE'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$invoice = json_decode($response, true);

echo "Számla elkészült: " . $invoice['invoice_number'];
// Példa: "Számla elkészült: BILLX-2025/0001"
Eredmény: Számla elkészült: BILLX-2025/0042
Számlatömbök: A számla számok az általad beállított számlatömbök alapján generálódnak (pl. BILLX-2025/0001, BILLX-ABC-2025/0042). Ha nem adsz meg block_id paramétert, az alapértelmezett számlatömböt használja az API.

Számla típusok

Az API-n keresztül három különböző típusú számlát hozhatsz létre:

Éles számla

invoice_type: "invoice"

Normál, végleges számla. Ez az alapértelmezett típus, ha nem adsz meg mást. Automatikusan beküldésre kerül a NAV-hoz.

Proforma számla

invoice_type: "proforma"

Előzetes számla, ajánlat. Nem kerül beküldésre a NAV-hoz, nem befolyásolja a könyvelést.

Piszkozat

invoice_type: "draft"

Piszkozat számla későbbi véglegesítéshez. Hasznos ha még nem biztos minden adat.

Tipp: Ha nem adsz meg invoice_type mezőt, automatikusan éles számla ("invoice") készül.

Gyakori Kérdések

Az API használat teljesen ingyenes minden BillX előfizetéshez! Nincs külön díj, korlátlan számú API hívást küldhetsz.

Igen! Az API kulcs 64 karakteres titkosított string, és csak HTTPS protokollon keresztül használható. Ne oszd meg senkivel, és csak biztonságos szerveren tárold!

Újat tudsz generálni a Beállítások menüpontban. A régi kulcs azonnal érvényét veszti, és frissítened kell a kulcsot az integrációdban.

Igen! Az API támogatja az EUR, USD és más devizákat is. Az MNB árfolyam automatikusan lekérdezésre kerül, vagy megadhatsz saját árfolyamot is.

Az integráció elkészítéséhez igen, de a használatához már nem! Egyszer beállítva automatikusan fog működni. Ha nem vagy programozó, kérj meg egy webfejlesztőt, hogy integrálja be neked (1-3 óra munka).

AI Asszisztens segítség

Kérdésed van az API bekötéssel kapcsolatban? Az AI chatbot segít a következőkben:

API endpoint-ok használata
Kódpéldák curl/PHP/JavaScript formátumban
Mezőnevek és típusok
customer_id, invoice_type, block_id stb.
Bearer token használat
Authorization header beállítása
WooCommerce plugin használat
Beállítások, hibaelhárítás, manuális generálás
Példa kérdések:
  • "Hogyan hozok létre számlát az API-val?"
  • "Milyen mezőket kell kitöltenem egy proforma számlához?"
  • "Hogyan állítom be a WooCommerce bővítményt?"
  • "Milyen HTTP headert kell küldeni az API kulccsal?"
Nyisd meg a chat ablakot a jobb alsó sarokban és kérdezz bátran!

Segítség kell?

Ha elakadtál, vagy kérdésed van az API használattal kapcsolatban, írj nekünk!

support@billx.hu