# Wasabil API

> API REST de Wasabil — facturación electrónica chilena (SII): emitir DTE al SII, clientes, proveedores, transacciones y conciliación.

Acá vas a encontrar toda la documentación del API en markdown plano, dividida por sección. **Cada archivo es autocontenido**: trae la URL base, el header de auth y ejemplos completos de request y response, así que con el de la sección que corresponde a la tarea alcanza. Al lado de cada uno está su peso.

Cada sección tiene su equivalente en HTML para humanos en `/api-docs/<nombre>`.

## Lo mínimo para arrancar

- **Auth**: header `Authorization: Bearer {token}`. Un token pertenece a una sola empresa; se crean en https://app.wasabil.com/api-tokens
- **Content-Type**: `application/json` en POST y PUT.
- **Todas** las respuestas tienen la misma forma: `{ success, status, error, errorCode, validation, data }`. `validation` trae los errores por campo (ej. `{"details.0.price": "Debe ser mayor a cero"}`) y siempre viene con `success: false`.
- **Al crear documentos mandá `idempotency_key`**: emitir consume un folio del SII y no se puede deshacer, así que un reintento sin clave puede terminar en dos DTE.
- **Sandbox**: no hay una URL distinta — se distingue por el RUT. Creá una empresa con RUT `99999999-K` en la app y sacá un token de esa empresa.
- **La emisión es asíncrona**: el documento queda en Procesando hasta que responde el SII. Enterate del estado final con un webhook (`notification_url`) o poleando `GET /api/documents/{uuid}/status`.
- **Probar el token**: `GET /api/whoami`.

## Dónde está cada cosa para emitir un documento

- El flujo de creación y emisión, la idempotencia (`idempotency_key`) y cómo emitir un documento ya creado: https://app.wasabil.com/llms/documents-create.txt
- El body completo de cada tipo de DTE: un archivo por tipo, en la tabla del final.
- Consultar, actualizar o anular lo ya emitido: https://app.wasabil.com/llms/documents.txt — y el estado final del documento llega por webhook: https://app.wasabil.com/llms/webhooks.txt

## Documentación por tema

### Empezar

