Funcții

Cum conectezi Oblio cu easySales: ghid complet de configurare

De echipa easySales · Actualizat 11 septembrie 2026 · 2 min citire

Cum conectezi Oblio cu easySales: ghid complet de configurare

Conectează Oblio la easySales: cele trei date de acces, ce face de fapt descărcarea din gestiune, seriile de facturi și chitanțe, opțiunile avansate specifice Oblio și ce înseamnă fiecare refuz.

Ce îți aduce conectarea Oblio

Cu Oblio conectat, easySales emite factura pentru o comandă, o trimite clientului, o marchează ca încasată, o anulează sau o stornează și poate ține gestiunea din Oblio la zi — fără să deschizi Oblio.

Ghidul acoperă toată conexiunea, inclusiv setarea care decide dacă facturile pleacă sau nu.

Înainte să începi

✓

Un cont Oblio cu acces API

Tokenul se emite din setările contului Oblio. Dacă acolo nu există niciun token, abonamentul nu include acces API, iar conexiunea va eșua cu You are not allowed to use this API.

✓

CUI-ul, exact cum îl are Oblio

Codul fiscal este verificat față de firmele din contul tău Oblio, nu doar ca format.

✓

Seria de facturi, creată în Oblio

easySales trimite seria de pe comandă. Orice serie pe care ar putea să o folosească trebuie să existe întâi în Oblio, altfel nu se emite nicio factură.

✓

O decizie despre stoc

Dacă gestiunea din Oblio trebuie descărcată la emiterea facturii. Dacă da, gestiunea trebuie să fie corectă — un stoc insuficient în Oblio oprește factura.

Pasul 1 — Deschide pagina Facturare

Mergi la Integrări → Facturare și caută oblio.

Pagina Facturare din easySales filtrată după Oblio, cu cardul Oblio conectat și butonul Editează.
Cardul Oblio din Integrări → Facturare.

Apasă Conectare pe cardul Oblio. Dacă ai deja o conexiune, apasă Editează.

Pasul 2 — Cele trei date de acces

Formularul de conexiune Oblio din easySales cu Nume conexiune, CUI Firmă, Utilizator (Email), Token, Descarcă din gestiune la facturare setat pe Da, Numele gestiunii, Numele punctului de lucru și Seria chitanței.
Conexiunea. Cele trei câmpuri cu asterisc sunt tot ce îi trebuie Oblio; restul schimbă cum arată factura.
Câmp Ce este
Nume conexiune Numele tău pentru această conexiune. Nu ajunge niciodată la Oblio.
CUI Firmă Codul fiscal al firmei care facturează, exact cum îl are Oblio. Pleacă la fiecare cerere ca cif, iar o firmă pe care Oblio nu o recunoaște returnează The company with cif … does not exist.
Utilizator (Email) Adresa de email a contului Oblio. Oblio o folosește drept client id pentru API.
Token Secretul de API din setările contului Oblio. Nu este parola de Oblio.
Cele trei câmpuri obligatorii

Pasul 3 — Decide ce faci cu gestiunea înainte să salvezi

Descarcă din gestiune la facturare este cel mai important câmp din formular, iar denumirea din interfața românească spune exact ce face.

Pasul 4 — Serii, punct de lucru și restul

Câmp Ce face
Descarcă din gestiune la facturare Da face ca fiecare factură să descarce și marfa din gestiunea Oblio. Vezi avertismentul de mai sus.
Numele gestiunii Gestiunea Oblio din care iese marfa. Opțional, case sensitive și practic necesar imediat ce descărcarea din gestiune este activă sau ai mai multe gestiuni.
Numele punctului de lucru Punctul de lucru Oblio de la care se emite documentul. Opțional, case sensitive.
Seria chitanței Seria pe care Oblio o folosește când încasarea este chitanță. Ignorată pentru orice alt tip de încasare.
Trimite actualizări de prețuri Trimite modificările de preț din easySales către produsul corespondent din Oblio. Obligatoriu — formularul nu se salvează fără un răspuns.
Folosește descrierea produselor Pune descrierea produsului pe linia de factură, nu doar denumirea.
Sabloane Textul de mențiuni tipărit pe factură.
Restul conexiunii
Partea de jos a formularului Oblio, cu Trimite actualizări de prețuri, Folosește descrierea produselor și caseta Sabloane cu butoanele de variabile și butonul Salvare.
Trimite actualizări de prețuri trebuie completat înainte ca formularul să se salveze.

