Marketplace-uri

Cum conectezi Okazii cu easySales: ghid complet de configurare

Cum conectezi Okazii cu easySales: ghid complet de configurare

Conectează Okazii la easySales: setările conexiunii, URL Feed-ul tău și cum îl configurezi în Okazii, care oferte ajung de fapt în feed și cum circulă înapoi comenzile, facturile și AWB-urile.

Cum funcționează integrarea Okazii

Okazii nu se conectează la fel ca majoritatea marketplace-urilor, iar dacă știi asta de la început îți scutești multă confuzie mai târziu.

Ofertele tale nu sunt niciodată trimise către Okazii. easySales construiește un fișier XML — feedul — și îl publică la o adresă privată. Okazii citește acel fișier după propriul lui program și importă tot ce găsește în el. Acesta este singurul drum pe care îl fac produsele, prețurile și stocurile tale.

Comenzile vin înapoi pe cealaltă cale, prin API-ul Okazii, folosind un token din contul tău Okazii. easySales trimite înapoi și factura, și numărul AWB pentru fiecare comandă.

Așadar configurarea are două jumătăți: una în easySales, una în panoul Okazii. Niciuna nu funcționează fără cealaltă.

Înainte să începi

Un cont de vânzător Okazii

Cu acces la zona de administrare a magazinului, pentru că jumătate din această configurare se face acolo.

Tokenul tău API de la Okazii

În panoul Okazii, în zona de administrare a magazinului, la setările API. Copiază doar partea numerică. Fără el, easySales nu poate citi nicio comandă.

Produse pregătite de vânzare

Fiecare are nevoie de nume, SKU, cel puțin o imagine, un preț de minimum 0,10 și stoc peste zero. Orice lipsește ține produsul în afara feedului — vezi verificările de mai jos.

O decizie despre TVA

Rata TVA implicită de pe conexiune este cea care îi spune aplicației easySales dacă prețurile tale de pe Okazii conțin TVA. Află care este situația ta înainte să salvezi.

Pasul 1 — Conectează Okazii în easySales

Mergi la Configurare → Integrări → Marketplace, caută Okazii și deschide cardul.

Pagina Marketplace din easySales filtrată după Okazii, cu cardul Okazii conectat, steagul României și acțiunea de editare.
Okazii în Configurare → Integrări → Marketplace.

Completează formularul din dreapta.

Partea de sus a formularului de conexiune Okazii, cu Nume Conexiune, Status custom pentru comanda noua, Adaos Preț, Cota de TVA pentru transport, Rata TVA implicită și Seria de facturare.
Prima jumătate a formularului. Rata TVA implicită decide dacă prețurile tale pleacă cu TVA.
Câmp Ce completezi
Nume Conexiune Obligatoriu. Numele pe care i-l dai tu acestui cont Okazii. Când ai mai multe conturi, acestea devin taburile.
Status custom pentru comanda noua Opțional. Un status propriu în care să intre fiecare comandă Okazii nouă.
Adaos Preț Obligatoriu. Un procent adăugat la prețul produsului în momentul creării ofertei. Se salvează pe ofertă atunci, așa că modificarea lui ulterioară nu schimbă prețul ofertelor care există deja.
Cota de TVA pentru transport Cota de TVA aplicată liniei de transport dintr-o comandă importată.
Rata TVA implicită Obligatoriu și mai important decât pare — vezi mai jos.
Seria de facturare Obligatoriu. Seria folosită atunci când se creează o factură pentru o comandă Okazii. Poate fi schimbată la nivel de comandă.
Tip de pachet implicit Plic sau Colet, folosit ca valoare implicită pe AWB-urile acestor comenzi.
Tip descriere Dacă feedul duce descrierea produsului tău sau una generată din caracteristicile produsului. Okazii nu acceptă cod HTML.
Token API Obligatoriu. Din contul tău Okazii, din zona de administrare a magazinului, la setările API — copiază doar partea numerică.
Formularul de conexiune

Restul formularului controlează felul în care produsele tale sunt descrise în feed.

Jumătatea de jos a formularului de conexiune Okazii, cu Tip de pachet implicit, Tip descriere, Token API, Atribute de mărime, Atribute de culoare, Adaugă caracteristicile în feed și Activează ofertele automat când produsele sunt pe stoc.
A doua jumătate. Token API este cel care face să funcționeze importul de comenzi.
  • Atribute de mărime și Atribute de culoare îi spun aplicației easySales care dintre caracteristicile produselor tale poartă mărimea și culoarea, astfel încât variantele să fie grupate într-un singur anunț pe Okazii, nu în mai multe.
  • Adaugă caracteristicile în feed pune în fișier toate caracteristicile produsului.
  • Activează ofertele automat când produsele sunt pe stoc reactivează singur o ofertă în momentul în care produsul revine pe stoc.

Pasul 2 — Copiază URL-ul feedului

