Skip to main content

Configurează integrarea FGO

Integrarea FGO permite emiterea facturilor pentru comenzile din Cart200, folosind seria și numerotarea configurate în contul tău FGO.

Înainte să începi​

Ai nevoie de:

  • acces la setările contului FGO;
  • dreptul de a crea un utilizator API și de a administra seriile de facturi;
  • CUI-ul companiei din FGO, fără prefixul RO;
  • domeniul public al magazinului Cart200, de exemplu magazinul-tau.ro.

În Cart200 vei completa următoarele câmpuri:

CâmpValoare
CUI companieCUI-ul companiei din FGO, fără prefixul RO
Cheie privată APIParola generată de FGO pentru utilizatorul API
Serie facturiSeria activă folosită pentru facturile Cart200
URL platformăAdresa completă a magazinului, de exemplu https://magazinul-tau.ro
Folosește mediul de test FGOActivează numai dacă folosești contul de test testuat.fgo.ro
Generează factura automatAlege dacă factura se emite la plasarea comenzii sau manual din detaliile comenzii

1. Generează cheia privată API​

  1. În FGO, deschide Setări → Date utilizator și date firmă → Utilizatori și permisiuni.
  2. Apasă API Utilizator.
  3. Confirmă crearea utilizatorului API.
  4. Copiază parola afișată de FGO. Aceasta este valoarea pentru câmpul Cheie privată API din Cart200.

Poți deschide direct pagina Utilizatori și permisiuni.

Păstrează cheia secretă

Nu trimite cheia prin e-mail sau mesagerie și nu o include în capturi de ecran. Introdu-o numai în formularul de configurare FGO din Cart200.

2. Configurează seria de facturi​

  1. În FGO, deschide Setări → Serii/registre.
  2. Creează o înregistrare pentru tipul Facturi sau alege o serie existentă.
  3. Verifică dacă seria este activă și poate fi folosită de utilizatorul API.
  4. Copiază exact valoarea din coloana Seria. Aceasta este valoarea pentru câmpul Serie facturi din Cart200.

Poți deschide direct pagina Serii/registre.

3. Autorizează domeniul magazinului​

  1. În FGO, deschide Setări → eCommerce → Setări API.
  2. Deschide secțiunea Site-uri acceptate prin API.
  3. În Domenii autorizate, adaugă domeniul magazinului, de exemplu magazinul-tau.ro.
  4. Apasă Salvează.

Poți deschide direct pagina Setări API.

Domeniul și URL-ul platformei

În lista FGO adaugi domeniul magazinului. În câmpul URL platformă din Cart200 introduci adresa rădăcină completă, inclusiv protocolul https://, fără o cale la final: https://magazinul-tau.ro.

4. Instalează și configurează FGO în Cart200​

  1. În dashboard-ul Cart200, deschide Aplicații.
  2. Selectează aplicația FGO.
  3. Completează CUI companie fără prefixul RO.
  4. Introdu Cheie privată API, Serie facturi și URL platformă cu valorile pregătite mai sus.
  5. Activează Folosește mediul de test FGO numai pentru un cont testuat.fgo.ro.
  6. Lasă Generează factura automat activ dacă vrei ca factura să fie emisă la plasarea fiecărei comenzi. Dacă dezactivezi opțiunea, vei putea genera factura manual din detaliile comenzii.
  7. Instalează aplicația și salvează configurarea.
O singură aplicație de facturare activă

Aplicațiile de facturare sunt exclusive. Activarea FGO dezactivează cealaltă aplicație de facturare activă pentru magazin.

Verifică integrarea​

  1. Plasează o comandă de test cu date complete de facturare.
  2. Dacă generarea automată este activă, verifică factura în comanda Cart200 și în contul FGO.
  3. Dacă generarea automată este dezactivată, deschide detaliile comenzii și generează factura manual.
  4. Verifică seria, numărul facturii, clientul, produsele și totalurile.

Folosește mediul de test înainte de activarea în producție. Când treci la contul FGO de producție, dezactivează opțiunea Folosește mediul de test FGO și folosește cheia, seria și domeniul configurate în contul de producție.

Probleme frecvente​

Autentificarea FGO eșuează​

Verifică dacă ai introdus CUI-ul fără RO, dacă cheia API nu conține spații copiate accidental și dacă opțiunea pentru mediul de test corespunde contului folosit.

Domeniul nu este acceptat​

Verifică dacă domeniul magazinului apare în Domenii autorizate din FGO. În Cart200, URL platformă trebuie să înceapă cu https:// și să nu conțină o pagină sau o cale suplimentară.

Seria facturii este respinsă​

Verifică dacă seria introdusă în Cart200 este identică cu seria din FGO, este activă și este disponibilă utilizatorului API.

Factura nu se generează automat​

Verifică dacă aplicația FGO este activă și dacă opțiunea Generează factura automat este pornită. Apoi verifică dacă respectiva comandă conține toate datele necesare facturării.