netSEO Smartbill Facturare pentru CS-Cart - Modul Integrare Generare Facturi in Smartbill
netSEO Smartbill Facturare pentru CS-Cart - Modul Integrare Generare Facturi in Smartbill
Scrie o recenzie
78534 Lei

netSEO Smartbill Facturare pentru CS-Cart - Modul Integrare Generare Facturi in Smartbill

netseo_smartbill_facturare
Scrie o recenzie
Ex. domeniu.ro, domeniu.com
Descriere

netSEO: Smartbill Facturare pentru CS-Cart

netSEO: Smartbill Facturare este un addon profesional pentru CS-Cart care automatizează generarea facturilor electronice prin integrarea directă cu platforma Smartbill Cloud (smartbill.ro). Modulul permite emiterea de facturi conform ANAF direct din pagina comenzii, cu preluare automată a datelor client și produse, reducând la minimum intervenția manuală și asigurând conformitatea cu legislația fiscală română.

Generare automată a facturilor în Smartbill

Modulul permite generarea facturilor direct din pagina de detaliu comandă, cu un singur click. Datele sunt trimise către API-ul Smartbill (documentație: https://api.smartbill.ro/), iar factura emisă este salvată automat în sistem, cu posibilitate de acces la link-ul către document. Fluxul respectă specificațiile Smartbill: autentificare Basic (email + token API), parametri firmă, client, produse și transport.

Integrare completă cu comenzile CS-Cart

Toate datele comenzii sunt preluate automat din CS-Cart:

  • Informații client (persoană fizică sau juridică)
  • Adresă de facturare, localitate, județ și țară
  • Produse comandate cu prețuri, cantități și coduri
  • Costuri de transport (linie dedicată în factură)
  • Monedă și data scadenței (configurabilă)

Modulul normalizează datele pentru API (eliminare diacritice unde este cazul) și asigură completarea câmpurilor obligatorii conform documentației Smartbill (ex. adresă/localitate „-” dacă lipsesc, CUI/CNP sau „-” pentru persoane fizice).

Configurare API Smartbill

Conectarea la Smartbill se face prin setările addon-ului:

  • URL API – URL de bază (implicit: https://ws.smartbill.ro/SBORO/api)
  • Utilizator (email) – adresa de e-mail din contul SmartBill Facturare/Gestiune
  • Token API – tokenul din SmartBill: Contul Meu → Integrari → API
  • CUI Companie – CUI-ul firmei emitente (doar cifre, fără prefix RO)
  • Serie factură – seria documentelor (ex: netseo, FACT, INV), definită în contul Cloud
  • Zile până la scadență – număr de zile pentru data scadenței facturii

Autentificarea se face prin Basic Authentication (email:token), conform documentației oficiale Smartbill.

Suport pentru persoane fizice și juridice

Modulul recunoaște tipul de client și preia datele din câmpurile de profil configurate:

  • Persoană juridică – nume companie, CUI, Nr. Reg. Com. (ID-uri câmpuri profil)
  • Persoană fizică – nume din facturare; CNP din câmp profil opțional; pentru fără CNP se trimite „-” conform API Smartbill

Județul este preluat din state-ul comenzii (b_state_descr) și trimis în format acceptat de Smartbill. Opțiunea „Salvează client în Smartbill” permite adăugarea automată a clientului în nomenclatorul Smartbill.

Produse și transport în factură

Fiecare linie de produs este trimisă către API cu:

  • Nume produs, cod (product_code sau PROD-ID), cantitate, preț (cu sau fără TVA)
  • Cotă TVA (nume și procent) și unitate de măsură (implicit BUC)
  • Monedă per linie (conform documentației Smartbill)

Transportul este adăugat ca linie separată, cu nume și cod configurabile (ex. „Cost transport”, cod TRANSP). Toate liniile respectă structura API (name, code, quantity, price, isTaxIncluded, taxName, taxPercentage, measuringUnitName, currency, isService pentru transport).

Configurare flexibilă a facturii

Administratorii pot configura:

  • Seria facturii și zilele până la scadență
  • Cota TVA și denumirea cotei (ex. Normala)
  • Prețurile incluzând sau nu TVA (isTaxIncluded)
  • Unitatea de măsură pentru produse și transport
  • Nume și cod pentru linia de transport
  • Câmpuri profil pentru companie, CUI, CNP, Nr. Reg. Com.

Istoric facturi generate

Toate facturile generate sunt salvate în baza de date cu:

  • ID comandă
  • Serie și număr factură (din răspunsul API)
  • Link către factură (PDF sau vizualizare, dacă este returnat de API)
  • Data generării

În pagina comenzii sunt afișate subheader „Generator Facturi Smartbill”, listă cu linkuri către facturile existente și buton „Generează Factură” (design albastru, culoare #467AD2) cu confirmare. Butoanele de acțiune pe factură apar doar după ce a fost generată cel puțin o factură.

Acțiuni pe facturi emise (API SmartBill)

După generarea unei facturi, pentru fiecare factură sunt afișate butoane mici cu iconițe care apelează direct API-ul SmartBill (conform documentației https://api.smartbill.ro/ – reverse, cancel, delete, restore):

  • Storno – emitere factură storno în baza facturii existente (POST /invoice/reverse). Factura storno este salvată automat în listă; stornarea este posibilă doar dacă pe factură nu există deja stornări.
  • Anulare – anulare factură în SmartBill fără ștergere din baza de date (PUT /invoice/cancel).
  • Ștergere – ștergere factură din SmartBill și din CS-Cart (DELETE /invoice). Conform API, doar ultima factură din serie poate fi ștearsă; pentru celelalte se folosește anularea.
  • Restaurare – restaurare factură anterior anulată (PUT /invoice/restore).

Fiecare acțiune este confirmată înainte de trimitere. Mesajele de eroare returnate de API (ex. „Factura este deja stornată”, „Documentul nu este ultimul din serie”) sunt afișate utilizatorului.

Mod debug pentru dezvoltare

Modulul include opțiune de debug care afișează JSON-ul trimis către API-ul Smartbill înainte de generarea facturii. Este util pentru testarea configurației, validarea datelor și depanare în cazul erorilor API (ex. serie inexistentă, CIF invalid, mesaje 400).

Integrare cu netSEO Addons Manager

Modulul se integrează cu netSEO Addons Manager pentru gestionarea licenței și actualizărilor:

  • Verificare licență la activare și la salvare cod licență
  • Cod licență configurat din setările addon-ului
  • Upgrade Center Connector pentru update-uri automate
  • Comportament aliniat cu celelalte addon-uri netSEO

Compatibilitate

Addon-ul este construit pentru stabilitate și conformitate cu API-ul Smartbill:

  • Compatibil CS-Cart 4.10.1+, ediții ULTIMATE și MULTIVENDOR
  • Dependență obligatorie: netSEO Addons Manager
  • La dezinstalare se șterg tabelul de facturi și înregistrarea de licență din Addons Manager

Integrare nativă în CS-Cart

netSEO: Smartbill Facturare se integrează în interfața de administrare CS-Cart prin hook în pagina de detaliu comandă (zona informații livrare): buton „Generează Factură” (albastru) și listă cu facturile Smartbill deja generate, fiecare cu butoane pentru vizualizare PDF, storno, anulare, ștergere și restaurare. Configurarea API, a câmpurilor client și a parametrilor de produs/transport se face din Setări addon, iar fluxul de emitere (pregătire date → POST /invoice → salvare serie/număr/link) și acțiunile pe facturi (reverse, cancel, delete, restore) sunt gestionate integral de modul.

Fără o integrare dedicată Smartbill, generarea facturilor din comenzi implică exporturi manuale sau facturare în altă aplicație. Acest addon oferă o soluție completă, aliniată la documentația oficială Smartbill (https://api.smartbill.ro/), cu suport pentru persoane fizice și juridice, transport, TVA și istoric facturi, potrivită pentru magazine CS-Cart care folosesc Smartbill Cloud ca soluție de facturare.

Caracteristici
Developer
netSEO
Recenzii
5
Recenzii: 1
5 stele
100%
4 stele
0%
3 stele
0%
2 stele
0%
1 stea
0%
Sub anonimat
5
Great addon to have for invoice automation with SmartBill and Cs-Cart! We had some slight issues with the addon, but netSEO team fixed them right away! Awesome addon and great people supporting it!

Intrebari frecvente despre netSEO Smartbill Facturare pentru CS-Cart - Modul Integrare Generare Facturi in Smartbill

netSEO Smartbill Facturare pentru CS-Cart - Modul Integrare Generare Facturi in Smartbill este un produs digital pentru platforma CS-Cart, disponibil pe CS-Cart Romania. După achiziție, produsul poate fi utilizat conform descrierii, documentației și condițiilor afișate în pagina produsului.

După plasarea și achitarea comenzii, pentru modulele CS-Cart se generează automat serialul de licență, iar modulul poate fi descărcat și instalat în site-ul clientului. Pentru licențele CS-Cart, distribuirea se face în aproximativ 1-2 zile lucrătoare după confirmarea plății.

Comenzile se pot plasa online și se achită cu card Visa sau Mastercard prin procesatori de plată securizați, inclusiv procesatori internaționali precum Stripe, acolo unde sunt disponibili.

Da. Modulele netSEO includ update gratuit timp de 6 luni, perioadă în care sunt corectate gratuit bug-urile sesizate. Licențele CS-Cart includ, de regulă, 12 luni de upgrade gratuit, conform condițiilor licenței.

Produsele digitale achiziționate și instalate nu sunt rambursabile. Te rugăm să verifici descrierea, compatibilitatea și documentația produsului înainte de achiziție.

Nu. Modulele netSEO respectă documentația de dezvoltare CS-Cart Add-on Development și nu modifică fișierele core ale platformei CS-Cart.

Modulele netSEO se instalează prin Add-on Manager netSEO, printr-un singur clic, iar fiecare modul include documentație de utilizare și configurare.

Recomandarile noastre