Cum conectezi OLX cu easySales: ghid complet de integrare

Ce poți face cu OLX și easySales

easySales publică produsele tale pe OLX sub formă de anunțuri și apoi le ține la zi: prețurile și stocul urmează catalogul tău, anunțurile se retrag când un produs se epuizează și revin când îl reaprovizionezi. Pe OLX PL, easySales poate și să importe comenzile tale OLX, iar pe OLX PL și OLX România PulseAI poate completa ofertele noi, pe care le verifici înainte să fie trimise.

Menții un singur catalog pentru toate canalele pe care vinzi, în loc să editezi fiecare anunț de mână. Asta contează cel mai mult la volum. Listarea a cincizeci de produse pe OLX manual înseamnă o după-amiază; menținerea a cincizeci de anunțuri corecte pe măsură ce stocul se mișcă este o treabă permanentă, iar aceasta este partea pe care o preia easySales.

Sunt acceptate patru piețe OLX, fiecare conectată separat și fiecare cu moneda ei:

Sunt conexiuni independente. Dacă vinzi și pe OLX.ro, și pe OLX.bg, ai nevoie de două conexiuni, fiecare cu propriile date de contact, localitate și mapare de categorii.

Cum funcționează conectorul OLX

easySales se conectează la OLX prin autorizarea OAuth a celor de la OLX — aprobi easySales din interiorul contului tău OLX, în loc să copiezi o cheie API dintr-o parte în alta, deci nu ai nicio cheie de păstrat sau de rotit.

easySales reînnoiește automat această autorizare cât timp conexiunea funcționează. Nu ai nimic de reînnoit de mână. Reînnoirea se oprește când se schimbă ceva în partea OLX — de exemplu, accesul easySales este revocat sau parola OLX se schimbă. Dacă trec 28 de zile fără o reînnoire, easySales te avertizează zilnic, prin e-mail și în aplicație. Acesta este semnalul să folosești Reautentificare cu OLX.

Catalogul tău pleacă întotdeauna spre OLX ca anunțuri. Comenzile vin înapoi doar de pe OLX PL: activează Importă comenzile și fiecare comandă ajunge ca o comandă obișnuită în easySales, gata pentru facturare, AWB-uri și fluxuri automate. Pe OLX România, Bulgaria și Portugalia integrarea acoperă doar anunțurile, iar cumpărătorii de acolo îi servești în continuare din contul tău OLX.

Înainte să începi

Pasul 1 — Deschide formularul de conectare și autentifică easySales

În easySales mergi la Integrări → Marketplace, caută piața OLX pentru țara ta și apasă Conectează.

Formularul se deschide cu butonul Autentificare cu OLX. Când îl apeși, ajungi pe ecranul de autentificare și de permisiuni al celor de la OLX. Aprobi easySales acolo și te întorci în formularul de conectare, acum legat de acel cont OLX.

Dacă vrei să muți conexiunea pe alt cont OLX sau easySales te avertizează că autorizarea nu se mai reînnoiește, același buton apare ca Reautentificare cu OLX. Folosește-l în loc să ștergi și să reconstruiești conexiunea — reautentificarea îți păstrează maparea de categorii și anunțurile legate.

Pe OLX PL și OLX România, conexiunea are două file: Setări principale și Generare oferte cu AI. A doua conține setările PulseAI descrise mai jos și apare dacă în contul tău este disponibilă generarea de oferte cu AI.

Pasul 2 — Completează setările conexiunii

Autentificarea este doar jumătate din treabă. Formularul conține setările pe care le moștenește fiecare anunț. Cinci sunt obligatorii: Nume Conexiune, Adaos Preț, Oraș, Nume contact și Număr telefon contact.

Identitate și localizare

