> ## 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

> Gestiona operaciones del comercio, datos de clientes en bulk y visibilidad de pedidos con la API Admin de Fire spark.

## Operaciones internas del comercio

La API Admin es cómo operas Fire spark desde el **lado del comercio**. Úsala para construir herramientas internas, sincronizar datos de clientes en bulk, consultar pedidos de todos los canales y migrar registros desde sistemas legacy — sin tocar flujos customer-facing ni integraciones POS directamente.

Si la [API Storefront](https://firespark.cloud/docs/es/storefront-api/introduction.md) impulsa los canales que usan tus clientes (app, web, kiosco), y la [API de integraciones](https://firespark.cloud/docs/es/integrations-api/introduction.md) conecta tu POS y RMS con esos canales, la API Admin es la capa de **back-office y operaciones**: dashboards, puentes con CRM, pipelines de datos y scripts de onboarding.

> [card] [¿Nuevo en Fire spark?](https://firespark.cloud/docs/es/guides/connecting-a-merchant.md)
>
> Conecta un comercio en el panel antes de llamar a la API Admin.

## Qué puedes construir

| Caso de uso | Consumidor típico |
| - | - |
| Dashboard de operaciones | Equipo interno monitoreando pedidos cross-channel |
| Sync con CRM | Push y pull de perfiles de cliente en bulk |
| Reporting y BI | Exportar historial de pedidos para analítica |
| Migración de datos | Importar clientes y pedidos desde una plataforma legacy |
| Scripts de automatización | Jobs programados que reconcilian o actualizan datos del comercio |

La API Admin es **solo servidor a servidor**. No es para apps mobile, sitios web o kioscos donde inician sesión clientes finales.

## Cómo funciona

**1. Autentica tu servidor**

Tu backend obtiene un access token con OAuth 2.0 client credentials. Guarda
tu `client_id` y `client_secret` de forma segura — nunca los expongas en
código del lado del cliente.

**2. Opera sobre datos del comercio**

Llama endpoints para listar y gestionar clientes en bulk, consultar pedidos
de todos los canales o ejecutar jobs de migración durante el onboarding.

**3. Los cambios se propagan en Fire spark**

Actualizaciones de clientes y registros migrados entran a la misma capa
omnicanal que alimenta tus APIs Storefront e Integrations. Un cliente creado
vía API Admin está disponible en cada canal conectado.

## Áreas de la API

### Autenticación

OAuth 2.0 client credentials protege el acceso a cada endpoint de la API Admin. Autentica desde tu servidor antes de hacer llamadas bulk o de migración.

> [card] [Token](https://firespark.cloud/docs/es/admin-api/oauth/token/post.md)
>
> Obtén un access token con client credentials.

### Tiendas

Crea ubicaciones del comercio usadas por menús, fulfillment y pedidos.

> [card] [Crear tienda](https://firespark.cloud/docs/es/admin-api/stores/post.md)
>
> Crear una tienda para el comercio autenticado.

> [card] [Actualizar tienda](https://firespark.cloud/docs/es/admin-api/stores/\[id]/patch)
>
> Actualiza una tienda por id externo.

### Clientes (bulk)

Crea, lee, actualiza y elimina registros de cliente en bulk. Usa estos endpoints para sincronizar un CRM, importar una lista de contactos o reconciliar datos de clientes entre sistemas.

| Endpoint | Propósito |
| - | - |
| `GET /customers/bulk` | Listar o exportar clientes |
| `POST /customers/bulk` | Crear clientes en lote |
| `PATCH /customers/bulk` | Actualizar clientes en lote |
| `DELETE /customers/bulk` | Eliminar clientes en lote |

### Pedidos

Consulta pedidos de todos los canales y tiendas de un comercio, o cancela un pedido antes del fulfillment. Úsalo para dashboards operativos, herramientas de soporte o pipelines de reporting.

> [card] [Listar pedidos](https://firespark.cloud/docs/es/admin-api/orders/get.md)
>
> Obtener pedidos de todos los canales.

> [card] [Cancelar pedido](https://firespark.cloud/docs/es/admin-api/orders/\[id]/cancel/post)
>
> Anula un pedido sin pago o reversa uno pagado.

### Migración

Importa clientes y pedidos históricos terminales desde una plataforma legacy. Cada petición valida el lote y encola un trabajo. Sigue el progreso en el dashboard en Clientes o Pedidos → Migraciones.

> [card] [Migrar clientes](https://firespark.cloud/docs/es/admin-api/customers/migrate/post.md)
>
> Upsert de clientes desde un sistema legacy

> [card] [Migrar pedidos](https://firespark.cloud/docs/es/admin-api/orders/migrate/post.md)
>
> Upsert de pedidos históricos terminales

## API Admin vs API Storefront vs API de integraciones

| | API Admin | API Storefront | API de integraciones |
| - | - | - | - |
| Quién la llama | Backend del comercio, herramientas internas | App, web, kiosco customer-facing | Partners de POS/RMS |
| Autenticación | Client credentials (servidor) | Exchange de ID token OIDC (cliente) | Client credentials (servidor) |
| Clientes | Lectura/escritura bulk, migración | Perfil, consentimiento y preferencias de notificación por cliente | No aplica |
| Pedidos | Consulta cross-channel y cancelación antes del fulfillment | Crear y gestionar por cliente | Recibir vía webhook, inyectar al POS |
| Objetivo principal | Operar y hacer onboarding de datos | Construir canales de venta propios | Sincronizar menús e inyectar pedidos |

Usa la API que corresponda al actor: los clientes interactúan vía Storefront, la cocina vía Integrations, y tu equipo de operaciones vía Admin.

## URL base

```
https://firespark.cloud/api/admin/v1
```

> [card] [Colección de Postman](https://firespark.cloud/docs/assets/fire-spark-admin-api-2026-10-16.postman_collection.json)
>
> Descarga todos los endpoints de la API Admin. Configura `client_id` y
> `client_secret`, luego ejecuta la solicitud Token para definir `bearerToken`.

## Próximos pasos

> [card] [Token](https://firespark.cloud/docs/es/admin-api/oauth/token/post.md)
>
> Obtener un access token

> [card] [Guía para desarrolladores](https://firespark.cloud/docs/es/admin-api/guides/developers.md)
>
> Configurar tu integración de servidor

> [card] [Clientes bulk](https://firespark.cloud/docs/es/admin-api/customers/bulk/get.md)
>
> Leer y gestionar clientes en bulk

> [card] [Límites de tasa](https://firespark.cloud/docs/es/admin-api/resources/rate-limit.md)
>
> Revisar rate limits y cuotas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.