Contenido 12 secciones
- ¿Qué es la integración XML?
- ¿Qué es XML y cómo se ve el XML de productos?
- ¿Cómo funciona la integración XML?
- ¿Cómo importar productos de un proveedor?
- ¿Cómo exportar productos a plataformas de publicidad y de compras?
- ¿Cómo mapear campos en XML?
- ¿Con qué frecuencia debe actualizarse el XML?
- ¿Cómo gestionar los errores en la integración XML?
- Errores frecuentes en la integración XML
- ¿Cómo hacer la integración XML con Faprika?
- Lista de verificación de la integración XML
- Preguntas frecuentes
Introducir a mano cientos de productos de su proveedor, cerrar una a una cada línea cuando se agota el stock y subir además el mismo producto a las plataformas de publicidad acaba por frenar el negocio. Para que, cuando un dato de producto cambia en un lugar, los demás se actualicen solos, los sistemas deben hablar el mismo idioma. En el comercio electrónico, el más extendido de esos idiomas comunes es XML.
Esta guía trata la integración XML de principio a fin: qué es XML, cómo es un XML de productos, la diferencia entre importar y exportar datos, cómo se hace la correspondencia de campos, con qué frecuencia deben ejecutarse las actualizaciones de stock y precio y los errores más habituales. También incluye una herramienta que calcula cuánto le cuestan los retrasos de actualización y una lista de comprobación con la que puede auditar su propia fuente XML y su salida. Sin repetir el artículo ¿Qué es un proveedor XML?, que trata el lado del proveedor, ni el artículo ¿Qué es la distribución XML y cómo empezar?, que trata el lado del modelo de negocio del método, aquí nos centramos en la propia conexión, es decir, en la técnica y la operación.
¿Qué es la integración XML?
La integración XML es la transferencia automática de datos como productos, stock, precios o pedidos entre dos sistemas mediante un formato de archivo estructurado llamado XML. Una parte publica los datos en XML y la otra lee ese archivo a intervalos y lo procesa en sus propios registros.
La fuerza del método es que los dos sistemas no necesitan conocerse. El sistema de origen ofrece los datos en un enlace que cualquiera puede leer; el sistema lector va a ese enlace y coloca el contenido en sus propios campos. Según la dirección de la transferencia, hay dos usos principales:
| Dirección | ¿Qué se hace? | ¿De quién a quién? | Uso típico |
|---|---|---|---|
| Importación | Los datos de productos y stock de una fuente externa se leen en la tienda | Proveedor o mayorista → tienda | Crear el catálogo de productos y mantener al día el stock y el precio |
| Exportación | Los datos de productos de la tienda se publican como un enlace XML | Tienda → plataformas de publicidad, de compras y de catálogo | Abrir los productos a la publicidad y a los escaparates, compartir informes de ventas |
La misma tienda suele usar ambas direcciones a la vez: recibe productos de su proveedor y también entrega los suyos a las plataformas de publicidad. La lógica de las dos direcciones es la misma; lo que cambia es quién publica y quién lee.
Le recomendamos leer¿Qué es un proveedor XML?¿Qué es XML y cómo se ve el XML de productos?
XML es un lenguaje de marcado en el que los datos se definen con etiquetas; cada dato queda entre una etiqueta de apertura y una de cierre, y las etiquetas se anidan formando un árbol. El XML de productos describe un producto en cada rama de ese árbol.
El siguiente ejemplo es un producto representativo; los nombres de las etiquetas cambian de una fuente a otra y cada fuente define su propia estructura.
<?xml version="1.0" encoding="UTF-8"?>
<urunler>
<urun>
<stok_kodu>ORN-1001</stok_kodu>
<barkod>8690000000012</barkod>
<ad>Örnek Keten Gömlek</ad>
<fiyat>1250.00</fiyat>
<stok>14</stok>
<kategori>Giyim > Gömlek</kategori>
<resim>https://www.ornek.com/img/gomlek-1.jpg</resim>
</urun>
</urunler>
| Elemento | ¿Para qué sirve? | Aspecto a tener en cuenta |
|---|---|---|
| Declaración XML | Indica que el archivo es XML y su codificación de caracteres | La codificación debe ser UTF-8 para los caracteres turcos |
| Etiqueta raíz | La etiqueta más externa, que abarca todos los productos | Una etiqueta raíz sin cerrar invalida todo el archivo |
| Etiqueta de producto | El bloque en el que cada producto se repite como un registro | El sistema lector separa los registros por el nombre de esta etiqueta |
| Etiquetas de campo | Datos individuales como código de stock, precio, stock, categoría | El mismo dato debe llegar con la misma etiqueta en todos los productos |
| Atributo | Información adicional escrita dentro de la etiqueta, por ejemplo la moneda | El lector debe estar configurado para leerla también |
XML está tan extendido porque lo pueden leer tanto las personas como las máquinas. Puede abrir un archivo en el navegador, mirar su interior y ver con sus propios ojos por qué algo falla. Esta característica facilita la depuración frente a otros métodos de transferencia. Para listas grandes como los datos de productos, el glosario también explica el concepto de XML feed.
¿Cómo funciona la integración XML?
La integración XML funciona así: el sistema lector va a intervalos al enlace de la fuente, descarga el archivo, analiza el contenido, hace corresponder los campos con los suyos y escribe los cambios en los registros. El proceso sigue el mismo orden en cada ronda.
- Va al enlace: El lector envía una solicitud a la dirección XML que da la fuente. A veces la fuente solo admite solicitudes procedentes de determinadas direcciones.
- Descarga el archivo: Una lista grande de productos puede estar dividida en varias partes; el lector las toma en orden.
- Analiza: Se leen las etiquetas y cada producto se separa como un registro. Una etiqueta dañada produce un error en este paso.
- Mapea: Los campos de la fuente se relacionan con los de la tienda: el código de stock con el código de stock, el precio con el precio.
- Compara: Los datos nuevos se contrastan con el registro existente; solo se actualizan los productos que cambian, se añaden los nuevos y se marcan los que desaparecen de la fuente.
- Escribe y guarda: Los cambios se procesan en la tienda; cuántos productos se añadieron, actualizaron o dieron error queda registrado en el historial.
- Espera: El sistema se detiene hasta que llega el momento de la siguiente ronda; la frecuencia la determina el ajuste.
En la dirección de exportación el orden se invierte: la tienda convierte sus productos a XML y los publica en un enlace; la plataforma de publicidad o de compras lee ese enlace con su propia programación. Aquí el control es suyo, porque usted decide qué productos, a qué precio y en qué idioma se publican.
¿Cómo importar productos de un proveedor?
Para recibir productos de un proveedor, usted da a conocer a la tienda el enlace XML del proveedor, mapea los campos y define la frecuencia de actualización. La configuración se hace una vez; después, el catálogo y el stock se mantienen al día solos.
¿Qué revisar antes de importar?
La calidad del archivo de origen determina la calidad de la integración. Antes de conectar el enlace, responda a estas preguntas:
- Frecuencia de actualización: ¿Con qué frecuencia renueva la fuente los datos? Aunque usted lea cada minuto, si la fuente se renueva una vez al día no obtendrá datos frescos.
- Integridad de los campos: ¿Tiene cada producto código de stock, precio, stock e imagen? Los campos que llegan vacíos significan una página vacía.
- Identificador único: ¿Hay un único campo (código de stock o código de barras) que distinga los productos entre sí? Ese campo es la clave del mapeo.
- Variantes: Las opciones como talla y color, ¿llegan dentro de un único producto o como registros separados?
- Fiabilidad de la fuente: ¿Se corta el enlace con frecuencia? ¿Es el tamaño del archivo demasiado grande?
Puede encontrar cómo elegir una fuente como proveedor y cómo establecer la relación comercial en el artículo ¿Qué es un proveedor XML?; para entender la lógica general del modelo que funciona sin stock, resulta útil el artículo ¿Qué es el comercio electrónico sin stock? ¿Cómo se vende sin stock?.
La primera importación y las actualizaciones posteriores no son lo mismo
La primera transferencia crea el catálogo: todos los productos, imágenes y descripciones llegan a la tienda. Las rondas siguientes solo llevan el cambio: el stock y el precio cambian a menudo; la descripción y la imagen, rara vez. Esta distinción es importante, porque reescribirlo todo en cada ronda es lento y además puede pisar las correcciones que usted haya hecho a mano. Decida desde el principio qué campos se tomarán siempre de la fuente y cuáles solo la primera vez.
¿Cómo exportar productos a plataformas de publicidad y de compras?
Exportar es publicar los productos de la tienda como un enlace XML en el formato que piden las plataformas de publicidad y de compras. La plataforma lee ese enlace a intervalos regulares y muestra sus productos en su escaparate y en sus anuncios.
Los nombres de campo y la información obligatoria que espera cada plataforma son distintos. Por eso la exportación suele hacerse con una plantilla: la plantilla determina cómo se convierten los campos de la tienda en las etiquetas que espera la plataforma. Conviene tener en cuenta lo siguiente:
- Entregue solo productos vendibles: Si un producto sin imagen ni stock sale a publicidad, o recibirá un error o gastará en publicidad de un producto agotado.
- Ajuste el precio según la plataforma: En algunas plataformas puede aplicarse una política de precios distinta; por eso es importante poder subir o bajar el precio en la salida, por importe o por porcentaje.
- Elija el idioma y la moneda: En la publicidad dirigida a mercados del extranjero, el producto debe salir en el idioma y la moneda correspondientes.
- Proteja el enlace: Si la dirección de salida es pública, los competidores también podrán leer su lista de productos y precios; si es posible, permita el acceso solo desde determinadas direcciones.
- Divida el archivo: En catálogos muy grandes, varias partes se leen de forma más segura y rápida que un solo archivo.
Los datos estructurados que usan los motores de búsqueda para entender las páginas de producto son otro tema; puede leerlo en el artículo ¿Qué son los datos estructurados (Schema)?.
Le recomendamos leer¿Cómo hacer la actualización masiva de productos?¿Cómo mapear campos en XML?
El mapeo de campos consiste en determinar en qué campo de la tienda se escribirá cada etiqueta del XML de origen. Si el mapeo es incorrecto, los datos fluyen pero al lugar equivocado: el precio puede escribirse en el campo de stock y el código de barras en el código de stock.
| Información en la fuente | Equivalente en la tienda | Aspecto a tener en cuenta |
|---|---|---|
| Código de stock | Código de stock del producto (SKU) | Clave del mapeo; debe ser único y estable |
| Código de barras | Campo de código de barras | Los códigos de barras vacíos o repetidos pueden chocar con las reglas de marketplaces y de publicidad |
| Nombre del producto | Nombre del producto | Los nombres demasiado largos o en mayúsculas deben editarse |
| Precio | Precio de venta | Debe aclararse si llega con IVA incluido o sin IVA |
| Cantidad en stock | Cantidad en stock | Los valores negativos y vacíos deben contarse como 0 |
| Categoría | Categoría de la tienda | El árbol de categorías de la fuente debe convertirse al suyo |
| Enlace de imagen | Imágenes de producto | El enlace debe funcionar; si la fuente retira la imagen, la página queda vacía |
| Variante (talla, color) | Opciones y variantes | La relación entre el producto principal y los registros secundarios debe establecerse correctamente |
Gestionar bien el código de stock es la base del mapeo; cómo deben construirse los códigos de stock lo explica el artículo ¿Qué es el SKU? ¿Cómo crear un código de stock (SKU)?. Si el árbol de categorías de la fuente es distinto del suyo, hacer corresponder una sola vez cada categoría de origen con su propia categoría le ahorrará trabajo en las rondas siguientes.
¿Con qué frecuencia debe actualizarse el XML?
La frecuencia de actualización se determina según la rapidez con que cambian los datos y lo que le cuesta ese retraso. El stock y el precio se actualizan a menudo; la descripción y la imagen, rara vez. A mayor frecuencia, menor probabilidad de ventas erróneas.
| Tipo de dato | Velocidad de cambio | Enfoque de actualización |
|---|---|---|
| Cantidad en stock | Muy rápida, con cada venta | Las rondas más frecuentes; si es posible, minutos |
| Precio | Media, rápida en periodos de campañas y de cambios de divisa | Rondas frecuentes; activación manual antes de las campañas |
| Estado del producto (activo, inactivo) | Medio | Se actualiza junto con el stock |
| Descripción y características | Lenta | Rondas espaciadas o solo en la primera transferencia |
| Imágenes | Lenta | Rondas espaciadas; cuando llega un producto nuevo |
| Producto y categoría nuevos | Irregular | Ronda diaria o semanal |
Aquí se mezclan dos retrasos distintos. El primero es el intervalo de lectura: ¿cada cuántos minutos lee su sistema el XML? El segundo es el propio intervalo de renovación de la fuente: ¿con qué frecuencia actualiza el proveedor su archivo? La edad media del dato depende de la suma de ambos retrasos. Por mucho que lea con frecuencia, si la fuente se renueva una vez al día, el stock quedará igual de anticuado.
En la gestión XML de Faprika, los tiempos de actualización y muchos campos los gestiona el cliente; la actualización puede hacerse en minutos, no a diario. En la presentación del complemento Gestión XML Dinámica también se indica que el tiempo de actualización, que en otras empresas ronda un día de media, en Faprika se deja en manos del cliente y puede reducirse a minutos. Para la parte de sincronización de stock con marketplaces, consulte la guía ¿Cómo hacer la sincronización de stock con marketplaces?.
Le recomendamos leer¿Cómo hacer la sincronización de stock con marketplaces?¿Cómo calcular el coste del retraso en la actualización?
El coste del retraso surge de que una parte de los pedidos recibidos con datos desactualizados llega a productos sin stock: el pedido se cancela, se pierde al cliente y, en algunos canales, se sufre una penalización o pérdida de puntuación. La siguiente herramienta lo estima con un modelo aproximado.
El modelo funciona así: el número de actualizaciones diarias da el intervalo entre rondas; la edad media del dato es la mitad de ese intervalo más el retraso; la parte del día que cubre esa edad indica la proporción de pedidos recibidos con datos desactualizados; el producto de esa proporción por la tasa de diferencia de stock da el número estimado de pedidos erróneos. Los valores son supuestos; cámbielos por sus propios datos.
Al interpretar el resultado, tenga en cuenta dos cosas. Primera, duplicar el número de actualizaciones no reduce a la mitad la antigüedad de los datos, porque el retraso sigue siendo el mismo. Segunda, el cálculo solo muestra la pérdida directa; la pérdida de confianza del cliente en la tienda tras un pedido cancelado es difícil de expresar en cifras, pero es real. La forma más eficaz de reducir el retraso suele ser no la frecuencia, sino acortar la espera entre la lectura y la escritura.
¿Cómo gestionar los errores en la integración XML?
La gestión de errores en una integración XML consiste en prevenir el error, detectarlo rápido cuando ocurre y saber quién debe corregir qué. Una integración que funciona en silencio no es una integración que funciona sin problemas; el registro de transferencias debe revisarse con regularidad.
Tres capas trabajan juntas: las reglas que validan el archivo de origen (¿hay un campo obligatorio vacío?, ¿el precio es cero?), el registro de transferencias (cuántos productos se añadieron, se actualizaron o dieron error) y la alerta (el mecanismo que avisa cuando la tasa de errores supera el umbral). La tabla siguiente resume las situaciones más habituales.
| Síntoma | Causa probable | ¿Qué se hace? |
|---|---|---|
| Los caracteres turcos aparecen dañados | La codificación no es UTF-8 o se lee de forma incorrecta | Revise la codificación declarada en el archivo y la configuración de codificación del lector |
| El archivo no se puede leer en absoluto | Etiqueta sin cerrar, carácter no válido o archivo truncado | Abra el archivo en el navegador, localice la línea del error e infórmelo a la fuente |
| La conexión agota el tiempo de espera | El archivo es demasiado grande o la fuente es lenta | Divida el archivo en partes y programe la lectura fuera de las horas de mayor tráfico |
| Los productos aparecen duplicados | La clave de emparejamiento (código de stock) no es única | Cambie la clave o pida a la fuente que elimine los duplicados |
| El precio o el stock se escribe en un campo equivocado | El emparejamiento de campos es incorrecto | Pruebe el emparejamiento con un solo producto y compruébelo |
| Los productos pasan a inactivos de golpe | La fuente publicó temporalmente un archivo vacío | Establezca un umbral que detenga la actualización cuando el archivo esté vacío o sea muy pequeño |
| Las imágenes no se ven | El enlace de la imagen está roto o la fuente restringe el acceso | Considere alojar las imágenes en su propio servidor o aclarar el acceso con la fuente |
| El producto sigue a la venta aunque el stock es cero | Retraso en la actualización o lectura incorrecta del campo de stock | Aumente la frecuencia; deje un stock de seguridad |
El caso del archivo vacío es especialmente peligroso: si durante una avería la fuente publica un XML vacío, la integración puede interpretarlo como «se agotó el stock de todos los productos» y cerrar todo el catálogo. Para evitarlo, utilice un umbral que no aplique la actualización si el número de registros recibidos ha disminuido bruscamente respecto a la ronda anterior. El stock de seguridad, por su parte, mantiene reservada en la tienda una cantidad determinada del stock que aparece en la fuente y amortigua las ventas en exceso causadas por el retraso.
Errores frecuentes en la integración XML
Los errores en la configuración de XML suelen deberse más a la planificación que a la técnica. Los más habituales son estos:
- No preguntar el intervalo de actualización de la fuente: Aunque usted lea con frecuencia, si la fuente se renueva poco, el retraso es inevitable.
- Escribirlo todo en cada ronda: Los textos e imágenes que corrigió a mano se sobrescriben continuamente.
- Aplicar el emparejamiento a todo el catálogo sin probarlo con un producto: Un emparejamiento incorrecto puede dañar miles de registros.
- No poner protección contra el archivo vacío: Una sola avería puede desactivar todo el catálogo.
- No dejar stock de seguridad: Vender hasta que el stock llegue a cero significa, cuando hay retraso, vender un producto que ya no se podrá entregar.
- Dejar en la salida exportada productos sin stock o sin imagen: El anuncio apunta a un producto agotado o se produce un error.
- Dejar la dirección de salida abierta a todo el mundo: Su lista de productos y precios se copia con facilidad.
- No leer el registro: El error se acumula durante mucho tiempo sin que se note.
¿Cómo se hace la integración XML con Faprika?
La gestión de XML en Faprika consta de dos partes: la Gestión Dinámica de XML, que se utiliza para la transferencia de productos y la actualización de stock, y la salida de productos que se obtiene desde el panel. En ambas el objetivo es el mismo: que usted gestione los tiempos de actualización y los campos.
El complemento Gestión Dinámica de XML le permite gestionar la transferencia de productos, la actualización de stock y la exportación de informes de ventas mediante estructuras XML personalizables. Que los campos sean personalizables le permite adaptarse a la estructura de la fuente y definir sus propias preferencias. El complemento está diseñado para que el proceso sea automático y continuo.
¿Cómo obtener el XML de productos desde el panel?
La salida de productos para plataformas de publicidad y compras se crea desde el panel en pocos pasos. En el panel de administración sigue los pasos Catálogo, Transferencia, Exportar productos. Para una explicación detallada, consulte el tutorial de Exportar productos.
Primero filtra qué productos se exportarán: productos con imagen, tipo de producto, productos activos, cantidad inicial de stock y categoría. Si deja el filtro vacío, se envían todos los productos. A continuación completa la configuración de salida:
| Campo | ¿Para qué sirve? |
|---|---|
| Nombre de salida | El nombre que le da para distinguir la salida de las demás |
| Tipo de archivo | En este flujo se selecciona XML |
| Plantilla | Según el formato de qué plataforma se genera la salida; se selecciona la plantilla de la plataforma |
| Idioma | Si los productos tienen información en otros idiomas, se obtiene la salida en distintos idiomas |
| Moneda | En qué unidad se escribe el precio de la salida |
| Valor del precio | Valor que se sumará o restará al precio; si no quiere diferencia, se deja en 0 |
| Tipo de precio | Sobre qué precio se realiza el envío |
| Tipo de cálculo | Si la diferencia será un importe o un porcentaje |
| Sentido del cálculo | Aumentar o disminuir el precio |
| Total de piezas | En cuántos enlaces se divide la salida; se usa en XML con muchos productos, la recomendación general es 1 |
| Direcciones IP permitidas | Restricción si desea acceso solo desde determinadas direcciones; si no, vacío |
Después de marcar la casilla Activo y guardar, entre en los enlaces de salida y utilice el enlace XML que aparece. El filtro no es obligatorio; sin embargo, que los productos en los que va a anunciarse tengan imágenes y stock evita errores y evita que se anuncie un producto sin stock.
¿Cómo se gestiona la actualización en Faprika?
Faprika deja en manos del cliente los tiempos y los campos de las actualizaciones XML. Esto tiene dos consecuencias prácticas: puede aumentar la frecuencia en campañas o periodos de gran venta y reducirla en periodos tranquilos; y puede emparejar los campos de la fuente con la estructura de su propia tienda. En qué plan se incluyen los complementos y otras soluciones varía según el plan; para más detalles, consulte la comparación de planes de comercio electrónico.
Lista de comprobación de la integración XML
Antes de conectar una fuente XML o publicar una salida, repase la lista siguiente. Cuando todos los puntos sean «sí», su flujo se apoya en una base sólida.
| Campo | Comprobación | ¿Hecho? |
|---|---|---|
| Archivo | Se abre sin errores en el navegador, codificación correcta | Sí / No |
| Identificador | Cada producto tiene un código de stock único | Sí / No |
| Emparejamiento | Precio, stock y categoría probados con un solo producto | Sí / No |
| Frecuencia | Se conocen el intervalo de la fuente y mi propio intervalo de lectura | Sí / No |
| Protección | Con un archivo vacío o pequeño, la actualización se detiene | Sí / No |
| Sobrescritura | Los textos editados a mano se conservan | Sí / No |
| Resultado | Solo se exportan productos con imagen y stock | Sí / No |
| Diario | El número de errores se vigila con regularidad | Sí / No |
Preguntas frecuentes
¿Qué es la integración XML?
La integración XML es la transferencia automática de datos como productos, stock y precios entre dos sistemas mediante un archivo en formato XML. Un sistema publica los datos en un enlace XML y el otro los lee a intervalos y los incorpora a sus registros.
¿Qué diferencia hay entre importar y exportar productos con XML?
En la importación, los datos de productos y stock de una fuente externa se leen en su tienda; sirve para montar un catálogo a partir del proveedor. En la exportación, los productos de su tienda se publican como un enlace XML que leen las plataformas de publicidad y compras.
¿Con qué frecuencia debe actualizarse el XML?
El stock y el precio se actualizan con más frecuencia; la descripción y las imágenes, con menos. A medida que aumenta el volumen de pedidos y la fuente se renueva con más frecuencia, debe aumentar la frecuencia. En Faprika, los intervalos de actualización los gestiona el cliente y pueden ser de minutos, no solo diarios.
¿Por qué es importante el emparejamiento de campos en XML?
El emparejamiento garantiza que cada dato de la fuente se escriba en el campo correcto de la tienda. Con un emparejamiento erróneo, el precio puede escribirse en el campo de stock o el código de barras en el código de stock. Por eso conviene probar el emparejamiento primero con un solo producto y después aplicarlo a todo el catálogo.
¿Cuál es el error más frecuente en la integración XML?
Los errores más frecuentes son una codificación de caracteres defectuosa, un código de stock no único, un emparejamiento de campos erróneo, que la fuente publique un archivo vacío y el retraso en la actualización. Leer con regularidad el registro de transferencias y poner una protección contra archivos vacíos evita la mayoría.
¿Cómo obtengo en Faprika los productos en XML para plataformas de publicidad?
En el panel de administración, en los pasos Catálogo, Transferencia y Exportar productos, filtra los productos y define el nombre de salida, el tipo de archivo, la plantilla, el idioma, la moneda y el ajuste de precio; tras guardar, usa la dirección XML del enlace de salida. Si los productos que va a anunciar tienen imagen y stock, evitará errores.
