Marketplace-uri

Cum conectezi Infinity cu easySales: ghid complet de configurare

Cum conectezi Infinity cu easySales: ghid complet de configurare

Conectează marketplace-ul Infinity la easySales: cheia de aplicație VTEX, de ce ID-ul de referință decide dacă ofertele pot fi create, maparea categoriilor, legarea ofertelor existente și ce înseamnă fiecare eroare.

Ce îți aduce conectarea Infinity

Cu Infinity conectat, easySales trimite produsele pe marketplace, ține prețurile și stocurile la zi, importă comenzile și le facturează prin programul tău de facturare — din aceleași ecrane pe care le folosești pentru orice alt canal.

Înainte să începi

Un cont de vânzător Infinity

Infinity funcționează pe VTEX, iar integrarea vorbește cu propriul tău cont Infinity — trebuie să vinzi deja acolo sau să fii aprobat.

O cheie de aplicație cu roluri

Generată în contul tău Infinity: o cheie și un token. O cheie fără roluri se autentifică drept nimeni și fiecare apel eșuează.

Numele contului

Prima parte din adresa administrării Infinity — easysales429 în easysales429.myvtex.com.

Categorii mapate, înainte de a trimite oferte

O ofertă fără categorie Infinity nu poate fi creată. Categoria și maparea categoriei sunt cele mai mari două motive pentru care ofertele stau pe loc, mai mari decât toate celelalte la un loc.

Pasul 1 — Creează o cheie de aplicație în Infinity

Infinity funcționează pe VTEX, așa că datele de acces sunt o cheie de aplicație VTEX: o cheie și un token generate în propriul tău cont Infinity, nu un nume de utilizator și o parolă.

În administrarea Infinity, deschide setările contului și caută Chei aplicație. Creează o cheie pentru easySales, dă-i rolurile de care are nevoie ca să citească și să scrie produse și comenzi, apoi generează cheia. Rămâi cu două valori — o Cheie a aplicației și un Token aplicație — și îți trebuie amândouă.

Îți mai trebuie și numele de cont: prima parte din adresa administrării Infinity. În https://easysales429.myvtex.com numele de cont este easysales429.

Pasul 2 — Conectează în easySales

Mergi la Integrări → Marketplace și caută infinity.

Pagina Marketplace din easySales filtrată după Infinity, cu cardul Infinity și starea de conectat.
Cardul Infinity din Integrări → Marketplace.

Apasă Conectare pe cardul Infinity. Formularul are două taburi, Setări principale și Setări adiționale.

Formularul de conexiune Infinity din easySales cu Nume Conexiune, status personalizat pentru comenzi noi, Adaos Preț, Cota de TVA pentru transport, Seria de facturare, Plătitor de taxe și Trimite ca ID-ul de referință.
Setări principale. Trimite ca ID-ul de referință este câmpul la care să te gândești înainte de salvare.
Câmp La ce folosește
Nume Conexiune Numele tău pentru această conexiune. Nu ajunge niciodată la Infinity.
Statusul personalizat pentru comenzi noi Opțional. Aduce comenzile importate de pe Infinity pe un status definit de tine, în locul celui implicit.
Adaos Preț Un procent adăugat la prețul produsului înainte de trimitere. 10% la un produs de 100 RON trimite 110 RON.
Cota de TVA pentru transport Cota de TVA aplicată liniei de transport pe comenzile Infinity.
Seria de facturare Seria pe care se emit facturile pentru comenzile Infinity.
Plătitor de taxe Da dacă firma ta este plătitoare de TVA, Nu altfel. Alegerea stabilește cota trimisă cu ofertele.
Trimite ca ID-ul de referință ID intern sau SKU — ce stochează Infinity ca referință pentru fiecare ofertă. Vezi pasul de mai jos înainte să alegi.
Nume de cont Prima parte din adresa administrării Infinity: în easysales429.myvtex.com este easysales429.
Cheia aplicației și Token aplicație Cheia de aplicație generată în contul tău Infinity. Ambele sunt obligatorii.
Conexiunea, câmp cu câmp
Partea de date de acces a formularului Infinity: Nume de cont, Cheia aplicației și Token aplicație.
Cele trei valori din contul tău Infinity: numele de cont din adresa administrării și perechea cheie–token.

