Áttekintés

A QUiCK egy modern könyvelési és pénzügyi platform, amelynek nyilvános REST API-ján keresztül a könyvelési folyamat teljes körűen automatizálható: partnertörzs, bejövő és kimenő számlák (költségek és bevételek), bizonylatok, pénzmozgások, adók, bérek és a könyvelési törzsadatok kezelése. Ezen a hubon megtalálod a fogalmi útmutatókat, az interaktív végpont-referenciát és a receptgyűjteményt a hétköznapi integrációs feladatokhoz.

Az API a könyvelési adminisztráció egészét lefedi — a hangsúly nem a számlakiállításon, hanem a könyvelési adatok kétirányú szinkronizálásán van egy külső ERP, webshop vagy saját rendszer felé.

• Költségek (expenses) és bevételek (incomes) — bejövő és kimenő bizonylatok listázása, létrehozása, módosítása
• Partnerek (partners) — vevők és szállítók törzsének kezelése, deduplikálva adószám alapján
• Bizonylatok (documents) — fájlok (PDF, kép) feltöltése és költséghez/bevételhez csatolása
• Pénzmozgások (payments) és pénztárak/bankszámlák (accounts)
• Adók (taxes, tax-codes) és bérek (salaries, monthly-salaries, monthly-taxes)
• Könyvelési törzsadatok (v2): főkönyvi számok (ledger-numbers), ÁFA-kategóriák (vat-categories), költség- és bevételtípusok, címkék, audit-xml export

• REST + JSON, előre jelezhető HTTP-státuszkódok, lapozott listák (page / page_size)
• Token-alapú hitelesítés — minden hívás az Authorization: Token <token> headerrel megy
• Két API-verzió él párhuzamosan: a /1/ a stabil alapműveletekhez, a /2/ a bővített, kötegelt könyvelési műveletekhez
• OpenAPI 3.0 gépi olvasható specifikáció — lásd az API Reference oldalt, ahol a hívások böngészőből is kipróbálhatók
• Tartalom-egyeztetés: a legtöbb végpont ?format=json (alapértelmezett) és ?format=html formában is válaszol

Három elkülönített felületet találsz — mindegyik ugyanabból a tartalommodellből épül.

Fogalmi útmutatók, receptek, hibakezelés és nevezéktan. Innen indulj, ha most ismerkedsz a QUiCK API-val.

Az OpenAPI specifikációból generált, interaktív végpont-referencia. A hívások közvetlenül a böngészőből kipróbálhatók a saját API tokeneddel.

Belső backoffice a dokumentáció szerkesztéséhez, publikálásához és a hub beállításaihoz.

A tipikus integráció négy lépésből áll:

1. API token létrehozása a QUiCK appban (Cégbeállítások → API Tokenek)
2. Cég azonosítása — a GET /2/company-info/ hívással lekérdezed a céged adatait, köztük a cég id-jét
3. Adatok olvasása — pl. partnerek (GET /1/partners/) vagy költségek (GET /1/expenses/) listázása
4. Adatok írása — új költség vagy bevétel rögzítése, bizonylat csatolása