QUiCK API
Asztaloddal nem, de minden mással összekötheted magad
Ezen az oldalon
A Publikus API a QUiCK gép–gép felülete: külső rendszer – könyvelőprogram, BI-eszköz, saját automatizáció – ezen keresztül olvassa és írja a cég számláit, kifizetéseit és törzsadatait, ugyanazokkal a szabályokkal, mint a felhasználó a képernyőn. A technikai referencia az api.quick.riport.co.hu oldalon él; ez a fejezet azt mondja el, mire való és hogyan indulsz el vele.
Definíció#
Cégszintű, token-alapú hozzáférés a QUiCK-fiók adataihoz. A tokent a cég adminisztrátora hozza létre, egy céghez tartozik, és csak annak a cégnek az adatait éri el. Amit az API ad:
Költség- és bevételi számlák – fejléc, tételek, tételbontás, kategória, címke, könyvelési adatok, fizetettség; olvasás és módosítás, költségszámla létrehozása.
Számlaképek és dokumentumok – letöltés és feltöltés.
Kifizetések, adók, bérek – listák; adó és bér rögzítése.
Törzsadatok – partnerek, pénztárcák és egyenlegek, kategóriák, címkék, ÁFA-kategóriák, kontírszámok.
Nem tartozik ide: a Számlázz.hu-, Billingo- és NAV Online Számla integráció (a QUiCK beépített adatkapcsolatai), a könyvelőprogram-partnerek saját beállítása (ők az API fogyasztói), a fájlexportok és a QUiCK MCP (saját dokumentáció). A QUiCK nem számlázóprogram: kimenő számla az API-n sem állítható ki.
Cél és kontextus#
A QUiCK-ben összegyűlő adat akkor ér a legtöbbet, ha nem marad a felületen. A könyvelőprogram emberi kéz nélkül veszi át a feldolgozott számlákat; a kontrolling Power BI-ban vagy Codában gördülő kimutatást épít rá; a cég saját scriptje tömegesen kategorizál, jóváhagy vagy belső rendszerből rögzít. Az API erre a három igényre egyetlen, stabil interfészt ad.
Mikor ezt, mikor mást#
Helyzet | Megoldás | Miért |
|---|---|---|
A könyvelőiroda programja ismeri a QUiCK-et (NOVITAX, SMARTbooks, NetAccounting, Cadren, QUiCK Audit, Acounto) | Kész integráció: a token a partner rendszerébe kerül | nincs fejlesztés; a program kéri le a Feldolgozott számlákat, és Könyvelt státuszt állít vissza |
A könyvelőprogramnak nincs QUiCK-kapcsolata | Könyvelői export a felületről | fájlalapú átadás, ugyanúgy Könyvelt státuszt állít |
BI, gördülő kimutatás külső eszközben | API, olvasó hívások | a kimutatás magától frissül, nem exportot töltesz újra |
Egyedi folyamat: tömeges kategorizálás, jóváhagyás, rögzítés belső rendszerből | API, író hívások | a felülettel azonos szabályok érvényesülnek |
Egyszeri adatkinyerés | Számlaadatok exportja | CSV vagy XLSX, token nélkül |
Hogyan indulsz el#
Token. Cégbeállítások → API tokenek → új token, névvel (mire használod). A kulcs egyszer látható: kimásolod, a fogadó rendszerbe illeszted. A lista mutatja az utolsó használat dátumát; integrációnként külön tokent adsz, így egy leválasztás nem érinti a többit.
Referencia. api.quick.riport.co.hu – végpontok, paraméterek, példák, changelog. Ezt a fejlesztő vagy a partner program kapja.
Partner program. Kész integrációnál a tokent a partner felületén adod meg (NOVITAX Feladási modul, SMARTbooks adatkapcsolatok, Cadren kapcsolódási beállítások, QUiCK Audit API/státusz); a könyvelőprogram-szinkronhoz a cég haladó könyvelői módban van.
Amit üzletileg tudni kell#
A token a cégé, nem a személyé. A hívás nem felhasználó nevében fut; a jogosultsági korlátok a tokenre nem vonatkoznak, ezért a tokent úgy kezeld, mint egy admin belépést.
A QUiCK nem értesít. Nincs webhook; a fogadó rendszer ütemezetten kérdezi le a változásokat. Ismert fejlesztési igény.
Blokkolt vagy lejárt előfizetésnél az API nem ad adatot; a megoldás az előfizetés rendezése, nem a token cseréje.
Még ebben a témakörben: Integrációk
- NAV Online Számla integrációA NAV Online Számla integráció kézi rögzítés nélkül tölti be a belföldi számlákat a QUiCK-be, költség és bevétel oldalon is.
- Számlázz.hu integrációA Számlázz.hu integráció a számlákat, számlaképeket és a fizetettséget szinkronizálja a QUiCK-be.
- Billingo integrációA Billingo integráció automatikusan szinkronizálja a vevői számlákat a QUiCK-be, a fizetettséggel és az adatokkal együtt.
- QUiCK MCPA QUiCK természetes nyelven
- NAV Ügyfélportál M2MAdóelőírások automatikusan