Cum conectezi Skroutz cu easySales: ghid complet de integrare

De ce să conectezi Skroutz cu easySales

Skroutz este cel mai mare marketplace și platformă de comparare a prețurilor din Grecia, iar a vinde acolo înseamnă să ții ordinea în listări, comenzi și facturi. easySales aduce Skroutz într-un singur panou, alături de restul canalelor tale de vânzare, așa că gestionezi un singur catalog și un singur flux de comenzi, în loc să comuți între ecrane.

Odată conectat, comenzile tale de pe Skroutz ajung în easySales gata de facturat, de procesat cu fluxuri automate și de expediat. Catalogul merge în sens invers: easySales îți publică produsele pe Skroutz și le ține prețurile și stocul la zi, așa că menții un singur catalog în loc să editezi manual fiecare listare de pe Skroutz.

Cum funcționează conectorul Skroutz

Skroutz este o integrare hibridă — parte feed, parte API live — așa că merită să înțelegi împărțirea înainte să începi.

• Catalogul tău iese printr-un feed de produse. easySales construiește un feed de produse XML cu listările tale — nume, descrieri, branduri, EAN-uri, categorii, imagini, prețuri, TVA, stoc, greutate și caracteristici — și îl reîmprospătează după un program recurent. Skroutz citește acel feed pentru a-ți crea și actualiza listările.
• Comenzile intră printr-un webhook. Skroutz trimite fiecare comandă nouă și actualizată direct în easySales, unde aterizează în Comenzi & clienți → Comenzi, gata de facturare și fluxuri.
• Acțiunile asupra comenzilor merg înapoi prin Token API de Merchant. Token-ul pe care îl lipești în conexiune permite easySales să acționeze asupra comenzilor tale de pe Skroutz — să le accepte sau să le respingă, să trimită detaliile de tracking și să încarce facturile înapoi pe Skroutz.

Pentru că partea de catalog rulează pe un feed, câteva lucruri funcționează diferit față de un marketplace pur API. Modificările pe care le faci în easySales nu sunt instant pe Skroutz — călătoresc cu următoarea reîmprospătare a feed-ului. Iar fluxul este unidirecțional pe alocuri: easySales nu citește înapoi de la Skroutz statusul ofertelor tale, iar listările existente de pe Skroutz nu sunt importate în easySales.

Cerințe preliminare — ce să pregătești înainte de a începe

Câteva lucruri trebuie să fie la locul lor înainte de prima sincronizare.

Pasul 1 — Conectează Skroutz în easySales

În easySales, din bara laterală mergi la Integrări → Marketplace, găsește cardul Skroutz și apasă Conectează pe el. Se deschide formularul de setări Skroutz, cu două file: Setări principale (configurarea de bază) și Setări adiționale (comportamentul sincronizării). Vei lucra întâi în Setări principale.

În fila Setări principale, completează cum ar trebui easySales să-ți construiască feed-ul, să-ți stabilească prețurile ofertelor și să-ți gestioneze comenzile:

• Nume Conexiune — o etichetă pe care o alegi pentru această conexiune. Vizibilă doar în interiorul easySales.
• Adaos Preț — un procent opțional adăugat peste prețul produsului tău când o ofertă nouă este publicată pe Skroutz. Se aplică ofertelor nou create.
• Cota de TVA pentru transport — cota de TVA aplicată liniei de transport de pe comenzile tale de pe Skroutz.
• Rata TVA implicită — procentul de TVA implicit aplicat ofertelor și comenzilor tale. Setează-l pe 0 dacă nu ești plătitor de TVA.
• Token API — Token API de Merchant al tău de la Skroutz. Lasă-l gol deocamdată; Skroutz îl emite după ce îți validează feed-ul de produse, iar tu vei reveni să-l lipești (vezi Pasul 4).
• Seria de facturare — seria de facturare implicită atribuită comenzilor Skroutz importate, potrivită cu seria pe care o folosești în softul tău de facturare.
• Tip de pachet implicit — dacă pachetele tale sunt implicit Plic sau Colet.
• Atribute de mărime și Atribute de culoare — caracteristicile de produs pe care Skroutz le citește ca mărime și culoare ale unei variații. Maparea acestora este ceea ce îi permite lui Skroutz să-ți grupeze variantele într-o singură familie (vezi Pasul 3).
• Caracteristici excluse din oferte — orice caracteristici pe care nu vrei să le scrii în feed-ul tău de Skroutz.
• Afișează caracteristicile în descrierea produsului și Documentația produsului în limba locală — controlează cum apar caracteristicile și textul produsului pe Skroutz.
• Zile de livrare — timpul de procesare publicat împreună cu ofertele tale.
• Finalizați comanda la generarea AWB și opțiunile de livrare — tratate în secțiunea despre comenzi de mai jos.

Apasă Salvează pentru a crea conexiunea.

Pasul 2 — Listează-ți produsele și trimite feed-urile către Skroutz

