Cum să conectezi IdoSell la easySales — Configurare, Sincronizare și Webhooks

easySales se conectează direct la magazinul tău IdoSell, importând comenzile și produsele automat pentru a gestiona totul dintr-un singur panou de control. Acest ghid te conduce prin întreaga configurare — de la generarea cheii API în IdoSell până la activarea webhook-urilor în timp real și urmărirea expedițiilor.

De ce să conectezi IdoSell la easySales

Dacă vinzi pe mai multe canale — propriul magazin IdoSell plus marketplace-uri precum Allegro, Amazon, eMag, Kaufland sau OLX — gestionarea comenzilor și a stocurilor pe toate devine rapid copleșitoare. Conectarea IdoSell la easySales îți oferă:

• Gestionare centralizată a comenzilor — comenzile din magazinul IdoSell apar alături de comenzile de pe marketplace-uri într-un singur loc. Procesează, expediază și urmărește totul dintr-un singur panou
• Sincronizare automată a stocului — când stocul se modifică în easySales (dintr-o vânzare pe marketplace, o ajustare manuală sau un retur), cantitatea actualizată este trimisă înapoi la IdoSell automat. Fără supravânzări
• Gestionare multi-canal a produselor — gestionează catalogul de produse o singură dată și publică pe IdoSell și 100+ marketplace-uri simultan. Actualizează prețurile, descrierile și imaginile dintr-un singur loc
• Expediere și fulfillment unificat — generează etichete de expediere, urmărește livrările și gestionează retururile pe toate canalele fără a comuta între platforme
• Fluxuri de automatizare — configurează reguli care se declanșează automat când sosesc comenzi din IdoSell: atribuie curieri, schimbă statusuri, notifică echipa, aplică etichete și altele
• ERP și facturare — conectează sistemul contabil sau ERP (precum wFirma, Fakturownia sau SmartBill) la easySales și generează automat facturi pentru comenzile IdoSell alături de toate celelalte canale. Poți folosi și easySales Billing pentru a genera facturi direct în platformă, sau te poți conecta la KSeF pentru conformitate eFactură în Polonia

Fie că te extinzi de la IdoSell către noi marketplace-uri sau consolidezi canalele existente într-un singur flux de lucru, integrarea elimină munca manuală de a păstra totul sincronizat.

Tur interactiv

Nu ai chef de citit? Pornește turul interactiv.

Ce ai nevoie înainte de a începe

Înainte de a conecta IdoSell la easySales, asigură-te că ai:

• Un cont IdoSell activ cu privilegii de administrator
• Acces la panoul de administrare IdoSell
• Un cont easySales (perioada de probă gratuită funcționează)

Va trebui să generezi o cheie API în panoul IdoSell. Această cheie permite easySales să citească în siguranță comenzile, produsele și datele de inventar.

Generarea cheii API în IdoSell

1. Conectează-te la panoul de administrare IdoSell
2. Navighează la Setări → API → Chei de Acces Admin API
3. Apasă Adaugă cheie nouă (sau editează una existentă)
4. Asigură-te că cheia are permisiuni de citire pentru OMS (comenzi), PIM (produse) și CMS (clienți)
5. Copiază cheia API generată — o vei lipi în easySales la pasul următor

Conectarea IdoSell la easySales

Odată ce ai cheia API, conectarea durează mai puțin de un minut.