- [Empezar](https://app.wasabil.com/llms/getting-started.txt) — 5.1 KB — Bienvenido a la API de Wasabil. Acá tenés todo lo que necesitas para conectar tu sistema a Wasabil.

### Documentos

- [Crear documento](https://app.wasabil.com/llms/documents-create.txt) — 18 KB — Cómo crear un documento tributario electrónico y emitirlo al SII. Cada tipo de DTE soportado tiene su propia sección con el body completo.
   - un archivo por tipo de DTE — ver la tabla más abajo
   - [Crear documentos en masa](https://app.wasabil.com/llms/documents-bulk.txt) — 19 KB — hasta 100 documentos en una sola llamada, para cargas masivas
- [Documentos](https://app.wasabil.com/llms/documents.txt) — 47 KB — Listar, consultar, actualizar, eliminar y operar sobre documentos ya creados. Para crear y emitir nuevos documentos ver [Crear documento](https://app.wasabil.com/llms/documents-create.txt).
- [Webhooks](https://app.wasabil.com/llms/webhooks.txt) — 12 KB — Cómo recibir notificaciones desde Wasabil cuando un documento cambia de estado. Podés configurarlos por documento (notification_url) o de forma global por empresa.

### Receptores y emisores

- [Empresa](https://app.wasabil.com/llms/companies.txt) — 9.4 KB — Datos de la empresa asociada al token, direcciones, giros tributarios y lookups auxiliares (datos públicos SII, monedas, países, tipo de cambio).
- [Clientes](https://app.wasabil.com/llms/clients.txt) — 17 KB — Gestión de clientes (receptores de documentos de venta). Cada cliente puede tener múltiples direcciones y giros tributarios.
- [Proveedores](https://app.wasabil.com/llms/suppliers.txt) — 13 KB — Gestión de proveedores (emisores de documentos recibidos) y sus cuentas bancarias para pagos.

### Finanzas

- [Transacciones](https://app.wasabil.com/llms/financials.txt) — 19 KB — CRUD de transacciones bancarias y de las fuentes (cuentas, tarjetas, etc.) donde se registran. Para vincular transacciones con documentos emitidos/recibidos ver Conciliación.
- [Conciliación](https://app.wasabil.com/llms/reconciliation.txt) — 15 KB — Vincular documentos con transacciones bancarias. Cada documento (o pack de documentos relacionados, ej. una factura + sus notas de crédito) se identifica por su document_pack — que es el id numérico del documento principal (campo `document`, ej. 90000000000366), NO el UUID.

### Otros

- [Transportes](https://app.wasabil.com/llms/transports.txt) — 4.3 KB — Choferes y vehículos para usar en guías de despacho (DTE 52). Cada transporte es una combinación de RUT del transportista + patente + chofer.
- [Metafields](https://app.wasabil.com/llms/metafields.txt) — 4.5 KB — Definiciones de campos personalizados (metafields) que se pueden adjuntar a documentos, clientes y proveedores.

### Referencia

- [Referencia](https://app.wasabil.com/llms/reference.txt) — 31 KB — Tablas de constantes, enums y catálogos referenciados desde otros endpoints (códigos SII, bancos, comunas, tipos de cuenta, etc).

## Crear cada tipo de DTE

Un archivo por tipo, con los campos del request, el body de ejemplo y el response. Son independientes entre sí:

| DTE | Código SII | Archivo | Peso |
| --- | --- | --- | --- |
| Factura de Venta | 33 | https://app.wasabil.com/llms/dte/33-factura-de-venta.txt | 13 KB |
| Factura Exenta | 34 | https://app.wasabil.com/llms/dte/34-factura-exenta.txt | 13 KB |
| Boleta de Venta | 39 | https://app.wasabil.com/llms/dte/39-boleta-de-venta.txt | 13 KB |
| Boleta Exenta | 41 | https://app.wasabil.com/llms/dte/41-boleta-exenta.txt | 13 KB |
| Factura de Exportación | 110 | https://app.wasabil.com/llms/dte/110-factura-de-exportacion.txt | 15 KB |
| Factura de Compra | 46 | https://app.wasabil.com/llms/dte/46-factura-de-compra.txt | 14 KB |
| Guía de Despacho | 52 | https://app.wasabil.com/llms/dte/52-guia-de-despacho.txt | 14 KB |
| Nota de Crédito (anulación total) | 61 | https://app.wasabil.com/llms/dte/61-nota-de-credito-anulacion-total.txt | 12 KB |
| Nota de Crédito (anulación parcial / corrección de montos) | 61 | https://app.wasabil.com/llms/dte/61-nota-de-credito-anulacion-parcial-correccion-de-montos.txt | 12 KB |
| Nota de Crédito de Exportación | 112 | https://app.wasabil.com/llms/dte/112-nota-de-credito-de-exportacion.txt | 13 KB |
| Nota de Débito (anular nota de crédito) | 56 | https://app.wasabil.com/llms/dte/56-nota-de-debito-anular-nota-de-credito.txt | 12 KB |
| Nota de Débito (extender factura) | 56 | https://app.wasabil.com/llms/dte/56-nota-de-debito-extender-factura.txt | 12 KB |
| Nota de Débito de Exportación | 111 | https://app.wasabil.com/llms/dte/111-nota-de-debito-de-exportacion.txt | 12 KB |
| Boleta de Honorarios de Terceros | 200 | https://app.wasabil.com/llms/dte/200-boleta-de-honorarios-de-terceros.txt | 14 KB |

## Todas las secciones en un solo archivo

- [llms-full.txt](https://app.wasabil.com/llms-full.txt) — **379 KB (~97k tokens)** — exactamente las mismas secciones de arriba, concatenadas y sin nada extra. Está para clientes que sólo pueden hacer un fetch; por separado cada sección pesa entre 4.3 KB y 47 KB.

Estándar: https://llmstxt.org  ·  Tokens del API: https://app.wasabil.com/api-tokens