Instrucțiuni pentru configurarea integrării cu Rozetka

Pe marketplace se pot înregistra ca vânzători persoane fizice autorizate din grupele II–III, persoane juridice sau persoane fizice; pentru persoanele fizice autorizate și persoanele juridice este necesară o adeverință bancară privind contul IBAN, iar pentru o persoană fizică — pașaportul, codul fiscal și datele bancare.

4. Cum să înregistrați un magazin pe Rozetka

Pentru completarea și trimiterea cererii în format electronic, trebuie să accesați secțiunea „Vinde pe Rozetka” și să apăsați butonul „Completați cererea”.

Dacă utilizați programul Torgsoft, atunci la completarea cererii, în câmpul „Sunteți gata să creați/furnizați export XML în format YML” puteți selecta „DA”.

Câmpul „Link către lista de prețuri” lăsați-l gol. Linkul către lista de prețuri sub forma unui fișier XML va fi creat în Torgsoft  mai târziu.

4.1. De ce la început puteți să nu indicați linkul către fișierul XML

După examinarea cererii, managerii Rozetka vă vor contacta pentru clarificarea detaliilor. La etapa de coordonare a condițiilor contractului, trebuie să informați managerul Rozetka că planificați să utilizați API pentru generarea unui fișier XML care corespunde cerințelor Rozetka.

Torgsoft generează un feed XML în formatul utilizat pentru transmiterea produselor către ROZETKA. API-ul poate fi utilizat pentru scenarii separate de integrare, inclusiv pentru lucrul cu comenzile și alte date, dacă acest lucru este acceptat de versiunea curentă a integrării.

Pentru lucrul cu API-ul „Rozetka” sunt necesare loginul și parola pentru accesul în contul de vânzător. Loginul și parola sunt oferite de managerii serviciului în momentul semnării contractului de colaborare, după efectuarea procedurilor pregătitoare. Decizia privind colaborarea este luată de „Rozetka” individual pentru fiecare client.

4.2. Solicitarea accesului la contul de vânzător pe Rozetka

Solicitați managerului loginul și parola pentru contul de vânzător, pentru a crea lista de prețuri folosind API-ul și pentru a transmite managerului Rozetka linkul către fișierul dumneavoastră XML pentru moderare și semnarea cu succes a contractului.

4.3. De ce este important să obțineți acces la contul de vânzător pe Rozetka

Programul Torgsoft pentru marketplace vă ajută să pregătiți fișierul XML (lista de prețuri) în formatul corect conform cerințelor pentru fișierul XML ale Rozetka.

Cu ajutorul modului Torgsoft „Asistent de configurare marketplace Rozetka” veți crea fișierul XML necesar. Pentru acest mod sunt necesare datele personale din contul de vânzător Rozetka, pentru a prelua prin API datele necesare:

Astfel veți economisi mult timp, dacă acești parametri vor fi preluați automat în Torgsoft. Nu va trebui să îi căutați manual în serviciu, să introduceți manual categoriile, caracteristicile pentru fiecare produs și producătorii.

Pentru magazinul dumneavoastră, managerul Rozetka poate stabili cerințe privind numărul de poziții unice de produse din lista de prețuri care trebuie transmisă pentru moderare. Cerințele privind numărul de poziții unice sunt individuale pentru fiecare potențial vânzător al serviciului Rozetka și depind de specificul magazinului și de sortimentul produselor. Iar pentru cei pentru care numărul stabilit de produse unice este prea mare, sunt necesare datele din contul de vânzător pentru pregătirea fișierului XML, deoarece numărul de produse unice din lista de prețuri pentru moderare poate fi egal cu numărul tuturor produselor care vor trebui publicate inițial pe Rozetka.

Dacă ați obținut acces la contul de vânzător, atunci lista caracteristicilor disponibile poate fi obținută în secțiunea  „Gestionarea produselor” sau prin încărcare cu ajutorul modului „Asistent de configurare marketplace Rozetka” în Torgsoft.

Dacă nu există acces la contul de vânzător, caracteristicile vor trebui căutate printre produse similare pe site-ul Rozetka.

5. Cum să pregătiți lista de prețuri pentru Rozetka

Cum să pregătiți linkul către lista de prețuri (fișier XML):

5.1. Configurarea obiectului de sincronizare în Torgsoft

Configurarea obiectului de sincronizare este prima setare cu parametrii necesari pentru conectarea cu succes la Rozetka.

După activarea funcției suplimentare „Integrare cu Rozetka”, trebuie să:

Fila „General”

În formularul „Obiect de sincronizare” există fila „General” cu câmpuri care trebuie completate parțial:

