Cómo crear un archivo XML para Rozetka.ua (sockets)
Para enumerar productos en Rozetka.ua, debe preparar una lista de precios con ofertas en formato XML (YML). Mientras se ejecuta la tienda, la dirección del enlace xml debe ser estática y no cambiar.
Requisitos del archivo XML (YML)
- el estándar XML (YML) no permite el uso de caracteres no imprimibles con códigos ASCII del 0 al 31 (a excepción de los caracteres con códigos 9, 10, 13 - tabulador, avance de línea, retorno de carro).
- los caracteres ", &, >, <, ' deben reemplazarse con códigos equivalentes. El requisito se aplica solo al texto y no afecta la escritura de las etiquetas;
- está prohibido cambiar la identificación de los productos y categorías después de agregarlos al sitio web de ROZETKA.
Símbolo en texto | Código para archivo XML |
---|---|
" | |
& | |
> | |
< | |
' |
- La dirección URL de una oferta de producto en el sitio web de la tienda debe codificarse de acuerdo con el estándar RFC-1738.
- Codificación de archivo XML (YML) válida: UTF-8.
ejemplo de archivo XML
Descripción de elementos
Elemento | Descripción |
---|---|
yml_catalog elemento requerido | El elemento raíz del formato YML. El atributo de fecha especifica la fecha y la hora en que se generó o modificó el XML (YML). La fecha debe estar en formato AAAA-MM-DD hh:mm. |
tienda elemento requerido | Contiene una descripción de la tienda y sus ofertas de productos. |
nombre elemento opcional | Nombre corto de la tienda. No publicado, utilizado para identificación interna. El número máximo de caracteres es ━ 255. |
empresa elemento opcional | El nombre completo de la empresa propietaria de la tienda. No publicado, utilizado para identificación interna. El número máximo de caracteres es ━ 255. |
URL elemento opcional | URL de la página principal de una tienda existente. El número máximo de caracteres es ━ 255. |
plataforma elemento opcional | El sistema de gestión de contenido en el que opera la tienda (CMS). |
monedas elemento requerido | Lista de tipos de cambio de tiendas. Cada una de las monedas se describe mediante un elemento de moneda independiente. Ejemplo: Los precios en el sitio se muestran solo en UAH. Solo hryvnia tiene rate="1". YML usa un punto o una coma para separar las partes enteras y fraccionarias de cualquier número, independientemente de la ubicación. El valor en el atributo de moneda id=". . . " se especifica de acuerdo con el estándar ISO 4217 como un código de moneda alfabético de tres letras (alfa-3). |
categorías elemento requerido | Lista de categorías de tiendas. A cada categoría se le asigna un número único, la numeración queda a criterio de la tienda.
Ejemplo: Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы El número máximo de caracteres es ━ 255. |
rz_id elemento opcional | Proporciona la vinculación automática de la categoría de la lista de precios con la categoría ROZETKA. Se indica solo en la lista de categorías, su identificación de categoría se indica en la ficha del producto. Ejemplo: Джемы и начинки id="12345" ━ su id de categoría; La prioridad de rz_id es mayor que la del nombre de categoría. Por ejemplo, si el nombre de la categoría en el archivo xml es "Camiseta", y la identificación de la categoría "Calcetines" en el sitio web de ROZETKA se indica en la etiqueta rz_id, automáticamente habrá una conexión con " Categoría "Calcetines". |
ofertas elemento requerido | Lista de ofertas de la tienda. Se abre una vez, después de la etiqueta. Cierra al final del documento, antes de la etiqueta Ejemplo: Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Tenga en cuenta que la etiqueta no debe repetirse en la lista de precios. |
oferta elemento requerido | Producto de tarjeta. Cerrado con etiqueta.
Para cada tipo de producto: color, tamaño, volumen, configuración, etc. — se debe crear una oferta única separada. En nuestra web, los productos estarán agrupados en 1 oferta con elección de color, tamaño, volumen, etc. Ejemplo: . . . |
Cantidad de stock (Cantidad en inventario) elemento requerido | El resto de los bienes. El producto estará en stock en el sitio siempre que este parámetro sea mayor a 0. Tenga en cuenta que al usar la etiqueta, es obligatorio indicarla en todos los productos en la lista de precios, de lo contrario, los productos sin esta etiqueta se asignarán al estado "Agotado". También asegúrese de seguir el valor en la etiqueta available=". . . " if stock_quantity > 0 ━ true, if stock_quantity < 0 ━ false. Ejemplo: 10 |
url (en oferta) elemento opcional | Enlace al producto en su sitio. Ejemplo: https://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx. html El número máximo de caracteres es ━ 500. |
precio elemento requerido | El precio del producto. Especifique solo un número entero, los kopeks se redondean en el sitio. Ejemplo: 4499 YML usa un punto o una coma para separar las partes enteras y fraccionarias de cualquier número. El precio indicado con kopeks se redondeará en el sitio. |
precio_antiguo (precio anterior) elemento opcional | El precio anterior de los productos se tachará en el sitio. Especificar después de la etiqueta Ejemplo: 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 Leer más: Descuento de producto |
precio_promo (precio promocional) elemento opcional | Precio del código de promoción. Debe tener una etiqueta Ejemplo: 820 620 или 820 620 или 820 620 или
Leer más: Participación en mailings promocionales |
ID de moneda elemento requerido | Moneda en la que se indica el precio de los bienes: UAH, EUR, EUR, RUR. Ejemplo: UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR |
categoria ID elemento requerido | ID de la categoría a la que está asociado este producto. Ejemplo: 391 |
imagen elemento requerido | Enlace a la foto del producto. La primera foto de la lista será la principal en la ficha del producto. El enlace no debe contener cirílico y espacios, el número máximo de caracteres es ━ 1999. El número mínimo de fotos es ━ 1, el máximo es 15. Ejemplo: Si su servidor tiene una restricción para cargar fotos, debe agregar las siguientes subredes a las excepciones: 89. 184. 81. 192/27 |
proveedor elemento requerido | Marca del fabricante. Debe cumplir con nuestros requisitos . Ejemplo: Abc clothes |
nombre (modelo) elemento requerido | Nombre del producto. Cumpla con nuestros requisitos y recomendaciones al especificar.
La etiqueta de modelo se puede utilizar como título en lugar de la etiqueta de nombre. Ejemplo: Куртка 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) El número máximo de caracteres es ━ 255. |
descripción elemento requerido | Descripción del Producto.
Ejemplo: Одежда <b>Abc clothes</b> способствует развитию… Productor: Estonia. ]]> |
Expresar elemento opcional | Condición del producto. Utilizado en el caso de bienes usados y reacondicionados Si no se especifica la etiqueta de estado, por defecto a los productos se les asigna el nuevo estado. Ejemplo: used |
. . . elemento requerido | Características (parámetros) de las mercancías. Se debe completar el nombre o valor de la característica (parámetro), no se permiten etiquetas vacías. El número mínimo de características requeridas para un producto = 3.
Ejemplo: Черный En un parámetro de varios valores, los valores se enumeran separados por comas y cerrados en CDATA. El número máximo de caracteres es ━ 255. |
paramid=". . . " elemento opcional | id de la característica (parámetro) en el sitio web de ROZETKA, se prescribe para vincular automáticamente el parámetro y acelerar el proceso de moderación. Si el tipo de parámetro (características) es: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ se requiere la etiqueta adicional valueid=". . . " Ejemplo: 2 |
valorid=". . . " elemento opcional | id del valor de la característica (parámetro) en el sitio web de ROZETKA, se prescribe para vincular automáticamente el valor y acelerar el proceso de moderación. Ejemplo: Осенняя, Весенняя, Летняя El número máximo de caracteres es ━ 255. |
Para descargar en XML, use sustituciones de macros
{Atributo: ID de Rozetka}
{Atributo: nombre de Rozetka}