După ce conexiunea este salvată, coloana din stânga afișează URL Feed. Arată așa: https://app.easy-sales.com/feed/12345/487213904/okazii.xml, iar fiecare cont Okazii conectat are propria adresă.

Coloana din stânga a paginii de conexiune Okazii din easySales, cu URL Feed și rândul Opțiuni cu Retrimite toate ofertele și Sincronizează comenzile.
URL Feed este adresa pe care i-o dai Okazii. Fiecare cont conectat are propria adresă.

Atât Regenerează URL Feed, cât și Adaugă cont — pentru un al doilea cont Okazii, cu setările lui și cu propriul URL Feed — se află în meniul al cardului.

Meniul cu trei puncte deschis pe cardul Okazii din easySales, cu Adaugă cont, Documentație, Regenerează URL Feed și Înregistrare.
Meniul cardului. Adaugă cont conectează un al doilea cont Okazii; Regenerează URL Feed înlocuiește adresa feedului tău.

Pasul 3 — Îndreaptă Okazii către feed

Această jumătate se petrece în panoul Okazii, a cărui interfață este în limba română.

  1. Deschide Meniu → Administrează Magazin (sau Setări → Magazin → Administrare).
  2. Mergi la Administrează articole → Import Produse și alege Import Automat.
  3. Lipește URL-ul feedului tău în Adaugă URL-ul Feedului.
  4. Bifează Elimină din okazii produsele care nu apar în feed.
  5. Salvează cu Salvează Opțiunile.

Pasul 4 — Creează-ți ofertele

O ofertă Okazii se creează dintr-un produs pe care îl ai deja în easySales. Deschide Produse, selectează produsele dorite și folosește Adaugă oferte pe din bara de sus — sau Adaugă ofertă pe un singur rând — și alege Okazii.

Care dintre ofertele tale ajung de fapt pe Okazii

Aceasta este întrebarea din spatele aproape fiecărei probleme de tipul „Okazii mi-a importat doar câteva produse”. O ofertă este scrisă în fișierul feed doar dacă toate patru condițiile de mai jos sunt adevărate:

Condiția Unde o vezi
Oferta are statusul Activat Butonul de status de pe rândul ofertei.
Oferta este Linked, adică legată de un produs Linia Linked de sub numele ofertei.
Produsul acela are stoc peste zero Linia Stoc de sub numele ofertei.
Oferta nu are nicio eroare blocantă Coloana Erori.
O ofertă intră în feed doar dacă toate patru condițiile sunt adevărate

Le vezi pe toate patru dintr-o privire în Marketplace → Oferte → Okazii.

Tabul Okazii din ecranul Oferte în easySales, cu șase oferte, fotografia lor, numele, SKU-ul legat, stocul, prețul, butonul de status și o eroare 1006 Missing product images.
Tot ce decide dacă o ofertă ajunge pe Okazii se vede pe acest ecran: statusul, produsul legat, stocul și erorile.

O ofertă care nu trece validarea este dezactivată, iar motivul apare în coloana Erori.

Eroare Ce ai de reparat
1000 Missing product name Produsul nu are nume.
1001 Missing product sku Produsul nu are SKU.
1004 Invalid product price Prețul de vânzare este sub 0,10.
1005 Invalid images data Imaginile ofertei nu sunt într-o formă utilizabilă. Salvează din nou imaginile pe produs.
1006 Missing product images Produsul nu are nicio imagine. Este de departe cea mai frecventă.
Erorile care țin o ofertă în afara feedului

În cât timp se vede o modificare

easySales reconstruiește fișierul feed cel mult o dată pe oră și, în mod normal, doar după ce Okazii a citit versiunea anterioară. Apoi Okazii trebuie să își ruleze propriul import. În practică, o ofertă nou adăugată apare de obicei după ce Okazii a descărcat fișierul de două ori, așa că lasă câteva ore, nu te aștepta să se întâmple imediat.

Categorii

Categorie de pe ofertă este un simplu text, preluat o singură dată din prima categorie în care se află produsul. easySales nu deține arborele de categorii al Okazii, așa că potrivirea dintre numele categoriilor tale și categoriile Okazii se face în Okazii, la Administrare Articole → Administrare Catalog.

Ca să schimbi textul pe care îl trimite easySales, modifică-l în easySales — pe ofertă (Marketplace → Oferte → Okazii → Editează) sau, pentru mai multe deodată, din Editare în masă → Editare categorie și caracteristici. Categoria este preluată la crearea ofertei și nu mai este actualizată după aceea, așa că modificarea ulterioară a categoriilor produsului nu schimbă ce scrie în feed.

Comenzi

Comenzile noi de pe Okazii sunt preluate aproximativ o dată pe minut, cu o trecere de recuperare mai largă de câteva ori pe zi. Dacă ai nevoie să mergi mai în urmă, pagina conexiunii are Opțiuni → Sincronizează comenzile, care acceptă un interval de până la 30 de zile.