Pe fila „Centre de evidență”, bifați centrele de evidență din care produsele vor fi sincronizate cu Rozetka. Câmpurile suplimentare ale filei „Centre de evidență”:

Pe fila „Ora sincronizării” indicați ora sincronizării automate dintre programul Torgsoft și Rozetka.

Pentru a crea o sarcină nouă de sincronizare automată, apăsați „Adăugați”. În fereastra „Ora sincronizării”, selectați mai întâi parametrul - executorul sincronizării automate - serverul de aplicații sau programul Torgsoft. Serverul de aplicații este o componentă suplimentară a programului Torgsoft, responsabilă de executarea sarcinilor automate.

De asemenea, pe fila „Ora sincronizării” puteți seta perioada de sincronizare. La apăsarea butonului „Creați interval de sincronizare” va apărea o fereastră în care trebuie, de asemenea, să completați câmpurile „Ora de început”, „Interval” și „Ora de sfârșit” și să apăsați „Salvați”.

După configurarea modului „Asistent de configurare marketplace Rozetka”, pe fila „Fișiere de sincronizare” vor fi afișate caracteristicile dinamice create automat caracteristici dinamice. Aceste valori în Torgsoft sunt atribuite câmpurilor Rozetka conform cerințelor pentru fișierul XML. Caracteristicile dinamice și valorile lor vor completa fișierul XML (lista de prețuri) - TSGoods.xml, care este creat automat de programul Torgsoft.

În mod implicit, acest formular conține 6 câmpuri, care vor fi completate cu parametri noi pe măsură ce sunt completate caracteristicile produselor. Dacă ați șters accidental una sau mai multe înregistrări implicite, folosiți butonul „Adăugați toate câmpurile în fișierul de sincronizare”.

Puteți sincroniza cu Rozetka orice câmp disponibil din fișa produsului sau orice caracteristică dinamică. Este important să efectuați aceste acțiuni în modul „Asistent de configurare marketplace Rozetka”. Pentru adăugarea manuală a unui câmp nou de sincronizare, apăsați „Adăugați”. În fereastra „Câmpul fișierului de sincronizare a produselor” selectați „Tip de date” și indicați valoarea câmpului „Denumirea coloanei”.

În cazul selectării în câmpul „Tip de date” a valorii „Caracteristică dinamică” pe lângă câmpul „Denumirea coloanei” selectați denumirea acestei caracteristici în câmpul „Caracteristica dinamică a produsului”.

5.2. Crearea listei de prețuri pentru Rozetka în Torgsoft

„Asistentul de configurare marketplace Rozetka” vă ajută să pregătiți, să completați și să creați fișierul XML. Deși, conform informațiilor din secțiunea Pregătirea listei de prețuri a produselor serviciul Rozetka nu colaborează cu resurse terțe care oferă servicii de pregătire a listei de prețuri, Torgsoft va pregăti și va crea lista de prețuri conform cerințelor pentru fișierul XML.

Pe lângă cerințele privind structura fișierului XML, care sunt respectate în Torgsoft, produsele din lista de prețuri trebuie, de asemenea, să corespundă cerințelor de completare a fișelor de produs:

Toți parametrii produsului: denumirea, descrierea, producătorul, prețul, disponibilitatea, caracteristicile și fotografiile trebuie să corespundă strict criteriilor „Rozetka”. În caz contrar, fișierul XML nu va trece verificarea.

Chiar și după semnarea contractului cu „Rozetka”, aprobarea listei de prețuri și prima sincronizare cu marketplace-ul, fișa produsului trebuie să corespundă cerințelor „Rozetka”. În caz contrar, pozițiile „problematice” vor fi ascunse pe site. De aceea, respectați cerințele (cu excepția lucrului cu tagurile XML, deoarece acest lucru este luat în considerare în Torgsoft la crearea fișierului XML).

Înainte de a crea lista de prețuri cu ajutorul Torgsoft, determinați categoriile finale corecte pe Rozetka în care planificați să publicați produsele. Cum se face corect acest lucru este descris în centrul de ajutor al marketplace-ului Rozetka, în secțiunea Alegerea categoriilor corecte.

Completarea produselor și crearea fișierului XML (lista de prețuri) se efectuează în „Asistentul de configurare marketplace Rozetka” în Torgsoft. Pentru a lucra cu modul „Asistent de configurare marketplace Rozetka”, accesați meniul „Depozit” și selectați formularul „Sincronizare cu magazinul online”. Apăsați „Asistent de configurare marketplace Rozetka” (pictograma cu logo-ul „Rozetka”).

Să analizăm formularul „Asistent de configurare marketplace Rozetka” mai detaliat.

