Ce include integrarea
Inregistram webhook-ul order/paid in Shopify Admin sau via Admin API GraphQL, configurat sa trimita payload-ul JSON la endpoint-ul nostru cu HMAC signature pentru securitate. Validam fiecare cerere cu SHOPIFY_WEBHOOK_SECRET pentru a preveni cereri falsificate.
O functie pe Vercel, Cloudflare Workers sau Next.js API route care preia comanda Shopify, mapeaza fiecare line item pe formatul SmartBill (cota TVA, cod produs, pret unitar fara TVA, cantitate, unitate masura), gestioneaza shipping cost ca linie separata si aplica reduceri proportional.
Endpoint POST catre ws.smartbill.ro/SBORO/api/invoice cu Basic Auth (email cont + API token din SmartBill Setari). Setam seria, numarul, data, clientul (creat la prima comanda cu detect cod fiscal sau persoana fizica), lista produse si moneda. Numar factura salvat ca metafield in Shopify pe comanda.
Configurare in SmartBill optiunea Trimitere automata e-Factura SPV pentru toate facturile B2B (cod fiscal RO valid). Pentru B2C peste 600 RON aplicam aceeasi regula. SmartBill trimite XML UBL 2.1 in SPV in maximum 5 zile lucratoare. Niciun click manual de la tine.
Pentru comenzi cu metoda de plata Virament bancar sau Plata la livrare, emitem proforma in SmartBill (endpoint /api/estimate) imediat la order/created. PDF trimis automat clientului cu detalii bancare. Factura fiscala emisa abia la order/paid, cu referinta la proforma.
La fiecare comanda cu adresa de facturare in UE si CUI completat, apelam VIES API gratuit al Comisiei Europene. Daca CUI valid → factura cu TVA 0% reverse charge. Daca invalid sau persoana fizica → cota TVA tara destinatie (OSS) sau RO 19% sub pragul de 10.000€.
Webhook refunds/create primeste payload-ul cu line items returnate si suma refundata. Apelam SmartBill /api/invoice/storno cu referinta la factura initiala. Storno emis cu seria separata legal, retransmis pe SPV ANAF. Retururi partiale gestionate corect, fara dubleaza in declaratia D394.
Toate apelurile sunt logate in Sentry pentru debugging. Daca SmartBill API e down sau returneaza eroare 5xx, mecanism de retry exponential backoff in 3 incercari peste 30 secunde. Dashboard intern unde vezi facturile emise in ultima saptamana cu status si link rapid catre SmartBill.
Cum functioneaza
Cumparatorul finalizeaza checkout-ul cu card prin Shopify Payments, Stripe sau NETOPIA. Comanda are status paid si toate datele de facturare completate (nume sau denumire firma, CUI optional, adresa).
In 1-3 secunde de la confirmarea platii, Shopify trimite payload-ul JSON cu detaliile comenzii catre endpoint-ul nostru. Validam HMAC signature cu secretul Shopify pentru a confirma autenticitatea cererii.
Serverless function transforma comanda Shopify in payload SmartBill: produse cu cote TVA corecte, shipping, reduceri. Daca exista CUI UE, apelam VIES sa-l validam si setam corect flag-ul de TVA reverse charge.
Trimitem cererea catre SmartBill ws.smartbill.ro/SBORO/api/invoice cu Basic Auth. Primim inapoi numarul facturii alocat din seria configurata. Salvam in Shopify Order metafield smartbill_invoice_number pentru referinta.
Configurat sa trimita automat, SmartBill formatizeaza factura in XML UBL 2.1 si o depune in SPV ANAF in fereastra legala de 5 zile lucratoare. Pentru B2B obligatoriu, pentru B2C peste 600 RON din 2025.
Klaviyo sau Shopify Email atasamenteaza PDF-ul facturii la confirmarea de comanda trimisa clientului. Tu vezi factura in Shopify Order detail, in SmartBill app si in dashboard-ul intern de monitoring construit pentru tine.
Stack tehnic
GraphQL Admin API pentru a citi comenzi, scrie metafields si gestiona returns. Webhook topics: orders/paid, orders/cancelled, refunds/create. HMAC signature validation pe fiecare cerere.
Endpoint-uri /api/invoice, /api/estimate, /api/invoice/storno, /api/invoice/payment. Basic Auth cu email cont + token. Documentatie completa pe smartbill.ro/manual-pentru-utilizatori.
Endpoint-ul de webhook pe Next.js App Router /api/webhooks/shopify cu deploy pe Vercel sau pe Cloudflare Workers pentru cost zero la volum mic. Edge runtime pentru latenta sub 50ms.
SmartBill se ocupa de XML UBL 2.1 + autentificare cu certificat digital ANAF. Tu doar bifezi optiunea in setari, restul ruleaza automat. Conform cerintei OUG 120/2021 pentru B2B obligatoriu.
Serviciu gratuit al Comisiei Europene la ec.europa.eu/taxation_customs/vies. Validam codul fiscal in timp real la order paid pentru a aplica corect TVA 0% reverse charge in tranzactiile intra-UE.
Logging structurat in Sentry pentru fiecare apel API. Alertare Slack instant daca SmartBill returneaza eroare 4xx/5xx, daca webhook Shopify nu poate fi validat sau daca VIES e indisponibil.
Pricing
350€
Setup in 5 zile
600-800€
Setup in 7-10 zile
1000-1200€
Setup in 14 zile
Intrebari frecvente
Integrarea se face prin Shopify webhooks + SmartBill REST API v1. Pasi concreti: 1) Configuram webhook order/paid in Shopify Admin care trimite payload-ul comenzii la endpoint-ul nostru. 2) Un serverless function (Vercel, Cloudflare Workers sau Next.js API route) primeste webhook-ul, valideaza HMAC signature cu SHOPIFY_WEBHOOK_SECRET, mapeaza linia comenzii pe formatul SmartBill (cota TVA, cod produs, pret fara TVA). 3) Apel POST la https://ws.smartbill.ro/SBORO/api/invoice cu Basic Auth (email + token din SmartBill). 4) Salvam invoice number primit inapoi ca metafield pe comanda Shopify. 5) Optional retransmitem PDF-ul facturii ca email atasament cu o aplicatie Klaviyo sau Shopify Email. Pentru cele mai multe magazine durata implementarii e 5-10 zile.
Setup implementare: 350€ pentru pachet basic (doar facturi automate B2C, fara TVA UE complex), 600-800€ pentru pachet complet (facturi + proforme + e-Factura ANAF + tratare retururi), 1000-1200€ pentru Shopify Plus B2B cu reguli TVA intracomunitar, multi-currency si validare CUI prin VIES. Abonamente lunare: Shopify Basic 27€/luna sau Advanced 84€/luna, SmartBill Pro de la 14€/luna (necesar pentru API), opcional o aplicatie out-of-the-box gen Invoice Falcon 15-30€/luna daca nu vrei custom. Solutia custom ramane mai ieftina la peste 200 comenzi/luna fata de aplicatii lunare per-order.
Da, automat. Dupa setup, fluxul ruleaza fara interventie: client cumpara pe Shopify, plateste cu cardul prin Shopify Payments sau Stripe sau NETOPIA, webhook order/paid se declanseaza in 1-5 secunde, facturam fiscala se emite in SmartBill cu numar corect din seria configurata, PDF-ul e atasat pe pagina comenzii in Shopify Admin si trimis automat catre clientul pe email. Nu trebuie sa intri zilnic in SmartBill sa apesi butoane. Single point of manual: doar pentru comenzi cu cerere de factura pe firma cu CUI diferit, unde adresa de facturare e completata altfel decat shipping — atunci primesti notificare Slack si confirmi rapid in 30 secunde.
SmartBill are integrare nativa cu SPV ANAF (sistemul e-Factura) inclusa in abonamentul Pro de la 14€/luna. Dupa ce factura se emite via API din Shopify, SmartBill o trimite automat in format XML UBL 2.1 catre SPV ANAF in maximum 5 zile lucratoare (legal cerinta). Nu trebuie sa faci nimic in plus — fluxul Shopify > webhook > SmartBill API > SmartBill > SPV ANAF ruleaza end-to-end automat. La nivel tehnic noi configuram in SmartBill optiunea trimite automat e-Factura (Setari > e-Factura > Activare automata). Pentru B2B obligatoriu din 2024 (CUI client RO), B2C de la 1 ianuarie 2025 e-Factura e obligatorie pentru tranzactiile peste 600 RON.
Da, dar logica e mai complexa. Pentru clientii care platesc cu plata la livrare sau virament bancar (nu card instant), recomandam acest flow: comanda creata in Shopify cu status pending, webhook order/created (nu paid) emite proforma in SmartBill via API endpoint /api/estimate, PDF-ul e trimis automat clientului cu detalii bancare prelipite. Dupa ce vine plata prin OP bancar si o marcam fulfilled in Shopify, webhook order/paid emite factura fiscala definitiva care o inlocuieste pe proforma. Pentru Shopify Plus folosim si Draft Orders API pentru cazuri cu negociere preturi B2B inainte de comanda finala. Pachetul cu proforme intra in 600-800€.
Aici e capcana clasica. Reguli: vanzare B2C (consumator final) in alta tara UE — aplici cota TVA a tarii destinatare daca treci de prag 10.000€/an cifra afaceri intra-UE (OSS - One Stop Shop). Vanzare B2B cu CUI valid VIES — facturezi cu TVA 0% reverse charge si declari in 390/394. Implementare in flow: noi adaugam in webhook-ul Shopify un check prealabil — daca shipping country e EU si exista billing CUI completat, apelam EU Commission VIES API (gratuit) sa validam CUI-ul, daca e valid trimitem SmartBill flag taxInversa true si cota 0%, altfel aplicam cota TVA tara destinatie (lista cote o avem hardcoded si actualizam anual). Pentru magazine sub pragul OSS, ramanem pe TVA 19% RO. Pachet cu TVA UE complet inclus in 1000-1200€.
Webhook refunds/create din Shopify ne trimite payload-ul cu suma refundata si line items returnate. Endpoint-ul nostru apeleaza SmartBill API la /api/invoice/cancel sau /api/invoice/storno cu referinta la factura initiala. SmartBill genereaza factura de storno cu numar din seria de stornare (separata legal de seria normala) si o trimite si pe SPV ANAF. Pentru retur partial, cream factura de storno doar pentru valoarea returnata, nu pentru intreaga comanda. Edge case important: refund dupa ce factura a fost deja preluata in declaratia D394 de luna trecuta — atunci storno se face cu data curenta, nu retroactiv (altfel ANAF da neconcordante). Configurarea fluxului de retururi face parte din pachetul de 600€+.
Da, dar implementarea diferiseste semnificativ. Shopify Plus B2B foloseste Companies API si Catalog-uri separate cu preturi B2B (frecvent fara TVA in listing) si plata pe net terms (Net 30, Net 60). In acest caz noi mapam Company din Shopify pe Client B2B in SmartBill (creat automat la prima comanda cu CUI validat VIES) si emiteam facturi cu termen de plata variabil. Multi-currency e gestionat astfel: comanda in EUR/USD/GBP, dar factura SmartBill emisa obligatoriu in RON cu BNR rate din ziua emiterii (cerinta ANAF), valoarea originala in valuta apare ca observatie. Pentru Shopify Plus integrarea o cotam la 1000-1500€ in functie de numar de Catalog-uri si reguli pricing B2B. Pachetul 1200€ acopera cel mai standard caz Plus.
Servicii conexe
SmartBill conectat cu WooCommerce, Magento, PrestaShop sau site custom — nu doar Shopify.
Magazin nou pe Shopify pentru piata RO, livrat in 14-30 zile cu SmartBill din start.
Daca preferi Oblio in loc de SmartBill pentru facturare si e-Factura — integrare similara.
Shopify Plus cu Catalog-uri B2B, Companies API, preturi separate si net terms pentru distributie.
Pagina dedicata integrarii directe cu SPV ANAF, OAuth certificate digital, XML UBL 2.1.
Magazinele Shopify pe care am livrat integrari SmartBill + ANAF in ultimele 12 luni.