1. În contul easySales, mergi la Integrații → Website-uri
2. Apasă Conectează un Website
3. Selectează IdoSell din lista de platforme
4. Introdu URL-ul magazinului IdoSell (ex. https://magazinultau.idosell.com)
5. Lipește cheia API generată la pasul anterior

Înainte de a salva, configurează setările generale ale website-ului:

• Limba — selectează limba magazinului IdoSell (determină cum sunt importate numele și descrierile produselor)
• Țara — selectează țara în care operează magazinul
• Cota TVA implicită — setează cota de impozitare implicită aplicată produselor și expedierilor (ex. 21% pentru România, 23% pentru Polonia)
• Moneda — selectează moneda magazinului
• Sursa inventar — alege cum gestionează easySales stocul pentru acest website. Depozit clasic folosește o singură valoare de stoc per produs, în timp ce Surse avansate de stoc permite gestionarea stocului din mai multe depozite independent
• Status personalizat implicit — dacă folosești statusuri personalizate de comenzi în easySales, selectează ce status vor primi implicit comenzile noi din IdoSell

Dacă nu ai definit încă statusuri personalizate sau surse de stoc în easySales, poți sări aceste câmpuri și le poți configura ulterior. Totuși, dacă le ai deja configurate, selectarea lor la conectarea inițială te scutește de editări ulterioare.

Odată ce toate setările sunt completate, apasă Salvează. easySales va valida conexiunea și va începe importul datelor. Comenzile se sincronizează în fiecare minut, iar produsele și categoriile la fiecare câteva ore.

Configurarea preferințelor

După conectare, poți ajusta modul în care easySales sincronizează cu magazinul IdoSell. Mergi la Integrații → Website-uri, găsește conexiunea IdoSell și apasă pictograma editare (creion) pentru a deschide fila Preferințe.

Domeniu magazin

Dacă contul IdoSell gestionează mai multe magazine (ex. magazinultau.pl, magazinultau.ro, magazinultau.hu), poți alege dacă sincronizezi datele din toate magazinele sau doar dintr-unul specific.

• Toate magazinele — comenzile și produsele din fiecare magazin din contul IdoSell sunt importate
• Magazin selectat — doar datele din magazinul ales sunt importate

Această opțiune este utilă când ai conexiuni easySales separate per țară sau vitrină.

Sursa stoc produse

Această setare se aplică când sursa de inventar este setată pe Depozit clasic. Controlează cum citește easySales nivelurile de inventar IdoSell:

• Depozit unic — valorile stocului provin dintr-un singur depozit din contul IdoSell. Apare un dropdown unde alegi depozitul
• Suma tuturor depozitelor — valorile stocului sunt totalul combinat din toate depozitele

Cum funcționează sincronizarea

Odată conectat, easySales păstrează automat datele sincronizate:

• Comenzi (IdoSell → easySales) — în fiecare minut
• Produse (IdoSell → easySales) — la fiecare 6 ore
• Niveluri stoc (IdoSell → easySales) — la fiecare 30 minute
• Actualizări stoc (easySales → IdoSell) — pe măsură ce apar modificări
• Categorii (IdoSell → easySales) — la fiecare 6 ore

Nu trebuie să faci nimic pentru a începe sincronizarea — pornește automat după conectare. Dacă dorești actualizari și mai rapide, poți activa webhook-urile (descrise în secțiunea următoare).

Aceste operații de sincronizare sunt configurabile. In secțiunea Preferințe sincronizare din setările website-ului IdoSell, poți activa sau dezactiva direcții individuale de sincronizare — de exemplu, poți dezactiva preluarea comenzilor dacă ai nevoie doar de sincronizarea produselor, sau dezactiva actualizările de stoc către IdoSell dacă gestionezi inventarul în altă parte.

Configurarea webhook-urilor pentru sincronizare în timp real

Implicit, easySales interoghează magazinul IdoSell la intervale regulate. Webhook-urile adaugă un strat mai rapid: IdoSell trimite modificările către easySales în momentul în care au loc, astfel încât comenzile noi și actualizările de produse apar în câteva secunde.

Webhook-urile funcționează alături de polling — nu trebuie să alegi între ele. Polling-ul continuă să ruleze ca rețea de siguranță chiar și când webhook-urile sunt active.

Pasul 1: Activează webhook-urile în easySales

1. Mergi la Integrații → Website-uri
2. Apasă pictograma editare pe conexiunea IdoSell
3. Deschide fila Preferințe
4. Activează Enable IdoSell Webhooks
5. Vor apărea două URL-uri webhook — unul pentru comenzi, unul pentru produse
6. Copiază ambele URL-uri folosind butonul de copiere de lângă fiecare

Pasul 2: Configurează webhook-urile în IdoSell

Acum trebuie să spui IdoSell unde să trimită notificările.

1. În panoul de administrare IdoSell, mergi la Setări → API → Chei de Acces Admin API
2. Editează cheia API folosită pentru easySales
3. Apasă Adaugă webhook
4. Pentru webhook-ul de comenzi:
   • Nume: easySales Orders (sau orice nume preferi)
   • URL: lipește URL-ul webhook de comenzi copiat din easySales
   • Evenimente: selectează toate evenimentele de comenzi — orderCreated, orderUpdated, orderPaid, orderStatusUpdated, orderPackageCreated, orderSent, orderDelivered, orderCanceled
5. Salvează, apoi adaugă un al doilea webhook pentru produse:
   • Nume: easySales Products
   • URL: lipește URL-ul webhook de produse din easySales
   • Evenimente: selectează toate evenimentele de produse — productCreated, productPriceUpdated, productStockUpdated, productDispositionUpdated
6. Salvează modificările

Atât. IdoSell va trimite acum actualizări în timp real către easySales ori de câte ori se plasează o comandă, se modifică un produs sau se expediază o livrare.

Testarea webhook-urilor

IdoSell oferă o funcție de testare integrată pentru webhook-uri. După salvarea configurației, apasă butonul Test de lângă acesta. Poți trimite date de exemplu sau folosi un ID real de comandă/produs pentru a verifica că easySales primește notificarea corect.

Dacă un webhook nu reușește să livreze (eroare de rețea, server indisponibil), IdoSell reîncearcă automat — la fiecare 10 minute in prima oră, apoi la fiecare oră timp de 23 de ore.

Urmărirea statusului expediției

Dacă gestionezi expedierile prin integrările de curierat ale IdoSell (InPost, DHL, GLS și altele), easySales poate afișa statusul livrării fiecărui colet direct pe comandă.

Activarea sincronizării statusului expediției

1. Mergi la fila Preferințe a conexiunii IdoSell
2. Activează Sync shipment status

Odată activat, easySales citește informațiile de urmărire a livrării la fiecare ciclu de sincronizare și le stochează ca metadate ale comenzii. Fiecare colet apare ca o intrare separată de metadate pe comandă. De exemplu:

• delivery_62099969xxxxxx — Livrat (InPost)
• delivery_PKG-98xxx — Expediat (GLS)

Statusul se actualizează automat pe măsură ce livrarea progresează — de la Eticheta creată la Expediat la Livrat.

Această funcție se aplică doar expedierilor create prin integrările de curierat ale IdoSell. Dacă gestionezi expedierile în afara IdoSell, nu vor fi generate metadate.