Holded integráció
A Holded egy mindent egyben üzletvezetési platform, amelyet elsősorban a spanyol piacra (ES) terveztek, de Portugáliát, Olaszországot, Franciaországot és Németországot is támogatja. Ha a CADENSA-ban beállítod, az időbejegyzésekből közvetlenül állíthatsz ki jogilag érvényes számlákat, amelyek megfelelnek a spanyol FacturaE e-számlázási szabványnak.
A Holded elsősorban Spanyolországban 🇪🇸 működő vállalkozások számára készült, kiegészítő támogatással Portugália 🇵🇹, Olaszország 🇮🇹, Franciaország 🇫🇷 és Németország 🇩🇪 piacaihoz.
Spanyolországban 2019 óta kötelező a munkaidő-nyilvántartás (Real Decreto-ley 8/2019). A Cadensa időkövetése a Holded számlázással kombinálva teljes időnyilvántartás → számla munkafolyamatot biztosít a spanyol vállalkozások számára.
Előfeltételek
Szükséged lesz:
- Aktív Holded-fiók (bármely fizetős csomag)
- Holded API-kulcs (lásd alább)
- CADENSA-egységen legalább Admin szerepkör
1. lépés — Holded API-kulcs generálása
- Jelentkezz be az app.holded.com oldalon
- Nyisd meg a Beállítások menüt (fogaskerék ikon, jobb felül)
- Navigálj az Integrációk → API menüpontba
- Kattints a "+ Új API kulcs" gombra (vagy másolj ki egy meglévő kulcsot)
- Másold ki a generált kulcsot
Soha ne oszd meg másokkal, és ne tárold verziókezelőben. A kulcs birtokában bárki számlákat és kapcsolatokat hozhat létre és kezelhet a nevedben.
A hivatalos Holded API dokumentációért lásd: developers.holded.com/reference
2. lépés — Beállítás CADENSA-ban
- Nyisd meg a Beállítások → Számla oldalt a CADENSA-ban
- Válaszd a Holded 🇪🇸 szolgáltatót
- Illeszd be az API-kulcsodat az API Key mezőbe
- Kattints a Kapcsolat tesztelése gombra — zöld
jelzi a sikeres kapcsolatot - Kattints a Mentés gombra
3. lépés — Alapértelmezett értékek beállítása
Állítsd be az alapértelmezéseket, hogy a Számla generálása dialógus ésszerű értékekkel legyen előre kitöltve:
| Beállítás | Ajánlott érték (ES) | Leírás |
|---|---|---|
| Alapértelmezett pénznem | EUR | Új számlákon használt pénznem |
| Alapértelmezett ÁFA % | 21 | Standard spanyol IVA (impuesto sobre el valor añadido) |
| Fizetési határidő (nap) | 30 | Fizetési határidő napokban |
| Alapértelmezett bizonylatfajta | Számla | Ez jelölődik be alapból a dialógusban |
| Kibocsátó országa | ES | A cég országa — engedélyezi az automatikus ÁFA-javaslatot |
- 21% — Standard kulcs (tipo general) — a legtöbb szolgáltatás
- 10% — Csökkentett kulcs (tipo reducido) — vendéglátás, közlekedés, egyes élelmiszerek
- 4% — Szuper-csökkentett kulcs (tipo superreducido) — könyvek, gyógyszerek, egyes élelmiszerek
- 0% — Adómentes — közösségen belüli értékesítés, export, egyes pénzügyi szolgáltatások
Számlakiállítás Holded-en keresztül
A beállítás után a standard számlakiállítási folyamatot kövesd:
- Nyisd meg a Jelentések oldalt → állítsd be a dátumtartományt és a projekt-szűrőket
- Kattints a Számla generálása gombra
- A Bizonylatfajta mezőben válaszd a Számla lehetőséget — a kimeneti csatorna
Holded-et jelez - Töltsd ki az ügyfél adatait (név, cím, ország, ÁFA/NIF szám)
- Állítsd be az ÁFA-kulcsot (alapértelmezett: 21%)
- Kattints az Előnézet gombra → ellenőrizd a tételeket és összegeket
- Kattints a Számla kiállítása (Holded) gombra
A CADENSA elküldi a számlát a Holded API-nak. A rendszer automatikusan megkeresi vagy létrehozza a kapcsolat-rekordot (először ÁFA-szám, majd név alapján). A számla létrejön, és a PDF letölthetővé válik.
- Egy új számladokumentum jön létre a Holded-ben a Facturación → Facturas emitidas alatt
- Ha nem található meglévő kapcsolat, a rendszer automatikusan létrehozza
- A számla PDF-je azonnal letölthető
Ügyfél-egyeztetés
A CADENSA az alábbi sorrendben keres meglévő Holded-kapcsolatot:
- ÁFA/NIF szám alapján — a legmegbízhatóbb egyezés (add meg az ügyfél ÁFA-számát a számla dialógusban)
- Cégnév alapján — pontos egyezés (kis- és nagybetű-érzéketlen)
- Új létrehozása — ha nincs egyezés, a rendszer automatikusan létrehoz egy új kapcsolatot
Spanyol ügyfeleknél mindig add meg a NIF/CIF számot (pl. B12345678) az ügyfél ÁFA-szám mezőjében. Ez biztosítja, hogy a megfelelő Holded-kapcsolat kerüljön egyeztetésre, még akkor is, ha a cégnév kis mértékben eltér.
Mentett partnerek (Partner picker)
Amikor a Holded van beállítva számlázási szolgáltatóként, a Számla generálása dialógus megjelenít egy partner picker-t — egy kereshető legördülő listát, amely közvetlenül a Holded-kapcsolataidból töltődik fel.
Hogyan működik:
- Gépelj be egy nevet vagy részleges szöveget a Holded-kapcsolataid valós idejű kereséséhez
- Egy partner kiválasztása automatikusan kitölti az összes ügyfélmezőt: cégnév, cím, irányítószám, város, ország, ÁFA-szám
- Az ország mező az eredeti Holded országnevet mutatja (pl. „Spain", „Hungary") a könnyebb felismerés érdekében — miközben a mögöttes ISO-kód (pl.
ES,HU) kerül felhasználásra az ÁFA-számításhoz és a fordított adózási logikához
A Holded teljes szöveges formában tárolja az országneveket ("Spain", "Germany" stb.). A CADENSA automatikusan ISO 3166-1 alpha-2 kódokká alakítja ezeket belsőleg a megfelelő ÁFA-javaslathoz (belföldi / fordított adózás / export). A teljes név jelenik meg a felületen az olvashatóság érdekében.
Támogatott munkafolyamatok:
- Válassz egy meglévő partnert → minden mező automatikusan kitöltődik
- Töröld a partnert → szerkeszd a mezőket manuálisan
- Add meg az ügyfél adatait manuálisan, ha a partner még nincs a Holded-ben (a számla kiállításakor automatikusan létrejön egy új kapcsolat)
ÁFA-kulcs leképezés
A Holded elnevezett adóobjektumokat használ. A CADENSA automatikusan leképezi a numerikus ÁFA-kulcsodat:
| ÁFA-kulcs | Holded adónév | Felhasználás |
|---|---|---|
| 21% | IVA 21% | Standard spanyol IVA |
| 10% | IVA 10% | Csökkentett kulcs |
| 4% | IVA 4% | Szuper-csökkentett kulcs |
| 0% | Exento | Adómentes / export |
Számlanyelvek
A CADENSA automatikusan kiválasztja a számla nyelvét a kibocsátó ország alapján:
| Kibocsátó országa | Számla nyelve |
|---|---|
| ES | Spanyol (es) |
| FR | Francia (fr) |
| DE | Német (de) |
| PT | Portugál (pt) |
| IT | Olasz (it) |
| Egyéb | Spanyol (es, alapértelmezett) |
Dokumentumtípusok irányítása
| Dokumentumtípus | Kimenet |
|---|---|
| Proforma | Belső PDF (soha nem kerül elküldésre a Holded-nek) |
| Munkaösszesítő | Belső PDF (soha nem kerül elküldésre a Holded-nek) |
| Számla | Elküldve a Holded API-nak → PDF visszakapva |
Kizárólag a Számla típusú dokumentumok kerülnek elküldésre a Holded-nek. A Proforma és a Munkaösszesítő mindig belsőleg generálódik, a szolgáltató beállításától függetlenül.
Számlatörténet és PDF letöltés
Sikeres számlakiállítás után:
- A számla megjelenik a CADENSA Jelentések → Számlák oldalán
- A számla a Holded-fiókodban is megjelenik: Facturación → Facturas emitidas
- A PDF-et bármikor újra letöltheted bármelyik helyről
Kapcsolat tesztelése
Az API-kulcs megadása után használd a Kapcsolat tesztelése gombot. A CADENSA meghívja a Holded Contacts API-t, hogy ellenőrizze a kulcs érvényességét.
Sikeres teszt esetén a következő jelenik meg:
✓ Sikeres kapcsolódás
A Holded-nek nincs sandbox környezete. Teszteléshez:
- Hozz létre egy teszt-kapcsolatot a Holded-ben (pl. „Test Client ES")
- Generálj egy kis teszt-számlát a CADENSA-ban
- Azonnal érvénytelenítsd/vond vissza a Holded-ben (Facturas emitidas → ⋯ → Anular)
Hibaelhárítás
„401 Unauthorized" / „403 Forbidden" hiba
Az API-kulcs érvénytelen, lejárt, vagy nem rendelkezik a szükséges jogosultságokkal.
Megoldás: Generálj új API-kulcsot a Holded-ben (Beállítások → Integrációk → API), és add meg újra a CADENSA-ban.
„INVOICE_NO_ENTRIES" hiba
Nem található időbejegyzés a kiválasztott dátumtartományra és projekt-szűrőkre.
Megoldás: Módosítsd a dátumtartományt vagy a projekt-szűrőt, és próbáld újra.
Kapcsolat nem jön létre / hibás kapcsolat egyeztetve
Ha az ÁFA-szám hiányzik, és a cégnév nem egyezik pontosan egy meglévő Holded-kapcsolattal, duplikátum jöhet létre.
Megoldás: Ellenőrizd a Contactos listát a Holded-ben, és vond össze a duplikált rekordokat. Jövőbeli számláknál mindig add meg az ügyfél NIF/CIF számát az ÁFA-szám mezőben.
PDF letöltése sikertelen
A Holded szinkron módon generálja a PDF-eket — a PDF-nek azonnal elérhetőnek kell lennie a számla létrehozása után.
Megoldás: Töltsd le újra a Jelentések → Számlák oldalról. Ha a probléma továbbra is fennáll, ellenőrizd a Holded állapotoldalát, vagy vedd fel a kapcsolatot a Holded ügyfélszolgálatával.
Számla visszavonása sikertelen
Csak pending (függőben lévő) vagy draft (piszkozat) állapotú számlák vonhatók vissza. A kifizetett számlák nem fordíthatók vissza az API-n keresztül.
Megoldás: Vond vissza a számlát manuálisan a Holded-ben (Facturas emitidas → ⋯ → Anular), ha az API-hívás sikertelen.
Lásd még
- Számlázási szolgáltató beállítások — Az összes szolgáltató áttekintése
- Számlagenerálás — Hogyan hozz létre számlát időbejegyzésekből
- Számlatörténet — Korábbi számlák megtekintése és újratöltése