Câmpul Sabloane stabilește textul de mențiuni tipărit pe fiecare factură de pe această conexiune. Butoanele de deasupra inserează valori din comandă — ID comandă, platformă, observații, număr AWB, curier, metodă de plată.

Pasul 5 — Opțiuni avansate

Nimic de aici nu este obligatoriu, dar patru dintre opțiuni există doar pentru Oblio, iar una previne facturile duplicate.

Opțiunile avansate ale unei conexiuni Oblio: Limbă factură, CNP-ul emitentului, Numele emitentului, Zile de scadență și Tip încasare.
Prima jumătate a opțiunilor avansate.
Opțiune Ce face
Limbă factură Forțează o singură limbă pentru toate facturile. Lăsată goală, easySales folosește limba magazinului sau a marketplace-ului de unde a venit comanda, dacă Oblio o suportă.
CNP-ul emitentului și Numele emitentului Apar pe factură ca persoana care o emite. CNP-ul este validat la exact 13 cifre.
Zile de scadență Câte zile de la emitere are factura până la scadență.
Tip încasare Forțează tipul de încasare înregistrat de Oblio — Chitanță, Bon fiscal, Card, Ordin de plată și celelalte. Lăsat gol, easySales îl deduce din metoda de plată a comenzii. Alegi Chitanță și se folosește Seria chitanței de mai sus.
Alege numele produsului Ce denumire ajunge pe linia de factură: numele produsului sau cel din comandă.
Detectează automat sectorul Deduce sectorul din București din adresă atunci când comanda nu îl conține.
Generează un cod unic de discount Doar Oblio. Trimite fiecare discount pe linia lui codificată, în loc să le unească.
Aplică taxare inversă Doar Oblio. Marchează factura cu taxare inversă.
Trimite numele cotei TVA doar pentru taxa de 0% Doar Oblio. Trimite denumirea scutirii de TVA doar pe liniile cu cotă zero, nu pe toate.
Activează idempotency key Doar Oblio. Împiedică o cerere repetată să creeze a doua factură pentru aceeași comandă.
Opțiuni avansate care merită setate
Restul opțiunilor avansate Oblio: Alege numele produsului, Detectează automat sectorul, Generează un cod unic de discount, Aplică taxare inversă, Trimite numele cotei TVA doar pentru taxa de 0% și Activează idempotency key.
Cele patru opțiuni care există doar pentru Oblio și cheia de idempotență care previne facturile duplicate.

Oblio ca sursă de stoc

Conexiunea de mai sus emite facturi. Sincronizarea stocului din easySales cu cel din Oblio este o a doua conexiune, separată, cu propriile date de acces.

Formularul conexiunii Oblio ca sursă de stoc, cu numele conexiunii, CUI, Token, Email și numele gestiunii.
Conexiunea de sursă de stoc este separată, cu propria copie a acelorași date de acces.

Mergi la Integrări → Surse de stoc, apasă Conectare pe cardul Oblio și completează același CUI, token și email, plus gestiunea din care se citește stocul.

Când Oblio refuză o factură

Mesajul vine de la Oblio nemodificat și apare pe comandă. Stocul este de departe cel mai frecvent motiv.

Ce spune Oblio Ce ai de făcut
Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient: Stocul din Oblio nu ajunge pentru produsele enumerate. Corectează stocul în Oblio sau dezactivează Descarcă din gestiune la facturare dacă nu ții gestiunea Oblio la zi.
Produsul "…" nu are stoc suficient. Același lucru, pentru un singur produs.
Concurrent requests timeout. Please make one request at a time. Oblio a primit mai multe cereri simultan pentru contul tău. Nu se pierde nimic; factura poate fi emisă din nou.
Too Many Requests, check back later Limita de cereri a Oblio pentru contul tău. Se resetează singură.
The access token provided has expired Oblio a încheiat sesiunea mai devreme decât se aștepta. Emite factura din nou — easySales generează o sesiune nouă când cea veche expiră.
Internal error. Please try again later. / un răspuns gol sau 504 Oblio nu a răspuns. Nu este nimic greșit la tine; reîncearcă.
You are not allowed to use this API. Contul Oblio nu are acces API pe abonamentul curent.
The company with cif … does not exist CUI Firmă de pe conexiune nu este o firmă din acel cont Oblio.
Tipul produsului nu a fost gasit, tipul trebuie sa fie unul din: Marfa, Semifabricate, … Un produs are în Oblio un tip pe care Oblio nu îl acceptă aici. Corectează tipul produsului în Oblio.
Introdu o serie de document valida. Acesta vine de la easySales, nu de la Oblio: seria de pe comandă nu există în contul tău Oblio.
Ce înseamnă refuzurile Oblio

