¿Qué es un DTE? Los documentos tributarios electrónicos de Chile, explicados

Si vendes algo en Chile, emites DTE. Cada factura, boleta y nota de crédito viaja a la autoridad tributaria como un archivo XML firmado. Para quienes desarrollan, es uno de esos dominios que parecen "generar un XML y hacer un POST" y resultan ser una cadena de reglas contables y criptográficas, donde una diferencia de redondeo de un peso o un archivo vencido lo detiene todo. Este artículo explica el sistema desde el punto de vista de un desarrollador: qué es un DTE, qué tipos vas a encontrar, el ciclo de vida por el que pasa cada documento y los errores que atrapan a la mayoría de las integraciones.

¿Qué es un DTE?#

Un DTE (Documento Tributario Electrónico) es un documento tributario emitido de forma electrónica: un archivo XML, firmado por el emisor, que el SII (Servicio de Impuestos Internos) recibe y valida. La facturación electrónica es obligatoria para las empresas en Chile, así que para la mayoría los DTE no son opcionales: son, simplemente, la forma de documentar las ventas.

La idea más importante es que el XML es el documento. El PDF que le envías por correo a un cliente, o la boleta que se imprime en la caja, es solo una representación. Esa representación lleva un código de barras con un resumen firmado del original, para que cualquiera pueda comprobar que el papel coincide con lo que se informó.

Cada DTE se identifica por tres valores: el RUT del emisor, el tipo de documento y el folio. El SII no acepta dos documentos que compartan los tres.

Los nueve tipos de documento que vas a encontrar#

Cada tipo tiene un código numérico, y la mayoría de las integraciones solo usa unos pocos:

Las facturas muestran precios netos y suman el 19% de IVA; las boletas muestran precios con el IVA ya incluido. Las notas de crédito y débito nunca van solas: deben referenciar el documento que modifican.

El ciclo de vida de un DTE#

Antes del primer documento, la empresa tiene que ser autorizada por el SII como emisor electrónico, lo que significa aprobar su certificación: sets de prueba, libros, una simulación, un intercambio y muestras impresas, todo en el ambiente de certificación del SII. Después de eso, todo documento, sea del tipo que sea, pasa por las mismas cinco etapas.

1. Folios y el CAF. No puedes numerar documentos libremente. El SII autoriza folios por rangos, por tipo de documento, emitiendo un CAF (Código de Autorización de Folios): un archivo XML con el rango, tu RUT, la firma del SII y una llave privada. Esa llave es la que prueba que cada folio que usas fue autorizado.

2. El TED. Cada documento lleva un TED (Timbre Electrónico DTE), un pequeño bloque que resume los campos clave (RUT, tipo, folio, fecha, total, primer ítem), incluye el CAF y se firma con la llave privada del CAF. El TED es lo que se imprime como código de barras PDF417.

3. La firma. Luego el documento completo se firma con XMLDSig usando un certificado digital emitido a una persona autorizada para firmar por la empresa. El TED prueba el folio; la firma prueba quién lo emitió.

4. El envío. Los documentos firmados viajan en un sobre: EnvioDTE, o EnvioBOLETA para las boletas. Antes de subirlo, el cliente se autentica con el mismo certificado firmando una semilla que entrega el SII y canjeándola por un token. El SII responde con un track id.

5. La aceptación. Recibir un envío no es aceptarlo. El SII valida de forma asíncrona el esquema, las firmas, el TED y sus reglas de negocio, y cada documento termina aceptado, aceptado con reparos o rechazado. Recién ahí el documento está realmente emitido.

Errores comunes#

Redondear el IVA línea por línea#

Los montos de un DTE son pesos enteros, y el IVA se calcula sobre el neto total, no por línea. Toma dos líneas de $2.450 netos cada una. Redondear el IVA por línea da 465,5 → 466 dos veces, o sea 932. Calcularlo sobre el neto total de $4.900 da 931. Un peso de diferencia basta para que la validación del SII observe el documento, y solo aparece con ciertos precios, por eso sobrevive a las pruebas.

import { createDocument } from 'dte-sdk'
 
const doc = createDocument({
  type: 33,
  folio: 1024,
  issuer,   // { rut: '76543210-3', ... }
  receiver, // { rut: '12345678-5', ... }
  items: [
    { name: 'Soporte mensual', quantity: 1, unitPrice: 2450 },
    { name: 'Hosting mensual', quantity: 1, unitPrice: 2450 },
  ],
})
 
