> ## Documentation Index > Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt > Use this file to discover all available pages before exploring further. # Introducción > Conecta tu POS y RMS con cada canal de venta a través de la API de integraciones de Fire spark. ## 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](https://developer.uber.com/docs/eats/guides/getting-started), 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. > [card] [¿Nuevo en Fire spark?](https://firespark.cloud/docs/es/guides/connecting-a-merchant.md) > > 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). | Capa | Rol | | - | - | | POS / RMS | Fuente de verdad para menús, precios, disponibilidad y fulfillment | | Fire spark | Sincroniza menús, enriquece canales con inteligencia y enruta pedidos | | Canales de venta | Donde 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. 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. > [card] [Token](https://firespark.cloud/docs/es/integrations-api/oauth/token/post.md) > > 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. > [card] [Listar tiendas](https://firespark.cloud/docs/es/integrations-api/stores/get.md) > > Lee tiendas para mapear ubicaciones de POS o RMS. > [card] [Crear o actualizar tiendas](https://firespark.cloud/docs/es/integrations-api/stores/put.md) > > 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. > [card] [Guía de sincronización de menús](https://firespark.cloud/docs/es/integrations-api/guides/menu-sync.md) > > 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. > [card] [Listar pagos](https://firespark.cloud/docs/es/integrations-api/payments/get.md) > > Lee las configuraciones de pago del comercio. > [card] [Crear o actualizar pagos](https://firespark.cloud/docs/es/integrations-api/payments/put.md) > > 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 dispara **`order.status.changed`** con `status` `injecting` — con el pedido en el estado en que esté en ese momento. > [card] [Webhooks de pedidos](https://firespark.cloud/docs/es/integrations-api/orders/webhooks.md) > > 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. > [card] [Dispositivos de kiosco](https://firespark.cloud/docs/es/integrations-api/kiosk/devices/get.md) > > 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 | | API de Uber Eats | API de integraciones de Fire spark | | - | - | - | | Canales | Solo Uber Eats | App, web, kiosco, call center, Uber Eats, Rappi, PedidosYa y más | | Origen del menú | Push hacia Uber Eats | Sync desde POS/RMS; composición por canal, tienda, fulfillment u horario | | Pedidos | Uber Eats → tu POS | Cualquier canal → Fire spark → tu POS/RMS | | Inteligencia | Específica de Uber | Reglas 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.cloud/api/integrations/v1 ``` > [card] [Colección de Postman](https://firespark.cloud/docs/assets/fire-spark-integrations-api-2026-10-16.postman_collection.json) > > 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 > [card] [Token](https://firespark.cloud/docs/es/integrations-api/oauth/token/post.md) > > Obtener un access token > [card] [Sincronización de menús](https://firespark.cloud/docs/es/integrations-api/guides/menu-sync.md) > > Sincronizar menús con POS y RMS > [card] [Webhooks de pedidos](https://firespark.cloud/docs/es/integrations-api/orders/webhooks.md) > > Recibir pedidos y enviarlos al POS > [card] [Arquitectura](https://firespark.cloud/docs/es/integrations-api/guides/architecture.md) > > arquitectura de la API de integraciones This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.