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:
3. • 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:
3. • 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.

Actualizado el: 06/11/2026