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).
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
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
Envía pedidos al POS y RMS
Cuando el pedido llega a un estado al que te suscribiste — normalmente
injecting vía order.status.changed — tu integración crea el ticket en el
POS o RMS del comercio con el payload tal cual.Á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.Token
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.Listar tiendas
Lee tiendas para mapear ubicaciones de POS o RMS.
Crear o actualizar tiendas
Crea o actualiza hasta 100 tiendas por id externo.
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.Pagos
Las configuraciones de pago definen qué métodos están disponibles en el checkout para una tienda, canal, marca y fulfillment.Listar pagos
Lee las configuraciones de pago del comercio.
Crear o actualizar pagos
Crea o actualiza hasta 100 configuraciones de pago por id.
Pedidos
Los pedidos llegan por webhooks cuando un cliente paga en cualquier canal. Tu integración confirma cada evento y crea el ticket en el POS cuando se disparaorder.status.changed con status injecting — con el pedido en el estado en que esté en ese momento.
Webhooks de pedidos
Conoce los eventos webhook y cómo
order.status.changed envía pedidos a tu
POS o RMS.Dispositivos de kiosco
Los dispositivos de kiosco son las tablets vinculadas a un canal de kiosco y a una tienda. Lista, lee uno por id, o crea y actualiza alias, tienda, código y pagos deshabilitados.Dispositivos de kiosco
Lee y actualiza los dispositivos de la página de kioscos.
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
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
Colección de Postman
Descarga todos los endpoints de la API de integraciones. Configura
client_id
y client_secret, luego ejecuta la solicitud Token para definir
bearerToken.Próximos pasos
Token
Obtener un access token
Sincronización de menús
Sincronizar menús con POS y RMS
Webhooks de pedidos
Recibir pedidos y enviarlos al POS
Arquitectura
arquitectura de la API de integraciones