Acest ghid detaliază procesul complet de activare și configurare a integrării SmartBill în cadrul platformei Infinity Marketplace.
Integrarea permite emiterea automată a facturilor pentru comenzile plasate în magazinul online, reducând erorile manuale și optimizând fluxul de vânzare–facturare–livrare.
Pentru ca integrarea să funcționeze corect, trebuie să existe următoarele:
✅ Cont activ în SmartBill, cu acces la funcția API (secțiunea Cont > Integrări API).
✅ Acces administrativ în VTEX Admin (drepturi de configurare aplicații).
✅ Aplicația Seller Order Processing instalată în magazin.
✅ Datele de facturare corect configurate în SmartBill (serie, cod TVA, token API etc.).
Recomandare: înainte de a începe, testează conexiunea API SmartBill separat, pentru a verifica dacă tokenul este valid.
- Accesarea secțiunii de aplicații
- Autentifică-te în contul tău VTEX Admin.
- Din meniul lateral stâng, selectează: Aplicații → Gestionare aplicație (Această secțiune conține toate extensiile instalate în magazin, inclusiv aplicațiile interne și cele de la parteneri terți).
„Pentru a putea activa SmartBill, în secțiunea Aplicații selectăm Gestionare aplicație”
Identificarea aplicației corecte
În pagina „Gestionare aplicație”, folosește bara de căutare din partea de sus.
Caută după denumirea: Seller Order Processing
Confirmă că aplicația este instalată (apare cu marcaj verde și textul Instalată).
Apasă pe butonul Setări (⚙️) din dreptul aplicației. „Căutăm Seller Order Processing”
Configurarea integrării SmartBill
După ce ai accesat setările aplicației, derulează în jos până la secțiunea: SmartBill Settings
Aici se realizează activarea și conectarea efectivă cu contul SmartBill.
Activarea integrării
Bifează caseta „Enable SmartBill Integration”. Aceasta activează opțiunile de configurare a câmpurilor aferente SmartBill.
„Dăm scroll până găsim Enable SmartBill”
Completarea datelor SmartBill
Completează următoarele câmpuri:
Câmp Descriere Exemplu
SmartBill Username Adresa de e-mail asociată contului SmartBill tehnic@infinity.ro
SmartBill API Token Cheia unică API generată în contul SmartBill b9f2a3b1cde98…
SmartBill VAT Code Codul fiscal al firmei (cu prefixul RO, dacă este cazul) RO8943657
SmartBill Series Name Codul seriei de facturi utilizată în SmartBill INF
„Bifăm casuța și completăm credențialele”
Atenție: Asigură-te că toate câmpurile sunt completate exact ca în contul SmartBill.
Tokenul API trebuie să aibă permisiuni pentru Creare facturi și Citire date cont.
În caz de eroare de conexiune, revizuiește tokenul sau verifică dacă aplicația are acces extern activat.
Salvarea modificărilor
După completarea celor patru câmpuri, derulează până la finalul paginii și apasă:
Save / Salvare
„După ce am completat cele 4 câmpuri, mergem josul paginii pentru a salva”
✅ Odată salvată, VTEX va stoca aceste date și va începe sincronizarea automată a facturilor în momentul procesării comenzilor.
Verificare și testare
Plasează o comandă de test în magazinul tău VTEX.
După ce comanda trece în statusul „Finalizată / Livrată”, verifică în contul SmartBill dacă s-a generat automat factura.
Dacă integrarea este corectă:
Factura va fi emisă automat;
Datele clientului și produsele vor fi completate corespunzător;
Seria și TVA-ul vor corespunde celor definite în setări.
Bune practici și depanare
Situație Cauză posibilă Soluție recomandată
Facturile nu se generează Token API invalid sau necompletat Reînnoiește tokenul din contul SmartBill
TVA incorect Cod TVA greșit sau lipsă Revizuiește câmpul „SmartBill VAT Code”
Eroare de conectare Aplicația nu are permisiune externă Activează accesul API în SmartBill
Seria nu apare Câmpul „SmartBill Series Name” este gol Completează corect codul seriei (ex. INF)
💬 Pentru depanare avansată, consultă logurile aplicației „Seller Order Processing” din consola VTEX Admin.
Concluzie
Prin activarea acestei integrări:
Facturile sunt emise automat prin SmartBill la fiecare comandă validată;
Se elimină procesul manual de facturare;
Se asigură trasabilitatea completă între comenzile VTEX și documentele contabile SmartBill.