API de DTE: emite facturas y boletas electrónicas al SII

Introducción #

Si tienes un sistema propio necesitas emitir DTE desde tu aplicación. La API de YAMT integra la facturación electrónica del SII con endpoints JSON simples, sin que tengas que manejar SOAP, XML ni almacenar certificados en tu servidor.

Todos los endpoints viven bajo https://app.yamt.com/api y se enrutan por el RUT del emisor:

El {rut} es el del emisor (empresa que factura), con guión y dígito verificador — por ejemplo 76123456-7. Todas las respuestas son JSON con un campo ok booleano.

Autenticación #

La API usa API keys con formato yamt_…. Genéralas y revócalas desde tu dashboard (máximo 5 activas por cuenta). Cada key se asocia a un emisor y a un rol.

Envía la key en el header Authorization como Bearer token:

Authorization: Bearer yamt_a1b2c3d4e5f6...
Content-Type: application/json

Quickstart #

Emitir una factura electrónica (tipo 33) en una sola llamada:

curl -X POST https://app.yamt.com/api/76123456-7/emitir \
  -H "Authorization: Bearer yamt_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": 33,
    "receiver": {
      "rut": "12345678-9",
      "name": "Comercial Ejemplo Ltda",
      "activity": "Venta al por menor",
      "address": "Av. Siempre Viva 742",
      "city": "Santiago",
      "email": "pagos@ejemplo.cl"
    },
    "items": [
      { "name": "Asesoría mensual", "qty": 1, "price": 150000 },
      { "name": "Hosting", "qty": 12, "price": 8000 }
    ]
  }'

YAMT calcula neto, IVA y total automáticamente, consume un folio del CAF, firma y envía al SII. La respuesta incluye el folio asignado, el track_id y las URLs del PDF y XML.

Ambientes y sandbox #

El ambiente lo determina la configuración SII del emisor (sii_ambiente), no la API key.

• Sandbox (emisor en ambiente de prueba): la emisión valida y guarda el documento localmente, sin enviarlo al SII. La respuesta trae env: "sandbox", sii: null y no genera track_id. Ideal para validar tu integración sin costo.
• Producción / live: valida certificado y folios, firma, envía al SII y devuelve env: "live" con el bloque sii (estado y track id).

Emitir un DTE #

Un único endpoint emite cualquier tipo de documento; el campo type decide cuál. También puedes usar POST /api/emitir pasando issuer_rut en el body.

Requiere rol owner o editor. En producción, antes de emitir se valida que el emisor tenga certificado digital vigente y folios CAF disponibles para ese tipo.

Tipos de documento #

Valores válidos para type:

Cuerpo del request #

Todos los campos van en JSON. Los montos son enteros en pesos (CLP); YAMT calcula neto, IVA, exento y total por ti.

Campos raíz

receiver — receptor

req* — rut y name son obligatorios salvo en boletas (39/41), donde el receptor puede omitirse.

items[] — líneas

refs[] — referencias (obligatorio en NC/ND)

shipping — transporte (guías 52)

Respuesta #

Respuesta 200 al emitir en producción. En sandbox, sii es null.

{
  "ok": true,
  "env": "live",
  "document": {
    "id": 4821,
    "type": 33,
    "type_name": "Factura electrónica",
    "folio": 137,
    "date": "2026-07-25",
    "issuer": { "rut": "76123456-7", "name": "Mi Empresa SpA" },
    "receiver": { "rut": "12345678-9", "name": "Comercial Ejemplo Ltda", "email": "pagos@ejemplo.cl" },
    "amounts": { "net": 246000, "tax": 46740, "tax_rate": 19, "exempt": 0, "total": 292740 },
    "items": [ { "name": "Asesoría mensual", "qty": 1, "price": 150000, "subtotal": 150000, "exempt": false } ],
    "refs": null,
    "shipping": null
  },
  "sii": { "status": "enviado", "track_id": "9182736450", "response": "..." },
  "pdf_url": "https://app.yamt.com/api/76123456-7/pdf/33/137?tk=abc123",
  "xml_url": "https://app.yamt.com/api/76123456-7/xml/33/137?tk=abc123"
}

Consultar estado en el SII #

Consulta el estado de un DTE ya emitido en el SII. Body: type y folio.

curl -X POST https://app.yamt.com/api/76123456-7/emision_estado_dte \
  -H "Authorization: Bearer yamt_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": 33, "folio": 137 }'

Listar emisiones #

Lista los documentos emitidos, con filtros y paginación. Query params:

Respuesta: { "ok": true, "data": [...], "total": N, "page": 1, "limit": 30 }.

Descargar PDF y XML #

Descarga el PDF con timbre PDF417 o el XML firmado. Autenticación por API key o por el token público tk que viene en pdf_url / xml_url (útil para compartir el documento sin exponer la key).

• ?download=1 — fuerza descarga como adjunto.
• ?base64=1 — devuelve el archivo en base64 dentro de un JSON.

Folios CAF #

Consulta los folios CAF disponibles por tipo de documento.

Solicita nuevos rangos de folios al SII. Body: tipo_dte y cantidad.

Anular un DTE #

No existe un endpoint de anulación. Para dejar sin efecto un documento, emite una nota de crédito (type: 61) que lo referencie en refs.

{
  "type": 61,
  "receiver": { "rut": "12345678-9", "name": "Comercial Ejemplo Ltda" },
  "items": [ { "name": "Anulación factura 137", "qty": 1, "price": 292740 } ],
  "refs": [
    { "type": 33, "folio": 137, "date": "2026-07-25", "reason": "Anula documento" }
  ]
}

Errores #

Los errores devuelven { "ok": false, "error": "mensaje" } con el código HTTP correspondiente.

{ "ok": false, "error": "Sin folios disponibles para Factura electrónica. Solicita folios CAF al SII." }

Preguntas frecuentes #

Dudas habituales al integrar la API de facturación electrónica.

Roadmap #

• Webhooks de estado SII — notificación a tu URL cuando el SII acepta, rechaza u observa un DTE.
• SDKs oficiales — PHP, Python y Node.js.