• Nume Conexiune — cum este etichetată conexiunea în easySales. Nu este arătată niciodată cumpărătorilor, așa că denumește-o pentru tine: OLX România, OLX BG depozit 2.
• Nume contact și Număr telefon contact — ce afișează OLX pe anunț. Acesta este numărul la care te vor suna cumpărătorii.
• Oraș și, opțional, Zonă — unde este postat anunțul. Alegi întâi orașul; lista de zone se filtrează după el. Zona poate rămâne necompletată.

Prețuri

• Adaos Preț — un procent adăugat peste prețul produsului tău, doar pentru acest canal. La 10%, un produs de 10 lei pleacă la 11 lei. Se aplică prețului pe care îl trimite easySales; catalogul tău rămâne neatins.
• Sursa prețului de vânzare — implicit Prețul din catalog. Dacă alegi în schimb un grup de prețuri, ofertele tale OLX își iau prețul din acel grup; când prețurile din grup se schimbă, easySales le retrimite automat. Adaosul de preț nu se aplică prețurilor preluate dintr-un grup de prețuri.
• Plătitor de taxe — pune Da doar dacă contul cu care te-ai înregistrat pe OLX este plătitor de TVA. Schimbă modul în care sunt calculate prețurile, deci o setare greșită mută fiecare anunț.

Valori implicite pentru anunțuri

• Stare implicită produs — aplicată anunțurilor care nu specifică altceva. OLX România oferă Nou, Uzat, Nou, cu eticheta, Nou, fara eticheta, Purtat o singura data și In conditii bune; OLX BG, PL și PT oferă Nou și Uzat.
• Auto Refresh — republică automat anunțurile când expiră. Anunțurile OLX nu rulează la nesfârșit, iar fără această opțiune ele trec în starea outdated și încetează discret să mai fie văzute.
• Livrare prin curier — Da dacă expediezi cu un curier, Nu dacă ridicarea se face personal. Câmpul nu este afișat pe OLX PL.
• Date livrare — se adaugă la finalul fiecărei descrieri de anunț și intră în calculul lungimii descrierii pe OLX.

Valori implicite pentru comenzi (OLX PL)

• Cota de TVA pentru transport — cota de TVA aplicată transportului pe comenzile OLX PL importate.
• Tip de pachet implicit — tipul implicit de pachet AWB pentru comenzile importate.
• Status custom pentru comanda noua — opțional; statusul personalizat primit de comenzile OLX PL importate.

Comportamentul stocului — două comutatoare care decid ce se întâmplă pe măsură ce stocul se mișcă:

• Dezactivează ofertele când produsele rămân fără stoc — retrage anunțul când produsul ajunge la zero, în loc să îl lase activ pentru cumpărători pe care nu îi poți servi.
• Activează ofertele automat când produsele sunt pe stoc — îl repune când produsul este reaprovizionat. Un anunț pe care l-ai dezactivat tu nu este reactivat.

Activarea ambelor este ceea ce face integrarea să se întrețină singură. Dacă le lași dezactivate, revii la gestionarea disponibilității de mână.

Pasul 3 — Mapează categoriile

Anunțurile nu se publică până când categoriile tale nu sunt mapate. easySales trebuie să știe cărei categorii OLX îi aparține fiecare categorie de-a ta, pentru că OLX decide din categorie ce poate conține un anunț.

Mapează la o categorie finală — cel mai de jos nivel din arborele de categorii OLX, sub care nu mai există nimic. O categorie părinte nu este suficientă: Telefoane, de exemplu, are nevoie de marca de sub ea. Dacă anunțurile sunt respinse imediat după prima publicare, o mapare care se oprește cu un nivel prea sus este de obicei motivul.

Alege cu grijă: după ce un anunț este publicat, OLX nu permite schimbarea categoriei lui.

Pe OLX PL și OLX România, cu PulseAI activat, o ofertă fără categorie mapată primește totuși una: PulseAI alege o categorie finală pentru acea ofertă, iar tu o verifici înainte ca oferta să fie trimisă.

Pasul 4 — Publică primele anunțuri

