Como convertir un catalogo a YML

YML es un formato de feed de productos basado en XML. En Eofferix, la entrada puede ser cualquier fuente compatible: XML, YML, JSON, CSV, XLS, XLSX, URL, FTP/SFTP, email, archivo comprimido o una exportacion preparada desde otro servicio. Antes de configurar el resultado, el servicio prepara un snapshot XML de trabajo, por lo que la asignacion se hace en un arbol de nodos y reglas de transformacion.

Esta guia describe el flujo general de conversion a YML. El formato de entrada no importa: despues de elegir YML, configuras la estructura final en el snapshot XML y el panel lateral ayuda a comprobar los requisitos de la plataforma seleccionada.

Cuando elegir YML

• la plataforma de destino acepta una lista de precios o feed de productos en YML;
• necesitas publicar una URL de catalogo que se actualiza automaticamente;
• la fuente del proveedor no es YML, pero contiene productos, precios, categorias, imagenes y descripciones;
• necesitas variantes separadas del feed: YML universal, Yandex Productos, Direct, Yandex Business, 2GIS u Ozon precios y stock.

Como funciona la preparacion

1. Crea un perfil y selecciona la fuente de datos.
2. Elige YML como formato de exportacion.
3. Si necesitas un archivo especializado, elige una plataforma o escenario. YML universal se usa por defecto.
4. Abre el snapshot XML. Veras los nodos de la fuente y la estructura YML generada.
5. Haz clic en las sugerencias del panel para aplicar renombrados encontrados o crear nodos faltantes. Las reglas estructurales complejas siguen siendo manuales.
6. Guarda la plantilla y ejecuta una exportacion de prueba. Despues comprueba el YML final y el cargador de la plataforma.

Que hace el panel lateral

Cuando se selecciona un escenario especializado, el snapshot XML muestra un panel de preparacion YML. Comprueba la estructura del feed, campos obligatorios de offer, campos condicionales, recomendados y otros parametros. El panel no cambia ajustes guardados en silencio: una accion se aplica solo despues de hacer clic en una sugerencia o boton.

La marca ! junto a un nodo o atributo indica que el elemento es importante para el escenario seleccionado. Al pasar el cursor se muestra el nombre del escenario. Los costes tecnicos de los elementos agregados estan ocultos por defecto y se activan desde las herramientas del editor.

Categorias y categoryId

YML enlaza categorias mediante identificadores numericos. Un nodo categories/category debe tener el atributo id, y offer/categoryId debe contener el mismo valor numerico. Si la fuente contiene categorias de texto o rutas, usa la herramienta de generacion de categorias: crea un diccionario de categorias, asigna IDs numericos y reemplaza los valores de categoria de los productos mediante reglas de transformacion.

Presets YML

Un preset no sustituye las reglas oficiales de la plataforma. Da una estructura inicial y resalta lo que falta en el perfil actual. Comprueba siempre la lista actual de parametros en la documentacion del servicio que recibira el feed.

Preparacion YML para Yandex Market

Escenario para el gabinete de vendedor de Market. El panel comprueba yml_catalog, fecha, shop, monedas, categorias, offers y el nodo de producto offer. La obligatoriedad de campos depende del objetivo del archivo: tarjetas de producto, precios, stock o gestion de colocacion. En Eofferix, url no se trata como obligatorio sin condiciones para este preset; aparece como campo condicionalmente importante. Ver documentacion YML de Yandex Market.

Preparacion YML para Yandex Productos / Busqueda

Escenario para un feed de productos destinado a superficies relacionadas con la busqueda de Yandex. El panel exige id, name, url, price, currencyId, categoryId, picture y description dentro de cada offer. Ver documentacion del feed de Yandex Productos.

Preparacion YML para Yandex Direct

Escenario para feeds publicitarios. Son importantes la URL del producto, precio, moneda, categoria e imagen. Si usas el atributo available, transmite true o false, no un numero. Para ofertas vendor.model, tambien se comprueban vendor y model. Ver requisitos del feed YML de Yandex Direct.

Preparacion YML para productos y servicios de Yandex Business

Escenario para la lista de precios de una empresa en Yandex Business: productos y servicios pueden mostrarse en la ficha de la empresa. En este preset, shop/url no es obligatorio como enlace a una ficha de producto; son mas importantes seccion, nombre, precio, moneda, categoria y proveedor o marca cuando el precio los necesita. Ver documentacion de lista de precios de Yandex Business.

Preparacion YML para 2GIS

2GIS acepta productos y servicios desde un archivo o URL en formato YML/CSV. El preset crea una estructura YML tipica con productos, precios, moneda y categorias, y recomienda URL, imagen y descripcion. La ayuda publica de 2GIS explica el metodo de carga; verifica la plantilla exacta en el gabinete de 2GIS. Ver ayuda de 2GIS sobre productos y precios.

Preparacion YML para Ozon: precios y stock

Este escenario no sustituye la Seller API de Ozon. Usalo cuando necesites entregar un archivo para actualizar precios y stock por identificador de producto. Las categorias no son obligatorias aqui; lo mas importante es id, price, currencyId y stock. Ver articulo de Ozon sobre actualizacion mediante feed.

YML universal

Usa YML universal cuando el receptor solo pide un archivo YML sin un conjunto propio de requisitos. En este modo no se muestra el panel especializado: defines tu mismo la estructura, nombres de nodos, atributos y reglas de transformacion.

Que comprobar antes de lanzar

• la raiz se llama yml_catalog si el receptor lo espera;
• la fecha del catalogo esta en RFC 3339 con zona horaria si el escenario la exige;
• shop, currencies, categories, offers y offer estan en los niveles de anidamiento esperados;
• offer/@id es unico y no esta vacio;
• price es numerico y currencyId coincide con la moneda en currencies;
• categoryId es numerico y referencia un categories/category/@id existente;
• url y picture son accesibles externamente si la plataforma los requiere;
• available es true o false si se usa;
• el archivo de prueba pasa el cargador del servicio sin errores criticos.