Cum conectezi FGO cu easySales: ghidul complet de configurare
Conectează FGO la easySales: cei trei pași de făcut întâi în FGO, fiecare setare a conexiunii, cum se emit facturile, ce înseamnă fiecare eroare FGO și cum folosești FGO ca sursă de stoc.
Ce îți aduce conectarea FGO
FGO este un serviciu românesc de facturare. Conectat la easySales, emite factura pentru o comandă fără să retastezi nimic — din lista de comenzi, din comanda în sine, în masă sau automat, dintr-un flux. Același utilizator API din FGO poate fi folosit și a doua oară, separat, ca să citească stocurile din FGO în easySales.
Înainte să începi
Un cont FGO cu acces API
Utilizatorul API de la pasul 1 poate fi creat doar pe un plan FGO care include acces API. Verifică-ți planul în FGO înainte să începi.
Un utilizator API creat în FGO
Nu contul tău obișnuit. FGO îi generează o parolă, iar acea parolă este ceea ce easySales numește Cheia privată.
CUI-ul tău
Codul fiscal afișat în Setări → Firmă, în FGO.
O serie de facturare gata de folosit
Cu drepturi API, o perioadă valabilă și numere încă disponibile. Acesta este pasul cel mai des uitat.
Pașii 1-3 se petrec în FGO, nu în easySales. Fiecare are o cădere distinctă, iar omiterea oricăruia produce un mesaj de eroare care are sens doar după ce știi la ce se referă — așa că merită făcuți toți trei înainte să deschizi easySales.
Pasul 1 — Creează utilizatorul API în FGO
În panoul de administrare FGO deschide Setări → Utilizatori și adaugă un utilizator API. FGO îi generează o parolă: copiaz-o acum, pentru că ea este ceea ce easySales numește Cheia privată.
Pasul 2 — Lasă FGO să accepte apeluri de la easySales
În FGO deschide Setări → eCommerce → Setări API și adaugă https://easy-sales.com în lista site-urilor care au voie să se conecteze prin API.
Pasul 3 — Pregătește seria de facturare
În FGO deschide Setări → Serii Documente și verifică seria cu care vrei să facturezi. Are nevoie de dreptul User API — atât pe utilizatorul API în sine, cât și pe intrarea pentru toți utilizatorii — și de o perioadă From / To care acoperă ziua de azi, cu numere rămase în ea.
Pasul 4 — Conectează FGO în easySales
Mergi în Configurare → Integrări → Facturare și caută cardul FGO.
Apasă Conectează și completează formularul.
| Câmp | Ce face |
|---|---|
| Nume conexiune | Obligatoriu. Eticheta ta. Devine numele tab-ului dacă legi mai multe conturi FGO. |
| CUI Firmă | Obligatoriu. CUI-ul tău, exact așa cum îl arată FGO în Setări → Firmă. |
| Cheia privată | Obligatoriu. Parola generată de FGO pentru utilizatorul API de la pasul 1. Este afișată în clar în acest formular, nu mascată. |
| Tipuri de facturi | Ce tip de document emite FGO — Factura pentru o factură obișnuită, cu unsprezece opțiuni în total, printre care Proforma, Aviz, taxarea inversă și regimul de marjă. |
| Modalitatea de corelare a produselor | Cum îi spune easySales către FGO la ce articol se referă o linie. SKU trimite codul de stoc al produsului, cu revenire la SKU. Nume nu trimite niciun cod și lasă FGO să potrivească după denumirea articolului. |
| Descarcă din gestiune la facturare | Obligatoriu, dar nu schimbă nimic pentru FGO — în ciuda denumirii, nu el descarcă gestiunea. Ce face FGO să scoată efectiv marfa din stoc este Cod Gestiune Saga, de mai jos. |
| Cod Gestiune Saga | Gestiunea FGO pe care se înregistrează fiecare linie de factură — asta face FGO să scoată marfa din stoc. Scrie-o exact cum se numește în FGO. Las-o goală dacă nu ții stocul acolo. |
| Sabloane | Text liber tipărit în observațiile facturii. Butoanele de deasupra inserează variabile — id-ul comenzii, numărul AWB, curierul, metoda de plată sau lista produselor comandate. |
Pasul 5 — Opțiuni avansate
Secțiunea avansată este restrânsă și nimic din ea nu este obligatoriu, dar două dintre setările ei rezolvă probleme altfel greu de diagnosticat.
| Setare | Ce face |
|---|---|
| Coduri de identificare taxe | Leagă liniile de transport, de discount și de comision de codurile de articol pe care le folosești în FGO. Dă-i fiecăreia un tip, textul pe care îl conține denumirea taxei și codul de articol din FGO. Fără asta, liniile respective ajung ca articole nepotrivite. |
| Folosește descrierea produselor | Alege ce intră în coloana de descriere de pe factură — nimic, codul produsului, numele lui, proprietățile sau EAN-ul. |
| Alege numele produsului | Care dintre cele trei denumiri pe care le ține easySales este tipărită: numele produsului din gestiune, cel din catalog sau numele ofertei. |
| Afișează produsele cadou ca discount separat | Pune produsele gratuite pe factură ca linie de discount, nu ca produs cu preț zero. |
| Elimină caracterele speciale | Scoate caracterele speciale din numele și adresele clienților înainte de trimitere. Util când FGO respinge o diacritică sau un simbol. |
| Generează garanție la facturare | Creează în același timp un certificat de garanție, dintr-un șablon ales de tine, și îl poate uni în același PDF cu factura. |
| Elimină discount-urile de pe facturi | Lasă liniile de discount complet în afara documentului. |
Pasul 6 — Spune-i easySales ce serie să folosească
Conexiunea nu poartă cu ea o serie. easySales rezolvă una pentru fiecare comandă, în ordinea aceasta: seria setată pe conexiunea de marketplace din care a venit comanda, apoi cea setată pe magazin, apoi cea aflată deja pe comandă.
Emiterea facturilor
| De unde | Acțiune | Serie |
|---|---|---|
| Lista de comenzi | Creare rapidă, în coloana de factură | Luată de pe comandă |
| Pagina comenzii | Creare factură | Luată de pe comandă |
| Lista de comenzi, mai multe deodată | Generare factură — până la 50 de comenzi, câte o factură fiecare | Rezolvată per comandă |
| Un grup de procesare | Creare factură | Rezolvată per comandă |
| Un flux de automatizare | Acțiunea de creare factură | Rezolvată per comandă |
Când o factură eșuează
Refuzurile FGO sunt transmise mai departe cuvânt cu cuvânt, în română, indiferent în ce limbă folosești easySales. Sunt precise, odată ce le poți citi.
| Ce spune FGO | Ce ai de făcut |
|---|---|
Platforma https://easy-sales.com nu este inregistrata in FGO
|
Pasul 2 a fost sărit. Adaugă adresa în FGO, în Setări → eCommerce → Setări API. |
Registrul pentru seria … nu este definit sau a expirat.
|
Seria nu are drepturi API, perioada ei a expirat sau a rămas fără numere. Verifică-le pe toate trei în Setări → Serii Documente. |
Campul 'Serie' este obligatoriu.
|
Nicio serie nu a ajuns la FGO. Setează una pe conexiunea de marketplace sau pe magazin. |
Hash-ul transmis nu este corect.
|
Cheia privată este greșită sau a fost schimbată în FGO. Introdu-o din nou pe cea curentă. |
Utilizatorul nu exista sau nu are drepturi de acces.
|
Utilizatorul API a fost șters sau și-a pierdut drepturile. Recreează-l în Setări → Utilizatori. |
Codul unic nu exista sau nu este asociat.
|
Valoarea din CUI Firmă nu se potrivește cu CUI-ul contului FGO. |
Campul Client[CodUnic] este obligatoriu.
|
Clientul este persoană juridică, dar comanda nu are CUI. Completează-l în datele de facturare ale comenzii. |
Judetul … nu exista in nomenclator
|
Adresa de facturare nu are județ sau are unul pe care FGO nu îl recunoaște. Alege județul pe comandă. |
CotaTVA … nu exista in nomenclator.
|
Cota de TVA de pe o linie nu există în FGO. Adaug-o în FGO sau corecteaz-o pe comandă. |
Factura este deja stornata.
|
Există deja o factură storno pentru această factură. |
Factura a fost transmisa in SPV. Nu se poate anula.
|
Factura a fost depusă la ANAF și nu mai poate fi anulată — emite în schimb o factură storno. |
Opțional — FGO ca sursă de stoc
FGO îi poate spune easySales și cât stoc ai. Aceasta este o a doua conexiune, separată, în Configurare → Integrări → Surse de stoc, cu același CUI și aceeași parolă de utilizator API, și trebuie legată de un magazin înainte să se sincronizeze ceva.
