> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ayuda.restolia.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# API de Restolia

# Conectá tus sistemas con la API de Restolia

Con la **API de Restolia** podés conectar tus propios sistemas —tu contabilidad, un sistema de reservas, un tablero de indicadores— para que lean la información de tu local sin tener que exportarla a mano. Para usarla, primero tu **responsable de ventas** de Restolia te habilita la sección **Admin → API**. Desde ahí pedís el acceso y, una vez aprobado, las conexiones funcionan con **claves de API** que creás y controlás vos.

## ¿Qué pueden hacer tus sistemas con la API?

* **Leer** tus ventas, gastos, productos y reservas.
* **Crear** reservas.

Cada clave tiene solo los permisos que vos le des, y llega solo a los locales que elijas.

En detalle, tus sistemas pueden leer:

* **Ventas:** cada cuenta con sus productos, pagos, descuentos, propinas y los comprobantes emitidos (con su CAE en Argentina o la autorización del CFE en Uruguay). También las ventas abiertas, canceladas y las de delivery que todavía no se entregaron.
* **Gastos:** con su proveedor, categoría, comprobante, percepciones (IIBB, IVA) y pagos, y cuánto queda por pagar.
* **Productos:** precio, IVA, costo, stock actual y mínimo, si está a la venta y si se muestra en el menú. Para un producto puntual, también su receta y sus opciones.
* **Reservas:** con su estado, y los salones y turnos de reserva del local.

Las reservas que crea tu sistema aparecen en la pantalla de **Reservas** del local como cualquier otra.

> **La API no te avisa sola de los cambios.** Tu sistema tiene que consultarla cada tanto para traer lo nuevo: cada cuánto lo haga define qué tan actualizada tiene la información. Esto lo configura quien arma la integración.

## ¿Quién puede usar la API?

* **Período de prueba:** podemos habilitarle la API a tu local para que la pruebes durante **1 a 2 semanas**.
* **Después de la prueba**, la API queda disponible **solo para locales que tengan el posnet de Terminales Restolia**.

## Antes de empezar

* **Tu responsable de ventas tiene que habilitarte la API.** Contactate con él: te habilita la sección **Admin → API**, desde donde después pedís el acceso.
* **Necesitás el permiso Gestionar claves de API.** Está en la sección **Integraciones** del editor de roles (**Admin > Roles**). Solo quienes lo tienen ven **Admin → API**, tanto para pedir el acceso como para crear claves.

## Pedí el acceso a la API

Una vez que tu responsable de ventas te la habilitó:

1. Ir a **Admin → API**.
2. Completar la solicitud:
    * **Contacto:** quién es la persona de referencia para la integración.
    * **Sistema:** qué sistema va a usar la API.
    * **Para qué:** qué querés hacer con la integración.
3. Enviar la solicitud.

La respuesta te aparece en esa **misma pantalla**: no hace falta que escribas a soporte ni que esperes un mail.

* **Si la aprobamos**, la pantalla muestra **API habilitada** junto con los límites de tu organización, y ya podés crear tus claves.
* **Si la rechazamos**, ves el **motivo** en la pantalla y podés **volver a pedirla**, por ejemplo con más detalle sobre el sistema o el uso.

## Crear una clave

1. Ir a **Admin → API** y, en **Claves**, tocar **Nueva clave**.
2. Completar:
    * **Nombre:** para reconocer qué sistema la usa (por ejemplo, *"Contabilium"* o *"Sistema de reservas"*).
    * **Permisos:** qué puede hacer esa clave. Marcá solo los que necesita:
        * **Leer ventas**
        * **Leer gastos**
        * **Leer productos**
        * **Leer reservas**
        * **Crear reservas**
    * **Locales:** **Todos los locales** o **Solo algunos** (y elegís cuáles).
    * **Vencimiento (opcional):** si querés que la clave deje de funcionar sola en una fecha.
3. Tocar **Crear clave**.

> **La clave se muestra una sola vez.** Copiala y guardala en un lugar seguro apenas la creás: después no se puede volver a ver, ni siquiera nosotros. Si la perdés, revocala y creá otra.

Tratá cada clave como una contraseña: quien la tenga puede acceder a la información que esa clave permite.

**¿Qué permisos le doy?** Los mínimos que sirvan. Por ejemplo:

* Para un **sistema contable**: Leer ventas y Leer gastos, solo en el local que corresponda.
* Para una **plataforma de reservas**: Leer reservas y Crear reservas.

## Revocar una clave

Si perdiste una clave, si ya no usás la integración o si creés que alguien más la tiene, revocala desde **Admin → API**. Las integraciones que la usan **dejan de funcionar al instante**. Para volver a conectarlas, creá una clave nueva y cargala en tu sistema.

