A la página principal
  1. Help Center - Channable
  2. APIs
  3. Configuración de otros canales

Artículos en esta sección

Más información

Configurar una API de Allegro

¿Quieres aprender de forma interactiva todos los aspectos básicos relacionados con la creación de una exportación de API, o cómo realizar una configuración avanzada para una API en Channable? Aprende a hacerlo creando una cuenta Channacademy en la App de Channable utilizando este artículo del Centro de Ayuda, y comienza con el curso APIs Básicas o APIs Expertas.

Para empezar a vender tus productos en el marketplace de Allegro, necesitarás tener una cuenta de vendedor de Allegro. Si aún no tienes una cuenta de vendedor de Allegro, puedes registrarte para obtener una cuenta de vendedor en esta página. Una vez que hayas establecido una cuenta de vendedor de Allegro, podrás conectarte con Channable.

Tabla de contenido

  1. Preparación
  2. Crea una nueva conexión
  3. Crea la API
  4. Crea tus listados de productos
  5. Envía tus productos a Allegro
  6. Comprueba si hay errores en los listados de productos

Preparación

  • Establece las políticas de ventas: Asegúrate de haber establecido las políticas, que se encuentran en Configuración de ventas en tu cuenta Allegro. Necesitarás los nombres de estas políticas durante la configuración en Channable:
    • Una política de garantía
    • Una política de devolución
    • Una configuración de envíos
    • Una política para las Condiciones de reclamación
  • Conoce sobre las tarifas y comisiones: obtén información sobre las tarifas y comisiones de venta para gestionar mejor tu estrategia de ventas. Aquí encontrarás información sobre las tasas y comisiones de venta. 
  • Visita el centro de ayuda de allegro para vendedores internacionales: Antes de proceder con la configuración de la API, lee los conceptos básicos sobre la venta en allegro, las solicitudes de configuración de cuenta y los consejos de navegación aquí. Adicionalmente, recomendamos leer los siguientes artículos: 

Paso 1: Crea una nueva conexión

Para crear una nueva conexión Allegro, sigue los pasos que se indican a continuación:

  1. Empieza por navegar hasta la página de la API dentro de tu proyecto y haz clic en el botón «+Agregar nueva API». Esta acción te redirigirá a la página de conexiones de tu compañía.
  2. En la página de conexiones, selecciona «+Agregar una nueva conexión».
  3. Busca la conexión «Allegro» haciendo clic a través de las páginas, después de encontrar la conexión «Allegro», proporciona una etiqueta para esta nueva conexión.
  4. Haz clic en «Conectar con Allegro». Serás redirigido a Allegro para el siguiente paso. Una vez redirigido, inicia sesión con las credenciales de Allegro.

Después de iniciar sesión correctamente, la conexión con Allegro está establecida y disponible para su uso. Volverás a la configuración de la API.

Paso 2: Crea la API

Al regresar, debes seleccionar tu nueva conexión con Allegro y continuar configurando tu API.

  1. Configurar los ajustes de la API:
    • Asigna un nombre a tu API
    • Elige el ID único por ítem. (recomendamos el campo 'id')

2. Crear API: Haz clic en «Continuar» para crear la nueva API de Allegro.

Paso 3: Crea tu listado de productos

Nota: En los próximos meses iremos desplegando gradualmente Marketplaces V2. Si tu API está en Marketplaces V1, estos pasos pueden ser diferentes. Consulta este artículo para obtener más información. 

Para configurar tu API, sigue los pasos que se describen a continuación. Haz clic en cada paso para ampliar y ver las instrucciones detalladas, que te guiarán a través de todo el proceso.

1. Categorización

Para que se creen los datos de tus productos, estos necesitan una categoría. Añade categorías a tus productos utilizando la función de generar categorías, o crea nuevas categorías desde cero.

  • Smart Categorization: Esta función asigna automáticamente categorías a tus productos basándose en criterios predefinidos, simplificando el proceso de categorización.
  • Categorización manual: Asigna manualmente categorías a tus productos estableciendo reglas específicas. Puedes crear filtros detallados para mapear cada producto a la categoría correcta.
  • Productos sin Categorizar: Revisa y categoriza cualquier ítem que permanezca sin categorizar para asegurar que todos los productos estén organizados correctamente.

Haz clic aquí para leer más sobre la Categorización en APIs.

2. Reglas

Crea diferentes reglas para optimizar los datos de tus productos. Para obtener ejemplos, consulta nuestro artículo de ayuda sobre reglas comunes.

  • Configuración de reglas: Configura varias reglas para refinar los datos de tus productos. Esto puede incluir filtrar, modificar o mejorar los campos de datos para cumplir con los requisitos del Marketplace

Haz clic aquí para leer más sobre las Reglas en las API.

3. Paso Crear

El paso Crear en Channable te permite configurar todos los atributos necesarios para tus ítems, asegurando que los datos de tu producto se alinean con los requisitos del Marketplace. Este paso es crucial para el éxito de los listados de productos y para evitar errores.