Ce Direcție Cum
Produse, prețuri, stocuri easySales → Okazii Feedul XML, pe care Okazii îl descarcă.
Comenzi Okazii → easySales API-ul Okazii, cu Tokenul API al tău.
Factura PDF easySales → Okazii Trimisă automat imediat ce factura este creată.
Numărul AWB easySales → Okazii Trimis când generezi eticheta de transport. Generarea ei marchează comanda și ca finalizată în easySales.
Statusul comenzii nimic Statusurile nu sunt trimise niciodată înapoi.
Anunțurile existente pe Okazii nimic Nu sunt importate niciodată în easySales.
Ce circulă între easySales și Okazii

Când comenzile nu mai ajung

Dacă nu există niciun mesaj de eroare și pur și simplu comenzile nu vin, verifică mai întâi Token API de pe conexiune. O conexiune salvată înainte ca tokenul să devină obligatoriu arată perfect normal — apare ca fiind conectată, feedul funcționează în continuare — dar nu se preia nicio comandă și nimic nu te avertizează.

Apoi parcurge lista de mai jos pentru un produs care nu este pe Okazii:

  • Oferta are statusul Activat?
  • Apare ca Linked, adică legată de un produs?
  • Produsul acela are stoc peste zero?
  • Oferta afișează vreo eroare?
  • URL-ul feedului din Okazii este cel actual?

Întrebări frecvente

Nu direct. easySales construiește un fișier feed XML și îl publică la URL Feed-ul tău; Okazii descarcă acel fișier și importă ce găsește în el. Nimic din ofertele tale nu este trimis către Okazii printr-un API, motiv pentru care URL-ul feedului trebuie configurat corect în partea de Okazii înainte să apară ceva.

Configurare → Integrări → Marketplace, apoi deschide conexiunea Okazii. URL Feed apare în coloana din stânga, deasupra rândului Opțiuni. Dacă ai conectat mai multe conturi Okazii, fiecare conexiune are propria adresă.

Un produs intră în feed doar dacă oferta lui are statusul Activat, este legată de un produs, produsul acela are stoc peste zero, iar oferta nu are nicio eroare blocantă. Ofertele fără stoc, dezactivate, nelegate și respinse sunt lăsate complet în afara fișierului — de obicei acesta este motivul pentru care numărul importat de Okazii este mult mai mic decât numărul de oferte pe care le vezi.

easySales scoate produsul din feed în loc să trimită cantitatea zero. Okazii retrage anunțul doar dacă importul lui automat este setat să elimine produsele care nu mai apar în feed — opțiunea „Elimină din okazii produsele care nu apar în feed”. Dacă aceasta nu este bifată, anunțul rămâne activ cu stocul vechi.

easySales reconstruiește fișierul feed cel mult o dată pe oră și, în mod normal, doar după ce Okazii a citit versiunea anterioară, așa că o ofertă nou adăugată are de obicei nevoie ca Okazii să descarce fișierul de două ori. Lasă câteva ore, nu te aștepta să apară imediat.

De Tokenul API din contul tău Okazii, salvat pe conexiune. Fără el nu se importă nicio comandă și nu apare nicio eroare care să îți spună asta — conexiunea arată tot ca fiind conectată, iar feedul funcționează în continuare. Cu el, comenzile sunt verificate aproximativ o dată pe minut.

Nu. Dacă marchezi o comandă drept finalizată, încheiată sau anulată în easySales, pe Okazii nu se schimbă nimic. Două lucruri circulă înapoi: factura PDF, imediat ce este generată, și numărul AWB împreună cu curierul, imediat ce generezi eticheta de transport.

Cargus, FanCourier, DPD, GLS, SameDay și Prioripost. Cu orice alt curier, eticheta este generată în continuare în easySales, dar Okazii respinge numărul de urmărire și trebuie să îl introduci tu în panoul Okazii.

Rezolvă cauza — cel mai des Tokenul API — și apoi apasă Restaureaza conexiunea pe cardul Okazii. Salvarea formularului de conexiune, în sine, nu repornește importul de comenzi. Reține că în această stare se opresc doar comenzile; feedul este servit în continuare, deci ofertele tale rămân active pe Okazii cât timp nu vine nicio comandă.

Nu. Ofertele Okazii provin întotdeauna din produsele tale din easySales; nimic nu este citit înapoi din anunțurile pe care le aveai deja.

Cu numele primei categorii în care se află produsul, ca text simplu. easySales nu deține arborele de categorii al Okazii — potrivirea dintre numele categoriilor tale și categoriile Okazii se face în Okazii, la Administrare Articole → Administrare Catalog. Poți schimba textul pe care îl trimite easySales editând oferta sau folosind Editare în masă → Editare categorie și caracteristici. Categoria este preluată la crearea ofertei și nu mai este actualizată niciodată după aceea.

Da. Folosește Adaugă cont din meniul ⋮ al cardului. Fiecare conexiune are numele ei, setările ei și propriul URL Feed, așa că lipești o adresă diferită în fiecare cont Okazii.

A fost util acest ghid?