API de Facturación Electrónica

Emite documentos tributarios electrónicos (DTE) ante el SII de Chile desde cualquier sistema, con una sola llamada HTTP. Diseñada para integradores, ERPs y plataformas de software.

Introducción

La API de Lael permite emitir, consultar y descargar documentos tributarios electrónicos ante el Servicio de Impuestos Internos (SII) de Chile. Está basada en REST, usa JSON en todas las respuestas y sigue el patrón asíncrono: el request inicial retorna HTTP 202 de forma inmediata con un tracking_id, y el resultado final se entrega vía webhook.

URL base

# Producción
https://api.lael.cl/v1

# Sandbox / Certificación SII (documentos sin validez legal)
https://apicert.lael.cl/v1

Autenticación

Todas las rutas requieren el header X-API-Key con tu API Key:

X-API-Key: lael_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Las API Keys son secretas y deben transmitirse únicamente desde tu servidor (nunca desde el browser o app móvil). Si una key es comprometida, puedes revocarla desde el portal de partners y generar una nueva.

Sandbox vs Producción

Inicio rápido (5 minutos)

1. Crea tu cuenta y obtén una API Key sandbox.

2. Sube tu certificado .p12 en el portal o vía API.

3. Emite tu primer DTE:

curl -X POST https://apicert.lael.cl/v1/dte/generar \
  -H "X-API-Key: lael_test_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "Documento": {
      "Encabezado": {
        "IdentificacionDTE": { "TipoDTE": 33, "FechaEmision": "2026-05-30" },
        "Emisor":   { "Rut": "76.123.456-7", "RazonSocial": "Mi Empresa SpA",
                      "GiroEmis": "Servicios TI", "DireccionOrigen": "Av. X 123",
                      "ComunaOrigen": "Santiago", "Ciudad": "Santiago" },
        "Receptor": { "Rut": "12.345.678-9", "RazonSocial": "Cliente SA",
                      "Direccion": "Calle Y 456", "Comuna": "Las Condes" },
        "Totales":  { "MontoNeto": 100000, "TasaIVA": 19, "IVA": 19000,
                      "MontoTotal": 119000 }
      },
      "Detalles": [{ "Nombre": "Servicio de desarrollo", "Cantidad": 1,
                     "Precio": 119000, "MontoItem": 119000 }]
    },
    "Certificado": { "Rut": "76123456-7", "Password": "mi_password_p12" }
  }'

<?php
// Con SDK PHP: composer require lael-cl/sdk
use LaelCl\Client;
use LaelCl\Dte\FacturaAfecta;

$lael = new Client('lael_test_xxxxxxxxxxxxxxxx');

$factura = FacturaAfecta::make()
    ->emisor('76.123.456-7', 'Mi Empresa SpA')
    ->receptor('12.345.678-9', 'Cliente SA')
    ->agregar('Servicio de desarrollo', cantidad: 1, precio: 100000)
    ->total(119000, neto: 100000, iva: 19000);

$resultado = $lael->dte()->emitir($factura)->esperar(timeoutSeg: 60);

echo $resultado->folio;       // Folio asignado
echo $resultado->urls->pdf;  // URL permanente del PDF

4. Consulta el estado con GET /v1/dte/status/{tracking_id} o espera el webhook.

POST /v1/dte/generar

Emite un DTE ante el SII. Responde HTTP 202 de forma inmediata con un tracking_id. El documento se procesa en segundo plano.

{
  "ok": true,
  "data": {
    "tracking_id":     "01HWXYZ1234ABCDEF567890AB",
    "status":          "pendiente",
    "tipo_dte":        33,
    "rut_emisor":      "76.123.456-7",
    "sandbox":         false,
    "idempotency_key": "mi-erp-doc-9999",
    "urls": {
      "status": "https://api.lael.cl/v1/dte/status/01HWXYZ...",
      "pdf":    "https://api.lael.cl/v1/dte/doc/a1b2c3d4e5f6.../pdf",
      "xml":    "https://api.lael.cl/v1/dte/doc/b2c3d4e5f6a1.../xml"
    },
    "estimado_ms": 8000
  }
}

GET /v1/dte/status/{tracking_id}

Consulta el estado de un documento. Úsalo para polling o para verificar el resultado final.

{
  "ok": true,
  "data": {
    "tracking_id": "01HWXYZ...",
    "status":      "completado",
    "tipo_dte":    33,
    "folio":       125,
    "rut_emisor":  "76.123.456-7",
    "monto_total": 119000,
    "emitido_at":  "2026-05-30T14:32:11-04:00",
    "sii": {
      "track_id": "987654321",
      "estado":   "EPR",
      "glosa":    "Envio Procesado"
    },
    "urls": { "pdf": "...", "xml": "..." },
    "intentos":  1,
    "error":     null
  }
}

GET /v1/dte/doc/{url_token}/pdf

GET /v1/dte/doc/{url_token}/xml

