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

# Introducción

> API REST de Abacco — base URL, formato y convenciones

## Base URL

```
https://api.abacco.ai/v1
```

Todas las respuestas son JSON (`Content-Type: application/json`). Los listados
están paginados con `page` y `page_size`.

## Convenciones

| Convención               | Detalle                                                 |
| ------------------------ | ------------------------------------------------------- |
| Identificador de empresa | `tax_id` (RUT con formato `12.345.678-9`)               |
| Tipos de documento       | `dte_type_code` con el código SII (33, 34, 39, 61, 80…) |
| Montos                   | Pesos chilenos (CLP) salvo indicación explícita         |
| Fechas                   | ISO 8601 (`YYYY-MM-DD`)                                 |
| Períodos                 | `YYYY-MM`                                               |

## Recursos disponibles

| Sección            | Recurso                                                        | Descripción                                                       |
| ------------------ | -------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Contabilidad**   | [`/accounting/journal-entries/`](/api/accounting/introduction) | Comprobantes contables (asientos del libro diario)                |
| **Impuestos**      | [`/accounting/f29-declarations/`](/api/f29/introduction)       | Declaraciones F29 de la cartera (estados, borradores, checks SII) |
| **Impuestos**      | [`/book-summaries/`](/api/book-summaries/introduction)         | Libros de compra/venta del SII por período                        |
| **Remuneraciones** | [`/payroll/…`](/api/payroll/introduction)                      | Empleados, procesos de nómina, liquidaciones e indicadores        |
| Documentos         | [`/documents/`](/api/documents/introduction)                   | Documentos tributarios electrónicos (emisión y consulta)          |
| —                  | `/master-entities/`                                            | Datos de una empresa por RUT                                      |

<Note>
  Los endpoints de **`/v1/`** (documentos, libros, remuneraciones) se autentican
  con `Api-Key`. Los de **`/api/accounting/`** (comprobantes, F29) usan el token
  Bearer de la sesión de la plataforma.
</Note>

## Errores

La API usa códigos HTTP estándar:

| Código | Significado                                      |
| ------ | ------------------------------------------------ |
| `400`  | Parámetros inválidos (el cuerpo indica el campo) |
| `401`  | API Key ausente o inválida                       |
| `403`  | La API Key no tiene acceso a esa empresa         |
| `404`  | Recurso no encontrado                            |
| `429`  | Límite de tasa excedido — reintenta con backoff  |
