Como convertir un catalogo a YML

YML es un formato de feed de productos basado en XML. El formato de entrada no importa: Eofferix puede usar como fuente XML, YML, JSON, CSV, XLS, XLSX, un archivo disponible mediante URL o FTP/SFTP, un adjunto de correo electrónico, un archivo comprimido o una exportación preparada por otro servicio. Después de elegir YML, Eofferix crea un snapshot XML de trabajo en el que configuras la estructura final y las reglas de transformación. Si eliges un escenario especializado, el panel lateral también ayuda a comprobar los requisitos de la plataforma seleccionada.

Cómo configurar una exportación a YML

1. Abre «Intérprete» y pulsa «Nuevo perfil».

   

2. Selecciona la fuente de datos: carga un archivo nuevo o elige una fuente existente.

   

3. Elige YML como formato de exportación.

   

4. Si necesitas un archivo especializado, elige una plataforma o un escenario. YML universal se selecciona de forma predeterminada.

   

5. Desplázate hasta el final del perfil y pulsa Continuar. El servicio guarda el perfil y abre el snapshot XML con los nodos de la fuente y la estructura YML generada. La marca ! identifica los nodos obligatorios para la plataforma seleccionada.

   

6. Haz clic en las sugerencias del panel para aplicar los cambios de nombre detectados o crear los nodos que faltan. Las reglas complejas deben configurarse manualmente.
7. Guarda la plantilla e inicia la exportación.

Cómo actualizar YML automáticamente

Para un feed periódico no hace falta cargar el archivo de origen ni iniciar la conversión manualmente cada vez. Conecta una fuente que Eofferix pueda comprobar de forma automática: una URL directa, FTP/FTPS, un archivo adjunto de correo, Google Sheets o Yandex Tables, o un almacenamiento en la nube. Para crear y comprobar el perfil, consulta Primera ejecución del perfil; para recibir nuevas versiones del archivo de origen, consulta Programación de carga de la fuente.

1. La fuente recibe una lista de precios o un catálogo actualizado según su propio horario.
2. Después de una actualización correcta, el perfil se inicia por el evento y aplica las asignaciones, transformaciones y el preset YML guardados.
3. El archivo terminado se publica en una URL permanente que puedes proporcionar a la plataforma. Cada ejecución correcta actualiza el archivo en esa misma URL.

Configura la secuencia «actualizar la fuente → generar YML» como se describe en Planificador de perfiles y fuentes. La URL permanente y la entrega del resultado se explican en Entrega del resultado después de las transformaciones.

Cómo utilizar el panel de ayuda

El editor comprueba la plantilla actual según los requisitos de la plataforma seleccionada y muestra el resultado a la derecha. Los requisitos se agrupan en estructura, propiedades obligatorias, condicionales, recomendadas, no compatibles y procesadas. Una marca verde indica que el punto se cumple; ! requiere atención; el icono de información explica una recomendación y no cambia nada por sí solo.

El panel nunca aplica una corrección de forma silenciosa. Los botones de acción solo funcionan después de un clic. Pase el cursor por un icono para ver su ayuda.

Qué hacer con las propiedades que la plataforma no admite

Esta sección reúne las propiedades del catálogo de origen que no forman parte de los requisitos de la plataforma seleccionada. Cada propiedad simple permite:

• Eliminar — no incluirla en la exportación;
• Convertir — transformarla en <param name="nombre_de_la_propiedad">valor</param>. El icono solo aparece si el formato de la plataforma admite param.

Después de eliminar o convertir, la fila sale de la lista que requiere atención y pasa a la sección plegada «Campos procesados». Cada propiedad procesada tiene su propio icono Deshacer, por lo que puede revertir una acción sin restablecer las demás.

Trabajar con categorías

No todas las plataformas necesitan categorías. Si el escenario seleccionado no las exige, puede omitir su configuración. Cuando sí las exige, el editor admite varias estructuras de origen:

• el catálogo ya contiene ID de categoría y un diccionario separado — conserve la relación entre categories/category/@id y offer/categoryId, y el panel la comprobará;
• cada producto contiene solo un nombre o una ruta de categoría — seleccione esa propiedad en «Categorías de productos»; Eofferix generará ID numéricos, creará categories y rellenará categoryId automáticamente;
• las categorías están en otro lugar, tienen otra jerarquía o la plataforma exige una estructura diferente — cree, mueva o seleccione manualmente los nodos necesarios.

En el origen, la categoría puede estar dentro de cada producto o separada de él. Los requisitos de la plataforma seleccionada determinan la estructura de salida.

La comprobación completa no se ejecuta después de cada edición. Pulse «Comprobar todos los productos» cuando la configuración esté lista. Después de un cambio, use «Volver a comprobar»; si una comprobación larga se interrumpe, use «Continuar comprobación». Así, incluso un catálogo muy grande no se vuelve a comprobar después de cada acción.

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;
• si el destinatario necesita categorías, categoryId debe ser numérico y hacer referencia a 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.