Salvați baza de date Rozetka - acțiunea este disponibilă dacă aveți acces la contul de vânzător Rozetka și dacă în setările obiectului de sincronizare sunt completate câmpurile „Nume de utilizator” și „Parolă”. Această acțiune salvează baza de date Rozetka în baza de date Torgsoft, și anume informații despre:

Procesul de încărcare a informațiilor din „Rozetka” în Torgsoft durează mult, de aceea încărcați baza de date doar după apariția unor modificări semnificative în Rozetka.

Recreați câmpurile fișierului de sincronizare - acțiunea recreează câmpurile necesare pentru încărcarea pe Rozetka conform caracteristicilor de categorie completate. Este relevantă în cazul în care, în setările obiectului de sincronizare, pe fila „Fișiere de sincronizare”, a fost șters manual un câmp care se creează automat la completarea caracteristicii categoriei de produse.

Efectuați analiza fișierului de sincronizare - acțiunea analizează lista de prețuri pentru completarea câmpurilor „Denumire”, „Producător”, „Categorie”, „Preț” și „Preț cu reducere”.

Modificați setările obiectului de sincronizare - acțiunea deschide formularul „Obiect de sincronizare” pentru modificarea setărilor de sincronizare.

Fila Lucrul cu produse este destinată lucrului cu tipurile de produse; completării categoriei, denumirii, producătorului, descrierii și caracteristicilor produselor exportate.

Fila Analiza fișierului de sincronizare afișează erorile după analiza listei de prețuri, care trebuie corectate.

5.3. Cum să descrieți produsele pentru Rozetka

Pasul 1. Fotografiile produsului

Existența fotografiilor produselor este prima și obligatorie condiție pentru a începe completarea informațiilor despre produs pentru încărcarea pe marketplace-ul Rozetka. Conform cerințelor pentru fotografiile produsului, fișa produsului trebuie să conțină cel puțin o fotografie, maximum 15.

Pasul 2. Configurarea tipurilor de produse

Pasul 3. Selectarea și configurarea grupei de produse

În setările obiectului de sincronizare, selectați grupa de produse, ale cărei produse trebuie încărcate. Dacă trebuie să încărcați absolut toate produsele din Torgsoft, nu selectați grupa de produse.

Pentru crearea grupei de produse pentru Rozetka, utilizați doar următoarele file:

Nuanță: filele „Producător”, „Sezon”, „Furnizor” și „Plus produse (servicii)” pentru includerea produselor care nu aparțin tipului de produs selectat nu vor influența în niciun fel grupa de produse pentru marketplace-ul Rozetka.

În exemplul nostru, în grupa de produse pe care o exportăm în marketplace, tipul de produs este „Echipamente comerciale”.

Pasul 4. Asocierea categoriilor cu Rozetka

Apoi, fiecare tip de produs trebuie asociat cu categoria finală de pe „Rozetka”. Acest lucru poate fi făcut în două moduri: „Asociați tipul de produs cu categoria de produs Rozetka” sau „Asociați tipul de produs și toate tipurile subordonate cu categoria de produs Rozetka”.

Dacă nu există acces la contul de vânzător Rozetka

După obținerea accesului la API și executarea acțiunii „Salvați baza de date Rozetka” în formularul principal al asistentului de configurare, categoriile create manual vor fi înlocuite automat cu categoriile „Rozetka”, dacă acestea există.

Dacă există acces la contul de vânzător Rozetka

Dacă există acces la API și acțiunea „Salvați baza de date Rozetka” a fost executată cu succes, în Torgsoft va apărea directorul categoriilor Rozetka. Va trebui doar să selectați categoria finală „Rozetka” în care produsul va fi publicat.

După asocierea fiecărei categorii Rozetka cu fiecare tip de produs în Torgsoft, vom obține următorul rezultat:

Dacă ați greșit și ați asociat o categorie incorectă, utilizați una dintre cele două acțiuni: „Deconectarea tipului de produs de la categoria de produs Rozetka” sau „Deconectarea tipului de produs și a tuturor tipurilor de produse subordonate de la categoria de produs Rozetka”. După aceea, asociați categoria corectă.

Pasul 5. Selectarea în masă a producătorului produsului

Produselor unui anumit tip de produs și subtipurilor acestuia li se poate atribui în masă un producător comun cu ajutorul acțiunilor „Setați producătorul pentru toate produsele tipului de produs” sau „Setați producătorul pentru toate produsele tipului de produs, inclusiv tipurile subordonate”.

Dacă există acces la API și acțiunea „Salvați baza de date Rozetka” a fost executată cu succes, câmpul Producător poate fi completat în masă cu un producător existent din „Rozetka”.

