API și integrări
Informații despre API-ul xPret.ro pentru Vânzători, chei API, CSV, feed XML, BaseLinker și sincronizarea automată a produselor și comenzilor.
1. Integrarea sistemelor cu xPret.ro
xPret.ro pune la dispoziția Vânzătorilor aprobați mai multe metode prin care produsele și comenzile pot fi conectate cu sisteme externe.
În funcție de planul activ și de permisiunile disponibile, integrarea poate fi realizată prin:
Vendor API;
import CSV;
feed XML;
BaseLinker;
alte integrări compatibile disponibile în platformă.
2. Cine poate utiliza API-ul
Accesul la API este disponibil numai pentru conturile de Vânzător aprobate și poate depinde de planul activ.
Un utilizator obișnuit care nu are statut de Vânzător nu poate utiliza funcțiile profesionale de integrare.
3. Cheile API
Accesul programatic la xPret.ro se realizează prin chei API generate pentru contul Vânzătorului.
Cheia API reprezintă o informație sensibilă și trebuie protejată similar unei parole.
4. Permisiunile cheilor API
Cheile API pot avea permisiuni diferite, astfel încât accesul să fie limitat la funcțiile necesare.
Permisiunile pot include, în funcție de configurația disponibilă:
citirea informațiilor contului;
citirea categoriilor;
citirea produselor;
crearea și actualizarea produselor;
dezactivarea sau ștergerea produselor;
citirea și gestionarea comenzilor.
5. Protejarea cheilor API
Vânzătorul trebuie să păstreze cheile API într-un mediu securizat.
Nu este recomandată:
publicarea cheii în cod sursă public;
trimiterea ei prin canale nesigure;
partajarea cu persoane neautorizate;
utilizarea aceleiași chei pentru sisteme care nu au nevoie de aceleași permisiuni.
6. Revocarea unei chei
Dacă o cheie API este compromisă sau nu mai este necesară, aceasta trebuie revocată și înlocuită cu o cheie nouă.
7. Categorii și atribute
Prin API pot fi consultate categoriile și structura lor, inclusiv atributele necesare pentru publicarea corectă a produselor.
Înainte de trimiterea unui produs, sistemul extern trebuie să identifice categoria corespunzătoare și câmpurile obligatorii aferente acesteia.
8. Crearea produselor prin API
Un produs poate fi creat prin API dacă Vânzătorul are permisiunile necesare și respectă limitele planului activ.
Datele pot include:
identificator extern;
titlu;
descriere;
categorie;
preț;
preț promoțional;
monedă;
stoc;
stare produs;
imagini;
atribute specifice categoriei.
9. Identificatorul extern
Pentru integrările automate este recomandată utilizarea unui identificator extern stabil pentru fiecare produs.
Acesta permite sistemului Vânzătorului și xPret.ro să identifice același produs la sincronizările ulterioare.
10. Actualizarea produselor
Produsele existente pot fi actualizate prin API fără a fi necesară recrearea lor.
Astfel pot fi sincronizate periodic:
prețurile;
stocurile;
titlurile;
descrierile;
imaginile;
atributele;
statusurile produselor.
11. Dezactivarea produselor
Dacă un produs nu mai este disponibil, sistemul integrat trebuie să actualizeze stocul sau să dezactiveze produsul, în funcție de fluxul utilizat.
Menținerea unor produse inexistente sau indisponibile poate genera comenzi care nu pot fi onorate.
12. Imaginile produselor
În funcție de integrare, imaginile pot fi trimise prin URL-uri accesibile public sau prin mecanismele acceptate de xPret.ro.
Vânzătorul trebuie să se asigure că:
imaginile sunt accesibile;
imaginile reprezintă produsul real;
are dreptul de a le utiliza;
URL-urile nu necesită autentificare incompatibilă cu importul.
13. Import CSV
Pentru Vânzătorii care nu doresc o integrare API completă, xPret.ro poate oferi importul produselor prin CSV.
CSV-ul trebuie să respecte formatul și coloanele definite în documentația disponibilă în Panoul Vânzător.
14. Actualizarea prin CSV
În funcție de funcțiile disponibile, fișierele CSV pot fi utilizate atât pentru crearea produselor, cât și pentru actualizarea produselor deja existente.
Pentru evitarea duplicatelor trebuie utilizat un identificator stabil al produsului.
15. Feed XML
Feed-ul XML permite sincronizarea automată a unui catalog de produse disponibil la o adresă URL.
xPret.ro poate verifica periodic feed-ul și poate actualiza informațiile conform configurației integrării.
16. Disponibilitatea feed-ului
URL-ul feed-ului trebuie să fie disponibil pentru sistemele xPret.ro și să răspundă într-un interval rezonabil.
Erorile serverului sursă, blocarea accesului sau răspunsurile invalide pot împiedica sincronizarea.
17. BaseLinker
xPret.ro poate permite integrarea contului Vânzătorului cu BaseLinker pentru automatizarea unor fluxuri operaționale.
În funcție de integrarea activă, aceasta poate fi utilizată pentru:
sincronizarea produselor;
sincronizarea stocurilor;
sincronizarea prețurilor;
exportul comenzilor;
actualizarea anumitor statusuri.
18. Exportul comenzilor
Comenzile primite prin xPret.ro pot fi transmise către un sistem extern atunci când integrarea utilizată suportă acest flux.
Datele transmise sunt limitate la informațiile necesare procesării comenzii și funcționării integrării.
19. Orders API
Vânzătorii care au acces la API-ul de comenzi pot utiliza sistemele proprii pentru citirea și gestionarea comenzilor.
Permisiunile și operațiunile disponibile sunt cele definite de documentația API și de cheia utilizată.
20. Sincronizarea stocului
Pentru evitarea vânzărilor unor produse indisponibile este recomandată sincronizarea frecventă a stocului.
Frecvența optimă depinde de numărul produselor, volumul comenzilor și sistemul utilizat de Vânzător.
21. Sincronizarea prețurilor
Prețurile trebuie menținute actualizate în raport cu sistemul sursă al Vânzătorului.
Dacă sunt utilizate prețuri promoționale, acestea trebuie transmise corect și să respecte regulile comerciale aplicabile.
22. Sincronizarea categoriilor
Produsele trebuie asociate categoriei corecte din xPret.ro.
O categorie incorectă poate determina:
afișarea unor filtre nepotrivite;
lipsa unor atribute obligatorii;
clasificarea greșită în căutare;
respingerea produsului.
23. Atributele dinamice
Unele categorii au atribute specifice care trebuie transmise împreună cu produsul.
Acestea pot include, de exemplu:
marcă;
model;
generație;
an;
cod motor;
combustibil;
putere;
alte caracteristici definite de categorie.
24. Validarea datelor
xPret.ro poate valida datele primite înainte de acceptarea unei operațiuni.
O solicitare poate fi respinsă dacă:
lipsesc câmpuri obligatorii;
categoria nu există;
valorile sunt invalide;
cheia nu are permisiunea necesară;
planul nu permite operațiunea;
produsul încalcă regulile platformei.
25. Codurile de răspuns
Sistemele integrate trebuie să verifice codurile HTTP și răspunsurile API pentru a determina dacă operațiunea a fost executată cu succes.
Ignorarea erorilor poate determina diferențe între catalogul Vânzătorului și datele disponibile pe xPret.ro.
26. Rate limiting și utilizare rezonabilă
xPret.ro poate aplica limite privind numărul de solicitări API pentru protejarea infrastructurii și asigurarea funcționării echitabile a serviciului.
Integrările trebuie construite astfel încât să evite solicitările repetitive inutile.
27. Procesarea asincronă
Anumite operațiuni, cum ar fi procesarea imaginilor, importurile sau sincronizările complexe, pot fi executate asincron.
Acceptarea unei solicitări nu înseamnă întotdeauna că toate operațiunile secundare sunt finalizate instantaneu.
28. Erori de sincronizare
Vânzătorul trebuie să monitorizeze erorile generate de integrarea proprie.
Acestea pot apărea din cauza:
datelor invalide;
categoriilor incorecte;
URL-urilor de imagini indisponibile;
problemelor de rețea;
expirării sau revocării cheii API;
modificării permisiunilor;
problemelor sistemului extern.
29. Logurile tehnice
xPret.ro poate păstra loguri tehnice pentru diagnosticarea importurilor, sincronizărilor și solicitărilor API.
Aceste informații pot fi utilizate pentru identificarea erorilor, securitate și funcționarea platformei.
30. Datele personale în integrări
Atunci când o integrare implică date ale cumpărătorilor sau comenzilor, Vânzătorul trebuie să respecte obligațiile aplicabile privind protecția datelor.
Mai multe informații sunt disponibile în Politica de confidențialitate.
31. Responsabilitatea Vânzătorului
Vânzătorul este responsabil pentru datele transmise către xPret.ro prin API, CSV, feed XML sau alte integrări.
Acesta trebuie să se asigure că datele sunt:
corecte;
actualizate;
legale;
complete;
compatibile cu regulile platformei.
32. Regulile de publicare se aplică și importurilor
Produsele importate automat sunt supuse acelorași reguli ca produsele create manual.
Consultă:
33. Suspendarea accesului la integrare
xPret.ro poate restricționa sau suspenda accesul unei integrări în cazul:
utilizării abuzive;
încălcării regulilor;
solicitărilor excesive care afectează infrastructura;
problemelor de securitate;
expirării drepturilor aferente planului;
suspendării contului de Vânzător.
34. Modificarea API-ului
xPret.ro poate dezvolta și actualiza API-ul pe măsură ce platforma evoluează.
Modificările importante pot necesita adaptarea sistemelor externe utilizate de Vânzători.
35. Documentația API
Documentația tehnică disponibilă pentru Vânzători reprezintă sursa principală pentru endpoint-uri, câmpuri, permisiuni și exemple de utilizare.
Este recomandată consultarea documentației înainte de dezvoltarea unei integrări.
36. Testarea unei integrări
Înainte de automatizarea completă a catalogului este recomandată testarea cu un număr redus de produse.
Trebuie verificate:
categoriile;
prețurile;
stocurile;
imaginile;
atributele;
actualizarea produselor existente.
37. Alegerea metodei de integrare
Metoda potrivită depinde de sistemul și volumul Vânzătorului.
API – potrivit pentru integrări în timp apropiat de real și control complet asupra sincronizării.
CSV – potrivit pentru importuri manuale sau periodice.
Feed XML – potrivit pentru cataloage publicate automat de sistemul sursă.
BaseLinker – potrivit pentru Vânzătorii care utilizează această platformă pentru centralizarea operațiunilor.
38. Ai nevoie de ajutor cu integrarea?
Pentru întrebări privind API-ul, importurile și integrările xPret.ro:
Email: office@xpret.ro
Telefon: 0745670770
39. Alte informații pentru Vânzători
Consultă și: