Come creare un file XML per Rozetka.ua (socket)
Per pubblicare le merci su Rozetka.ua, è necessario preparare un listino prezzi con offerte in formato XML (YML). Mentre lo store è in esecuzione, l'indirizzo del collegamento XML deve essere statico e non cambiare.
Requisiti del file XML (YML).
- lo standard XML (YML) non consente l'utilizzo di caratteri non stampabili con codici ASCII da 0 a 31 (ad eccezione dei caratteri con codici 9, 10, 13 - tabulazione, avanzamento riga, ritorno a capo).
- i caratteri ", &, >, <, ' devono essere sostituiti con codici equivalenti. Il requisito si applica solo al testo e non pregiudica la scrittura dei tag;
- è vietato modificare l'ID di merci e categorie dopo l'aggiunta al sito web di ROZETKA.
Simbolo nel testo | Codice per file XML |
---|---|
" | |
& | |
> | |
< | |
' |
- L'indirizzo URL di un'offerta di prodotti sul sito Web del negozio deve essere codificato in conformità con lo standard RFC-1738.
- codifica file XML (YML) valida: UTF-8.
Esempio di file XML
Descrizione degli elementi
Elemento | Descrizione |
---|---|
catalogo_yml Elemento richiesto | L'elemento radice del formato YML. L'attributo date specifica la data e l'ora in cui l'XML (YML) è stato generato o modificato. La data deve essere nel formato AAAA-MM-GG hh:mm. |
negozio Elemento richiesto | Contiene una descrizione del negozio e delle sue offerte di prodotti. |
nome Elemento opzionale | Nome breve del negozio. Non pubblicato, utilizzato per l'identificazione interna. Il numero massimo di caratteri è ━ 255. |
azienda Elemento opzionale | Il nome completo dell'azienda proprietaria del negozio. Non pubblicato, utilizzato per l'identificazione interna. Il numero massimo di caratteri è ━ 255. |
url Elemento opzionale | URL della pagina principale di un negozio esistente. Il numero massimo di caratteri è ━ 255. |
piattaforma Elemento opzionale | Il sistema di gestione dei contenuti su cui opera il negozio (CMS). |
valute Elemento richiesto | Elenco dei tassi di cambio del negozio. Ciascuna delle valute è descritta da un elemento di valuta separato. Esempio: I prezzi sul sito sono visualizzati solo in UAH. Solo la grivna ha rate="1". YML utilizza un punto o una virgola per separare le parti intere e frazionarie di qualsiasi numero, indipendentemente dalle impostazioni locali. Il valore nell'attributo currency id=". . . " è specificato secondo lo standard ISO 4217 come codice valuta alfabetico di tre lettere (alfa-3). |
categorie Elemento richiesto | Elenco delle categorie di negozi. Ad ogni categoria è assegnato un numero univoco, la numerazione è a discrezione del negozio.
Esempio: Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Il numero massimo di caratteri è ━ 255. |
rz_id Elemento opzionale | Fornisce il collegamento automatico della categoria dal listino prezzi con la categoria ROZETKA. È indicato solo nell'elenco delle categorie, il tuo ID categoria è indicato nella scheda prodotto. Esempio: Джемы и начинки id="12345" ━ il tuo ID categoria; La priorità di rz_id è superiore a quella del nome della categoria. Ad esempio, se il nome della categoria nel file xml è "T-shirt" e l'id della categoria "Calze" sul sito web di ROZETKA è indicato nel tag rz_id, allora ci sarà automaticamente una connessione con " categoria Calzini". |
offerte Elemento richiesto | Elenco delle offerte del negozio. Si apre una volta, dopo il tag. Si chiude alla fine del documento, prima del tag Esempio: Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Si prega di notare che il tag non deve essere ripetuto all'interno del listino. |
offerta Elemento richiesto | Prodotto di carta. Chiuso con cartellino.
Per ogni tipologia di prodotto: colore, taglia, volume, configurazione, ecc. — deve essere creata un'offerta unica separata. Sul nostro sito web, i prodotti saranno raggruppati in 1 offerta con una scelta di colore, taglia, volume, ecc. Esempio: . . . |
stock_quantità (quantità_in_stock) Elemento richiesto | Il resto della merce. Il prodotto sarà in stock sul sito fintanto che questo parametro è maggiore di 0. Si ricorda che quando si utilizza il cartellino è obbligatorio indicarlo in tutti i prodotti a listino, altrimenti ai prodotti sprovvisti di tale cartellino verrà assegnato lo stato di “Esaurito”. Assicurati inoltre di seguire il valore nel tag available=". . . " se stock_quantity > 0 ━ true, se stock_quantity < 0 ━ false. Esempio: 10 |
URL (in offerta) Elemento opzionale | Link al prodotto sul tuo sito. Esempio: https://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx. html Il numero massimo di caratteri è ━ 500. |
prezzo Elemento richiesto | Il prezzo del prodotto. Specificare solo un numero intero, i copechi vengono arrotondati sul sito. Esempio: 4499 YML utilizza un punto o una virgola per separare le parti intere e frazionarie di qualsiasi numero. Il prezzo indicato con copechi verrà arrotondato sul sito. |
prezzo_vecchio (prezzo_vecchio) Elemento opzionale | Il vecchio prezzo della merce sarà barrato sul sito. Specificare dopo il tag Esempio: 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 Per saperne di più: Sconto sul prodotto |
prezzo_promo (prezzo_promo) Elemento opzionale | Prezzo del codice promozionale. Deve avere un'etichetta Esempio: 820 620 или 820 620 или 820 620 или
Per saperne di più: Partecipazione a invii promozionali |
valutaId Elemento richiesto | Valuta in cui è indicato il prezzo della merce: UAH, EUR, EUR, RUR. Esempio: UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR |
IDCategoria Elemento richiesto | ID della categoria a cui è associato questo prodotto. Esempio: 391 |
foto Elemento richiesto | Link alla foto del prodotto. La prima foto dell'elenco sarà quella principale nella scheda prodotto. Il link non deve contenere cirillico e spazi, il numero massimo di caratteri è ━ 1999. Il numero minimo di foto è ━ 1, il massimo è 15. Esempio: Se il tuo server ha una restrizione sul caricamento delle foto, devi aggiungere le seguenti sottoreti alle eccezioni: 89. 184. 81. 192/27 |
venditore Elemento richiesto | Marchio del produttore. Dovrebbe soddisfare le nostre esigenze . Esempio: Abc clothes |
nome (modello) Elemento richiesto | Nome del prodotto. Si prega di attenersi ai nostri requisiti e raccomandazioni quando si specifica.
La targhetta del modello può essere utilizzata come titolo al posto della targhetta del nome. Esempio: Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Il numero massimo di caratteri è ━ 255. |
descrizione Elemento richiesto | Descrizione del prodotto.
Esempio: Одежда <b>Abc clothes</b> способствует развитию… Produttore: Estonia. ]]> |
stato Elemento opzionale | Condizione del prodotto. Utilizzato nel caso di beni usati e ricondizionati Se il tag di stato non è specificato, per impostazione predefinita ai prodotti viene assegnato il nuovo stato. Esempio: used |
. . . Elemento richiesto | Caratteristiche (parametri) della merce. Il nome o il valore della caratteristica (parametro) deve essere compilato, non sono ammessi tag vuoti. Il numero minimo di caratteristiche richieste per un prodotto = 3.
Esempio: Черный In un parametro multivalore, i valori sono elencati separati da virgole e chiusi in CDATA. Il numero massimo di caratteri è ━ 255. |
paramid=". . . " Elemento opzionale | id della caratteristica (parametro) sul sito web di ROZETKA, è prescritto per l'auto-vincolo del parametro e per accelerare il processo di moderazione. Se il tipo di parametro (caratteristiche) è: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ è richiesto un tag valueid=". . . " aggiuntivo Esempio: 2 |
valueid=". . . " Elemento opzionale | id del valore della caratteristica (parametro) sul sito web di ROZETKA, è prescritto per vincolare automaticamente il valore e accelerare il processo di moderazione. Esempio: Осенняя, Весенняя, Летняя Il numero massimo di caratteri è ━ 255. |
Per scaricare in XML, utilizzare le sostituzioni di macro
{Attributo: ID Rozetka}
{Attributo: nome Rozetka}