Conectarea contului nu-ți pune catalogul pe Skroutz de la sine — tu alegi ce produse să listezi.

Din bara laterală, mergi la Magazine Online → Produse, selectează produsele pe care vrei să le vinzi pe Skroutz, iar din bara de acțiuni în masă folosește acțiunea Adaugă ofertă(e) pe, alegând conexiunea ta Skroutz. easySales creează câte o ofertă Skroutz pentru fiecare produs, legată de acesta în catalogul tău. De atunci, oferta călătorește în feed-ul tău de produse, iar stocul și prețul ei rămân legate de produsul sursă. Doar ofertele care sunt active, sincronizate și legate de un produs din catalog sunt scrise în feed. Ofertele tale publicate apar în Marketplace → Oferte, pe fila Skroutz, unde le poți verifica și edita.

Când salvezi conexiunea, easySales generează două feed-uri care fac integrarea să funcționeze. Ambele apar pe cardul tău Skroutz din Integrări → Marketplace:

• URL Feed — feed-ul de produse XML pe care Skroutz îl citește pentru a-ți construi și actualiza listările.
• Orders URL — adresa la care Skroutz îți trimite comenzile.

easySales nu înregistrează automat aceste URL-uri — le copiezi de pe cardul tău Skroutz și le predai lui Skroutz, iar fiecare merge într-un loc diferit în contul tău Skroutz Merchants:

• URL Feed — trimite-l în Services → XML file (fișierul XML): validează-ți feed-ul, apoi folosește Send XML link (trimite linkul XML). Echipa Skroutz face verificări suplimentare și finalizează evaluarea.
• Orders URL — pe Skroutz, deschide Services → Skroutz Marketplace și derulează până la Integration with the online store → Order webhooks (integrarea cu magazinul online → webhook-uri de comenzi): lipește URL-ul în câmpul Webhook URL și bifează Enable, ca Skroutz să înceapă să-ți trimită comenzile către easySales.

Punerea în funcțiune este un pas operațional care poate dura puțin, în loc să se întâmple instant. Un feed conectat, fără comenzi deocamdată, este normal cât timp Skroutz încă îți integrează feed-ul.

Gruparea variațiilor într-o familie

Dacă vinzi un produs în mai multe mărimi sau culori, Skroutz poate afișa variantele ca o singură listare de familie, în loc de produse separate. easySales construiește această grupare integral din datele tale de produs — familia de produse și caracteristicile ei — plus o mică mapare pe care o setezi pe conexiune. Iată cum se îmbină piesele:

• Familia vine din structura produsului tău. Variantele care merg împreună trebuie să împartă un produs părinte în easySales (aceeași familie de variație). easySales preia acest lucru automat când produsele sunt deja grupate în magazinul tău sursă; altfel, setezi variația pe fiecare ofertă manual sau printr-un import Excel. Variantele care nu împart un părinte sunt trimise către Skroutz ca listări de sine stătătoare, iar listarea de familie își ia numele de la produsul părinte.
• Valorile de mărime și culoare sunt citite din caracteristicile produsului. Mărimea fiecărei variante — și culoarea ei — vine direct din caracteristicile proprii ale acelui produs, de exemplu o caracteristică „
  ” cu valoarea „
  ” sau o caracteristică „
  ” cu valoarea „
  ”. Nu le reintroduci pentru Skroutz; sunt preluate din produs.
• Tu mapezi ce caracteristică este mărimea și care este culoarea. În fila Setări principale a conexiunii, folosește Atribute de mărime ca să-i spui lui easySales care caracteristică conține mărimea, și Atribute de culoare pentru culoare. Această mapare este ceea ce transformă caracteristicile produsului tău în dimensiunile de mărime și culoare ale Skroutz.

Două condiții decid dacă o familie chiar se formează:

• O caracteristică de mărime trebuie mapată. Familia este construită în jurul dimensiunii de mărime — dacă nu ai mapat un Atribut de mărime, sau un produs nu are o valoare pentru el, acel produs iese ca listare de sine stătătoare în loc să se alăture unei familii. Maparea unui Atribut de culoare de una singură nu creează o familie; ea doar adaugă dimensiunea de culoare variantelor deja grupate după mărime.
• Valoarea de mărime sau culoare nu trebuie să fie în titlul ofertei. Variantele dintr-o familie împart același nume de produs, iar mărimea stă în câmpul ei propriu, așa că nu scrie „
  ” sau „
  ” în titlu — altfel Skroutz nu le poate grupa corect.

Maparea atributului îi spune lui easySales doar care caracteristică să citească — tot trebuie să completezi valoarea acelei caracteristici pe fiecare produs. easySales nu inventează niciodată o mărime, așa că un produs a cărui caracteristică de mărime este goală este trimis fără mărime și nu se va alătura unei familii. Acesta este cel mai frecvent motiv pentru care o mărime lipsește dintr-un feed de Skroutz. Dacă mai multe produse nu au valoarea, completeaz-o în masă cu Mass edit (editare în masă) din lista ta de oferte Skroutz. Pentru un produs care într-adevăr nu are mărime, introdu valoarea literală One Size (în engleză) pe acea caracteristică — Skroutz așteaptă exact acel text, iar easySales îl trimite ca atare. Odată ce valorile sunt la locul lor, easySales generează automat variațiile de mărime pentru produsele care sunt deja grupate ca variante — fără configurare suplimentară.

