Skip to main content
La API pública de Retailgrid es la contraparte programática de los flujos de carga y exportación de la aplicación. Úsala cuando quieras mantener Retailgrid sincronizado con tus sistemas de origen de forma programada, o devolver datos enriquecidos a tu ERP y tus herramientas de BI, en lugar de subir y descargar archivos CSV a mano.

​
URL base

Todos los endpoints están bajo /v1. Los futuros cambios incompatibles se publicarán bajo un nuevo prefijo; las adiciones menores no cambiarán /v1.

​
Qué puedes hacer hoy

  • Enviar datos del catálogo: crear, modificar, eliminar y hacer upsert masivo de productos y variantes de producto.
  • Enviar transacciones: crear, modificar, eliminar y hacer upsert masivo de transacciones de ventas.
  • Enviar precios de competidores: crear, modificar, eliminar y hacer upsert masivo de precios de competidores observados.
  • Extraer catálogo y transacciones: listar productos enriquecidos y transacciones de ventas para su ingesta en ERP / BI. Incluye las columnas personalizadas añadidas en el momento de la importación.
  • Extraer precios aprobados: leer los precios finales que tu equipo aprobó en Price Approval, para sincronizarlos con tu ERP, tienda online o POS.
  • Exportar Grids: listar los Grids de tu cuenta y extraer el contenido completo de las filas de cualquier Grid, incluidas las columnas canónicas, personalizadas y de fórmula / calculadas.
  • Subir archivos CSV de forma asíncrona: enviar un CSV multipart a /v1/imports/* y consultar el estado de un trabajo (job).
  • Verificar tu clave de API: comprobar que tu clave funciona antes de conectar una canalización.
Retailgrid indexa el catálogo a nivel de SKU. item_id es el identificador único obligatorio de cada artículo y la clave que se usa para vincular las transacciones, los datos a nivel de tienda y los precios de competidores con tu catálogo. product_id es un código opcional a nivel de producto que agrupa artículos / variantes relacionados bajo un mismo producto.

​
Cuándo usar la API frente a otras vías

API pública

Para una sincronización continua, de máquina a máquina, desde tu ERP, PIM o almacén, en cualquiera de los dos sentidos.

Carga de CSV en la aplicación

Para cargas puntuales o cuando un analista lleva el control. Los mismos datos, con un flujo manual.

Conexiones de IA (MCP)

Para preguntar a un asistente de IA sobre tus Grids en lenguaje natural y actuar sobre ellos de forma interactiva, en lugar de una sincronización programada.

​
Convenciones

Vale la pena leer algunas cosas una vez antes de empezar a integrar:

​
Versionado

La versión actual es v1. Los cambios aditivos (campos nuevos, endpoints nuevos, parámetros opcionales nuevos) se publican sin previo aviso. Los cambios incompatibles se anunciarán en las novedades de la API y se publicarán bajo un nuevo prefijo de versión.