Alap-URL
https://freebillgen.com/api/v1Hitelesítés
Minden kérés Bearer-tokent használ. Hozzon létre egyet a Beállítások → API-kulcsok menüpontban, adja meg a szükséges erőforrásonkénti olvasási/írási jogosultságokat (scope), opcionálisan állítson be lejárati időt, és küldje el minden kérésben:
Authorization: Bearer <your-api-key>A kérések hitelesítése a kulcsot létrehozó fiók alapján történik, és a rendszer ellenőrzi a hozzárendelt jogosultságokat. Tartsa titokban a tokent, és vonja vissza, ha kiszivárgott vagy már nincs rá szükség.
Mit tehet
- Számlák, ügyfelek, vállalatok, kifizetések és ismétlődő ütemezések olvasása
- Létrehozásuk és frissítésük (író API - Pro)
- Hívja le az áfa- és lejárati jelentéseket JSON formátumban
- Olvassa be ugyanazt a korlátos „Következő teendők” várólistát, amelyet az irányítópult is használ
- Olvassa be a Beérkező számlák közé manuálisan feltöltött beszállítói e-számla fájlokat (nem egy Peppol-/e-mail-fogadó végpont)
- Töltse le az általános OASIS UBL és UN/CEFACT CII leképezéseket áttekintés céljából (profil-érvényesítés nélkül)
- Webhook-végpontok regisztrálása számla- és fizetési eseményekhez (Pro)
- Idempotency-Key a támogatott írási műveleteknél - ugyanazon kulcs alatt a megváltozott kérelemadatok 409-es hibakódot eredményeznek
- Kurzorral történő lapozás a links.next segítségével, a per_page paraméterrel állítható (max. 100)
- Lehetővé teszi az AI-ügynökök számára bármely megosztott számla elolvasását - schema.org/Invoice JSON-LD, valamint Accept: application/json vagy text/markdown minden aláírt megosztási linken
- Hitelesítés nélküli, csak olvasható MCP-kiszolgáló a https://freebillgen.com/api/mcp címen (get_invoice, verify_invoice) az AI-ügynökök számára
Konvenciók
- Idempotencia
- A támogatott létrehozási és műveleti hívások esetén küldjön egyedi Idempotency-Key értéket. Az azonos kérelemadatokkal történő újrapróbálkozás az eredeti sikeres eredményt adja vissza; a megváltozott kérelemadatok 409-es hibakódot eredményeznek.
- Oldalszámozás
- A mentett erőforráslisták kurzorral lapozhatók - kövesse a links.next hivatkozást (vagy adja meg a ?cursor=... paramétert), és állítsa be a ?per_page= értéket (max. 100). A korlátozott műveleti hírcsatorna jelzi a korlátot és a csonkított állapotot.
- Pénz
- A pénzösszegek pontos JSON-karaktersorozatok a pénznem ISO 4217 szabvány szerinti skálájához igazítva, például "121.00" euró vagy "500" japán jen esetén. Az egységárak megőrizhetnek további beviteli pontosságot.
- Azonosítók
- Minden erőforrást egyedi, opák (belső jelentés nélküli) azonosító jelöl, soha nem növekvő sorszám.
Példa: számláinak felsorolása
curl https://freebillgen.com/api/v1/invoices \
-H "Authorization: Bearer $FREEBILLGEN_API_KEY"Nyissa meg a teljes interaktív API-referenciát →
Számla-API-val kapcsolatos kérdések
Ingyenes a számla-API?
Igen - az olvasási API díjmentesen elérhető az ingyenes csomagban. Az írási API és a kimenő webhookok az adótartalmú 49 €-s Lifetime Pro csomagban érhetők el: egyszeri fizetés, havi díj és éves megújítás nélkül.
Hogyan hitelesíthetem magam?
Hozzon létre egy Bearer tokent a Beállítások -> API-kulcsok menüpont alatt, rendeljen hozzá erőforrásonkénti olvasási/írási hatóköröket, és küldje el az Authorization: Bearer fejlécben minden kérésnél. A kulcsok a saját fiókjára érvényesek, visszavonhatók vagy lejárhatnak.
Programozással is létrehozhatok számlákat?
Igen, a Pro kiegészítő részét képező írási API-n keresztül. Ugyanazokat a professzionális számlákat állítja elő, mint a webalkalmazás, sorozatszámozással és szerveroldalon alkalmazott, konfigurálható áfa-kezeléssel. Az API nem garantálja a helyi jogszabályoknak való megfelelést.
Hogyan kerülhetem el az ismételt kísérlet során a duplikált számlák létrehozását?
Küldjön egyedi Idempotency-Key értéket a létrehozási híváskor. Ugyanazzal a kulccsal és azonos kérelemadatokkal történő újrapróbálkozás az eredeti eredményt adja vissza. A kulcs újrafelhasználása megváltozott kérelemadatokkal 409-es hibakódot eredményez, ahelyett, hogy csendben egy másik számlát adna vissza.
Elolvashatom a kapott számlákat?
Igen, ingyenes. A GET /api/v1/inbox parancs felsorolja azokat a támogatott UBL/CII beszállítói fájlokat, amelyeket Ön manuálisan feltöltött, és amelyeket a FreeBillGen feldolgozott, az eredeti példányt pedig ellenőrzés céljából megőrizte; a GET /api/v1/inbox/{id} parancs egyet ad vissza. A szintaxisfelismerés nem egyenlő a profil-érvényesítéssel, és ezek a végpontok nem teszik a FreeBillGen-t Peppol-, kormányzati hálózat- vagy e-mail-fogadó végponttá.
Elolvashat-e egy mesterséges intelligencia-ügynök számlát fiók nélkül?
Igen. Minden számla, amelyet aláírt nyilvános linkjén keresztül oszt meg, ügynök által olvasható ugyanazon az URL-en: az oldal beágyaz egy schema.org/Invoice JSON-LD-t, és az Accept: application/json elküldése strukturált számlát (felek, tételek, összegek, fizetendő egyenleg, fizetési lehetőségek) ad vissza, míg az Accept: text/markdown tiszta, kevés tokenből álló megjelenítést ad vissza. Emellett elérhető egy hitelesítés nélküli, csak olvasásra szolgáló Model Context Protocol (MCP) szerver is a https://freebillgen.com/api/mcp címen, amely a get_invoice és a verify_invoice eszközöket tartalmazza. A link aláírása az elérési token. Kezelje a teljes URL-t titkos adatként, mert bárki, aki megkapja, megnyithatja a számlát.