3.1 Visión general

  1. Accede al paso Crear: Comienza accediendo a la interfaz centralizada del paso Crear. Aquí es donde gestionarás y mapearás todos los atributos del producto.
  2. Identifica los campos obligatorios y opcionales: Los campos obligatorios están resaltados en rosa, lo que indica que son esenciales para listar tus productos. Los campos opcionales están marcados en naranja y pueden rellenarse en función de las necesidades específicas.

3.2 Rellenar atributos compartidos

  1. Rellenar atributos compartidos: Introduce detalles comunes que se aplican a todos los productos, como EAN, precios y títulos. Este paso garantiza la uniformidad de la información básica del producto en todos tus listados.
    • Utiliza Valores estáticos o dinámicos:
      • Valores estáticos: Introduce directamente valores que permanecen constantes, como la marca o el fabricante.
      • Valores dinámicos: Utiliza campos que se actualizan automáticamente en función de los datos vinculados, ideales para variables como los niveles de stock o los precios.

Una vez introducidos los valores deseados para los atributos compartidos, procede a los atributos específicos de la categoría.

3.3 Especificar atributos específicos de la categoría

  1. Selecciona la categoría del producto: Elige la categoría relevante para tu producto, como ropa o muebles.
  2. Introducir atributos específicos de la categoría: Rellena los atributos específicos de la categoría seleccionada, como la talla para la ropa o las dimensiones para los muebles. Este paso ayuda a afinar tus listados de acuerdo con los requisitos de la categoría. Aquí también puedes utilizar valores estáticos o dinámicos.

Haz clic aquí para leer más sobre el Paso Crear

 

4. Paso Calidad

El paso de Calidad proporciona información instantánea sobre la calidad de la configuración, destacando los errores obligatorios y opcionales para garantizar que los datos de tus productos cumplen las condiciones de los Marketplaces.

Acciones:

  • Ver ítems: Ver productos con problemas específicos.
  • Ver en Crear: Redirecciona al paso Crear para mapear la información que falta.
  • Establecer categorías: Dirige al paso de categorías para categorizar los artículos.
  • Mostrar fuente: Disponible para campos ID, redirige al paso de configuración.

Haz clic aquí para leer más sobre el paso Calidad

5. Paso Vista Previa

El paso de vista previa muestra los atributos mapeados para múltiples ítems, resaltando los errores antes de exportar al Marketplace.

Características

  • Búsqueda y filtrado: Encuentra productos específicos o filtra por mensaje de error/categoría.
  • Resumen de ítems: Muestra todos los ítems a exportar; puedes filtrar para mostrar sólo los ítems con errores
  • Vista previa detallada del producto: Muestra la información que falta y las acciones dinámicas para corregir errores.

Lista de verificación para finalizar los atributos

  • Revisa los atributos compartidos: Comprueba que se han rellenado todos los atributos compartidos obligatorios.
  • Revisar los atributos específicos de la categoría: Asegúrate de que se han rellenado todos los atributos obligatorios específicos de la categoría.
  • Comprueba si hay errores: Corrige los campos marcados en rojo.

Haz clic aquí para leer más sobre el paso Vista previa.

6. Paso de Resultados

La pestaña de resultados proporciona una visión general de los resultados de la configuración de la API, incluidas las cargas correctas, los errores y una vista previa de los productos que se mostrarán. Esta pestaña garantiza que los datos de tus productos se procesan correctamente e identifica cualquier problema que deba resolverse.

  • Visión general: La pestaña de resultados muestra el estado de tus listados de productos, resaltando errores y problemas para obtener información detallada.
  • Vista previa de productos: Muestra una visión general de los productos que se enviarán al Marketplace, permitiendo la verificación de los atributos rellenados correctamente.
  • Exitosos: Enumera los productos procesados correctamente y listos para su inclusión en el listado, confirmando el cumplimiento de los requisitos del Marketplace.
  • Errores: Identifica los errores durante el procesamiento, proporcionando información detallada para solucionar y resolver los problemas.

Las pestañas opcionales, como errores de repricer, historial de eventos de repricer, actualizaciones de stock y actualizaciones de cumplimiento, sólo aparecen si son relevantes para la API que estás utilizando. Haz clic aquí para leer más sobre el paso Resultado. 

Requisitos adicionales para Allegro

La siguiente información es específica para Allegro, discutimos por pestaña lo que debes tener en cuenta.

Pestaña de ítem

  • Divisa: Asegúrate de que la moneda coincide con el mercado al que te diriges (por ejemplo, Polonia ⇾ PLN).

