Skip links
nuevo endpoint Bulk Product Upsert de OpenTiendas

Actualizaciones masivas de catálogo: Nuevo Endpoint Bulk Upsert

¿Tardas horas en actualizar el catálogo y temes que la web se ralentice? Si gestionas el e-commerce de tu empresa conectándolo a un ERP o PIM con miles de referencias, sabes que el rendimiento y la estabilidad son críticos.

Cambiar precios masivamente o subir la nueva temporada puede suponer una carga inmensa para el servidor. En OpenTiendas sabemos que una tienda online no puede permitirse interrupciones. Por eso, hemos evolucionado nuestra API para llevar la sincronización de catálogos al siguiente nivel.

POST /api/v1/products/bulk-upsert/

{
  "products": [
    {
      "internal_id": "PROD-001",
      "price": 29.99,
      "stock": 150
    }
  ]
}
  • 🔴 Cero Interrupciones: Tu tienda sigue online y rápida mientras el sistema procesa los datos en segundo plano.
  • Monitorización Total: Nueva sección «Jobs» en el panel de control para ver el progreso en tiempo real.
  • Upsert Inteligente: Crea productos nuevos o actualiza los existentes de forma automática.
Api bulk
Api bulk para sincronización masiva

🛠️ Detalles técnicos para desarrolladores
El nuevo endpoint Bulk Product Upsert ha sido diseñado bajo un modelo asíncrono. Esto significa que, al realizar la petición, el sistema no te hace esperar a que se procesen todos los datos; en su lugar, valida el esquema y te devuelve inmediatamente un 202 Accepte

  • Método: POST.
  • Ruta: /api/v1/products/bulk-upsert/.
  • Autenticación: Requiere ApiKeyAuth.
  • Límite: Soporta payloads de hasta 10 MB por petición.

Este nuevo endpoint permite sincronizar datos usando el campo match_by. Puedes elegir identificar tus productos por su id interno o, de forma más eficiente para integraciones ERP/PIM, por su internal_id. Si el sistema no detecta una coincidencia, creará automáticamente el nuevo producto

{
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending"
}

Optimiza la sincronización de tu catálogo con el nuevo endpoint Bulk Product Upsert de OpenTiendas. Actualizaciones masivas asíncronas diseñadas para integraciones con ERP y PIM sin afectar al rendimiento de tu e-commerce.

📈 ¿Qué sucede tras enviar los datos?

Una vez que el ‘Job’ entra en cola, el sistema se encarga del trabajo pesado de forma asíncrona, permitiendo que tu tienda siga operativa sin caídas de rendimiento. Dependiendo del volumen, OpenTiendas dispara procesos automáticos internos para asegurar la consistencia del catálogo

  • Refresco de caché: Los nuevos precios y stock se propagan para ser visibles al instante para los clientes.
  • Actualización de listados: Los filtros, categorías y buscadores se reindexan automáticamente.
  • Notificaciones al sistema: Sincronización transparente con el resto de módulos del e-commerce.

Puedes monitorizar el progreso en tiempo real y consultar los logs de resultados en la nueva sección ‘Jobs’ de tu panel de administración (Configuración → Opciones avanzadas)