POST /v1/partner/webhook

GET /v1/partner/uso

{
  "ok": true,
  "data": {
    "periodo":          "2026-05",
    "total_emitidos":  87,
    "total_rechazados": 2,
    "desglose_tipo":   [{ "tipo_dte": 33, "emitidos": 85 }]
  }
}

POST /v1/partner/cert

curl -X POST https://api.lael.cl/v1/partner/cert \
  -H "X-API-Key: lael_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "rut_emisor": "76123456-7",
    "p12_base64": "'"$(base64 -w0 /ruta/certificado.p12)"'",
    "password":   "mi_password"
  }'

Tipos de DTE soportados

Webhooks

Lael envía un POST a tu URL cuando el estado de un DTE cambia. El body es JSON y está firmado con HMAC-SHA256.

Eventos disponibles

Estructura del payload

{
  "evento":      "dte.completado",
  "tracking_id": "01HWXYZ1234ABCDEF567890AB",
  "timestamp":   "2026-05-30T18:32:15Z",
  "sandbox":     false,
  "data": {
    "tipo_dte":   33,
    "folio":      125,
    "rut_emisor": "76.123.456-7",
    "monto_total":119000,
    "sii_estado": "EPR",
    "urls": {
      "pdf": "https://api.lael.cl/v1/dte/doc/.../pdf",
      "xml": "https://api.lael.cl/v1/dte/doc/.../xml"
    }
  }
}

Verificar la firma HMAC-SHA256

$body   = file_get_contents('php://input');
$secret = 'tu_webhook_secret';
$firma  = 'sha256=' . hash_hmac('sha256', $body, $secret);

if (!hash_equals($firma, $_SERVER['HTTP_X_LAEL_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

$data = json_decode($body, true);
// Procesar $data['evento'], $data['tracking_id'], etc.

const crypto = require('crypto');

app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const firma    = 'sha256=' + crypto
    .createHmac('sha256', process.env.LAEL_WEBHOOK_SECRET)
    .update(req.body)
    .digest('hex');

  if (firma !== req.headers['x-lael-signature']) {
    return res.status(401).send('Unauthorized');
  }

  const data = JSON.parse(req.body);
  console.log(data.evento, data.tracking_id);
  res.sendStatus(200);
});

import hmac, hashlib
from flask import request, abort

SECRET = b'tu_webhook_secret'

@app.route('/webhook', methods=['POST'])
def webhook():
    body      = request.get_data()
    firma     = 'sha256=' + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
    recibida  = request.headers.get('X-Lael-Signature', '')

    if not hmac.compare_digest(firma, recibida):
        abort(401)

    data = request.json
    return '', 200

Manejo de errores

Todas las respuestas de error usan el campo ok: false y error con descripción en español.

{
  "ok":    false,
  "error": "TipoDTE 99 no es soportado. Soportados: 33, 34, 39, 41, 46, 52, 56, 61, 110, 111, 112"
}

Límites y tarifas

Rate limits

Planes

Servicios de Certificación SII (pago único + IVA)

Cuando tu sistema necesita certificarse ante el SII para emitir un tipo de documento, puedes contratar el servicio de certificación con Lael. Realizamos el proceso completo por ti.

Licencias de Software (pago único)

Para integradores que prefieren operar en su propia infraestructura sin suscripción mensual.

SDK PHP

Instala el SDK oficial vía Composer para una integración con tipado fuerte, polling automático y manejo de errores:

composer require lael-cl/sdk

<?php
use LaelCl\Client;
use LaelCl\Dte\FacturaAfecta;
use LaelCl\Dte\NotaCredito;
use LaelCl\Exception\DteRechazadoException;

$lael = new Client('lael_live_xxxxxxxx');

// ─── Emitir factura afecta ───────────────────────────────────────
$factura = FacturaAfecta::make()
    ->emisor('76.123.456-7', 'Mi Empresa SpA')
    ->receptor('12.345.678-9', 'Cliente SA')
    ->agregar('Consultoría', cantidad: 1, precio: 500000)
    ->total(595000, neto: 500000, iva: 95000);

try {
    $r = $lael->dte()->emitir($factura)->esperar(timeoutSeg: 60);

    echo "Folio: "  . $r->folio      . PHP_EOL;
    echo "PDF:   "  . $r->urls->pdf  . PHP_EOL;
    echo "Track: "  . $r->sii->trackId . PHP_EOL;

} catch (DteRechazadoException $e) {
    // SII rechazó el documento
    error_log("DTE rechazado: " . $e->getMessage());
}

// ─── Verificar webhook ────────────────────────────────────────────
use LaelCl\Webhook\WebhookVerifier;

$body  = file_get_contents('php://input');
$firma = $_SERVER['HTTP_X_LAEL_SIGNATURE'];

if (WebhookVerifier::verify($body, $firma, 'mi_secret')) {
    $data = json_decode($body, true);
    // $data['evento'] === 'dte.completado'
}