Referencia API
Consumo
El libro de medición inmutable del que sale tu factura.
Base: https://api.facturia.cl/v1. Todos los endpoints de este capítulo se autentican con Authorization: Bearer salvo que se diga lo contrario, y el sobre de error es el de Errores.
| Método | Ruta | Qué hace |
|---|---|---|
GET | /usage | Resumen de consumo de un período de facturación |
GET | /usage/records | El libro de medición inmutable |
GET /usage
Resumen de consumo de un período de facturación
curl -sS https://api.facturia.cl/v1/usage \
-H "Authorization: Bearer $FACTURIA_KEY"Parámetros
| Parámetro | En | Requerido | Tipo | Notas |
|---|---|---|---|---|
period | query | — | Period | Período tributario, YYYY-MM, America/Santiago. |
group_by | query | — | empresa · tipo_dte · metric |
Respuestas
| Código | Significado | Cuerpo |
|---|---|---|
200 | El resumen de consumo. | UsageSummary |
GET /usage/records
El libro de medición inmutable
Un registro por evento facturable. Un documento es facturable cuando el SII lo acepta — los rechazados, los fallidos y los del sandbox no aparecen nunca aquí. Las correcciones son registros compensatorios con cantidad negativa, jamás actualizaciones.
curl -sS https://api.facturia.cl/v1/usage/records \
-H "Authorization: Bearer $FACTURIA_KEY"Parámetros
| Parámetro | En | Requerido | Tipo | Notas |
|---|---|---|---|---|
limit | query | — | integer | |
cursor | query | — | string | Cursor opaco tomado del next_cursor de una respuesta anterior. |
period | query | — | Period | Período tributario, YYYY-MM, America/Santiago. |
metric | query | — | document_accepted · received_document · f29_filing · empresa_active | |
empresa_rut | query | — | Rut |
Respuestas
| Código | Significado | Cuerpo |
|---|---|---|
200 | Una lista de registros de consumo. | lista de UsageRecord |