Pasul 3 — Reglează fin sincronizarea

Fila Setări adiționale controlează cum se sincronizează easySales cu Skroutz după ce conexiunea este activă.

• Trimite MPN — alege ce trimite easySales către Skroutz ca MPN al produsului (numărul de piesă al producătorului). Există patru opțiuni: nu trimite nimic, SKU-ul ofertei, SKU părinte (SKU-ul produsului părinte — util pentru variante grupate care ar trebui să împartă un singur MPN), sau valoarea unei caracteristici anume. Dacă alegi Caracteristică, apare un al doilea câmp în care selectezi ce caracteristică să trimiți.
• Activează ofertele automat când produsele sunt pe stoc — reactivează ofertele automat odată ce un produs revine pe stoc peste zero.

Pasul 4 — Adaugă Token-ul API după ce Skroutz validează feed-ul

Aceasta este partea la care se împiedică vânzătorii, așa că merită subliniată clar. Skroutz nu-ți dă un Token API de Merchant din start — îl emite după ce ți-a validat feed-ul de produse pe care l-ai trimis. Deci secvența este:

1. Conectează Skroutz în easySales și listează-ți ofertele (Pașii 1–2).
2. Trimite URL-ul Feed și Orders URL către Skroutz.
3. Odată ce Skroutz îți aprobă feed-ul, generează-ți Token API de Merchant în contul tău Skroutz Merchants, în Products → API, folosind Generate a new API token (generează un nou token API). Skroutz păstrează un singur token activ la un moment dat, așa că generarea unuia nou înlocuiește orice cheie anterioară.
4. Înapoi în easySales, deschide conexiunea ta Skroutz, lipește token-ul în câmpul Token API din Setări principale și salvează.

Până când token-ul nu este la locul lui, comenzile pot ajunge în continuare, dar easySales nu le poate accepta și nu poate trimite tracking-ul și facturile înapoi la Skroutz — toate aceste acțiuni se autentifică cu token-ul. Dacă vezi comenzi care intră, dar nu sunt acceptate, un câmp Token API gol este primul lucru de verificat.

Cum funcționează comenzile, livrarea și facturile Skroutz

Comenzile sunt partea din Skroutz care rulează pe cont propriu. easySales nu extrage comenzile de la Skroutz — Skroutz trimite fiecare comandă la Orders URL-ul tău, deci Skroutz controlează livrarea. easySales importă fiecare comandă, potrivind produsele după EAN și tarifând totul în euro. Odată ce Token-ul API este la locul lui, easySales acceptă automat comanda înapoi pe Skroutz și rezervă o fereastră de ridicare de la curier. Setarea Întârzie intervalul de ridicare decide ce interval rezervă: activată implicit, alege cea mai târzie fereastră disponibilă; dezactiveaz-o pentru a rezerva cea mai devreme.

Pentru că livrarea este bazată pe push, dacă o comandă nu ajunge vreodată la easySales, o poți retrimite singur din Skroutz: deschide acea comandă în contul tău Skroutz Merchants și, în panoul ei Webhook, apasă New Request (cerere nouă) pentru a o trimite din nou.

Livrarea funcționează în unul din două moduri, iar tu alegi per conexiune:

• Skroutz furnizează eticheta. Activează Atașează awb-ul din marketplace și easySales atașează voucherul de transport pe care Skroutz îl emite pentru comandă, așa că nu generezi un AWB separat.
• Tu generezi AWB-ul. Generează eticheta de transport în easySales ca de obicei, iar easySales trimite detaliile de tracking înapoi la Skroutz. Skroutz recunoaște un set fix de curieri pentru asta — DPD, DHL, GLS, ACS, Speedex, ELTA și Geniki Taxydromiki — așa că folosește unul dintre aceștia pentru ca tracking-ul să se înregistreze pe Skroutz.

Și facturile sunt trimise înapoi: când generezi o factură pentru o comandă Skroutz, easySales încarcă automat PDF-ul pe Skroutz. Finalizați comanda la generarea AWB este activată implicit, așa că easySales marchează comanda și ca finalizată odată ce eticheta ei de transport este atașată — dezactiveaz-o dacă preferi să gestionezi tu acel status.

Ești conectat — ce urmează

Cu comenzile care sosesc, pasul următor este automatizarea: configurează fluxuri în Procesare → Fluxuri pentru a genera facturi și a procesa comenzile pe măsură ce intră. Ține un ochi pe ofertele tale în Marketplace → Oferte, pe fila Skroutz, unde oricare dintre cele care nu trec validarea sunt semnalate — și contactează suportul dacă ceva pare în neregulă.