Emisión de DTE
¿Qué es la facturación electrónica?
Este curso parte de cero: no necesitas saber nada de facturación ni de impuestos. Al terminarlo vas a entender qué es un documento tributario, qué pide el SII y cómo emitirlo desde tu software con API Gateway V2.
Un documento tributario, en palabras simples
Cada vez que una empresa vende algo en Chile tiene que dejar constancia de esa venta ante el Servicio de Impuestos Internos (SII), que es la institución que cobra los impuestos. Esa constancia es un documento tributario: una factura, una boleta, una nota de crédito, una guía de despacho, etc.
Antes esos documentos se imprimían en talonarios de papel timbrados por el SII. Hoy son electrónicos, y por eso se llaman Documentos Tributarios Electrónicos, o DTE.
Un DTE tiene la misma validez legal que el documento en papel. La diferencia es que:
- No es un PDF: es un archivo XML con un formato definido por el SII.
- Va firmado electrónicamente por la empresa que lo emite, para probar quién lo hizo.
- Lleva un timbre electrónico que prueba que el SII autorizó su número (folio).
- Se envía al SII apenas se emite, para que el SII sepa de esa venta.
El PDF que ve el cliente es solo una representación impresa del XML. Lo que tiene validez tributaria es el XML.
La mayoría de las ventas en Chile pagan IVA (Impuesto al Valor Agregado), que es el 19% del precio neto. El documento tributario es la forma en que el SII sabe cuánto IVA cobró cada empresa y cuánto IVA pagó en sus compras. Por eso es tan importante que los montos del documento sean exactos.
¿Quién participa?
| Actor | Qué hace |
|---|---|
| Emisor | La empresa que vende y emite el documento. En tu integración es tu cliente (o tu propia empresa). |
| Receptor | Quien compra y recibe el documento: otra empresa o una persona. |
| SII | Autoriza los folios, recibe cada documento y valida que esté correcto. |
| Tu software | Junta los datos de la venta (quién compra, qué compra, cuánto cuesta) y llama a la API. |
| API Gateway | Arma el XML en el formato del SII, lo timbra, lo firma, lo envía al SII y genera el PDF. |
¿Qué resuelve API Gateway V2?
Armar un DTE “a mano” es difícil: el formato del SII tiene cientos de campos y reglas, el XML debe firmarse con criptografía y el envío al SII usa servicios web propios del SII. API Gateway V2 incluye la biblioteca de LibreDTE (el mismo núcleo de LibreDTE Edición Enterprise) y la expone como una API REST:
- Tú envías los datos del documento en JSON.
- La API calcula los totales e impuestos, timbra el documento con tu CAF y lo firma con tu certificado digital.
- La API envía el documento al SII, consulta el resultado y genera el PDF.
Tu sistema sigue siendo el dueño de los datos: decide qué emitir, guarda los XML y lleva el control de los folios.
Lo que vas a aprender
- Fundamentos: los conceptos, los tipos de documentos, los requisitos y el proceso completo.
- Preparación: cómo funciona la API, tu primera llamada, el certificado digital y los folios (CAF).
- Emisión paso a paso: desde los datos del documento hasta su PDF.
- Casos prácticos: una factura de principio a fin, notas de crédito, guías de despacho, facturas exentas y boletas.
- Paso a producción: errores frecuentes, buenas prácticas y la lista de verificación final.
Si todavía no tienes una conexión ni un token, revisa primero el curso Primeros pasos. Ahí se explica cómo crear la conexión, el token y cómo leer la documentación de la API.