Pasul 3 — Stabilește ID-ul de referință înainte să trimiți ceva

Trimite ca ID-ul de referință este câmpul pe care documentația veche nu îl menționa deloc și cel care decide dacă ofertele tale pot fi create.

Pasul 4 — Setări adiționale

Tabul Setări adiționale al conexiunii Infinity, cu trimiterea prețurilor, trimiterea stocului și activarea automată a ofertelor când produsele au stoc.
Setările adiționale decid ce continuă easySales să trimită după ce oferta există.
Setare Ce face
Trimite prețurile pe marketplace Trimite modificările de preț din easySales către Infinity. Dezactiveaz-o dacă prețurile sunt gestionate în Infinity.
Trimite stocul ofertei către marketplace Trimite modificările de stoc din easySales către Infinity.
Activează ofertele automat când produsele sunt pe stoc Reactivează singură o ofertă când produsul ei trece de la stoc zero la stoc pozitiv. Este dezactivată implicit și merită activată dacă rămâi des fără stoc și reaprovizionezi.
Setări adiționale

Pasul 5 — Mapează categoriile înainte să trimiți oferte

O ofertă pleacă din easySales doar după ce are o categorie Infinity. Problemele de categorie sunt de departe cea mai mare cauză a ofertelor blocate: un produs fără categorie Infinity sau unul a cărui categorie nu a fost mapată niciodată.

Deschide Marketplace → Categorii, alege Infinity și mapează categoriile în care se află produsele tale cu cele ale Infinity. Apoi verifică greutatea, următoarea cauză ca frecvență după acestea două.

Pasul 6 — Ofertele pe care le ai deja pe Infinity

Dacă vindeai deja pe Infinity înainte de conectare, acele oferte sunt importate în Marketplace → Oferte, în tabul Infinity, și ajung nelegate. Legarea unei oferte de produsul din easySales este ceea ce permite actualizărilor de preț și stoc să circule.

Lista de oferte din easySales, tabul Infinity, cu ofertele, produsele legate, prețurile, stocul, starea Activat sau Dezactivat și coloana Erori.
Tabul Infinity din lista de oferte. Fiecare ofertă arată produsul de care este legată și ce o blochează.

Pasul 7 — Trimiterea produselor noi

Din Produse, filtrează după Fară oferte pe → Infinity, ca să vezi doar produsele care nu sunt încă pe marketplace, apoi folosește Adaugă ofertă pe cele pe care vrei să le trimiți.

Pagina Produse din easySales cu filtrul Fară oferte pe deschis, listând marketplace-urile, printre care Infinity Demo Store.
Filtrează după Fară oferte pe → Infinity înainte să trimiți produse, ca să nu trimiți același produs de două ori.

Comenzi și facturi

Comenzile noi de pe Infinity sunt importate în Comenzi ca la orice alt canal. Două setări din conexiune decid ce se întâmplă cu ele: Seria de facturare stabilește seria pe care se emit facturile, iar Statusul personalizat pentru comenzi noi le poate aduce pe un status definit de tine în loc de cel implicit.

Când conexiunea nu mai funcționează

