Configurar una API de Carrefour España

Nota I: Los códigos EAN son obligatorios en Carrefour. Asegúrate que tus códigos EAN sean válidos para todos tus productos, sino no se pueden crear los listados de productos en Carrefour. 

Nota II: Por medio de Channable, puedes crear una conexión API con Carrefour Spain y no con otros países.

Paso 1: Genera tus credenciales API en tu cuenta de Carrefour 

Carrefour API esta basada en la plataforma Mirakl. Esto significa que debes de tener una cuenta en Mirakl para conectar y sincronizar tu lista de productos en Carrefour.

Dentro de tu cuenta de Mirakl Carrefour, navega a My user settings, esto haciendo clic en tu correo electrónico en la parte superior derecha.  Luego, haz clic en la pestaña "API key". Allí, puedes hacer clic en "generate API key" en el caso de que no exista uno. Si ya existe una, entonces puedes utilizar esa misma. Copia la API key ya que la necesitas para el siguiente paso.

Luego, necesitas tu Shop ID en tu cuenta del seller central. Primero, selecciona la tienda a la cual quieres enviar tus productos en la parte superior derecha. Luego, haz clic en My Account > Settings para encontrar el número ID de tu tienda. Guarda este ID también ya que lo necesitas para el siguiente paso.

Paso 2: Crea una nueva conexión en Channable con la API de Carrefour

Ve a Channable, abre el proyecto y haz clic en APIs > Agregar nuevo API. Allí podrás crear una nueva conexión tal y como se ve en la siguiente imagen. 

Después de escoger Carrefour serás redirigido a la siguiente imagen, donde puedes especificar el nombre de la conexión API dentro de Channable. Luego, debes de rellenar la API Key y Shop ID para crear la conexión.

Paso 3: Crea tu listado de productos en Channable

Una vez hecha la conexión con Carrefour API, puedes empezar a crear la planilla de los productos.

1. Categorías
   Para el listado de tus productos, debes categorizar tus productos con las categorías disponibles de Carrefour. Agrega las categorías de tus productos usando la funcionalidad para auto generar categorías o puedes crearlas de manera manual.
2. Reglas
   Crea distintas reglas para optimizar el listado de tus productos. Para ver ejemplos, recomendamos que visites el siguiente artículo.
3. Crear
   Aquí, puedes crear la plantilla de tu listado de productos. Sólo debes seleccionar los campos que quieres utilizar para la plantilla. Por ejemplo, para el campo Título utiliza el título de tus productos. Cuando termines, debes de guardar la plantilla.
   
   ¡Consejo! Revisa el signo de interrogación, estos te sugieren el contenido del campo que Carrefour requiere.
   
   Nota: Carrefour requiere que incluyas la categoría de envío (Categoría Logística) de los productos en función del peso. Puedes añadir dicha categoría a tus productos siguiendo las especificaciones de esta tabla:
   

   Peso de los Productos	Categoría Logística
   De 0 a 2 kilos	A**
   De 2 a 5 kilos	B**
   De 5 a 10 kilos	C**
   De 10 a 15 kilos	D**
   De 15 a 20 kilos	E**
   De 20 a 30 kilos	F**
   De 30 a 40 kilos	G**
   De 40 a 50 kilos	H**
   De 50 a 60 kilos	I**
   Más de 60 kilos	J**

   
   
   
4. Atributos
   Luego, debes de revisar que los campos rojos en el paso de atributos estén completados. Ver la siguiente imagen. Presiona aquí para ver un artículo detallado sobre como rellenar los atributos.

Paso 4: Envía los datos de tus productos a Carrefour

Debes de activar el proyecto en Channable en el cual estas trabajando. Para hacer esto, asegúrate de primero de estar dentro del proyecto y luego haz clic en "Configuración" al lado izquierdo del menú en Channable y activa el proyecto/tienda. Luego, regresa a las APIs, haz clic en la API que creaste y la activas. Regresa a la vista previa de las conexiones APIs y haz clic en "Actualizar" para mandar el listado de productos a Carrefour.

Nota: los vendedores ya pueden enviar sus nuevos productos a través de la API de Carrefour España, sin necesidad de enviar una plantilla CSV de forma manual a Carrefour. Aún así, Carrefour sigue manteniendo como requisito que cualquier vendedor que quiera dar de alta nuevos productos debe proporcionarles una copia de su feed en formato excel. Ellos serán los encargados de comprobar y validar que los nuevos productos son aptos para ser listados en Carrefour.es

Paso 5: Revisa si hay errores con los datos de tus productos

Una vez enviados tus productos a Carrefour, puedes revisar posibles errores en el paso de "Vista previa" y luego en la pestaña "Errores".  Ahora puedes revisar los productos que no fueron publicados en Carrefour debido a un error. Haz clic en el error para obtener más información sobre el problema y revisa las soluciones para estas aquí.