Pasul 6. Completarea informațiilor despre produse pentru Rozetka

După asocierea fiecărui tip de produs cu o categorie pe Rozetka, trecem la completarea datelor despre produs în formularul „Produse care participă la sincronizare”.

Câmpurile din formularul „Produse care participă la sincronizare”:

În formularul „Produse care participă la sincronizare” veți putea, de asemenea:

Pasul 7. Completarea caracteristicilor suplimentare ale produsului pentru marketplace

Zona de lucru a asistentului de configurare este „Parametrii categoriei”.
Acest formular este destinat completării proprietăților și caracteristicilor distinctive ale produsului pentru export.

Dacă există acces la API după asocierea tipului de produs cu categoria Rozetka, tabelul „Parametrii categoriei” se va completa automat cu toate caracteristicile disponibile ale categoriei „Rozetka”. Completarea automată este posibilă doar dacă în formularul „Produse care participă la sincronizare” vor exista produse.

Exemplu incomplet al listei de caracteristici pentru categoria „Imprimante de etichete” pe Rozetka, care au fost preluate automat în programul Torgsoft prin API:

La trecerea cursorului mouse-ului peste „semnul întrebării” din partea dreaptă, va apărea o sugestie despre cum trebuie completat parametrul de categorie necesar.

Fără acces la API, tabelul „Parametrii categoriei” va fi gol, iar toate denumirile caracteristicilor vor trebui completate manual, după ce parametrii sunt găsiți în prealabil în unul sau mai multe produse de pe „Rozetka” din categoria corespunzătoare.

Pasul 8. Lucrul cu caracteristicile de bază ale produsului pentru „Rozetka”

În Rozetka există caracteristici de bază care participă la filtrul de căutare a produselor. Dacă nu completați caracteristicile de bază ale produsului, utilizatorul nu va găsi produsul dumneavoastră pe „Rozetka” atunci când caută cu ajutorul filtrelor marketplace-ului. Numărul minim de caracteristici pentru un produs este 3. Caracteristicile trebuie să corespundă fotografiei, descrierii și denumirii, iar parametrii logistici este recomandat să fie completați pentru calcularea corectă a livrării.

Dacă există acces la API caracteristicile de bază din tabelul „Parametrii categoriei” sunt evidențiate cu roșu.

Fără acces la API caracteristicile principale vor trebui găsite independent pe marketplace, create manual în formularul „Parametrii categoriei” și completate cu valori.

Pentru crearea parametrului unei caracteristici de bază fără acces la API în formularul „Parametrii categoriei” trebuie să efectuați una dintre cele două acțiuni:

Denumirea parametrului categoriei trebuie să fie identică cu denumirea caracteristicii existente pe Rozetka. Caracteristicile create de dumneavoastră în Torgsoft vor fi asociate cu cele existente pe „Rozetka”. Dacă o caracteristică a produsului nu există pe „Rozetka”, aceasta trebuie adăugată în descrierea text a produsului. Nu puteți crea propria caracteristică unică pe „Rozetka” dacă aceasta nu este prevăzută de serviciu.

Pasul 9. Completarea acelorași caracteristici pentru toate produsele din categorie

Caracteristicile produselor se pot repeta. Dacă trebuie să completați aceeași valoare a caracteristicii pentru toate produsele din categorie, atunci atât cu acces la API, cât și fără acces la API, utilizați următoarele acțiuni din zona „Parametrii categoriei”.

Pasul 10. Descrierea produsului

Zona de lucru a asistentului de configurare este „Descrierea produsului”.
După completarea caracteristicilor, singurul lucru care rămâne de completat pentru fiecare produs este descrierea acestuia conform cerințelor pentru descrierea produsului. În zona „Descrierea produsului” sunt disponibile componente standard pentru editarea textului HTML.

Pasul 11. Analiza fișierului de sincronizare

După ce ați completat toți parametrii, câmpurile și informațiile necesare despre produs în Torgsoft pentru Rozetka, trebuie să „Efectuați analiza fișierului de sincronizare”.

Programul Torgsoft va deschide fila „Analiza fișierului de sincronizare”, va analiza lista de prețuri și va anunța dacă:

Dacă există observații, acestea trebuie corectate obligatoriu, pentru ca fișierul XML să treacă ulterior moderarea pe marketplace. Din formularul „Analiza fișierului de sincronizare” puteți imediat „trece la produsul” cu observație și corecta erorile.

Dacă în „Asistentul de configurare marketplace Rozetka” sunt completate toate informațiile și „Analiza fișierului de sincronizare” nu conține nicio eroare, trecem la încărcarea fișierului XML (listei de prețuri) pe serverul FTP, crearea linkului public și transmiterea linkului către lista de prețuri managerului Rozetka pentru moderarea fișierului.

