Importul de produse prin fișier XML este unul dintre cele mai rapide și mai ușoare moduri de a importa un catalog mare de produse în magazinul dvs. Adesea, importul XML poate fi necesar dacă lucrați cu un partener/distribuitor care vă oferă un catalog în structura XML. În acest articol veți găsi informații despre ce este o structură XML și cum s-o folosiţi pentru a activa aplicația pe care am dezvoltat-o pentru facilitarea gestionării catalogului de produse din magazinul dvs. online. 


În articol veţi găsi:


Ce este un fișier XML și o structură XML?

Ideea corecției datelor este utilă pentru înțelegerea XML. Oamenii au creat, de-a lungul secolelor, diverse documente și tot aşa, secole la rând, au adăugat caractere documentelor respective. Editarea  documentului este modul în care determinăm structura, semnificația și aspectul informațiilor din document. În lumea calculatoarelor, „edicarea” a evoluat spre „marcare” ("markup"). Marcarea este procesul de folosire a anumitor coduri numite etichete (sau uneori markere) pentru a defini structura, aspectul și - în cazul XML - semnificația datelor. Iată cum arată o parte a unui exemplu de fișier XML, deschis într-un browser și care conține informații despre sute de produse:
În imaginea de mai sus, vedeți tag-uri care conțin fiecare element din informații generale despre produs. Fiecare element al unui produs, cum ar fi codul de identificare, numele, categoria, descrierea, tag-uri, marca, prețul, greutatea, cantitatea, fotografia, varietatea și valoarea trebuie să fie împrejmuit de un tag de deschidere și închidere, astfel încât informațiile să poată fi citite corect și poate fi importat în magazinul dvs. prin intermediul aplicației de import XML. Numele tag-urilor, care conțin fiecare element al produsului, sunt determinate de creatorul fișierului XML.

Un fișier XML bine structurat corespunde unui set de reguli foarte stricte care guvernează XML. Dacă un fișier nu îndeplinește aceste reguli, XML nu mai funcționează. De exemplu, în eșantionul din codul de mai sus, fiecare tag de deschidere are un tag de închidere corespunzător, astfel încât eșantionul să îndeplinească una dintre regulile pentru formatarea corectă. Dacă eliminați un tag și încercați să deschideți acest fișier, veți vedea un mesaj de eroare și programul vă va împiedica să folosiţi fișierul.

Nu trebuie să cunoașteți regulile pentru crearea unui XML bine formatatat (deși sunt ușor de înțeles), dar trebuie să vă amintiți că puteți partaja date XML între programe și sisteme numai dacă datele sunt bine formatate. Dacă nu puteți deschide un fișier XML, este foarte probabil ca acest fișier să nu fie bine formatat.


 Aici puteți vedea structura unui exemplu de fișier XML bine formatat.


În ce cazuri sfolosiţi aplicația de import XML 

*când aveți informații furnizate online (într-o altă structură decât XML dar care poate fi convertită în XML) despre un număr mare de produse pe care doriți să le vindeți în magazinul dvs. online 
*când partenerul sau distribuitorul dvs. vă oferă într-un fișier XML informațiile despre produsele pe care doriți să le vindeți  

Dacă informațiile despre produsele pe care doriți să le încărcați în magazinul dvs. nu sunt strânse într-un singur loc și produsele nu sunt multe, nu este necesar să folosiţi această aplicație pentru importare. În acest caz, puteți încărca manual orice produs din magazinul dvs, ceea ce este, de asemenea, foarte ușor și rapid, din secțiunea Produse din panoul de control al magazinului dvs.

Primul pas în setările de sarcini, din aplicația XML 

Accesați panoul de control al magazinului dvs. și găsiți importul XML în secțiunea Aplicații. Faceţi clic și instalaţi această integrare.
După instalarea aplicației, apăsaţi butonul Începe sarcina și completați următoarele setări:

Numele sarcinii (Job name) – scrieți un nume pentru sarcina XML în conformitate cu criteriile și scopul pentru care o creați. Numele va apărea numai în panoul de control, în lista sarcinilor din aplicația de import
XML URL link – aici plasați adresa URL completă, la feeder-ul XML. Dacă aveți un fișier XML, încărcați-l mai întâi în secțiunea Setări > Fișiere din panoul de control pentru a obține un link de plasat în acest câmp
Importați toate produsele într-o categorie – folosiţi meniul derulant pentru a selecta o categorie de produse existentă în care vor fi importate toate produsele XML. Dacă fișierul XML conține informații despre categoriile de produse, nu este nevoie să folosiţi acest meniu derulant, trebuie doar să-l ignorați și să treceți la următoarele setări ale sarcinii Importați toate produsele cu marcăfolosiţi meniul derulant pentru a selecta o marcă existentă în care vor fi importate toate produsele XML. Dacă fișierul XML conține informații despre marca produsului, nu este necesar să folosiţi  acest meniu derulant, doar ignorați-l și treceți la următoarele setări din sarcină
Importați toate produsele ca – din meniul derulant, selectați dacă doriți să importați produsele direct vizibile în magazinul dvs. sau să le importați ca nepublicate. După finalizarea întregii sarcini și importarea produselor, puteți folosi instrumentele rapide din secțiunea Produse pentru a publica toate produsele simultan 
XML tag al produsului – introduceți aici tag-ul din structura XML, care conține toate celelalte tag-urile și informațiile despre fiecare produs. Tag-ul XML de produs în această structură de ex.:
este <product> – în acest caz, în primul pas din setările sarcinii, trebuie să introduceți "produsul" pentru tag-ul produsului.


Atașați la o sarcină principală – dacă aveți o sarcină XML de bază și cea pe care o creați acum trebuie să fie rulată peste prima, o puteți selecta pe cea principală din acest meniu derulant. De exemplu, dacă aveți un feed XML cu produse și un al doilea feed XML cu stocuri, atunci primul XML (cel cu produsele) va fi bazat pe XML-ul cu stocuri.
Linii(Rânrui, rows) – aici introduceți numărul maxim de rânduri din feedul XML în care sistemul poate verifica dacă există tag-ul produsului. Dacă structura unui feed este corectă, nu ar trebui să fie necesar să se schimbe numărul de linii și tag-ul produsului este cu siguranță conținut în primele 500 de linii.
Urmărirea cantității – prin această opțiune cantitatea tuturor produselor care vor fi importate va fi monitorizată de sistem. Când un articol este vândut, cantitatea rămasă va fi recalculată din cantitatea totală stabilită a produsului.
Continuă vânzarea – dacă activați această opțiune, sistemul va permite comandarea produsului, chiar dacă cantitatea produsului este 0 
ID-ul sarcinii – introduceți numărul sarcinii. Acesta va servi pentru a permite sistemului să diferențieze sau să consolideze activitățile pe care le-ați activat în aplicație. ID-ul sarciniii vă permite să creați mai multe sarcini de import pentru a lucra sincronizat. Pentru a putea lucra împreună și actualiza informațiile despre produse, ID-urile lor de sarcină trebuie să fie aceleași.
Adăugare pași – dacă feedul XML conține produse cu două prețuri (de bază și redus), aici trebuie să selectați o reducere fixă existentă în panoul de control, în care aceste produse pot fi importate pentru a afișa cele două prețuri în magazinul dvs. Dacă încă nu aveți o astfel de reducere în panoul de control și există produse cu două prețuri în feedul XML, vedeți cum să creați o reducere fixă aici .
După verificarea datelor introduse în primul pas, utilizați butonul Salvare și treceți la Pasul 2, unde veți specifica cum importați datele feedului XML în catalogul de produse din magazinul dvs.

Al doilea pas din setările sarcinii din aplicația XML 

Dacă tag-ul de produs introdus în pasul anterior este corect, platforma va putea citi acum conținutul feedului XML. Rămâne să setați ca ce element de produs să fie importat fiecare dintre tag-urile existente în feedul XML.

În primul rând și cel mai important, este să alegeți numărul de produs unic în feed-ul XML. Examinați fișierul pe care îl aveți și decideți care tag conține numere diferite pentru fiecare dintre produsele din feedul XML.


