Más opciones para buscar y editar tus productos a través de la API
Esta actualización amplía las posibilidades de la API para facilitar la sincronización del catálogo con sistemas externos como PIMs o ERPs, incorporando nuevas operaciones masivas y más opciones de búsqueda.
Esta actualización amplía las posibilidades de la API para facilitar la sincronización del catálogo con sistemas externos como PIMs o ERPs, incorporando nuevas operaciones masivas y más opciones de búsqueda.
Nuevo endpoint: Bulk Update de combinaciones
Nuevo endpoint para realizar actualizaciones masivas de combinaciones (variantes) de producto, pensado principalmente para actualizar datos propios de la variante, como precios, stock u otros atributos de combinación.
A diferencia del endpoint de Bulk Product Upsert, que trabaja a nivel de producto y variantes realizando el matching por id o internal_id, este endpoint actúa directamente a nivel de combinación (variant). Y permite identificar las variantes utilizando distintos criterios de matching como id, internal_id, ean o sku + supplier, lo que facilita trabajar con catálogos gestionados desde sistemas externos.
El procesamiento se realiza de forma asíncrona, creando una tarea (Job) en segundo plano que permite manejar grandes volúmenes de actualizaciones sin afectar al rendimiento de la tienda. Resulta especialmente útil para integraciones con PIMs, ERPs, sistemas de proveedores o herramientas de gestión de inventario que necesitan mantener actualizada esta información de forma masiva.
Recuerda que puedes consultar los jobs y sus estados en el backoffice: configuración > opciones avanzadas > Jobs.
Nuevo endpoint: Vincular productos con sistemas externos
Nuevo endpoint diseñado exclusivamente para asociar los productos ya existentes en tu tienda OpenTiendas con los identificadores utilizados en sistemas externos.
Este endpoint permite actualizar el identificador alternativo (internal_id) de productos y variantes utilizando distintos criterios de identificación como ean o sku + proveedor. Está pensado principalmente para procesos de sincronización inicial entre la tienda y un sistema externo. Por ejemplo, en escenarios en los que los productos ya existen en la web y posteriormente se quiere poner en marcha un ERP, PIM u otro sistema de gestión, este endpoint permite establecer la correspondencia entre ambos catálogos sin necesidad de recrear los productos.
Una vez vinculados los identificadores, los sistemas externos pueden utilizar posteriormente endpoints de actualización masiva (como el bulk upsert products) para mantener sincronizada la información del catálogo.
Nuevas opciones de filtrado por slug
El endpoint List products incorpora ahora la posibilidad de filtrar resultados utilizando el slug del producto.
Además, ahora también es posible enviar múltiples slugs como parámetro de búsqueda, lo que permite consultar varios productos en una sola petición. Esta mejora se aplica también al resto de endpoints donde ya existía soporte para filtrado por slug, como categorías y marcas.
Esto facilita las integraciones con sistemas externos o frontends que utilizan el slug como identificador público del producto.
Posibilidad de modificar el slug
Ahora también es posible modificar el slug (slug_base) a través de a la API en Productos, marcas y categorías.
👌Más detalles en el blog técnico
Consulta el blog de opentiendas.dev para ver el detalle completo de estos nuevos endpoints y mejoras en la API, junto con ejemplos de uso y la documentación actualizada. Última versión de la API 1.2.2.