Coda integráció
Ezen az oldalon
A QUiCK Sync Pack egy egyenirányú (read-only) Coda integráció, amellyel a QUiCK API-ból szinkrontáblákba hozhatod át a költségeket, bevételeket, partnereket, adókat, béreket és a bankszámla-egyenlegeket. A pack a QUiCK webes felületére mutató mélylinkeket is épít.
Mit tud az integráció?#
Szinkrontáblák#
Költségek: költség fejadatok + link a QUiCK felületre.
Költség tételek: tételsorok (menny., egységár, ÁFA, bruttó/nettó).
Költség kategóriák: könyvelési bontások (költségtípus, főkönyvi/ÁFA főkönyvi, munkaszám, címkék).
Költség kifizetések: fizetési előzmények (dátum, összeg, sorszám).
Bevételek: bevétel fejadatok, fizetettség, számlatípus + link.
Bevétel tételek: bevételi tételsorok.
Bevétel kategóriák: bevétel-típus bontások (címkék, összegek).
Bevétel kifizetések: bevételek fizetéstörténete + link.
Adók: havi adócsoportok + egyedi adók (esedékesség, fizetettség, címkék).
Bérek: havi bércsoportok + egyedi tételek (bruttó/nettó, esedékesség, fizetettség).
Partnerek: partner-törzs (vevő/szállító jelölők).
Bankszámla egyenlegek: bankszámla-egyenlegek.
Okos mező-feloldás: azonosítók → nevek (pénznem, ÁFA, címkék, fizetettség státusz) szövegesítése.
Mélylinkek a QUiCK-be: számlákhoz automatikus link.
Paraméterezhető szinkron: időszak, és dátummező választás.
Előfeltételek#
Coda dokumentum a Pack telepítéséhez.
QUiCK API-kulcs, melyet a Pack kapcsolatnál kell megadni.
Beállítás lépései#
Pack telepítése a Codában
Nyisd meg a dokumentumodat → Insert → Packs → keresd: QUiCK → Add to doc.Kapcsolat létrehozása
A Pack első használatakor add meg az API-kulcsot.Szinkrontábla felvétele
Válaszd ki a kívánt táblát (pl. Költségek, Bevételek stb.), majd állítsd be a paramétereket:
from_date (YYYY-MM-DD), to_date (opcionális, YYYY-MM-DD);
date_field (opcionális: fulfilled_at | created_at | due_at | issued_at).
Alapértékek: from_date = 2025-01-01, to_date = "", date_field = fulfilled_at
Első szinkron futtatása, majd igény szerint ütemezés a Coda szokásos Sync beállításaival.
Működési logika (adatáramlás – röviden)#
API hívás (GET) a megadott végpontokra.
Transzformáció: partner/pénznem/ÁFA/címkék feloldása, állapotok szövegesítése, linkek összeállítása.
Coda szinkrontáblába írás: a Pack sémái fix mezőlistát adnak (pl. Expenses: expense_id, partner adatok, számla- és könyvelési mezők, paid_status, tags, link; …Payments: dátum, összeg, sorszám, link; …Assignments: költség/főkönyv/ÁFA bontás stb.). A címkék SelectList típusúak.
Limitációk és specialitások#
Csak olvasás: a Pack nem ír vissza a QUiCK-be, műveleteket nem végez (nincsenek gombok/akciók).
Dátumok: a választott date_field csak a felsorolt négyből lehet
issued_at = kiállítás dátuma
fulfilled_at = teljesítés dátuma
created_at = létrehozás dátuma (QUiCK-be kerülés dátuma)
due_at = fizetési határidő
Séma-azonosítók: több táblában mesterséges row_id biztosítja az egyediséget (pl. tételek és fizetések).