## Límites, uso y documentación

En la misma pantalla de **Admin → API** ves:

* Los **límites de tu organización**: cuántos pedidos por minuto y cuántos por día puede hacer (por ejemplo, *60 req/min · 1000 req/día*).
* El **uso**: un gráfico de los últimos 30 días y cuánto llevás hoy y en este minuto (por ejemplo, *"Hoy: 0 de 1000 · Este minuto: 0 de 60"*).
* Los links **Ver la guía** y **Ver documentación**, para quien arme la integración.

Tené en cuenta:

* **Los límites son de toda la organización**, compartidos entre todas tus claves: tener más claves no te da más pedidos.
* **El día se cuenta en horario UTC**: la cuota diaria se renueva a las **21:00 hora de Argentina y Uruguay**, no a la medianoche.
* **Los pedidos rechazados también cuentan** para el límite.
* **Si necesitás más**, pedile al equipo de Restolia que suba los límites de tu organización.

## Si algo falla

Si tu integración tiene un error con un pedido puntual, pedile a quien la armó el **X-Request-Id** de ese pedido (viene en todas las respuestas de la API) y mandánoslo cuando escribas a soporte: así lo encontramos enseguida.

## Condiciones de uso de la API

El uso de la API se rige por el **Anexo I — Uso de la API** de los Términos y Condiciones de Restolia. Lo más importante:

* **Los datos son tuyos.** No cambian de titular porque los leas por la API ni porque se los des a un tercero. Vos decidís a quién le das una clave, y sos responsable del uso que ese tercero haga de los datos.
* **Datos de tus clientes.** Algunas respuestas incluyen datos personales de tus comensales (nombre, teléfono y, si la cargaste, su identificación fiscal). Si le das una clave a un tercero, tiene que cumplir la normativa de protección de datos, no puede usar esos datos para fines ajenos a tu local, y tenés que revocar la clave cuando termine la relación con él.
* **Cuidá tus claves.** No las publiques ni las incluyas en aplicaciones que se instalen en un celular, en una página web o en otro dispositivo: usá la API solo desde tus servidores. Si una clave queda expuesta, revocala y avisanos. Todo lo que se haga con una clave tuya se considera hecho por vos.
* **Límites de uso.** Cada organización tiene un límite de pedidos por minuto y una cuota diaria. La API los informa en cada respuesta y rechaza los pedidos que los excedan.
* **Lo que no se puede hacer:** revender o redistribuir los datos, intentar acceder a datos de otros locales, usar varias claves para esquivar los límites, o usar los datos o la documentación para construir un producto que compita con Restolia.
* **Cambios en la API.** Dentro de una misma versión se pueden sumar campos y valores nuevos sin aviso, así que tu integración tiene que ignorar los que no conoce. Un cambio que pueda romper una integración sale como versión nueva, y la anterior sigue funcionando **al menos 12 meses más**. Les avisamos por email a quienes crearon las claves.
* **Suspensión.** Podemos suspender una clave o el acceso de toda la organización si un uso pone en riesgo el sistema, si hay un problema de seguridad o si no se cumplen estas condiciones. Si no es urgente, te avisamos antes.
* **Si se deshabilita la API**, las claves no se borran: dejan de funcionar y vuelven a funcionar si se habilita de nuevo. Si se cancela tu cuenta, el acceso a la API termina con ella.

La API no reemplaza tus obligaciones de respaldo ni de conservación de documentación fiscal.

## Preguntas frecuentes

**¿Cómo activo la API?**
Primero contactate con tu responsable de ventas de Restolia para que te la habilite. Después pedí el acceso desde **Admin → API**: contanos quién es el contacto, qué sistema la va a usar y para qué. La respuesta te aparece en esa misma pantalla. Una vez aprobada, las claves las creás vos desde ahí.

**¿Puedo probar la API antes de decidir?**
Sí. Podemos habilitártela durante **1 a 2 semanas** de prueba. Pedísela a tu responsable de ventas.

**¿Qué necesito para seguir usando la API después de la prueba?**
Tener en tu local el **posnet de Terminales Restolia**. Pasado el período de prueba, la API está disponible solo para locales que lo tengan.

**¿Qué pasa con mis claves cuando termina la prueba?**
Si tu local no tiene el posnet de Terminales Restolia, las claves no se borran, pero no se pueden usar. Si después sumás el posnet y volvemos a habilitar la API, vuelven a funcionar.

**¿Cómo sé si mi organización ya tiene la API aprobada?**
En **Admin → API** vas a ver **API habilitada**, junto con los límites por minuto y por día.