5.4. Crearea linkului către lista de prețuri pentru Rozetka

Pentru a transmite linkul către fișierul XML, acesta trebuie încărcat pe serverul FTP indicat în setările obiectului de sincronizare. Pe serverul FTP vor fi încărcate fotografiile tuturor produselor incluse în lista de prețuri.
Mai întâi exportați datele manual în formularul „Sincronizare cu magazinul online” din Torgsoft. Este recomandat să rulați sincronizarea automată doar după ce linkul către fișierul XML a fost transmis managerului și lista de prețuri a trecut cu succes moderarea pe „Rozetka”.

Pentru a efectua sincronizarea manuală, accesați în Torgsoft formularul „Sincronizare cu magazinul online” și apăsați „Marcați toate fotografiile”. Această acțiune va marca toate fotografiile produselor pentru export împreună cu lista de prețuri. După aceea, apăsați „Efectuați sincronizarea”.

Acțiunea „Efectuați sincronizarea” exportă toate fotografiile produselor și lista de prețuri pe serverul FTP indicat. Rețineți că pe fila „Produse de sincronizare”, lista produselor poate fi diferită de cea care va fi exportată pe Rozetka. Acest lucru poate fi legat de faptul că în asistentul de configurare sunt disponibile doar produse cu fotografie și lipsesc produsele adăugate în grupa de produse prin fila „Plus produse și servicii”.
Fila „Jurnal de sincronizare” va afișa date despre sincronizarea reușită.

După exportul reușit al datelor, verificați accesul la fișierul XML prin link. Pentru aceasta, în browser, la linkul https: //siteulmeu.ua/catalog/rozetka/TSGoods.xml trebuie să se afișeze informațiile cu produsele din fișierul XML.

Înainte de a transmite managerului linkul către lista de prețuri pentru moderare, efectuați validarea fișierului XML cu ajutorul instrumentului special al marketplace-ului Rozetka. După primirea informației despre verificarea reușită, sunați managerul Rozetka și furnizați linkul către lista dumneavoastră de prețuri.

6. Adăugarea și vânzarea produselor pe Rozetka

După semnarea contractului cu „Rozetka”, poate fi necesară adăugarea de produse noi sau actualizarea parametrilor produselor existente pe Rozetka. Faceți toate acestea cu ajutorul modului „Asistent de configurare marketplace Rozetka”.

Consultați cerințele pentru adăugarea produselor noi și cerințele pentru actualizarea produselor existente înainte de a adăuga sau actualiza produsele în lista de prețuri.

Am analizat cerințele și putem evidenția următoarele:

Torgsoft actualizează automat fișierul listei de prețuri TSGoods.xml cu informații despre prețuri și disponibilitatea produselor pe serverul FTP. Pentru aceasta, nu uitați să configurați „Ora sincronizării” în Torgsoft în obiectul de sincronizare. Sincronizarea manuală este necesară doar la primul export al listei de prețuri și la modificarea conținutului acesteia: adăugarea și actualizarea produselor.

Rozetka este, într-un fel sau altul, responsabilă pentru conformitatea vânzătorilor și a produselor acestora pe propriul site. De aceea, înainte de începerea colaborării, consultați cerințele Rozetka privind lucrul cu comenzile și livrarea produselor:

Este recomandat ca lucrul cu comenzile și clienții să fie gestionat fie doar în Torgsoft, fie doar pe marketplace-ul Rozetka, pentru a menține disponibilitatea actuală a produselor în program și, respectiv, pe „Rozetka”. Pentru lucrul cu comenzile de pe Rozetka în Torgsoft, utilizați modul „Comerț cu emiterea facturii”.

Funcția suplimentară „Integrare cu Nova Poshta” și „Integrare cu Ukrposhta”. va ajuta la automatizarea lucrului cu serviciile de livrare. În Torgsoft, în modul „Comerț cu emiterea facturii”, creați și tipăriți documente de transport pentru facturile emise, urmăriți statusul coletului și trimiteți clientului numărul documentului de transport cu ajutorul funcției „Mesaje în masă către clienți”.

7. Limitări și cerințe pentru lucrul cu funcția suplimentară „Integrare cu Rozetka.ua”

Limitările includ următoarele aspecte:

Cerințele din partea Torgsoft includ doar prezența SQL Server 2008 sau mai nou, pe care va funcționa baza de date Torgsoft, cu nivelul de compatibilitate setat în proprietățile bazei de date din SQL Server la 100 sau mai mare.