doc.header.totals
// { netAmount: 4900, vatRate: 19, vatAmount: 931, totalAmount: 5831 }

Dejar vencer un CAF#

Los CAF de facturas, facturas de compra y notas (33, 46, 56 y 61) vencen seis meses después de su autorización. Hay equipos que piden un rango generoso, usan una parte y meses después descubren que los folios restantes ya no sirven. Los folios sin usar pesan dos veces: mientras el SII raciona un tipo de documento, bajan la cantidad de folios que autoriza la próxima vez. Ajusta tus solicitudes a tu volumen real, vigila la fecha de vencimiento y pide el siguiente CAF antes de que el actual se quede sin folios o sin tiempo.

Enviar al ambiente equivocado#

El SII opera un ambiente de certificación para pruebas y uno de producción para documentos reales, y no comparten nada: un CAF de certificación no sirve en producción. El error caro es el inverso: los documentos de prueba enviados a producción son documentos tributarios reales. Haz que el ambiente sea un parámetro explícito, nunca un valor por defecto.

Mezclar codificaciones#

El SII trabaja en ISO-8859-1. Una dirección como "Huérfanos" codificada en UTF-8 en un paso y en ISO-8859-1 en otro produce, en el mejor caso, texto ilegible y, en el peor, una firma inválida, porque la firma cubre los bytes exactos. Elige una codificación en el borde y mantenla: arma el XML como texto y conviértelo a bytes ISO-8859-1 una sola vez, justo antes de que salga.

Confundir "recibido" con "aceptado"#

Un track id significa que el envío llegó, nada más. Guárdalo junto al folio, consulta el estado hasta que se resuelva y recién entonces entrega el documento al cliente.

Cómo lo modela dte-sdk#

dte-sdk asigna una función a cada etapa del ciclo de vida, y sus tipos siguen el mismo orden: signDocument() solo acepta un documento que stampDocument() ya timbró.

import { createDocument, stampDocument, signDocument } from 'dte-sdk'
import { createEnvelope, signEnvelope } from 'dte-sdk'
import { createSiiClient, uploadEnvelope, waitForUploadStatus } from 'dte-sdk'
 
const doc = createDocument({ type: 33, folio: 1024, issuer, receiver, items })
const stamped = stampDocument(doc, caf)             // TED, firmado con la llave del CAF
const signed = signDocument(stamped, certificate)   // XMLDSig con tu certificado
 
const envelope = signEnvelope(
  createEnvelope({
    kind: 'dte',
    documents: [signed],
    cover: {
      issuerRut: '76543210-3',
      senderRut: certificate.rut!,
      resolutionDate: '2024-01-15',
      resolutionNumber: 123,
    },
  }),
  certificate,
)
 
const sii = createSiiClient({ environment: 'certification', certificate, companyRut: '76543210-3' })
const { trackId } = await uploadEnvelope(sii, { envelope })
const status = await waitForUploadStatus(sii, { trackId })
status.status // 'accepted' | 'acceptedWithObjections' | 'rejected' | …

issueDocument({ document, caf, certificate }) hace los tres primeros pasos en una sola llamada. createDocument() valida RUT, montos y largos de los campos y calcula los totales con las reglas de redondeo de arriba, así que la mayoría de los errores aparecen como un DteError tipado en tu código en vez de un rechazo del SII. stampDocument() verifica que el folio esté dentro del rango del CAF, que el CAF corresponda al tipo de documento y al emisor, y que no esté vencido. El environment del cliente no tiene valor por defecto, y la semilla y el token se resuelven por ti. Los mensajes de error nunca incluyen RUT, nombres ni el texto de los ítems (el valor problemático va en los details del error), así que es seguro registrarlos.

La librería también cubre lo que rodea la emisión: los libros del SII, las solicitudes de folios y CAF en el portal del SII, el registro de compras y ventas, el proceso de certificación y las muestras impresas.

Para seguir leyendo#

• Conceptos clave: tipos de documento, CAF, TED, certificados y estados del SII en más detalle
• Inicio rápido: emite una factura tipo 33 de punta a punta
• Totales: cómo se calculan exactamente neto, exento, IVA y total
• Timbre (TED) y CAF: folios, validaciones del CAF y el TED
• Ejemplo de nota de crédito: referencias y anulación de una factura
• Certificación: el proceso del SII antes del primer documento real
• Seguridad: manejo de llaves del CAF, certificados y datos personales