> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduccion - API Consultas

> Consultas de datos agregados scrapeados desde el SII, como el resumen de libro de compras/ventas

## Para que sirve la API de Consultas?

La **API de Consultas** agrupa endpoints de solo lectura sobre datos que Tupana obtiene periódicamente desde el SII u otras fuentes, distintos de los documentos tributarios electrónicos en sí. Por ahora incluye el **resumen de libro de compras y ventas** (getResumen del SII): totales agregados por tipo de documento y operación (COMPRA/VENTA) para un período dado.

## Habilitación

El resumen de libro de compras/ventas es un dato **opt-in**: solo se scrapea para las entidades que lo tengan explícitamente habilitado. Si tu integración necesita este dato para una entidad, solicita su habilitación a [soporte@tupana.cl](mailto:soporte@tupana.cl). El campo `is_enabled` en la respuesta del endpoint te indica si la entidad ya está habilitada.

## Autenticacion

Todos los endpoints requieren autenticacion (API Key o JWT). La API Key debe tener el permiso `book_summary:access` y acceso a la entidad consultada.

## Referencia rapida

| Accion                             | Metodo | Endpoint                                                |
| ---------------------------------- | ------ | ------------------------------------------------------- |
| Resumen de libro de compras/ventas | GET    | `/book-summaries?master_entity_id={id}&period={period}` |

`master_entity_id` acepta el id opaco (`eid_...`, campo `opaque_id` de `/master-entities?rut=`) o el id entero. La ruta anidada anterior (`/master-entities/{id}/book-summaries`) sigue funcionando por compatibilidad.