Facturación electrónica chilena para developers

MCP Server — Emite DTEs desde Claude o tu IDE

Wasabil fue el primer facturador electrónico de Chile en implementar el Model Context Protocol. Conecta Claude Code, Claude.ai, Cursor o Windsurf directamente a tu empresa.

claude mcp add \
  --transport http \
  --scope user \
  wasabil \
  https://mcp.wasabil.com

# Luego escribe /mcp y autoriza

OAuth 2.0 — Parámetros de conexión

La mayoría de los clientes detectan estos valores automáticamente con solo pegar la URL del servidor. Si tu cliente te pide completarlos manualmente, usa estos valores:

Tools disponibles en el MCP

→ Ver guía completa de instalación del MCP

API REST

Authorization: Bearer TU_TOKEN
Content-Type: application/json

URL Base: https://api.wasabil.com/api

La URL antigua https://api.wasabil.com/v1 sigue funcionando para integraciones existentes pero no recibirá nuevos endpoints. Para integraciones nuevas, usa siempre /api.

Estados de documentos

Tipos de DTE soportados

Crear y emitir un documento

POST /api/documents

Crea cualquier tipo de DTE. Define el tipo con sii_document_type_code. Incluye issue: true para emitir inmediatamente.

Ejemplo — Factura de Venta (cURL)

curl -X POST https://api.wasabil.com/api/documents \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sii_document_type_code": 33,
    "issue": true,
    "payment_method": "contado",
    "receiver_rut": "12345678-9",
    "receiver_name": "Cliente SpA",
    "receiver_email": "facturacion@cliente.cl",
    "details": [
      {
        "name": "Consultoría desarrollo web",
        "price": 100000,
        "quantity": 1
      }
    ],
    "notification_url": "https://tu-app.com/webhooks/wasabil"
  }'

Ejemplo — Boleta (JavaScript / Node.js)

const response = await fetch('https://api.wasabil.com/api/documents', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.WASABIL_TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    sii_document_type_code: 39,   // Boleta de Venta
    issue: true,
    payment_method: 'contado',
    details: [
      { name: 'Suscripción mensual', price: 9990, quantity: 1 }
    ]
  })
});

const { data } = await response.json();
console.log(data.folio);              // folio asignado por el SII
console.log(data.document_pdf_url);  // URL del PDF

Ejemplo — Factura de Compra / servicios digitales (Python)

import requests

resp = requests.post(
    'https://api.wasabil.com/api/documents',
    headers={
        'Authorization': f'Bearer {WASABIL_TOKEN}',
        'Content-Type': 'application/json'
    },
    json={
        'sii_document_type_code': 46,   # Factura de Compra
        'issue': True,
        'payment_method': 'contado',
        'receiver_rut': '59.015.491-7',
        'receiver_name': 'Google LLC',
        'details': [{
            'name': 'Google Ads - Mayo 2026',
            'price': 84034,
            'quantity': 1
        }]
    }
)
doc = resp.json()['data']
print(doc['folio'])  # folio SII

Emisión masiva — hasta 100 documentos por request

// POST /api/documents/bulk — array de hasta 100 objetos
[
  {
    "sii_document_type_code": 39,
    "issue": true,
    "payment_method": "contado",
    "details": [{ "name": "Venta #001", "price": 9990, "quantity": 1 }]
  },
  {
    "sii_document_type_code": 39,
    "issue": true,
    "payment_method": "contado",
    "details": [{ "name": "Venta #002", "price": 14990, "quantity": 2 }]
  }
]

Consultar y gestionar documentos

Filtros de búsqueda

// POST /api/documents/query
{
  "page": 1,
  "perPage": 50,
  "siiDocumentTypeCode": "33",
  "fromDocumentDate": "2026-05-01",
  "toDocumentDate": "2026-05-31",
  "search": "folio:1234",      // también: tipo:33, ref:OC-9876, receptor:12345678-9
  "statusId": 3,               // 3 = Emitidos
  "received": false            // false = emitidos, true = recibidos
}

Webhooks

Al crear un documento con notification_url, Wasabil envía un POST a esa URL cada vez que cambia de estado. El body contiene el documento completo. Reintentos automáticos si no recibe HTTP 200.

// Body del webhook — documento emitido
{
  "uuid":                  "36cdebc2-79b7-402f-ac91-1534d003a91b",
  "document":              90000000005953,   // ID numérico interno
  "sii_document_type_id":  33,
  "status_id":             3,                // 3=Emitido · 4=Fallido · 6=Pendiente
  "folio":                 "1234",
  "document_date":         "2026-05-14",
  "company_id":            2337,
  "client_id":             111481,
  "receiver_rut":          "12.345.678-9",
  "receiver_name":         "Cliente SpA",
  "currency_id":           1,
  "current_nsubtotal":     100000,
  "current_niva":          19000,
  "current_ntotal":        119000,
  "invoice_reference":     "OC-9876",
  "error_code":            null,
  "display_error":         null,
  "has_document_pdf":      true,
  "document_pdf_url":      "https://api.wasabil.com/api/documents/.../document-pdf/...",
  "document_xml_url":      "https://api.wasabil.com/api/documents/.../document-xml/...",
  "status_updated_at":     "2026-05-14T10:31:15.000000Z",
  "details": [
    { "name": "Consultoría", "quantity": 1, "price": 100000, "total": 119000 }
  ]
}

Otros módulos de la API

Clientes

CRUD completo con metafields, múltiples direcciones y giros por cliente.

Conciliación bancaria

Vincula movimientos bancarios con documentos emitidos o recibidos.

Metafields

Campos personalizados (Centro de Costos, Categoría, Proyecto, etc.) aplicables a documentos, clientes y proveedores.

// Asignar metafield a un documento
PUT /api/documents/{uuid}/metafields/proyecto
{ "value": "ecommerce-2026" }

Sandbox

Los documentos creados en sandbox incluyen "sandbox": true. Usa estos endpoints para simular estados sin depender del SII:

Preguntas frecuentes