Toate câmpurile pe care le vedeți în stânga, sunt elementele care ar putea exista pentru un produs. Titlul produsului este numele acestuia. Dacă în fișierul XML pe care îl încărcați există un tag care conține numele fiecărui produs, trebuie să selectați din meniul derulant vizavi de Titlu care este tag-ul respectiv. De exemplu, în feedul XML cu această structură:

product еste tag-ul produsului, tag-ul id va fi folosit ca număr unic al produsului, product code poate fi introdus ca SKU al produsului, dar title este tag-ul care conține denumirera fiecărui produs din fișier. Astfel, primele câteva elemente ale pasului 2 al eșantionului nostru de sarcină vor arăta astfel:

Importul varietăților produselor 

Pentru a importa varietăți de produse, fișierul dvs. XML trebuie să conțină grupuri de varietăți de produse.

În cel mai general caz, puteți avea un grup de varietăți, cum ar fi Mărimea, și puteți avea nenumărate valori pentru aceasta. De ex. XS, S, M, L, XL, XXL, XXXL etc.


În exemplul de mai jos analizăm unul dintre cele mai frecvente cazuri - două varietăți - Mărime și Culoare 


IMPORTANT! Este posibil să aveți un număr de până la 3 varietăți 

Descriere detaliată a anatomiei fișierului XML 

Iată cum arată un al doilea pas în maparea varietăților acestui fișier XML:

În funcție de informațiile pe care le aveți în feed-ul XML și de informațiile pe care doriți să le importați în magazin, continuați să conectați cele două coloane alegând cu atenție ce tag-uri completați pentru produsele din catalogul dvs. Faceți clic pe Salvare și continuați cu pasul 3 pentru a finaliza setările sarcinii.

Al treilea pas în setările sarcinii din aplicația XML 

În acest pas, puteți crea operațiuni și reguli suplimentare pentru importul produselor din fișierul XML în catalogul magazinului dvs. De exemplu, dacă doriți ca conținutul unuia din tag-uri să fie modificat/completat sau modificat cu anumite valori, puteți ajusta toate aceste acțiuni și puteți modifica importul produselor după cum este necesar.


În exemplul de mai jos, la pasul 3 al sarcinii, se face o setare prin care, dacă tag-ul din fișierul care completează câmpul cantității produsului conține cuvintele „disponibilitate limitată”, acest conținut va fi înlocuit cu „1”. 

Această setare ar putea fi necesară dacă în feedul XML, tag-ul <qty> nu conține o cantitate reală, dar conține un statut în cuvinte precum „disponibilitate limitată”.


În exemplul următor, în al treilea pas al sarcinii, se face o setare, prin care informațiile din tagul din fișierul, care completează câmpul de preț al produsului vor fi înmulțite cu o anumită valoare.


Această setare ar putea fi necesară dacă în feedul XML aveți o valoare de preț, pe care doriți s-o încărcați în catalogul dvs. gata majorată. 

Setări suplimentare ale sarcinii XML 

Unele dintre elementele pe care le adăugați pentru fiecare dintre produsele dvs. pot fi modificate prin introducerea mai multor tag-uri pentru a le compune. De exemplu, dacă doriți ca numele produsului din magazinul dvs. să conțină informații din două tag-uri diferite de flux XML, puteți face acest lucru selectând în al doilea pas al sarcinii că doriți ca un Titlu să fie format din mai multe elemente și apoi adăugați fiecare dintre ele. Urmăriți scurtul videoclip de mai jos.O altă opțiune este să adăugați subcategorii pentru produsele dvs. dacă aveți astfel de tag-uri în feedul XML care conțin informații despre categorii, subcategorii sau subsubcategorii. De exemplu, dacă doriți să adăugați o astfel de structură pentru categoriile de produse, puteți selecta în al doilea pas al sarcinii butonul Adăugați încă și din noul meniu derulant puteți specifica tag-ul responsabil pentru subcategoria produselor. Urmăriți scurtul videoclip de mai jos.

Este important să rețineți că, dacă în primul pas ați specificat corect care este tag-ul produsului, atunci pe parcursul următorilor pași veţi folosi meniurile derulante în care sistemul va afișa cu succes informațiile din fișier și trebuie doar să specificați pentru ce este utilizat fiecare tag din feed-ul XML