Explore

Google Sheets

"Nincs több export, csak közös kép"

A QUiCK Sync v2 Google Apps Script egy egyirányú, olvasási célú integráció: a QUiCK API-ból táblázatokba tölti a költségeket, bevételeket, partnereket, adókat, béreket és bankszámla-egyenlegeket. A script rögzített fejlécű, csak-olvasású munkalapokat tart fenn, és menüből indítható frissítésekkel szinkronban tartja az adatokat.

Mit tud az integráció?

Adatlekérés és lapokra írás

Költségek + tételek, könyvelési bontások, fizetési előzmények

Bevételek + tételek, bontások, fizetési előzmények

Partnerek

Adók

Bérek

Bankszámla-egyenlegek

Link oszlopok a QUiCK felületére mutatva

Menü a Táblázatban (QUiCK Sync): „Minden frissítése”, illetve modulonkénti frissítések.

Csak-olvasású kimenetek: a munkalapok védettek; kézi módosítás visszaállításra kerül.

Szelektív lekérés: dátumtól/dátumig + dátummező választás (pl. fulfilled_at).

Állapotok/mezők normalizálása: fizetettség (not paid / paid / partially paid), számlatípus (invoice/storno/advance/final/credit), címkék összefűzése (tags + simple_tags).

⁠

Előfeltételek

Google Sheet, ahol fut az Apps Script.

API kulcs a QUiCK-hez:

Hozz létre egy egycella-nyi elnevezett tartományt: QUICK_API_KEY.

Ide írd be az API kulcsot; a script Script Properties-be menti, majd a cellában maszkolja: •••••• API KULCS MENTVE ••••••.

Hiány esetén hiba: „Nincs API kulcs beállítva. Írd be a QUICK_API_KEY nevű cellába.”

⁠

Beállítás lépései

API kulcs beírása.

Dátum- és mezőszűrők beállítása elnevezett tartományokkal:

Költségek: QUICK_EXPENSES_FROM_DATE, QUICK_EXPENSES_TO_DATE, QUICK_EXPENSES_FIELDS, QUICK_EXPENSES_DATE_FIELD.

Bevételek: QUICK_INCOMES_FROM_DATE, QUICK_INCOMES_TO_DATE, QUICK_INCOMES_FIELDS, QUICK_INCOMES_DATE_FIELD.

Alapértelmezések: from = 2025-01-01, to = üres; fields = (költség: items,payment_history,accounting, bevétel: items,payment_history); date_field = fulfilled_at.

fields csak az alábbiakat fogadja: items, payment_history, accounting.

date_field csak: fulfilled_at, created_at, due_at, issued_at.

Modulkapcsolók (logikai elnevezett tartományok):

QUICK_TAXES_ENABLED, QUICK_SALARIES_ENABLED, QUICK_ACCOUNTS_ENABLED (false esetén a modul frissítése kihagyásra kerül).

Menü → QUiCK Sync: futtasd a „Minden frissítése” vagy az egyes modulfrissítéseket.

⁠

Működési logika (adatáramlás – röviden)

Transzformáció: partner-, pénznem-, ÁFA-, típus- és címketáblákból azonosítók feloldása, szöveges állapotok előállítása.

Kiírás: a cél-lap fejlécét a script beállítja, sorokat felülírja, jegyzetben időbélyeg (Last update), auto-oszlopszélesség.

Védelem + tükör: a kimeneti lapok védettek; háttérben egy rejtett tükörből visszaírja a kézi editet; üzenet jelzi.

⁠

Kimeneti munkalapok és tartalmuk

KÖLTSÉGEK / KÖLTSÉG_NAV_TÉTELEK / KÖLTSÉG_KATEGÓRIÁK / KÖLTSÉG_KIFIZETÉSEK Költség-fej adatok, tételsorok, könyvelési/ÁFA bontások (főkönyvi, ÁFA főkönyvi, költségtípus), valamint fizetési előzmények. Kulcsmezők példa: expense_id, partner adatok, invoice_number, vat_area, könyvelési státusz, paid_status (szöveges), tags, link.

BEVÉTELEK / BEVÉTEL_NAV_TÉTELEK / BEVÉTEL_KATEGÓRIÁK / BEVÉTEL_BEFIZETÉSEK Bevétel-fej, tételek, bevétel-típus bontások, fizetési előzmények. Kulcsmezők: income_id, partner adatok, összegek, invoice_type (szöveges), paid_status (szöveges), tags, link.

PARTNEREK: partner-törzs (vevő/szállító jelzőkkel).

ADÓK (ha engedélyezett): havi csoportok + egyedi adók (összegek, esedékesség, fizetettség, címkék).

BÉREK (ha engedélyezett): havi csoportok + egyedi tételek (bruttó, nettó, esedékesség, fizetettség, címkék).

BANKSZÁMLA_EGYENLEGEK (ha engedélyezett): számla ID, név, pénznem, egyenleg(ek), időbélyeg.

A script minden lapot fix oszlopfejléccel hoz létre és kezeli; az oszloprend kimenetenként előre definiált.

⁠

Vezérlés a Táblázat menüjéből

QUiCK Sync menü:

Minden frissítése (sorrendben: költségek, bevételek, partnerek, adók, bérek, bankszámlák).

Modulonként: Költségek / Bevételek / Adók / Bérek / Bankszámla-egyenlegek / Partnerek frissítése.

⁠

Limitációk és specialitások

A kimeneti lapok read-only: kézi módosítás visszavonásra kerül.

⁠

GYIK

Hol adjam meg az API kulcsot? Hozz létre egy elnevezett tartományt QUICK_API_KEY néven (1 cella), írd be a kulcsot; a script eltárolja és a cellát maszkolja.

Hogyan szűrök időszakra? Állítsd a megfelelő elnevezett tartományokat (pl. QUICK_EXPENSES_FROM_DATE / QUICK_EXPENSES_TO_DATE). Dátum formátum: YYYY-MM-DD.

Mit írhatok a “fields” mezőbe? Csak: items, payment_history, accounting — vesszővel elválasztva.

Miért nem tudom szerkeszteni a lapokat? A kimeneti lapok védettek; a kézi editet a script azonnal visszaállítja (toast üzenet jelenik meg).

Hogyan kapcsolom ki az adók/bérek/bankszámlák lekérését? Állítsd false-ra az adott logikai elnevezett tartományt: QUICK_TAXES_ENABLED, QUICK_SALARIES_ENABLED, QUICK_ACCOUNTS_ENABLED.

Minden frissítés egyben? Igen: QUiCK Sync → Minden frissítése.

Want to print your doc?
This is not the way.

Try clicking the ··· in the right corner or using a keyboard shortcut (

CtrlP

) instead.