Cu conexiunea autentificată și categoriile mapate, mergi la Produse, selectează ce vrei listat și folosește Adaugă ofertă pe un produs sau butonul de adăugare a ofertelor de deasupra listei, ca să publici mai multe deodată.

Începe cu câteva, nu cu tot catalogul. Primul lot îți arată dacă maparea de categorii și valorile implicite sunt corecte, iar corectarea a zece anunțuri este mult mai simplă decât corectarea a o mie.

Înainte de o publicare mare, verifică-ți conținutul față de limitele OLX:

• Titluri: OLX cere 16–150 de caractere.
• Descrieri: cel mult 9.000 de caractere, numărate așa cum le numără OLX: cu formatarea lor și cu Datele de livrare pe care le adaugă easySales.

Pe OLX PL și OLX România, easySales verifică categoria, caracteristicile obligatorii și lungimea descrierii înainte de trimitere și oprește o ofertă pe care OLX ar respinge-o — vezi mai jos Verificările prin care trece fiecare ofertă OLX PL și OLX România înainte de trimitere.

Stările de anunț pe care le vei vedea

După publicare, fiecare anunț are în easySales o stare care reflectă ce raportează OLX:

limited și moderated sunt cele două de urmărit. limited înseamnă că ai atins plafonul de anunțuri gratuite, iar anunțurile următoare nu vor deveni active până nu cumperi capacitate suplimentară în OLX. moderated este normal la o primă publicare într-o categorie nouă și de obicei se rezolvă de la sine.

Comenzile OLX PL și livrarea OLX

OLX PL este piața OLX ale cărei comenzi intră în easySales. Importul comenzilor este dezactivat implicit și se setează pe fiecare conexiune: deschide conexiunea OLX PL și, în secțiunea Comenzi OLX, activează Importă comenzile.

O comandă OLX PL importată este o comandă obișnuită în easySales. Conține clientul, adresa de facturare și adresa de livrare, produsele — potrivite cu oferta ta prin anunțul OLX — și o linie de transport taxată la Cota de TVA pentru transport. Primește Status custom pentru comanda noua, dacă l-ai setat, iar fluxurile tale automate rulează pe ea ca pe orice altă comandă.

Pagina comenzii arată statusul OLX al comenzii și termenul până la care trebuie confirmată. easySales traduce statusurile OLX în statusurile proprii:

• În așteptarea confirmării → Nouă
• Confirmată sau în așteptarea expedierii → În procesare
• În tranzit, plată către vânzător sau finalizată → Finalizată
• Respinsă, anulată sau expediere expirată → Anulată
• Expediere eșuată sau returnată → Retur

Acceptarea automată a comenzilor

Acceptare automată a comenzilor confirmă pentru tine comenzile OLX PL noi: „Acceptarea unei comenzi confirmă în numele tău condițiile comenzii OLX, folosind datele expeditorului de mai jos.”

Datele expeditorului cer Prenume, Nume, Companie (opțional), Telefon, Email, Stradă, Număr, Apartament (opțional), Cod poștal și Oraș.

Livrarea cu OLX Delivery

OLX rezervă transportatorul în momentul în care comanda este acceptată. Când eticheta OLX este gata, easySales o descarcă și salvează pe comandă transportatorul și numărul de urmărire, iar curierul OLX Delivery devine disponibil la alegerea curierului pentru AWB. Alege-l acolo ca să folosești eticheta OLX drept AWB al comenzii.

Trimite stocul la OLX

Trimite stocul la OLX este pentru anunțurile pe care le vinzi cu pachete de livrare OLX, alese în contul tău OLX. Cu opțiunea activă, easySales trimite stocul disponibil, maximum 1.000, la fiecare actualizare a anunțului. Cum notează chiar setarea: „OLX oprește livrarea când ajunge la zero.”

Facturi și anulări

Comenzile OLX PL le facturezi prin programul tău de facturare, ca pe orice altă comandă din easySales. Ca să anulezi una, anuleaz-o în easySales: comanda este respinsă sau anulată și pe OLX, iar motivul îl alegi din lista OLX.

