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.
Completează formularul din dreapta.
| 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ă. |
Restul formularului controlează felul în care produsele tale sunt descrise în feed.
- 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ă.
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.
Pasul 3 — Îndreaptă Okazii către feed
Această jumătate se petrece în panoul Okazii, a cărui interfață este în limba română.
- Deschide Meniu → Administrează Magazin (sau Setări → Magazin → Administrare).
- Mergi la Administrează articole → Import Produse și alege Import Automat.
- Lipește URL-ul feedului tău în Adaugă URL-ul Feedului.
- Bifează Elimină din okazii produsele care nu apar în feed.
- 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. |
Le vezi pe toate patru dintr-o privire în Marketplace → Oferte → Okazii.
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ă. |
Î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. |
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?