Saltar al contenido principal

Conecta POS y RMS con cada canal

La API de integraciones conecta tu POS y RMS con cada canal de venta donde opera tu comercio. Si has construido o usado una integración como Uber Eats Marketplace, los bloques te resultarán familiares: autenticación, tiendas, menús y pedidos. La diferencia está en el alcance: Uber Eats es un canal. Fire spark es tu capa de inteligencia omnicanal para agregadores. En lugar de integrar cada agregador por separado, te conectas una vez a Fire spark. Sincronizamos menús con tu POS y RMS, aplicamos inteligencia en todos tus canales e inyectamos los pedidos de vuelta al sistema donde ya opera tu cocina.

¿Nuevo en Fire spark?

Empieza conectando un comercio antes de desarrollar contra la API de integraciones.

Qué hace esta integración

Fire spark se ubica entre tu stack operativo (POS, RMS, inventario) y tus canales de venta (app, web, kiosco, call center, Uber Eats, Rappi, PedidosYa y más).
CapaRol
POS / RMSFuente de verdad para menús, precios, disponibilidad y fulfillment
Fire sparkSincroniza menús, enriquece canales con inteligencia y enruta pedidos
Canales de ventaDonde los clientes descubren, piden y pagan
Una integración de un solo canal como Uber Eats suele cubrir:
  • Autenticación — acceso seguro a la API para tu integración
  • Gestión de tiendas — qué ubicaciones están activas y cómo operan
  • Sincronización de menús — lo que ven los clientes en la app del agregador
  • Procesamiento de pedidos — recibir pedidos y enviarlos a tu POS
Fire spark cubre las mismas responsabilidades, pero en todos los canales conectados al comercio. Uber Eats es una entrada en tu lista de canales, no la integración completa.

Cómo funciona de punta a punta

1

Autentica tu integración

Tu servidor obtiene un access token con OAuth 2.0 client credentials. Todas las solicitudes a la API de integraciones usan este token.
2

Sincroniza menús con POS y RMS

Fire spark obtiene estructura de menú, ítems, precios y disponibilidad de tu POS o RMS. Los cambios operativos salen de esa fuente; tú compones lo que ve el cliente por canal, tienda, tipo de fulfillment u horario.
3

Aplica inteligencia en todos los canales

Fire spark define cada contexto de venta — menús por canal, horarios, reglas de disponibilidad y opciones de fulfillment — sin integraciones separadas por variación. Tu app, agregadores y superficies en tienda pueden mostrar surtidos distintos desde la misma base sincronizada.
4

Recibe pedidos de cualquier canal

Cuando un cliente hace un pedido en cualquier canal conectado, Fire spark envía un webhook a tu integración con el payload del pedido.
5

Inyecta pedidos en POS y RMS

Tu integración reenvía el pedido al POS o RMS del comercio para que la cocina lo reciba en el sistema que ya usa, sin captura manual.

Áreas de integración

La API se organiza en los mismos dominios que esperarías de una integración con marketplace, extendidos para operaciones omnicanal.

Autenticación

OAuth 2.0 client credentials protege el acceso servidor a servidor. Tu integración se autentica una vez y llama endpoints de menús, tiendas, canales, pedidos y fulfillment.

Autorizar

Obtén un access token con client credentials.

Tiendas

Las tiendas representan ubicaciones del comercio. Mapea cada tienda de Fire spark a una ubicación en tu POS o RMS para que menús y pedidos queden alineados por sitio.

Menús

Sube y mantén las estructuras de menú que ven los clientes en cada superficie. Fire spark sincroniza con tu POS y RMS cambios de ítems, precios y disponibilidad, y aplica composición de menús — catálogos distintos por canal, tienda, fulfillment u horario cuando tu estrategia lo requiere.

Guía de sincronización de menús

Aprende a mantener sincronizados POS, Fire spark y canales.

Canales

Los canales son las superficies donde piden los clientes: canales propios (app, web, kiosco) y agregadores (Uber Eats, Rappi, PedidosYa). Fire spark gestiona la configuración por canal y aplica inteligencia sin duplicar integraciones.

Pedidos

Los pedidos llegan por webhooks cuando un cliente paga en cualquier canal. Tu integración confirma el evento, obtiene el pedido completo y lo inyecta en el POS o RMS.

Guía de inyección de pedidos

Aprende a recibir webhooks e inyectar pedidos en tu POS o RMS.

Fulfillment

Las opciones de fulfillment (delivery, pickup, dine-in) definen cómo se completan los pedidos por tienda y canal. Mantén las reglas de fulfillment consistentes entre Fire spark y tu stack operativo.

Uber Eats vs Fire spark

API de Uber EatsAPI de integraciones de Fire spark
CanalesSolo Uber EatsApp, web, kiosco, call center, Uber Eats, Rappi, PedidosYa y más
Origen del menúPush hacia Uber EatsSync desde POS/RMS; composición por canal, tienda, fulfillment u horario
PedidosUber Eats → tu POSCualquier canal → Fire spark → tu POS/RMS
InteligenciaEspecífica de UberReglas y enriquecimiento cross-channel en una sola capa
Si ya integraste con Uber Eats o una API de agregador similar, reutiliza los mismos patrones: autenticar, mapear tiendas, sincronizar menús, escuchar webhooks y cumplir pedidos. Fire spark generaliza ese modelo para que lo construyas una vez y cubras todos los canales.

URL base

https://firespark.vercel.app/api/integrations/v1

Próximos pasos

Autorizar

Obtener un access token

Sincronización de menús

Sincronizar menús con POS y RMS

Inyección de pedidos

Recibir e inyectar pedidos

Límites de recursos

Revisar rate limits y cuotas