Resumen de libro de compras/ventas
Obtiene el resumen de libro de compras y ventas (getResumen del SII) para una entidad y período. Es data agregada por tipo de documento y operación (COMPRA/VENTA), no el detalle línea a línea. Solo devuelve datos para entidades habilitadas explícitamente para este scrape (ver is_enabled en la respuesta); si la entidad no está habilitada, results viene vacío.
¿Para qué se usa?
Permite obtener el resumen agregado del libro de compras y ventas (getResumen del SII) de una entidad para un período determinado. Cada ítem representa un total por tipo de documento (factura, nota de crédito, etc.) y operación (COMPRA o VENTA), no el detalle línea a línea de cada documento.Qué hace
- Devuelve los totales del libro (
total_docs,net_amount,exempt_amount,vat_amount,total_amount) agrupados pordte_type_codeyoperationpara elperiod(YYYYMM) indicado. - La entidad se indica con el query param
master_entity_id, igual que en/documents. Acepta el id opaco (eid_..., campoopaque_idde/master-entities?rut=) o el id entero. - Puedes filtrar por operación (
COMPRAoVENTA); si se omite, devuelve ambas. - El campo is_enabled indica si la entidad tiene habilitado el scrape de este resumen. Si es
false,resultsviene vacío aunque el período sea válido — la entidad necesita ser habilitada primero (ver Introducción).
Ejemplos de uso
- Conciliar el IVA débito/crédito declarado por el SII contra tu propia contabilidad.
- Mostrar en un dashboard los totales mensuales de compras y ventas de una entidad sin tener que descargar el detalle documento por documento.
Authorizations
API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)
Query Parameters
ID de la entidad maestra. Acepta el id opaco (eid_..., campo opaque_id de /master-entities?rut=) o el id entero.
"eid_NDgyMTM6c2lnbmF0dXJl"
Período a consultar, formato YYYYMM.
"202603"
Filtra por operación: COMPRA o VENTA. Si se omite, devuelve ambas.
COMPRA, VENTA 