Pestaña de Entrega y envío

  • Tiempo de gestión: Allegro utiliza formatos específicos para el tiempo de gestión.
    Puedes rellenar manualmente un tiempo de gestión fijo para todos tus productos en el paso Crear. Los valores aceptados son:
    Formato Tiempo de gestión
    PT0S Immediately
    PT24H 24 horas
    PT2D 2 días
    P3D 3 días
    P4D 4 días
    P5D 5 días
    P7D 7 días
    P10D 10 días
    P14D 14 días
    P21D 21 días
    P30D 30 días
    P60D 60 días
    Si tienes diferentes tiempos de gestión, configura una regla para insertar dinámicamente el tiempo de gestión correcto para cada ítem.

Imágenes y descripción

  • Formato de las descripciones: Allegro requiere que las descripciones utilicen HTML. Para evitar errores, asegúrate de que tus descripciones incluyen las siguientes etiquetas HTML:
    HTML Tag Uso
    <h1> Título
    <h2> Subtítulo
    <p> Párrafo
    <ul> Viñetas o bullet points
    <ol> Lista enumerada
    <li> Producto en una lista
    <b> Texto en negritas
    Puedes crear descripciones detalladas utilizando estas etiquetas, o encapsular todo tu campo de descripción dinámica de una sola vez creando una regla como la que se muestra a continuación:

    Opciones adicionales

    • Políticas de venta: En la pestaña 'Servicios postventa' es donde puedes enviar las políticas de venta. Allegro vinculará tus productos a las políticas de venta que hayas configurado en tu cuenta de vendedor Allegro utilizando los nombres de estas políticas. Para asegurarte de que cada producto está vinculado a la política de venta correcta, rellena los nombres de cada una de estas políticas en sus campos correspondientes creando un valor manual. Si utilizas varias políticas de venta, añade nuevos campos en tu mapeo de importación y rellena los nombres de las políticas utilizando reglas dinámicas. 

 

Información adicional

    • Dejar campos vacíos: Allegro rellenará por sí mismo un conjunto específico de campos en caso de que estos estén vacíos. Por ejemplo: el campo "Formato de modo de venta" se establecerá como "COMPRAR_AHORA" si el campo enviado está vacío. O cuando dejes vacío el campo "Fecha de inicio de la publicación", Allegro lo leerá como "La oferta se activará inmediatamente".

    • Estructura padre/hijo: Allegro gestiona las estructuras padre/hijo basándose en la información del producto incluida en tus listados. No necesitas configurar nada en Channable para crear listados agrupados.

  1.  

Paso 4: Envía tus productos a Allegro

Ya casi está, tus listados de productos están listos para ser enviados. Si no has activado tu proyecto, ve a Configuración > Configurar tienda en la parte izquierda de la pantalla y haz clic en "Activar tienda". Después, vuelve a la vista general de APIs y ve a «Tu nombre de API Allegro» > Configuración, selecciona «Activar API». Una vez completado este paso, vuelve a la vista general de APIs y selecciona el botón azul «Actualizar» para enviar tus listados de productos a Allegro.

Paso 5: Comprueba si hay errores en los listados de productos

Para revisar si hay errores, ve a la página de resultados de la API > pestaña Errores, donde verás qué listados de productos tienen errores. Al hacer clic en el específico, se mostrará más información sobre lo que está causando el error.

Importante: Allegro no arrojará todos los errores en una sola vez, por lo que es posible que necesites un par de actualizaciones más para que tus productos estén publicados y actualizados.

 

Errores comunes y soluciones

Para ayudarte a manejar eficientemente los errores comunes al usar Channable con Allegro, hemos detallado algunos errores típicos y sus soluciones a continuación. Esta tabla proporciona pasos claros y prácticos para resolver estos fallos.

Tipo de error Descripción Solución
VALIDATION ERROR Generado por Allegro para evitar repetidas actualizaciones del exportador por errores evitables (por ejemplo, campos de precio vacíos o etiquetas HTML incorrectas).

Allegro tiene un conjunto específico de características HTML que admite, como se describe aquí.

Allegro espera que la descripción esté en formato HTML, por lo que eliminar todo el HTML no resolverá el problema.
Channable VALIDATION ERROR
 		Generado por Channable para evitar repetidas ejecuciones del exportador por errores evitables.

Corrige los datos asociados que aparecen en el mensaje de error para resolver este problema.
PARAMETER_MISMATCH Se produce cuando el código EAN/GTIN ya se conoce en Allegro, pero un atributo enviado no coincide con el valor esperado de Allegro. Cambia el valor del atributo por el valor sugerido que aparece en el mensaje de error.
CATEGORY_MISMATCH Similar a Parameter Mismatch, pero para categorías. Allegro espera un ítem en una categoría específica, pero se envía una categoría diferente. Cambia la configuración de tu categoría para que coincida con el valor correcto mostrado en el mensaje de error.
Attribute Value Error Channable intenta crear un nuevo valor permitido para un atributo, pero Allegro indica que el valor ya es conocido con diferente capitalización o espaciado. Modifica el valor del atributo para que coincida con los valores de la lista de «valores permitidos» de Allegro, incluidas las mayúsculas y el espaciado.