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. El campois_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 permisobook_summary:access y acceso a la entidad consultada.
Referencia rapida
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.