¿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.
Actualización importante para los usuarios de la API de Conrad
Conrad utiliza SKU en lugar de EAN para crear ofertas. Nuestro paso de Crear no refleja esto correctamente.
Para publicar ofertas en el Marketplace, necesitas proporcionar el SKU en el campo EAN. Estamos actualizando nuestra API para incorporar esto, pero hasta que se implementen los cambios, sigue estos pasos para una correcta integración:
-
Envío de ofertas a Conrad: Introduce el SKU en el campo EAN en el paso Crear. Aunque esto pueda parecer inusual, ahora mismo esta es la forma correcta de proporcionar el ID necesario.
- Para antiguos usuarios de feeds: Si anteriormente utilizabas un feed, es posible que haya un mapeo de atributos en tu tienda Mirakl que entre en conflicto con la nueva integración de la API. Asegúrate de eliminar o borrar dichos mapeos antes de continuar. En nuestra guía de Mirakl explicamos cómo eliminar el mapeo de Mirakl para un error diferente, pero el mismo proceso se aplica aquí.
Estos cambios en la API requerirán algo de tiempo, así que, mientras tanto, sigue las instrucciones anteriores para garantizar que tu API funcione correctamente.
Conrad, empresa familiar desde hace casi 100 años, suministra tecnología innovadora y fiable a clientes de toda Europa. Con una oferta de más de 1.5 millones de productos de los principales fabricantes, Conrad da servicio a clientes industriales, profesionales, instituciones educativas, intermediarios y particulares.
Esta guía te guiará a través de los pasos necesarios para configurar una API entre Channable y Conrad.
Tabla de contenido
- Paso de preparación
- Crea una nueva conexión
- Crea la API
- Crea listados de productos
- Envía tus listados de productos a Conrad
- Comprueba si hay errores en tus listados de productos
Paso de preparación
Para garantizar una configuración sin problemas y evitar cualquier problema, revisa y sigue estas importantes directrices:
- Configuración de la cuenta: Para vender tus productos en Conrad, necesitas una cuenta de vendedor profesional. Sigue las directrices de creación de cuenta aquí.
- Países compatibles: Actualmente están disponibles los siguientes países: Alemania, Italia, Francia, Países Bajos, Austria y República Checa.
- Múltiples APIs de Conrad: Cada cuenta de tienda, es 1 canal de ventas. Si quieres vender en varios países, tienes que:
- Abrir una nueva cuenta de tienda.
- Crear una nueva API de Conrad en Channable para conectar con esa cuenta de tienda.
Después de completar y revisar todos los puntos de preparación, estás listo para ir al primer paso.
Paso 1: Crea una nueva conexión
Para crear una nueva conexión Conrad, sigue los pasos que se indican a continuación:
- Empieza por navegar hasta la página API dentro de tu proyecto y haz clic en el botón "+Añadir nueva API ". Esta acción te redirigirá a la página de conexiones de tu compañía.
- En la página de conexiones, selecciona "+Añadir una nueva conexión".
- Busca la conexión "Conrad" haciendo clic a través de las páginas, después de encontrar la conexión "Conrad", proporciona una etiqueta para esta nueva conexión.
4. Haz clic en "Conectar con Conrad" Se te redirigirá a Conrad para el siguiente paso. Una vez redirigido, inicia sesión con las credenciales de Mirakl/Conrad. - Después de iniciar sesión con éxito, la conexión con Conrad está establecida y disponible para su uso. Volverás a la configuración de la API.
Paso 2: Crea la API
Una vez de vuelta, tienes que seleccionar tu nueva conexión con Conrad y continuar configurando tu API.
-
Configura los ajustes de la API:
- Asigna un nombre a tu API
- Elige el ID único por ítem. (recomendamos el campo 'id')
- Selecciona el idioma de tu API
- Crear API: Haz clic en "Continuar" para crear la nueva API de Conrad.
Paso 3: Crea listados de productos
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
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
- 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.
- 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
-
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.
-
Utiliza Valores estáticos o dinámicos:
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
- Selecciona la categoría del producto: Elige la categoría relevante para tu producto, como ropa o muebles.
-
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.
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.
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 Conrad
La siguiente información es específica para Conrad, comentamos por pestaña lo que debes tener en cuenta.
Pestaña de "Ítem"
- Plazo de expedición para enviar: El plazo de envío indica el tiempo necesario hasta que el paquete se entrega al proveedor de servicios de envío. Si el valor permanece vacío, Conrad asume que el envío se realiza el mismo día. En la Tienda Conrad, se añaden 1-2 días al plazo de entrega especificado.
-
Categoría de envío: Las clases logísticas determinan los respectivos gastos de envío de tus productos. Puedes configurar hasta ocho clases de envío diferentes. Los valores correctos deben introducirse en el atributo "Categoría de envío" en el paso Crear. A continuación se muestran los valores posibles, estos también se pueden encontrar como valores estáticos al pasar el cursor sobre el símbolo (?) junto al atributo "Categoría de envío"
Valores de categoría de envío ID categoría de envío Descripción Small & Medium 1 SM1 10 kg y menos Small & Medium 2 SM2 Más de 10 kg hasta 15 kg Small & Medium 3 SM3 Más de 15 kg hasta 31.5 kg Bulk Shipment bulk De 31.5 kg a 40 kg Pallet Shipment pallet Más de 40 kg hasta 500 kg Extra Logistic Class 1 extra1 Precio específico para Logística extra 1 Extra Logistic Class 2 extra2 Precio específico para Logística extra 2 Free shipping free Envío gratuito Fulfillment Small & Medium 1 FSM1 Cumplimiento de 10 kg o menos Fulfillment Small & Medium 2 FSM2 Cumplimiento de más de 10 kg a 15 kg Fulfillment Small & Medium 3 FSM3 Cumplimiento de más de 15 kg a 31.5 kg Fulfillment Bulk Shipment fbulk Voluminosos de más de 31.5 kg a 40 kg Fulfillment Pallet Shipment fpallet Pallet de más de 40 kg a 500 kg Fulfillment Extra Logistic 1 fextra1 Cumplimiento adicional 1 Fulfillment Extra Logistic 2 fextra2 Cumplimiento adicional 2 Fulfillment Free shipping fulfree Cumplimiento Envío gratuito (sin gastos de envío) OCI assortment oci Envío OCI (sin gastos de envío) Nota: Las clases logísticas adicionales 1 y 2 sólo están activadas en Alemania.
-
Se aplica el cobro revertido: El procedimiento de cobro revertido anula la obligación de pagar el IVA correspondiente a las entregas: No es la empresa que realiza la entrega la que paga el IVA a la Agencia Tributaria, sino el cliente. El requisito previo para la aplicación del cobro revertido es que el cliente sea también titular de un número de identificación a efectos del IVA.
Indica el valor ''false'' o ''true'' para cada oferta, en función de si se aplica o no esta normativa. - ID de almacén: Devuelve la ubicación del almacén desde el que se envía el artículo correspondiente. La configuración se realiza en el atributo "ID de almacén" en el paso Crear. Se introduce un valor de 1 a 5 en función de la configuración de las ubicaciones de almacén guardadas. El atributo de almacén está destinado a una cifra específica, puedes especificar hasta 5 almacenes en tu cuenta Conrad. Este atributo decide de qué almacén procede finalmente el artículo seleccionando el identificador 1-5
- Unidades de medida: El atributo "Unidad de medida" especifica la unidad utilizada para calcular el precio por unidad de un producto. Esto garantiza que los consumidores puedan comparar costes fácilmente. Para productos vendidos por peso, volumen, longitud o área, incluye precios unitarios utilizando unidades comunes como kilogramos (KG), litros (L), metros (M) o metros cuadrados (M2). Asegúrate de que el atributo "Unidad de medida" de Channable está correctamente rellenado para reflejar estos estándares.
-
Cantidad: En Channable, este atributo "Cantidad" especifica la unidad de medida del producto que se vende. Por ejemplo, si vendes un paquete de 4 tapones, introduce "4" como cantidad. Esto permite a Conrad mostrar tanto el precio por unidad como el precio total del paquete de 4 unidades. Puedes lograr esto para productos específicos:
-
Creando un campo de proyecto
-
Utilizarlo en una regla y rellenarlo con un valor
-
A continuación, selecciona el campo en el atributo "Cantidad". Consulta este artículo para obtener más información sobre los campos dinámicos.
-
- Impuesto por copia privada: En Francia, el impuesto por copia privada es una obligación legal que compensa a los autores y titulares de derechos por las copias privadas realizadas con medios de almacenamiento como CD, DVD, discos duros externos y memorias USB. Este canon se incluye en el precio de venta de medios de almacenamiento y se distribuye a los creadores y titulares de derechos a través de las entidades de gestión colectiva. Los vendedores deben especificar el importe del canon de copia privada en euros para cada artículo de esta categoría.
- Eco-contribuciones: Francia ha introducido una legislación para la eco-participación. Si tu empresa opera en Francia, debes añadir eco-contribuciones a tus ofertas en el Marketplace. En este artículo encontrarás una lista de las categorías de eco-participación disponibles.
Mejores prácticas
Añadir varios valores a un atributo: cuando añadas varios valores en un campo de atributo para Mirakl Marketplaces, separa cada valor con un símbolo de barra vertical «|» para garantizar una detección y un procesamiento adecuados.
ID de producto del vendedor para productos simples: Ten en cuenta que hay dos atributos denominados 'SellerArticleId' y 'SellerProductId', respectivamente. SellerProductId' se refiere al ID de padre, mientras que 'SellerArticleId' se refiere a los artículos variantes. Para productos simples, ambos atributos deben rellenarse con el mismo valor.
Para obtener más información sobre los errores de Mirakl Marketplace, cómo hacerlo y las mejores prácticas, consulta nuestra guía específica. Haz clic aquí para leer más.
Paso 4: Envía tus listados de productos a Conrad
Ya casi está, tus listados de productos están listos para ser enviados. Si no has activado tu proyecto, ve a la configuración de tu proyecto 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 API de Conrad] > Configuración, donde activarás la API haciendo clic en "Activar API".
Una vez activada la API, vuelve a la vista general de APIs y haz clic en el botón azul "Actualizar" para enviar tus listados de productos a Conrad.
Paso 5: Comprueba si hay errores en tus listados de productos
Para comprobar si hay errores, ve a la página de resultados de la API > pestaña de Errores, donde verás qué listados de productos tienen errores. Al hacer clic en el error específico, se mostrará más información sobre lo que está causando el error. Para más información sobre el significado de los errores, lee este artículo. Además, puedes encontrar mucha información en el centro de ayuda de Conrad.