**¿Qué permiso necesito para pedir el acceso y crear claves?**
El permiso **Gestionar claves de API**, en la sección **Integraciones** del editor de roles. Es el mismo que te deja revocarlas.

**¿Dónde veo la respuesta a mi solicitud?**
En **Admin → API**, la misma pantalla desde donde la pediste.

**Me rechazaron la solicitud. ¿Qué hago?**
En **Admin → API** ves el motivo del rechazo. Revisalo y volvé a pedir el acceso desde ahí mismo, las veces que haga falta.

**No veo la sección Admin → API. ¿Por qué?**
Puede ser por dos motivos: tu responsable de ventas todavía no te habilitó la API, o tu rol no tiene el permiso **Gestionar claves de API** (sección Integraciones del editor de roles). En el primer caso, contactate con tu responsable de ventas; en el segundo, pedile a un administrador que te active el permiso.

**Veo Admin → API pero no puedo crear claves. ¿Por qué?**
Porque tu organización todavía no tiene el acceso aprobado. Pedilo desde esa misma pantalla, o revisá ahí el estado de la solicitud que ya enviaste.

**¿Qué información pueden ver mis sistemas?**
Ventas (con sus pagos y comprobantes), gastos, productos y reservas, según los permisos que le hayas dado a cada clave y solo de los locales que elegiste. También pueden crear reservas.

**¿La API puede cargar ventas, gastos o productos?**
No. Lo único que puede crear es reservas. Todo lo demás es solo lectura.

**¿Puedo modificar o cancelar una reserva desde la API?**
No. La API solo crea y lee reservas. Para modificarla o cancelarla, hacelo desde la pantalla de **Reservas** del local; tu sistema ve el cambio la próxima vez que consulte la API.

**¿Dónde aparecen las reservas que crea mi sistema?**
En la pantalla de **Reservas** del local, como cualquier otra reserva.

**¿La API controla que haya lugar antes de crear una reserva?**
No. Si tu sistema necesita chequear el lugar disponible, tiene que consultarlo antes. Quien arme la integración lo encuentra en la guía de la API.

**¿Mi sistema se entera solo cuando cambia algo en Restolia?**
No. La API no manda avisos: tu sistema la consulta cada tanto y trae lo que cambió desde la última vez.

**¿Puedo tener una clave distinta para cada sistema?**
Sí. Te conviene crear una clave por integración, con un nombre que la identifique y solo los permisos y locales que necesita. Así, si tenés que revocar una, las demás siguen funcionando.

**¿Puedo hacer que una clave llegue solo a algunos de mis locales?**
Sí. Al crearla, en **Locales**, elegí **Solo algunos** y marcá cuáles.

**Perdí la clave. ¿Puedo volver a verla?**
No, se muestra una sola vez al crearla y no la podemos recuperar. Revocala y creá una nueva.

**¿Qué pasa cuando revoco una clave?**
Las integraciones que la usan dejan de funcionar al instante.

**¿Las claves vencen?**
Solo si les pusiste una fecha de vencimiento al crearlas. Es opcional.

**¿Dónde veo cuánto estoy usando la API?**
En **Admin → API**: ves el uso de los últimos 30 días y cuánto llevás hoy y en este minuto, junto con los límites de tu organización.

**¿Si creo más claves tengo más pedidos por día?**
No. Los límites son de toda la organización y los comparten todas las claves.

**¿A qué hora se renueva la cuota diaria?**
A las 00:00 UTC, que son las 21:00 en Argentina y Uruguay.

**Necesito más pedidos por día. ¿Se puede?**
Sí. Pedile al equipo de Restolia que suba los límites de tu organización.

**¿Puedo darle una clave a un proveedor externo?**
Sí, pero sos responsable del uso que haga de los datos. Tiene que cumplir la normativa de protección de datos, y tenés que revocarle la clave cuando termine la relación.

**¿Puedo usar la clave dentro de una app de celular o una página web?**
No. Las claves no se pueden incluir en aplicaciones que se instalen en un dispositivo ni en páginas web: la API se usa solo desde tus servidores.

**¿Qué pasa si paso el límite de pedidos?**
La API rechaza los pedidos que superan el límite por minuto o la cuota diaria, y le indica a tu sistema cuánto esperar para seguir. Los rechazados también cuentan para el límite.

**Si la API cambia, ¿se me rompe la integración?**
No de golpe. Los cambios que pueden romper una integración salen como una versión nueva, y la anterior sigue funcionando al menos 12 meses más. Te avisamos por email.

**¿Dónde están las condiciones completas de uso de la API?**
En el **Anexo I — Uso de la API** de los Términos y Condiciones de Restolia.

---