Ugrás a fő tartalomhoz

SmartBill integráció

A SmartBill egy romániai számlázási platform, amely teljes e-Factura / ANAF megfelelőséget biztosít a román piachoz ().

e-Factura kötelezettség

Románia kötelezővé tette az e-Factura jelentést az ANAF-nak (Adóügyi Nemzeti Ügynökség) a B2B tranzakciókban. A SmartBill automatikusan kezeli az ANAF beküldést, ha a SmartBill Cloud fiókodban konfigurálva van.

Előfeltételek​

  • Aktív SmartBill Cloud fiók
  • SmartBill API token (lásd alább)
  • Vállalat CIF/CUI adószáma
  • Legalább egy számlafüzet (FCT sorozat) a SmartBill-ben konfigurálva
  • CADENSA Számlázási szolgáltató beállítása szükséges

API token generálása​

  1. Jelentkezz be a SmartBill Cloud fiókodba
  2. Nyisd meg a Contul Meu → Integrări → API menüt
  3. Kattints az Generare token gombra
  4. Másold ki a generált tokent
Hitelesítési adatok

A SmartBill HTTP Basic Auth hitelesítést használ:

  • API Key (token): A generált API token
  • API Secret (e-mail): A SmartBill-regisztrációs e-mail-cím
  • Company ID (CIF): A vállalat adószáma (pl. RO12345678)

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

  1. Nyisd meg a Beállítások → Számla menüt
  2. Válaszd a SmartBill szolgáltatót
  3. Töltsd ki a mezőket:
  • API Key: SmartBill API token
  • Account Email (API Secret): SmartBill-regisztrációs e-mail
  • Company ID: Vállalat CIF adószáma (pl. RO12345678)
  1. Kattints a Kapcsolat tesztelése gombra — ellenőrzi a tokent és a CIF-et
  2. Kattints a Mentés gombra

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

BeállításAjánlott érték
PénznemRON
ÁFA kulcs19% (cota normală)
Fizetési határidő30 nap

Román TVA kulcsok​

KulcsArányLeírás
Normala19%Standard kulcs — általános áruk és szolgáltatások
Redusa9%Csökkentett — élelmiszer, gyógyszer, szállodaszolgáltatások
Redusa15%Szuper-csökkentett — könyvek, újságok, szociális lakhatás
Scutit0%Adómentes — export, egyes közérdekű szolgáltatások

Partner kereső​

A számla generálásakor a Partner kereső lehetővé teszi, hogy a SmartBill-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 az ügyfél nevét vagy 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:
  • Cégnév, cím, CIF/CUI adószám
  • TVA-alanyiság állapota
Ü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 SmartBill-ben.

Számlafüzet (FCT sorozat)​

A SmartBill megköveteli, hogy a számla egy előre konfigurált számlafüzethez (sorozathoz) tartozzon:

  • A számlafüzeteket a SmartBill Cloud-ban kell létrehozni (Documente → Serii Documente)
  • Az alapértelmezett sorozat neve általában FCT
  • Az ANAF-beküldéshez az FCT sorozatot kell használni

Ha a számla generálása „Érvénytelen sorozat" hibával meghiúsul, ellenőrizd a SmartBill-fiókodban a konfigurált sorozatokat.

Számla visszavonása (anulare)​

Megjegyzés

A SmartBill különbséget tesz a visszavonás (anulare) és a törlés (stergere) között:

  • Visszavonás (anulare): A számla „anulata" állapotba kerül, az ANAF-nál is megjelenik — könyvelési szempontból végleges
  • Törlés: Csak vázlat számlánál lehetséges

A CADENSA a visszavonás (anulare) API végpontot hívja: PUT /invoice/cancel.

TVA-alany és nem TVA-alany cégek​

A SmartBill integráció mindkét esetben működik:

TípusLeírásBeállítás
TVA-alanyNormális TVA-kulcsok alkalmazhatókStandard beállítás
Nem TVA-alany0% TVA (Scutit) szükségesAlapértelmezett kulcs: 0

PDF letöltés​

  1. A számla generálása után a CADENSA lekéri a PDF-et a SmartBill 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 SmartBill API szinkron — a PDF általában azonnal elérhető

Hibaelhárítás​

„Érvénytelen hitelesítési adatok" hiba​

  • Ellenőrizd, hogy a helyes e-mail-címet és API tokent adtad meg
  • Generálj új API tokent a SmartBill-ben (Contul Meu → Integrări → API)

„Érvénytelen CIF" hiba​

  • Ellenőrizd a CIF formátumát: RO előtag + számok (pl. RO12345678) vagy csak számok (pl. 12345678)
  • Ellenőrizd, hogy az ANAF adatbázisában regisztrált CIF-et adtad meg

„Érvénytelen sorozat" hiba​

  • Ellenőrizd, hogy legalább egy FCT sorozat be van állítva a SmartBill-ben
  • Documente → Serii Documente → Adaugă serie

„Kapcsolat tesztelése" sikertelen​

  • Ellenőrizd, hogy a SmartBill-fiókod aktív
  • Ellenőrizd az összes hitelesítési adatot (e-mail, token, CIF)

A PDF nem töltődik le​

CADENSA → SmartBill mező megfeleltetés​

CADENSA mezőSmartBill mező
Leírásname
Mennyiség (óra)quantity
Egységárprice
Egység (óra/nap/darab)measuringUnitName (ora/zi/buc)
ÁFA kulcstaxName + taxPercentage
Projekt / feladatproductDescription

Lásd még​