Ugrás a fő tartalomhoz

Holded integráció

A Holded egy spanyol üzletvezetési platform, amely a spanyol piacot () és a FacturaE e-számlázási szabványt célozza. Emellett támogatja Portugáliát , Olaszországot , Franciaországot és Németországot .

FacturaE kötelezettség

A FacturaE e-számlázás már kötelező a spanyol közszektori számlákhoz, és egyre inkább előírt a B2B tranzakciókban is. A Holded biztosítja a megfelelő formátumú számlák automatikus kiállítását.

Előfeltételek​

  • Aktív Holded fiók (bármely csomag)
  • Holded API kulcs (lásd alább)
  • CADENSA Számlázási szolgáltató beállítása szükséges

API kulcs generálása​

  1. Jelentkezz be a Holded fiókodba
  2. Nyisd meg a Beállítások → Integrációk → API menüt
  3. Kattints az Új API kulcs gombra
  4. Másold ki a generált kulcsot — csak egyszer látható!
Biztonság

Az API kulcsot biztonságos helyen tárold (pl. jelszókezelő). Ha elveszíted, új kulcsot kell generálni a Holded-ben, és frissíteni a CADENSA-ban.

Holded beállítása a CADENSA-ban​

  1. Nyisd meg a Beállítások → Számla menüt
  2. Válaszd a Holded szolgáltatót
  3. Illeszd be a Holded API kulcsodat az API Key mezőbe
  4. Kattints a Kapcsolat tesztelése gombra — ez megerősíti, hogy a kulcs érvényes
  5. Kattints a Mentés gombra

Alapértelmezett értékek beállítása​

BeállításAjánlott érték (ES)Leírás
Alapértelmezett pénznemEURÚj számlákon alkalmazott pénznem
Alapértelmezett ÁFA %21Standard spanyol IVA (általános kulcs)
Fizetési határidő (nap)30Esedékesség napjai
Alapértelmezett dokumentumtípusSzámlaEz lesz előre kiválasztva az párbeszédablakban
Kibocsátó országESA cég országa — automatikus ÁFA javaslat engedélyezéséhez

Spanyol IVA kulcsok​

KulcsArányLeírás
IVA 21%21%Tipo general — általános áruk és szolgáltatások
IVA 10%10%Tipo reducido — élelmiszer, egészségügyi termékek, szállás
IVA 4%4%Tipo superreducido — alapvető élelmiszer, gyógyszerek, könyvek
Exento0%Exento — adómentes ügyletek, export, egyes pénzügyi szolgáltatások

Partner kereső​

A számla generálásakor a Partner kereső lehetővé teszi, hogy a Holded-fiókodból keress ügyfeleket:

  1. A Számla generálása párbeszédablakban kattints a Partner keresése gombra
  2. Gépeld be a kapcsolat nevét vagy NIF/CIF adószámát (minimum 2 karakter)
  3. Válaszd ki a megfelelő ügyfelet a listából
  4. Az összes ügyfélmező automatikusan kitöltődik:
  • Név, cím, NIF/CIF adószám
  • Ország (a Holded eredeti nevén jelenik meg, pl. „Spain", „Hungary")
Ügyfél nem található?

Ha az ügyfél nem szerepel a listában, töltsd ki manuálisan a mezőket. A ügyfél nem kerül automatikusan létrehozásra a Holded-ben — ezt manuálisan kell megtenni a Holded felületén.

Ügyfél-keresési logika​

A CADENSA az alábbi sorrendben keresi az ügyfeleket:

  1. NIF/CIF egyezés (ha meg van adva az ügyfél ÁFA száma)
  2. Névazonosság (pontos egyezés keresése)
  3. Névtöredék (részleges egyezés)

Számla visszavonása​

A Holded-számlák visszavonhatók a CADENSA Jelentések → Számlák fülről:

  1. Keresd meg a visszavonandó számlát
  2. Kattints a ⋯ Műveletek gombra
  3. Válaszd a Számla visszavonása lehetőséget
  4. A CADENSA meghívja a Holded API void végpontját
Megjegyzés

A visszavonott számla a Holded-ben „érvénytelenített" állapotba kerül. Ez könyvelési szempontból végleges — nem lehet újra aktiválni.

PDF letöltés​

  1. A számla generálása után a CADENSA lekéri a PDF-et a Holded API-ján keresztül
  2. A PDF letöltési gomb a Jelentések → Számlák fülön jelenik meg
  3. A PDF a Holded szervereiről töltődik le közvetlenül

Támogatott piacok​

OrszágÁFA rendszerMegjegyzés
SpanyolországIVAFacturaE kötelező a közszektori számlákhoz
PortugáliaIVAStandard európai szabályok
OlaszországIVASDI e-számlázási rendszerrel kompatibilis
FranciaországTVAFactur-X szabvány alkalmazásával
NémetországMwStZUGFeRD szabvány alkalmazásával

Hibaelhárítás​

„Érvénytelen API kulcs" hiba​

  • Ellenőrizd, hogy a teljes kulcsot másoltad-e be (szóközök nélkül)
  • Generálj új API kulcsot a Holded-ben (Beállítások → Integrációk → API)

„Partner nem található" — kereső üres eredményt mutat​

  • Ellenőrizd, hogy az ügyfél létezik a Holded-fiókodban
  • A kereső minimum 2 karaktert igényel

„Kapcsolat tesztelése" sikertelen​

  • Ellenőrizd, hogy a Holded-fiókod aktív és nem korlátozott
  • Ellenőrizd az API kulcs jogosultságait: legyen engedélye az invoicing modulhoz

A PDF nem töltődik le​

  • A Holded API néha késleltet; várj 30 másodpercet, majd próbáld újra
  • Ha a probléma fennáll: support@cadensa.io

Dokumentum típus útválasztás​

DokumentumtípusKimenet
ProformaBelső PDF (nem kerül elküldésre a Holded-be)
MunkakimutatásBelső PDF (nem kerül elküldésre a Holded-be)
SzámlaElküldve a Holded API-ra → PDF visszatöltve

Csak a Számla típusú dokumentumok kerülnek a Holded-be. A proforma és munkakimutatás mindig belsőleg generálódik.

Lásd még​