# Guía operativa para la emisión de DTE

> **Propósito.** Esta guía describe el proceso que una plataforma de facturación debe controlar para emitir Documentos Tributarios Electrónicos (DTE) en Chile mediante el SII.
>
> **Fuente de autoridad.** No reemplaza la normativa, los esquemas XML ni los manuales vigentes del SII. Ante una diferencia, prevalecen siempre las publicaciones oficiales del SII y los XSD vigentes.
>
> **Documento de referencia.** Elaborado a partir del *Instructivo técnico para la emisión de documentos* del SII, versión 28-10-2021. Sus ejemplos y valores históricos no deben usarse como configuración productiva sin verificar su vigencia.

## Contenido

1. [Alcance y responsabilidades](#alcance-y-responsabilidades)
2. [Flujo de emisión](#flujo-de-emisión)
3. [Prerequisitos por empresa](#prerequisitos-por-empresa)
4. [Checklist previo a emitir](#checklist-previo-a-emitir)
5. [Construcción y firma del DTE](#construcción-y-firma-del-dte)
6. [Envío, intercambio y seguimiento](#envío-intercambio-y-seguimiento)
7. [Checklist posterior al envío](#checklist-posterior-al-envío)
8. [Certificación con el SII](#certificación-con-el-sii)
9. [Controles, errores y recuperación](#controles-errores-y-recuperación)
10. [Referencias y glosario](#referencias-y-glosario)

---

## Alcance y responsabilidades

Esta guía cubre el ciclo de vida de un DTE: preparación de la empresa, asignación de folio, generación de XML, timbraje, firma, validación, transmisión, seguimiento y conservación de evidencias. Incluye facturas, boletas, notas de crédito, notas de débito y otros tipos que estén habilitados para la empresa.

| Actor | Responsabilidades principales |
| --- | --- |
| Empresa emisora | Mantener habilitación SII, firmantes, certificados vigentes, CAF autorizados, datos tributarios y casilla de intercambio. |
| Plataforma de facturación | Custodiar secretos, controlar folios, construir y validar XML, firmar, registrar trazabilidad, transmitir y exponer estados verificables. |
| SII | Autorizar contribuyentes, firmantes y rangos de folios; publicar esquemas; recibir envíos y entregar sus respuestas o estados. |
| Receptor | Recibir el intercambio de DTE y emitir los acuses o respuestas comerciales que correspondan. |

### Límite importante

Un XML generado o un PDF descargable **no prueban** que el DTE fue aceptado por el SII. La plataforma debe conservar la respuesta del envío, su identificador de seguimiento y el resultado posterior de la consulta de estado.

## Flujo de emisión

```text
Empresa habilitada y configurada
        ↓
Certificado vigente + firmante autorizado + CAF válido
        ↓
Validar datos comerciales y tributarios
        ↓
Reservar un folio único para el tipo de DTE
        ↓
Construir XML del Documento
        ↓
Generar TED con el CAF correspondiente
        ↓
Firmar XML completo con certificado de la empresa
        ↓
Validar XML/XSD y controles de negocio
        ↓
Persistir evidencia y generar representación impresa
        ↓
Armar, firmar y enviar el SetDTE al SII
        ↓
Registrar Track ID, consultar estado e intercambiar con receptor
```

No avance al paso siguiente cuando el anterior no haya terminado correctamente. En particular, no se debe reutilizar un folio una vez que fue comprometido en un documento o un intento de envío que deba conservarse para auditoría.

## Prerequisitos por empresa

### Habilitación ante el SII

Antes de operar, confirme que la empresa:

- Está incorporada o habilitada para emitir los tipos de DTE requeridos.
- Tiene un Usuario Administrador y los firmantes autorizados registrados ante el SII.
- Mantiene una casilla de correo de intercambio de información actualizada.
- Tiene número y fecha de resolución registrados para el ambiente que corresponda: certificación o producción.

### Certificado digital

El certificado se usa para la firma electrónica del documento y para operaciones de autenticación del SII. Controle como mínimo:

- Vigencia, revocación y pertenencia al firmante autorizado.
- Acceso sólo por componentes autorizados; nunca incluir el archivo, contraseña, llave privada ni contenido PFX/P12 en logs, respuestas HTTP o respaldos sin cifrar.
- Alertas previas a su vencimiento y procedimiento de reemplazo probado.
- Identidad del firmante que efectuó cada operación sensible.

### CAF y folios

Cada CAF autoriza un rango de folios para un tipo de documento. Al cargar un CAF:

1. Verifique que corresponda al RUT emisor y al tipo de DTE esperado.
2. Valide su firma y rango contra la información entregada por el SII.
3. Compruebe criptográficamente el par de llaves indicado en el CAF antes de habilitarlo.
4. Almacene CAF y llave de timbraje con cifrado y control de acceso.
5. Mantenga estados de folio: disponible, reservado, usado, anulado o agotado.

> Un CAF no es intercambiable entre empresas, tipos de DTE ni rangos. Seleccionar uno incorrecto invalida el timbre.

### Datos tributarios y comerciales

La empresa debe mantener datos consistentes y vigentes para construir el encabezado: RUT, razón social, giro, actividades económicas, dirección, comuna, ciudad y configuración de documentos autorizados. También valide los datos del receptor y las reglas específicas del tipo de documento antes de reservar un folio.

## Checklist previo a emitir

Use esta lista en cada solicitud de emisión:

- [ ] La empresa está habilitada en el ambiente correcto.
- [ ] El tipo de DTE está autorizado para la empresa.
- [ ] El certificado digital existe, está vigente y corresponde a un firmante autorizado.
- [ ] Hay un CAF válido y con folios disponibles para el tipo de documento.
- [ ] Los datos del emisor coinciden con la configuración tributaria de la empresa.
- [ ] El RUT, fecha de emisión, referencias, ítems y totales del receptor son válidos para el tipo de DTE.
- [ ] Los montos se recalcularon desde el detalle; no se confía ciegamente en totales enviados por un cliente.
- [ ] El proceso de reserva de folio impide asignar el mismo folio a dos documentos concurrentes.
- [ ] El intento tiene una clave de idempotencia o mecanismo equivalente para evitar duplicados ante reintentos.

Si cualquiera de estas validaciones falla, responda con un error claro y no genere ni reserve un documento utilizable sin conservar una traza de la causa.

## Construcción y firma del DTE

### 1. Asignar y registrar el folio

El folio debe ser único por tipo de DTE y empresa. La reserva debe ser transaccional o atómica frente a solicitudes concurrentes. Registre al menos: empresa, tipo, folio, CAF utilizado, instante de reserva, identificador de solicitud y estado.

No confunda **reservar** con **usar**. Defina explícitamente cuándo el folio queda consumido y asegure que los reintentos no creen otro documento para la misma operación comercial.

### 2. Construir el documento XML

Construya el documento conforme a los XSD vigentes del SII. El XML debe contener los datos obligatorios del encabezado, detalle, totales, referencias y campos específicos del tipo de DTE.

Validaciones mínimas:

- El tipo de DTE y el folio del XML coinciden con la reserva.
- RUT, fecha y totales tienen formato y consistencia tributaria.
- Las referencias son obligatorias y están en orden cuando el tipo de documento lo exige.
- El detalle genera los totales informados, incluidos neto, exento, IVA, descuentos y total cuando apliquen.
- La codificación y declaración XML son aceptadas por el esquema aplicable.

### 3. Generar el TED

El Timbre Electrónico del DTE (TED) incorpora el bloque `DD` y el CAF para representar datos esenciales del documento. Entre otros, considere RUT emisor, tipo DTE, folio, fecha, RUT y razón social del receptor, monto total y primer ítem de detalle, según la especificación del SII.

La firma del TED se genera con la llave de timbraje contenida en el CAF correspondiente. Preserve exactamente la serialización exigida: alteraciones de caracteres, espacios, codificación o campos cambian el resultado de la firma.

### 4. Firmar el XML completo

Después de incorporar el TED, aplique la firma XML del documento completo con el certificado digital vigente del firmante autorizado. La firma del TED y la firma XML son controles distintos; una no sustituye a la otra.

Antes del envío, valide:

- Presencia y ubicación de TED, `TmstFirma` y firma XML requeridos.
- Integridad de las firmas tras serializar el XML final.
- Vigencia del certificado a la fecha y hora de firma.
- Conformidad con los XSD aplicables.

### 5. Generar la representación impresa

La representación impresa debe incluir la información exigida y el código PDF417 derivado del TED. Es un respaldo visual; el XML firmado es el documento electrónico que se transmite y cuya integridad debe conservarse.

## Envío, intercambio y seguimiento

### Envío al SII

Los DTE se agrupan en un `SetDTE` con su carátula, se firma el envío y se transmite usando el mecanismo y ambiente publicados por el SII. Antes de enviar:

- Use credenciales y endpoints del ambiente configurado; no mezcle certificación y producción.
- Revise RUT emisor, RUT del enviador, resolución, fecha, tipos y cantidades declaradas en la carátula.
- Compruebe que cada DTE incluido fue validado y no fue enviado previamente de forma incompatible.

Después de enviar, guarde de forma inmutable el XML remitido, fecha/hora, respuesta inmediata, Track ID, reintentos y mensajes de error. La respuesta técnica inicial no equivale necesariamente a aceptación definitiva.

### Intercambio con el receptor

La empresa debe poder enviar y recibir los XML de DTE y las respuestas o acuses que corresponda a través de la casilla de intercambio registrada. Controle la identidad del emisor, integridad de adjuntos, duplicados, trazabilidad de recepción y conservación de los mensajes.

### Estados que debe distinguir la plataforma

Modele el estado local por separado de la respuesta externa. Como mínimo, diferencie:

- Borrador o validación fallida.
- Folio reservado y documento en construcción.
- Firmado y pendiente de envío.
- Enviado, con Track ID.
- Recibido técnicamente, en proceso, aceptado, aceptado con reparos o rechazado, según la respuesta obtenida.
- Fallo recuperable de transporte o autenticación.

El nombre exacto y los códigos deben provenir de la respuesta vigente del SII; no convierta un estado desconocido en “aceptado”.

## Checklist posterior al envío

- [ ] Se conserva el XML final firmado y su versión original de entrada cuando corresponda.
- [ ] Se almacenó Track ID, fecha/hora, ambiente, solicitud y respuesta del envío.
- [ ] El estado consultado se registró con el payload de respuesta y no sólo como texto resumido.
- [ ] Se enviaron o encolaron los intercambios y acuses al receptor cuando corresponda.
- [ ] La representación PDF417 usa el TED del XML final.
- [ ] El folio quedó en el estado correcto y no puede reasignarse.
- [ ] Los errores de negocio son visibles para un operador, sin exponer certificados, CAF ni XML sensible a usuarios no autorizados.
- [ ] Se generaron alertas para CAF por agotarse, certificado próximo a vencer o envíos pendientes de resolución.

## Certificación con el SII

La certificación debe tratarse como un ambiente y expediente separados de producción. Para el set de pruebas:

1. Solicite los folios por tipo de DTE en el ambiente de certificación.
2. Construya cada caso exactamente con los datos, orden de detalle y referencias indicados por el SII.
3. Use la referencia `SET` y la razón `CASO xxxxx-x` donde el instructivo del set lo exige.
4. Envíe el conjunto para revisión con la carátula y datos de resolución del ambiente de certificación.
5. Si un caso aceptado con reparos debe reenviarse, use un folio distinto; no reutilice el folio previo.
6. Conserve los resultados de cada caso, correcciones aplicadas y evidencias de aceptación.

Consulte las instrucciones detalladas en [Construcción de DTE con datos del set de pruebas](./inst_set_pruebas.md). La aprobación de casos de prueba no autoriza por sí sola una configuración de producción: complete todos los hitos exigidos por el SII.

## Controles, errores y recuperación

| Situación | Acción requerida |
| --- | --- |
| Sin CAF o sin folios | Detener la emisión; cargar o habilitar un CAF válido. No inventar ni reciclar folios. |
| XML no válido contra XSD | No firmar ni enviar. Registrar errores por campo y corregir datos o generador. |
| Error de firma o certificado vencido | Detener el flujo; rotar o corregir el certificado antes de reintentar. |
| Error de transporte o token | Conservar el intento, obtener diagnóstico y reintentar de forma idempotente. Antes de reenviar, comprobar si el SII ya recibió el envío. |
| Rechazo técnico o comercial | Guardar el código y detalle original; generar una acción de corrección conforme a la normativa y al tipo de documento. |
| Folio comprometido en un intento | No reasignarlo automáticamente. Un operador debe resolverlo según evidencia de emisión, envío y respuesta SII. |
| Inconsistencia entre XML, base de datos y PDF | Marcar el documento para revisión y preservar todos los artefactos. No regenerar silenciosamente una versión diferente. |

### Seguridad y auditoría

- Cifre certificados, contraseñas, CAF y llaves privadas tanto en reposo como en tránsito.
- Aplique aislamiento estricto por empresa: una identidad autenticada no puede seleccionar libremente otra empresa mediante cabeceras o payloads.
- Registre quién, cuándo y desde qué operación cargó, activó, reemplazó o revocó certificados y CAF.
- Proteja las descargas de XML y PDF mediante autorización por empresa y roles.
- Mantenga registros de auditoría y artefactos suficientes para reconstruir cada emisión sin exponer secretos.

## Relación con api-factura

El módulo SII de `api-factura` concentra los componentes de certificados, CAF, folios, perfil de certificación y DTE. Para conocer los contratos HTTP disponibles, consulte la [referencia OpenAPI interactiva](/docs/api).

`DteService` contiene operaciones para construir DTE, obtener token, generar TED, validar XML, transmitir, consultar estado y descargar XML/PDF. Esta guía describe el resultado operativo esperado; cada endpoint debe verificarse contra su implementación y pruebas antes de declararlo apto para producción.

## Referencias y glosario

### Fuentes y documentos relacionados

- [Formato XML y recursos oficiales del SII](./formato-xml.md): punto de partida para descargar los XSD y diagramas vigentes.
- [Construcción de DTE con datos del set de pruebas](./inst_set_pruebas.md): reglas específicas de los casos de certificación.
- Sitio oficial del SII: confirme manuales, resoluciones, endpoints y esquemas antes de cada release o habilitación de empresa.

### Glosario

| Término | Definición |
| --- | --- |
| **CAF** | Código de Autorización de Folios entregado por el SII para un rango y tipo de DTE. |
| **DTE** | Documento Tributario Electrónico. |
| **TED** | Timbre Electrónico del DTE, firmado usando la llave de timbraje del CAF. |
| **SetDTE** | Contenedor de uno o más DTE que se firma y remite al SII. |
| **Track ID** | Identificador de seguimiento de un envío, entregado por el SII cuando aplica. |
| **XSD** | Esquema XML con el que se valida la estructura de DTE y envíos. |
| **PDF417** | Simbología bidimensional utilizada en la representación impresa del TED. |

---

## Historial documental

| Fecha | Cambio |
| --- | --- |
| 2026-08-28 | Se reemplaza la transcripción paginada del instructivo SII por esta guía operativa. |
