Este artículo explica cómo configurar una API de Winkelstraat paso a paso.
Paso 1: Solicita las credenciales de la API de Winkelstraat.nl
Para Winkelstraat se necesita un ID de cliente y una clave secreta para hacer una conexión API válida. Para obtener estas credenciales, debes solicitarlas enviando un correo electrónico a contentapi@winkelstraat.nl.
Cuando hayas recibido las credenciales de Winkelstraat, puedes crear la conexión API en Channable.
Paso 2: Crea una conexión API de Winkelstraat.nl en Channable
Para crear una nueva conexión con Winkelstraat, ve al proyecto en el que estás trabajando y navega a la pestaña APIs. Haz clic en "+Agregar nuevo API" y luego en "+Agregar nueva conexión". Ahora puedes seleccionar Winkelstraat:
Después de seleccionar Winkelstraat, dale un nombre (etiqueta) a la conexión y rellena tu ID de cliente y la clave secreta:
Por último, haz clic en "Conectar con Winkelstraat.nl" y la conexión será validada y creada. Ahora ya podrás empezar a configurar tu listado de productos.
Paso 3: Crea tu listado de productos en Channable
Sigue los cuatro pasos siguientes para configurar tu listado de productos para Winkelstraat.nl.
1. Categorías
Configura las categorías de Winkelstraat para tus productos utilizando la función de generar categorías o crea nuevas categorías desde cero.
2. Reglas
Crear reglas para optimizar la información de tus productos. Para ver ejemplos, puedes echar un vistazo a nuestro artículo de soporte de las reglas más comunes.
3. Crear
En el paso Crear puedes encontrar nuestra plantilla preestablecida para los listados de productos. Todo lo que tienes que hacer es rellenarlo haciendo clic en el campo que necesites y seleccionando el valor correspondiente. Por ejemplo, el campo "Nombre" debería mostrar el "Título" de tu producto y así sucesivamente.
Nota: el campo de ID de grupo de ítems es obligatorio. Por lo general, el campo que puedes utilizar aquí se denomina "item_group_id" o "parent_id".
4. Atributos
A continuación hay que rellenar los atributos por categoría en el paso Atributos. Necesitas rellenar al menos los atributos obligatorios, estos se mostrarán en rojo cuando estén vacíos o rellenados con un valor inválido.
Una explicación más detallada de lo que hay que hacer en el paso Atributos se puede encontrar en nuestro artículo de soporte de Atributos.
Nota: Por el momento el campo EAN no es obligatorio para que sus artículos sean aceptados por Winkelstraat, pero es altamente recomendado.
Nota II: Las imágenes y la descripción también deben ser añadidas en el paso de Atributos. Aunque no se muestren como campos rojos cuando están vacíos, en realidad son obligatorios.
Paso 4: Manda tu listado a Winkelstraat.nl
Una vez que hayas terminado de configurar tu listado de productos, puedes empezar a enviarlos a Winkelstraat.nl.
Si aún no has activado el proyecto, dirígete a "Instalación> Configuración del proyecto" y activa el proyecto. A continuación, vuelve a la pestaña de APIs, dirígete al paso de Configuración de tu API de Winkelstraat y activa la API. Cuando hagas clic en "Actualizar" en la vista general de las APIs, tus productos se enviarán a Winkelstraat.nl.
Nota: En Winkelstraat no es posible eliminar productos de tu cuenta, sólo ponerlos en stock=0, lo que inactiva el producto en la plataforma. Por lo tanto, si por alguna razón quieres eliminar tus productos de Winkelstraat, sólo tienes que enviar los productos de nuevo, pero con stock 0.
Paso 5: Comprueba tus productos en el paso de Resultado
Una vez que la API haya terminado de ejecutarse, puedes comprobar los resultados en el paso "Resultados" de tu API de Winkelstraat. Verás cuántos elementos se han enviado con éxito y si se ha devuelto algún error. Los artículos con un error no se han publicado en Winkelstraat. Haz clic en un error para ver cuál es el mensaje de error y qué productos tienen ese error.
Puedes intentar solucionar los errores optimizando o cambiando los datos de los productos que envíes a Winkelstraat en los pasos de Categorías, Reglas, Crear y Atributos. Después de la optimización, ejecuta la API de nuevo y comprueba los resultados.