PulseAI pe OLX PL și OLX România: generarea automată a ofertelor

PulseAI poate completa pentru tine ofertele OLX PL și OLX România noi — categorie, caracteristici, starea produsului și, dacă alegi, titlul și descrierea — apoi le păstrează pentru verificarea ta. Este disponibil pe OLX PL și OLX România, pe fiecare conexiune, și este dezactivat implicit.

Setările se află în fila Generare oferte cu AI a conexiunii, care rezumă totul așa: „Ofertele noi sunt completate automat cu AI, apoi păstrate pentru verificarea ta. Nimic nu este trimis către marketplace până nu aprobi.”

Setările de generare a ofertelor cu AI

• Completează ofertele noi cu AI — pornește completarea automată. Se aplică doar ofertelor nou create; ofertele existente nu sunt modificate.
• Caracteristici de completat — cât de departe merge PulseAI: Doar cele care blochează publicarea, Toate caracteristicile, lăsate goale când nu e sigur (implicit) sau Toate caracteristicile, întotdeauna cu cea mai bună estimare. O selecție mai largă consumă mai mult din alocarea zilnică pentru fiecare ofertă.
• Corectează câmpurile pe care marketplace-ul le-ar respinge — activată implicit. Pe OLX, un titlu de peste 150 de caractere este scurtat la limita unui cuvânt.
• Îmbunătățește titlul ofertei — rescrie titlul fiecărei oferte noi după regulile OLX: 16–150 de caractere, nu predominant cu majuscule, fără date de contact. Noul titlu este păstrat pentru verificare împreună cu restul ofertei.
• Îmbunătățește descrierile scurte sau lipsă — rescrie doar descrierile goale sau foarte scurte. OLX afișează formatarea doar la Locuri de muncă, așa că descrierea este scrisă ca rânduri simple și se încadrează în limita de lungime OLX împreună cu Datele de livrare.
• Când alocarea zilnică se termină — Creează oferta fără AI, ca de obicei sau Așteaptă alocarea de mâine. Ofertele care așteaptă nu sunt trimise până nu sunt completate și verificate, iar le poți elibera oricând din lista de oferte.

Încă o setare se află în fila Setări principale: PulseAI poate schimba starea produsului, setată implicit pe Nu.

• Nu — PulseAI propune o stare a produsului doar când categoria nu o acceptă pe cea curentă.
• Da — PulseAI propune starea (nou, utilizat, deteriorat…) din datele produsului chiar dacă starea curentă este validă pentru categorie, astfel încât o piesă folosită salvată ca nouă este corectată.

Se aplică atât completării automate, cât și butonului Completează automat valorile cu PulseAI. Când nimic nu stabilește starea, se folosește Stare implicită produs din conexiune, dacă este acceptată de categorie.

Ce completează PulseAI pe o ofertă nouă

• Categoria — se păstrează categoria din maparea ta de categorii. Fără una, PulseAI alege o categorie finală pentru ofertă. Nu schimbă niciodată categoria unui anunț deja publicat pe OLX, pentru că OLX nu permite acest lucru.
• Caracteristicile — la nivelul ales de tine. PulseAI nu ghicește niciodată coduri de piesă, serii VIN, coduri de producător, liste de compatibilitate sau garanția.
• Starea produsului — după cum este setat PulseAI poate schimba starea produsului.
• Titlul și descrierea — doar când setările corespunzătoare sunt activate.

Verificarea ofertelor completate de AI

O ofertă completată de PulseAI afișează pe pagina ei bannerul Completată de AI — în așteptarea verificării tale, cu nota „Verifică valorile de mai jos, apoi aprobă pentru a o trimite. Salvarea sau retrimiterea nu o publică până atunci.” Dacă PulseAI a schimbat starea produsului sau categoria, bannerul spune asta și arată valoarea veche și pe cea nouă.

