Conectar tu tienda a un proveedor por API: stock, tarifas e imágenes al día

Importar el catálogo de un proveedor una vez es un trabajo de días. Mantenerlo al día es un trabajo que no se acaba: cambian los precios, se agota el stock, salen colores nuevos, se retiran referencias. Si lo haces a mano, tu tienda siempre va por detrás, y vendes lo que ya no hay o a un precio que ya no es.

Cuando el proveedor ofrece una API, la tienda puede consultarla de forma continua. Este artículo trata esa sincronización permanente; si tu proveedor solo te da ficheros CSV o XML, tenemos otra guía dedicada a ese caso.

Qué cambia con una API frente a un fichero

• Datos al momento: el stock se consulta cuando hace falta, no cuando el proveedor genera el fichero.
• Consultas parciales: se puede pedir solo el stock o solo los precios, sin descargar el catálogo entero.
• Datos ricos: muchos proveedores publican en la API cosas que no caben en un CSV: tarifas por tramos, técnicas de personalización, imágenes por color, textos en varios idiomas.
• Más exigente: hay que gestionar autenticación, límites de peticiones, errores de red y cambios de versión de la API.

Qué sincronizar y con qué frecuencia

Lo que no tiene sentido es descargar todo el catálogo cada hora: cargas el servidor del proveedor, el tuyo, y te arriesgas a superar sus límites.

Precio de coste no es precio de venta

El proveedor te da su tarifa; tú decides tu precio. La conexión necesita reglas claras:

• Margen por categoría, marca o tramo de precio, no uno único para todo.
• Tramos por cantidad: en sectores como el textil o el artículo promocional, el coste baja mucho a partir de cierto volumen. Esos tramos deben convertirse en precios por cantidad en tu tienda.
• Redondeos que no dejen precios como 12,37 €.
• Precios que no se tocan: si has bajado a mano un producto para una campaña, la sincronización no debería pisarlo sin avisar.

Stock: el tuyo y el del proveedor

Si además tienes género en tu almacén, mezclar tu stock con el del proveedor en un solo número engaña al cliente: no es lo mismo «lo tengo y sale hoy» que «lo pido a fábrica y tarda una semana». Lo correcto es separarlos y mostrar un plazo distinto según de dónde salga cada unidad. Y decidir qué hacer cuando se pide más de lo que suman los dos: bloquear la venta o pedir que contacte para un presupuesto.

Combinaciones, idiomas e imágenes

• Colores y tallas deben convertirse en combinaciones de PrestaShop emparejadas con los atributos que ya tienes, no en atributos nuevos duplicados («Rojo», «rojo», «ROJO»).
• Imágenes por color, asociadas a su combinación.
• Textos en cada idioma activo de tu tienda, si el proveedor los publica.
• Categorías: el árbol del proveedor no es el tuyo. Hay que emparejar sus categorías con las tuyas.
• Características (material, medidas) como características de PrestaShop, para que funcionen en los filtros.

Personalización

En el artículo promocional o el textil personalizado, el producto no se vende solo: se vende con un marcaje. El proveedor publica técnicas, zonas, número de colores y costes (a menudo con costes fijos de preparación). Llevar eso a la tienda permite que el cliente elija la técnica y vea el precio final calculado, en lugar de pedir presupuesto para todo.

Errores frecuentes

1. Sobrescribir lo que has mejorado: textos SEO o fotos propias que la sincronización vuelve a cambiar por las del proveedor.
2. No registrar lo que cambia: sin historial, no sabes por qué un precio subió.
3. Sincronizar en horas punta y ralentizar la tienda.
4. No avisar cuando la API falla: la sincronización se para y nadie lo nota hasta que se vende algo agotado.
5. Credenciales en el código: las claves de la API van en la configuración, nunca en ficheros que se copian o se suben a un repositorio.

Checklist

1. Tienes claro qué datos da la API y con qué límites.
2. Reglas de precio por categoría y tramos por cantidad.
3. Stock propio y del proveedor separados, con plazos distintos.
4. Productos retirados se desactivan, no se borran.
5. Atributos y categorías emparejados con los tuyos.
6. Historial de cambios y aviso si la sincronización falla.

Cómo resolverlo en PrestaShop

RKR Conector Makito es un ejemplo de este tipo de conexión: un paquete con un hub que compara y escribe en la tienda, el conector con la API de Makito, un módulo opcional de múltiplos de venta y RKR Supplier Stock (opcional, PrestaShop 9). Trae los cuatro tramos de tarifa del proveedor (por unidad y desde 500, 2.000 y 5.000 unidades) convertidos en precio de venta con tus reglas y en precios por cantidad, los textos, colores y características en los siete idiomas que publica Makito, y permite que el cliente añada al carrito el producto con su marcaje y el precio ya calculado. Con RKR Supplier Stock, tu stock y el de Makito se guardan por separado, por combinación, con mensajes y plazos distintos para cada caso, y por defecto no se vende más de lo que suman los dos. Sin ese módulo, el conector funciona en PrestaShop 1.7.6 a 9.x. Para otros proveedores, los conectores a medida que acompañan este artículo siguen el mismo planteamiento.