Flujo General de Emisión de un DTE

La emisión de un Documento Tributario Electrónico no es solo generar un XML. Es un proceso que involucra múltiples pasos, validaciones y actores. En esta lección veremos el flujo completo desde que se origina la necesidad del documento hasta que llega al receptor.

Visión General del Proceso

El proceso de emisión de un DTE se puede dividir en 4 grandes etapas:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   GENERAR   │ --> │   ENVIAR    │ --> │  CONSULTAR  │ --> │ DISTRIBUIR  │
│     XML     │     │   AL SII    │     │   ESTADO    │     │     PDF     │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘

Paso 1: Generar XML del DTE

¿Qué sucede en este paso?

1. Tu sistema envía los datos del documento a API Gateway
2. API Gateway valida y normaliza la información
3. Se genera el XML según el formato del SII
4. Se aplica la firma electrónica

Datos Requeridos

{
  "auth": {
    "cert": {
      "cert-data": "certificado en base64",
      "pkey-data": "llave privada en base64"
    }
  },
  "dte": {
    "Encabezado": { },
    "Detalle": [ ],
    "DscRcgGlobal": [ ]  // Opcional
  },
  "resolucion": {
    "fecha": "2019-12-23",
    "numero": 0
  },
  "caf": "CAF en base64"
}

Respuesta

{
  "dte": "XML solo del DTE en base64",
  "sii": "XML para enviar al SII en base64",
  "receptor": "XML para el receptor en base64"
}

Paso 2: Enviar XML al SII

¿Qué sucede en este paso?

1. Se toma el XML firmado (campo sii de la respuesta anterior)
2. Se envía al servidor del SII
3. El SII valida el documento
4. Retorna un Track ID para seguimiento

Solicitud

{
  "auth": {
    "cert": {
      "cert-data": "certificado",
      "pkey-data": "llave privada"
    }
  },
  "emisor": "76192083-9",
  "xml": "XML del campo 'sii' en base64"
}

Respuesta

{
  "track_id": 4753411374,
  "certificacion": 0
}

Consideraciones

• Timeout recomendado: 30 segundos
• Reintentos: Hasta 3 veces con espera exponencial
• Contingencia: Si falla, almacenar localmente

Paso 3: Consultar Estado del Envío

¿Qué sucede en este paso?

1. Con el Track ID consultas el estado del procesamiento
2. El SII puede tardar desde segundos hasta minutos
3. Obtienes el estado final del documento

Estados Posibles

Los estados principales que retorna el SII son:

Estados Específicos de Rechazo

Cuando un documento es rechazado, el campo revision_detalle puede contener:

• Error en RUT: RUT del emisor o receptor inválido
• Error en Folios: Folio ya utilizado o fuera de rango
• Error en Montos: Diferencias en cálculos de IVA o totales
• Error en Fechas: Fecha de emisión fuera de plazo
• Error en Referencias: Referencias a documentos inválidas (para NC/ND)

Solicitud para Consulta

{
  "auth": {
    "cert": {
      "cert-data": "certificado",
      "pkey-data": "llave privada"
    }
  },
  "emisor": "76192083-9",
  "track_id": "4753411374",
  "dte": "33",
  "folio": "1234567890"
}

Estrategia de Consulta

Intento 1: Inmediato
Intento 2: +5 segundos
Intento 3: +15 segundos
Intento 4: +30 segundos
Intento 5+: Cada 60 segundos (máximo 24 horas)

Paso 4: Generar y Distribuir PDF (Opcional)

¿Qué sucede en este paso?

1. Con el XML aceptado, generas la representación visual
2. El PDF incluye el timbre electrónico del SII
3. Se envía al receptor y se almacena

Formatos Disponibles

Manejo de Contingencias

Si el SII no responde

1. Guardar XML localmente
2. Asignar número de folio
3. Intentar envío cada 30 minutos
4. Máximo 72 horas para enviar

Si el documento es rechazado

1. Identificar el error específico
2. Corregir los datos
3. Generar nuevo XML
4. Usar nuevo folio (no reutilizar)
5. Reenviar al SII

Errores Comunes

El SII puede rechazar documentos por diversas razones:

Importante: El SII proporciona mensajes de error detallados en la respuesta. Siempre revisa el campo revision_detalle para obtener la descripción exacta del problema.