Cum conectezi Pepita cu easySales: ghid complet de integrare

De ce să conectezi Pepita cu easySales

Vinzi pe Pepita și vrei un singur loc din care să gestionezi comenzile, să emiți facturi și să-ți menții listările la zi? easySales îți aduce marketplace-urile Pepita — Ungaria, România, Polonia, Slovacia, Germania, Austria, Bulgaria și Croația — într-un singur panou, alături de restul canalelor tale de vânzare.

Odată conectate, comenzile Pepita intră în easySales, ca să le poți factura, procesa cu flow-uri de automatizare și urmări livrarea. Catalogul tău merge în sens invers: easySales îți publică produsele pe Pepita și le menține stocul și prețurile actualizate, astfel încât gestionezi un singur catalog în loc să editezi fiecare listare manual.

Pepita se conectează diferit față de majoritatea marketplace-urilor. Nu ai chei API de copiat și niciun plugin de instalat. În schimb, completezi un formular scurt de setări și salvezi — iar easySales generează cele două feed-uri care îți leagă contul: un feed de produse care îți duce catalogul către Pepita și un URL de comenzi unic pe care Pepita îl folosește pentru a-ți trimite comenzile înapoi.

Cum funcționează conectorul Pepita

Merită să înțelegi împărțirea înainte de a începe, pentru că Pepita este o integrare bazată pe feed-uri, nu pe un API live.

• Catalogul tău iese printr-un feed de produse. easySales construiește un feed XML de produse cu listările tale — denumiri, descrieri, branduri, coduri EAN, categorii, imagini, prețuri, TVA, stoc și caracteristici — și îl reîmprospătează după un program recurent. Pepita citește acel feed pentru a crea și actualiza ofertele tale.
• Comenzile intră prin URL-ul tău de comenzi. Fiecare conexiune de țară Pepita are propriul URL de comenzi, iar Pepita trimite la el comenzile noi și actualizate ale acelei țări. Comenzile ajung în ecranul de Comenzi, gata de facturare și flow-uri; pentru livrările la locker, Pepita include totodată eticheta de livrare împreună cu comanda.

Pentru că legătura funcționează pe feed-uri, câteva lucruri se comportă diferit față de un marketplace cu API. Modificările pe care le faci în easySales nu apar instant pe Pepita — ele călătoresc odată cu următoarea reîmprospătare a feed-ului, iar adăugarea sau actualizarea informațiilor în feed poate dura până la aproximativ trei ore până apare pe Pepita. Iar fluxul este intenționat unidirecțional pe alocuri: easySales nu citește înapoi statusul de aprobare al ofertelor tale de la Pepita, listările Pepita existente nu sunt importate în easySales, iar statusul comenzii nu este trimis înapoi către Pepita.

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

Câteva lucruri trebuie să fie pe poziții înainte de prima sincronizare.

Pasul 1 — Deschide formularul de conectare în easySales

În easySales, din bara laterală mergi la Integrări → Marketplace. Fiecare țară Pepita are propriul card — Ungaria, România, Polonia, Slovacia, Germania, Austria, Bulgaria și Croația. Găsește cardul pentru țara pe care o conectezi și apasă Conectează pe el.

Formularul de setări Pepita se deschide cu două taburi: Setări principale (configurarea de bază) și Setări adiționale (comportamentul de sincronizare). Vei lucra mai întâi în Setări principale.

Pasul 2 — Completează setările Pepita

În tabul Setări principale, completează configurarea pe care easySales o folosește pentru a-ți construi feed-ul și a-ți stabili prețurile ofertelor. Nu există credențiale aici — fiecare câmp descrie cum ar trebui să se comporte catalogul și comenzile tale.