O ofertă aflată încă în coadă afișează În așteptarea completării cu AI: „Această ofertă nu este încă pe marketplace. Elimină-o din coada AI pentru a o lista așa cum este.”

În listele de oferte OLX PL și OLX România, filtrul Generare AI arată În așteptarea verificării mele, În așteptare pentru completare sau Dezactivate automat: fără verificare AI, iar ofertele poartă eticheta AI — de verificat sau AI — în coadă. Meniul de acțiuni AI conține Aprobă și trimite, Elimină din coada AI și Vezi activitatea AI.

Verifică în 60 de zile. O ofertă neverificată în 60 de zile este dezactivată fără să fi fost trimisă vreodată și apare ca Dezactivată automat: fără verificare AI. Activarea ei o aprobă și o trimite pe OLX.

Completează automat valorile cu PulseAI, la cerere

Pe orice ofertă OLX, butonul Completează automat valorile cu PulseAI completează caracteristicile în formular și propune starea produsului. Nimic nu se salvează până nu salvezi tu. Valorile completate sunt marcate „Completat de AI - verifică înainte de salvare.”, iar o valoare pe care PulseAI nu a putut-o stabili este marcată „PulseAI nu a fost sigur de această valoare. Te rugăm să o completezi.” La final, o scurtă întrebare: „A fost corectă completarea automată?”

Alocarea zilnică

Completarea automată folosește alocarea zilnică de AI a contului tău; butonul Completează automat valorile cu PulseAI nu o folosește. Ce se întâmplă când alocarea se termină alegi tu, din Când alocarea zilnică se termină.

Verificările prin care trece fiecare ofertă OLX PL și OLX România înainte de trimitere

Se aplică fiecărei oferte OLX PL și OLX România, fie că a completat-o PulseAI, fie că nu. easySales oprește oferta înainte să ajungă pe OLX și îți arată motivul când:

• nu are categorie sau are o categorie pe care OLX nu o listează;
• descrierea, cu formatarea ei și cu Datele de livrare, are mai mult de 9.000 de caractere;
• doar pentru un anunț nou: categoria ei nu este o categorie finală, o caracteristică obligatorie este goală sau o valoare aleasă dintr-o listă ori starea produsului nu este acceptată de OLX în acea categorie.

Un anunț deja publicat pe OLX nu este oprit pentru caracteristicile lui: OLX le verifică atunci când anunțul este creat.

Limita de anunțuri gratuite și promovarea

OLX oferă fiecărui cont un număr de anunțuri gratuite și taxează peste acest număr. Când depășești pragul, easySales afișează un mesaj, iar anunțurile noi primesc starea limited — nu se pierde nimic, dar nimic nu se publică până nu adaugi capacitate în contul tău OLX.

Promovarea se face în OLX, nu în easySales. Ridicarea unui anunț pe prima pagină, plasarea evidențiată și impulsurile plătite sunt toate în contul tău OLX. easySales publică și întreține anunțul; cât de vizibil este rămâne o decizie OLX.

Dacă sincronizarea se oprește

Aproape orice conexiune OLX stricată se reduce la autorizare: o aprobare revocată sau o schimbare de parolă în partea OLX oprește reînnoirea automată. Deschide conexiunea și folosește Reautentificare cu OLX. Maparea și anunțurile legate supraviețuiesc, deci reautentificarea este întotdeauna de preferat ștergerii conexiunii și luării de la capăt.

Dacă anunțurile se publică, dar sunt respinse, cauza ține de obicei de anunț, nu de conexiune: o categorie care nu este finală, o descriere peste limita OLX ori o caracteristică obligatorie lăsată goală. Pe OLX PL și OLX România, easySales prinde aceste probleme înainte de trimitere și îți arată motivul.

Dacă o ofertă OLX PL sau OLX România nu a plecat, verifică dacă nu o ține PulseAI: filtrul Generare AI din lista de oferte arată fiecare ofertă care așteaptă verificarea ta sau AI-ul.