# R2 Developers

> Conecta tu software contable, punto de venta o herramienta de reportes con los datos de un negocio en R2. API REST de solo lectura, con permisos por recurso y llaves que el dueño controla.

> URL base: https://api.r2-os.com/api/connect/v1 · Auth: llave Bearer · Solo lectura v1.

## Empezar
- [Introducción](https://r2developers.com/): Conecta tu software contable, punto de venta o herramienta de reportes con los datos de un negocio en R2. API REST de solo lectura, con permisos por recurso.
- [Inicio rápido](https://r2developers.com/inicio-rapido.html): De cero a tu primera respuesta de la API en dos minutos: pide la llave al dueño del negocio y haz una solicitud.
- [Autenticación y permisos](https://r2developers.com/autenticacion.html): Cómo se autentica cada solicitud y qué significa cada permiso que el dueño del negocio te concede.

## Fundamentos
- [Paginación y filtros](https://r2developers.com/paginacion.html): Cómo recorrer listas largas con cursores y cómo acotar resultados por fecha y estado.
- [Límites de uso](https://r2developers.com/limites.html): Cuántas solicitudes puedes hacer, cómo saber cuántas te quedan y qué hacer si te pasas.
- [Errores](https://r2developers.com/errores.html): Forma de los errores, qué significa cada código y cómo reaccionar a cada uno.

## Referencia de la API
- [Cuenta](https://r2developers.com/account.html): Identifica a qué negocio pertenece la llave, en qué moneda opera y qué permisos tiene.
- [Reservas](https://r2developers.com/reservations.html): Estancias de hospedaje con fechas, huéspedes, cargos, impuestos, pagos y saldo pendiente.
- [Órdenes](https://r2developers.com/orders.html): Toda transacción comercial del negocio, de cualquier giro: hospedaje, restaurante, tienda y experiencias.
- [Pagos](https://r2developers.com/payments.html): Cobros con su método, proveedor y momento exacto. La base de la conciliación contable.
- [Clientes](https://r2developers.com/guests.html): Directorio de clientes y huéspedes del negocio con su historial de visitas y consumo.
- [Catálogo](https://r2developers.com/items.html): Todo lo que el negocio vende: habitaciones, platillos, productos y experiencias, con su precio base.

## Guías
- [Integrar contabilidad](https://r2developers.com/contabilidad.html): Cómo llevar ingresos, impuestos y cobros de un negocio en R2 hacia un sistema contable, sin captura manual.
- [Integrar punto de venta](https://r2developers.com/punto-de-venta.html): Cómo sincronizar catálogo y consumo entre R2 y un sistema de punto de venta.
- [Reportes y BI](https://r2developers.com/business-intelligence.html): Cómo alimentar un tablero o un almacén de datos con la operación de un negocio en R2.

## Recursos
- [Especificación OpenAPI](https://r2developers.com/openapi.html): Descarga el contrato de la API en formato OpenAPI 3.1 para generar clientes o importarla en tus herramientas.
- [Cambios](https://r2developers.com/changelog.html): Historial de versiones de R2 Connect API y nuestra política de compatibilidad.

## Formato para máquinas
- [openapi.json](https://r2developers.com/openapi.json)
- [llms-full.txt](https://r2developers.com/llms-full.txt)