De tu clave sk_test al primer DTE: emitir por API en 5 minutos

Si integras facturación electrónica a tu e-commerce, tu POS o tu SaaS, no necesitas entrar a ninguna pantalla: emites el DTE con una llamada REST. Tú mandas el JSON del documento y nosotros generamos el XML, lo firmamos con tu certificado, le ponemos el timbre y lo enviamos al SII. Esta es la ruta más corta, de tu clave de prueba al primer documento, en unos cinco minutos.

1. Crea tu cuenta y saca la clave sk_test

Primero crea tu cuenta. En el panel, sección de API keys, generas dos tipos de clave, con el mismo estilo que Stripe:

• sk_test_…: emite contra el ambiente de certificación del SII (Maullín). No gasta folios reales ni tiene valor tributario. Es donde pruebas todo.
• sk_live_…: emite de verdad, con folios reales y valor tributario. La misma llamada, cambiando solo la clave.

El paso a paso de las claves está en el manual de API keys. Empieza siempre con la sk_test.

2. Emite tu primer DTE con un curl

La emisión es un POST a /api/public/v1/dte. La clave va en el header X-Api-Key. Este ejemplo emite una factura afecta (tipo 33) por $297.500:

curl https://api.facturador.pulsandotech.cl/api/public/v1/dte \
  -H "X-Api-Key: sk_test_5f3a...e91" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_dte": 33,
    "fecha_emision": "2026-09-07",
    "receptor": { "rut": "76543210", "dv": "3", "razon_social": "Acme SpA" },
    "items": [{ "nombre": "Asesoría", "cantidad": 1, "precio_unitario": 250000, "monto_item": 250000 }],
    "totales": { "monto_neto": 250000, "monto_iva": 47500, "monto_total": 297500 }
  }'

Fíjate en el bloque de totales: los montos son enteros en pesos y tienen que cuadrar (neto + IVA = total). Si algo no cuadra o falta una clave obligatoria, la API te responde con el detalle del error antes de tocar al SII.

3. Lee la respuesta

Si el documento se aceptó para envío, recibes un 201 con el folio asignado y el estado local en pendiente:

{
  "id": 1042,
  "folio": 1042,
  "estado_local": "pendiente",
  "monto_total": 297500,
  "message": "DTE creado y encolado para envío al SII."
}

Importante: la emisión es asíncrona. El 201 no significa que el SII ya lo aceptó, significa que quedó encolado para envío. El SII nunca contesta al instante: emisión y envío son procesos separados.

4. Recibe el estado final por webhook

En vez de andar preguntándole al SII, configuras un webhook y nosotros te avisamos cuando el estado del documento cambia: aceptado, con reparo o rechazado. Así tu sistema reacciona solo. Si un rechazo te aparece con un código que no entiendes, tenemos el diccionario de rechazos del SII con la causa real de cada uno.

5. Pasa a producción con sk_live

Cuando la integración anda en sandbox, cambias la clave sk_test por sk_live y ya estás emitiendo de verdad. No cambia el endpoint ni el payload. Antes de emitir en producción, tu RUT tiene que estar certificado ante el SII y con folios (CAF) cargados; si vienes de otro facturador o del sistema gratuito del SII, te acompañamos en ese trámite.

Ojo con el plan: el plan Gratis son 5 DTE al mes, suficiente para probar la integración pero no para operar. Para facturar en serio necesitas al menos el plan Emprendedor.

Referencia completa

Este quickstart cubre el 80% de una integración. Para el detalle de cada campo, los tipos de DTE que puedes emitir (33, 34, 39, 41, 46, 52, 56 y 61), boletas, notas de crédito/débito y los webhooks, revisa la documentación de la API. Y si quieres entender qué código corresponde a cada documento, mira los tipos de DTE del SII.

¿Prefieres una vista general antes de escribir código? Así funciona la API de facturación. Cuando estés listo, crea tu cuenta y saca tu sk_test.