Ce vezi Ce ai de făcut
Categorie lipsă / Mapare de categorie lipsă Produsul nu are categorie Infinity sau categoria în care se află nu a fost mapată. Mapeaz-o în Marketplace → Categorii. Împreună, acestea sunt motivul majorității ofertelor blocate.
Greutate invalidă Infinity nu acceptă greutatea produsului. Corecteaz-o pe produs.
Titlu prea lung (maxim 120 de caractere) Scurtează numele produsului sau numele trimis pe acest marketplace.
Descrierea nu poate fi goală Adaugă o descriere produsului.
Brand lipsă Produsul nu are brand, iar Infinity cere unul.
Caracteristici obligatorii lipsă Categoria Infinity cere caracteristici pe care produsul nu le are. Completează-le din ecranul de editare al ofertei.
Produs respins de marketplace Infinity a refuzat oferta. Detaliul apare pe ofertă; de obicei este o regulă de catalog de partea lor.
A product with external id "…" already exists. Oferta este deja pe Infinity. Leagă oferta importată de produsul tău în loc să trimiți una nouă.
Cannot authenticate request: failed to authenticate with provided credentials Cheia de aplicație nu mai funcționează — a fost ștearsă sau i s-au scos rolurile. Generează una nouă în Infinity și actualizează conexiunea.
Price Variation Not Allowed: BasePrice Variation: Price exceeds allowed limits Infinity limitează cât de mult poate sări un preț dintr-o dată. Modifică-l în trepte mai mici sau ridică limita de partea lor.
Ce înseamnă cele mai frecvente erori Infinity

Întrebări frecvente

Produsul este deja pe Infinity cu acea referință, aproape întotdeauna pentru că vindeai acolo înainte de a conecta easySales. Nu reîncerca — mergi la Marketplace → Oferte, deschide tabul Infinity, găsește oferta importată și leag-o de produsul tău. De atunci, actualizările de preț și stoc merg către oferta care există deja. Este cea mai frecventă eroare Infinity.

SKU-ul este alegerea obișnuită, pentru că se potrivește cu ce se folosește deja pe Infinity. Mai important este să alegi înainte să plece primele oferte: dacă schimbi ulterior, easySales rescrie referința pentru toate ofertele deja existente pe conexiune.

Verifică întâi cheia de aplicație în Infinity. O cheie ștearsă sau căreia i s-au scos rolurile face ca fiecare apel să eșueze cu o eroare de autentificare, în timp ce ofertele pur și simplu nu se mai schimbă. Apoi uită-te la cardul Infinity din easySales: dacă a fost dezactivată conexiunea după eșecuri repetate, apare bannerul de eroare cu butonul Restaureaza conexiunea.

Șterge marcajul de dezactivare, ca sincronizarea să reînceapă. Nu repară ce a cauzat eșecurile — dacă datele de acces sau informațiile sunt încă greșite, conexiunea se va opri din nou singură. Rezolvă întâi cauza.

Cele trei cauze mari sunt aproape mereu aceleași: fără categorie Infinity, fără mapare de categorie și greutate invalidă. Mapează categoriile din Marketplace → Categorii, apoi parcurge coloana Erori din lista de oferte — fiecare corecție se aplică la următoarea trimitere.

Prețul produsului este baza. Adaos Preț de pe conexiune adaugă un procent peste el pentru acest marketplace, iar prețul poate fi suprascris pe fiecare ofertă din lista de oferte. Dezactivarea trimiterii prețurilor oprește complet trimiterea lor din easySales.

Nu mai există în formular. Termenul de livrare pentru comenzile Infinity nu este ceva ce conexiunea păstrează astăzi.

Se întâmplă la conexiunile create înainte de schimbarea cotei de TVA din România: ele păstrează cota veche, pe care câmpul nu o mai oferă. Alege din nou Da sau Nu și salvează — câmpul este obligatoriu, deci nimic altceva nu se salvează până atunci.

Nu, dacă activezi Activează ofertele automat când produsele sunt pe stoc, din tabul Setări adiționale. Cu opțiunea dezactivată, o ofertă oprită cât timp produsul nu a avut stoc rămâne oprită până o activezi tu.

Cea setată la Seria de facturare pe conexiune. Trebuie să fie o serie pe care programul tău de facturare o cunoaște — dacă nu, factura eșuează când easySales încearcă să o emită, nu la importul comenzii.

A fost util acest ghid?