• Nume Conexiune — o etichetă aleasă de tine (de exemplu „Pepita HU"). Vizibilă doar în interiorul easySales, utilă când ai mai multe conexiuni Pepita.
• Adaos Preț — un procent opțional adăugat peste prețul produsului tău atunci când o ofertă nouă este publicată pe Pepita. Se aplică ofertelor nou create.
• Cota de TVA pentru transport — cota de TVA aplicată liniei de transport de pe comenzile tale Pepita.
• Rata TVA implicită — procentul de TVA implicit aplicat ofertelor și comenzilor tale. Setează-l la 0 dacă nu ești plătitor de TVA.
• Zile de livrare — timpul de procesare publicat împreună cu ofertele tale, folosit ca întârziere de livrare în feed-ul tău.
• Seria de facturare — seria de facturare implicită atribuită comenzilor Pepita importate, care corespunde seriei folosite în software-ul tău de facturare. O poți suprascrie per comandă.
• Tip de pachet implicit — dacă coletele tale sunt implicit plic sau colet.

Apasă Salvează pentru a finaliza.

Pasul 3 — Salvează și transmite feed-urile către Pepita

Când apeși Salvează, easySales creează conexiunea și generează cele două feed-uri care o fac să funcționeze. Ambele apar direct pe cardul tău Pepita din Integrări → Marketplace și, din nou, în vizualizarea conexiunii când o deschizi:

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

Ca să pornești live, ambele URL-uri trebuie să ajungă la Pepita: aceasta îți citește feed-ul de produse și îți trimite comenzile înapoi la URL-ul de comenzi. easySales nu le înregistrează automat la Pepita și nu există niciun loc în panoul Pepita unde să le adaugi singur — așa că îți copiezi cele două linkuri de pe cardul Pepita și le trimiți prin email către Pepita, care le configurează de partea lor pentru a finaliza conexiunea.

Echipa Pepita implementează feed-urile de partea lor, așa că pornirea live este un pas operațional care poate dura câteva zile, în loc să se întâmple instant. Un feed conectat, dar fără comenzi încă, este normal cât timp Pepita încă îți integrează feed-ul — nu e un semn că ceva nu funcționează.

Cum îți duci catalogul pe Pepita

Publicarea pe Pepita este un al doilea pas deliberat — conectarea contului nu îți urcă singură tot catalogul pe Pepita. Tu alegi ce produse să listezi.

Din bara laterală, mergi la Magazine Online → Produse, selectează produsele pe care vrei să le vinzi pe Pepita și folosește acțiunea Adaugă ofertă(e) pe, alegând conexiunea ta Pepita. easySales creează o ofertă Pepita 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ă.

Această legătură este ceea ce menține o ofertă sincronizată: doar ofertele active și legate de un produs din catalog sunt scrise în feed. Dacă un produs este dezlegat ulterior, oferta lui pur și simplu dispare din feed. Ofertele tale publicate apar în Marketplace → Oferte, pe tabul Pepita, unde le poți revizui și edita.

Nu există un pas de mapare a categoriilor pentru Pepita. Feed-ul tău îți transportă propriile categorii easySales exact așa cum sunt, deci — spre deosebire de marketplace-uri precum eMAG sau Trendyol — nu îți potrivești produsele la un arbore de categorii Pepita înainte ca ele să poată fi listate.

Reglarea fină a conexiunii Pepita

Tabul Setări adiționale controlează cum sincronizează easySales cu Pepita după ce conexiunea este live.

• Trimite stocul ofertei către marketplace — când e activ, feed-ul tău include cantitatea exactă de stoc pentru fiecare ofertă. Dezactivează-l și feed-ul îi spune în continuare Pepitei dacă un produs este pe stoc sau nu, dar reține numărul exact.
• Caracteristici excluse din oferte — alege orice caracteristici de produs pe care nu vrei să le scrii în feed-ul tău Pepita.
• Finalizați comanda la generarea AWB — când e setat pe Da, easySales marchează o comandă Pepita ca finalizată odată ce eticheta ei de livrare este atașată.
• Activează ofertele automat când produsele sunt pe stoc — reactivează ofertele automat de îndată ce un produs revine pe stoc peste zero.

Cum funcționează comenzile, AWB-urile și facturile Pepita

Comenzile sunt partea din Pepita care merge de la sine. Fiecare conexiune de țară Pepita are propriul URL de comenzi, așa că odată ce URL-ul unei țări este configurat de partea Pepita, Pepita trimite comenzile acelei țări direct în conexiunea corespunzătoare din easySales, gata de facturare și flow-uri.

Pentru livrările la locker (de exemplu GLS parcel locker sau parcelshop), Pepita emite ea însăși eticheta de livrare și o include cu comanda, așa că easySales atașează acel AWB în loc să genereze unul nou — iar dacă ai activat Finalizați comanda la generarea AWB, atașarea etichetei marchează totodată comanda ca finalizată. Pentru comenzile cu livrare la domiciliu Pepita nu trimite nicio etichetă, așa că generezi AWB-ul în easySales la fel ca pentru orice altă comandă.

Două lucruri rămân, prin design, de partea ta. Statusul comenzii nu este trimis înapoi către Pepita — când procesezi sau finalizezi o comandă în easySales, actualizează-i statusul și în panoul propriu al Pepitei. Iar Pepita nu acceptă facturi încărcate, așa că factura pe care o generezi rămâne în easySales; vei vedea pe comandă o notă care confirmă că a fost creată aici, nu trimisă către Pepita.

HU, RO, PL, SK, DE, AT, BG și HR — conectează fiecare țară

Procedura de conectare este identică pentru toate cele opt marketplace-uri Pepita. Ce diferă este specific fiecărei țări, iar easySales gestionează asta odată ce alegi cardul potrivit:

• Moneda urmează țara — HUF pentru Ungaria, RON pentru România, PLN pentru Polonia și EUR pentru Slovacia, Germania, Austria, Bulgaria și Croația.
• Cotele de TVA disponibile urmează regulile fiscale ale fiecărei țări.

Adaugi fiecare țară ca propria conexiune în Integrări → Marketplace, iar fiecare generează propriul URL Feed și Orders URL. Trimite către Pepita perechea proprie de URL-uri a fiecărei țări — URL-urile unei țări nu funcționează pentru alta, așa că fiecare conexiune se predă separat.

Ești conectat — ce urmează

Cu comenzile care încep să sosească, următorul pas este automatizarea: configurează flow-uri care să emită facturi și să proceseze comenzile pe măsură ce intră.

Ca să-ți duci catalogul pe Pepita, adaugă-ți ofertele din Magazine Online → Produse și lasă easySales să le publice și să le mențină prin feed. După ce primele tale oferte pleacă, ține un ochi pe ofertele tale din Marketplace → Oferte, unde oricare care nu trece de validare este semnalată — și contactează suportul dacă ceva pare în neregulă.