Storno, anulări și încasări

Acțiune Ce se întâmplă în Oblio
Marcarea comenzii ca încasată Factura este încasată în Oblio cu tipul din Tip încasare sau cu cel dedus din metoda de plată a comenzii. O încasare pe chitanță folosește Seria chitanței.
Returul unei comenzi easySales cere Oblio un storno pe factura inițială.
Anularea unei facturi Oblio anulează documentul; numărul rămâne consumat, așa cum trebuie.
Ștergerea unei facturi Posibilă doar cât timp Oblio o mai permite — altfel anuleaz-o.
Ce mai face conexiunea

Întrebări frecvente

Conexiunea are Descarcă din gestiune la facturare pe Da, deci fiecare factură descarcă și marfa din gestiunea Oblio — iar Oblio nu are stoc suficient pentru produsele enumerate. Fie corectezi stocul în Oblio (și verifici că Numele gestiunii de pe conexiune indică exact gestiunea corectă, scrisă la fel), fie pui Descarcă din gestiune la facturare pe Nu, dacă nu ții gestiunea Oblio la zi. Este cel mai frecvent motiv pentru care o factură Oblio eșuează.

Nu. Oblio emite un secret de API separat, în setările contului, iar acela este tokenul. Câmpul Utilizator (Email) primește adresa cu care este înregistrat contul Oblio. Dacă în setări nu există niciun token, abonamentul tău Oblio nu include acces API.

Mesajul vine de la easySales și înseamnă că seria nu există în contul tău Oblio. easySales trimite seria configurată pe marketplace-ul sau magazinul de unde a venit comanda, iar Oblio acceptă doar o serie pe care o are deja. Creeaz-o în Oblio sau schimbă seria din easySales cu una cunoscută de Oblio.

Nu. easySales schimbă emailul și tokenul pe o sesiune și o reînnoiește singur când expiră. Dacă vezi "The access token provided has expired" pe o comandă, emite factura din nou — nu trebuie să umbli la conexiune decât dacă ai schimbat tokenul în Oblio.

Cu numele gestiunii din Oblio, caracter cu caracter — câmpul este case sensitive și eticheta o spune. La fel și Numele punctului de lucru, care trebuie să corespundă unui punct de lucru din Oblio. Copiază-le din Oblio în loc să le scrii.

Pune Tip încasare pe Chitanță la Arată opțiuni avansate și completează Seria chitanței pe conexiune cu o serie de chitanță care există în Oblio. Când easySales marchează comanda ca încasată, încasarea se înregistrează pe acea serie. Dacă lași Tip încasare gol, easySales alege tipul după metoda de plată a comenzii.

Activează Activează idempotency key la Arată opțiuni avansate. easySales trimite atunci numărul comenzii împreună cu factura, iar Oblio nu creează un al doilea document pentru o cerere pe care a procesat-o deja. Opțiunea este ascunsă dacă acel cont este setat intenționat să permită mai multe facturi pe comandă.

Prima emite facturi. A doua citește stocul din Oblio în easySales și este o conexiune separată, cu propriul CUI, token și email. Nu împart nimic, deci dacă schimbi tokenul în Oblio trebuie să le actualizezi pe amândouă.

Da. Returul unei comenzi cere Oblio un storno pe factura inițială, deci nota de credit se creează în Oblio cu aceleași reguli de serie ca factura.

Pentru că Limbă factură de la Arată opțiuni avansate este setată și se aplică tuturor facturilor. Golește-o și easySales folosește limba magazinului sau a marketplace-ului de unde a venit comanda, dacă Oblio o suportă.

A fost util acest ghid?