Integración para la emisión de DTE

Sigue los pasos para emitir documentos tributarios desde tu software usando API Gayeway.

Consultar Estado del Envío

Después de enviar un documento al SII y recibir un Track ID, es fundamental consultar el estado del procesamiento. El SII no procesa los documentos instantáneamente, por lo que debes implementar un mecanismo de consulta para conocer el resultado final.


Endpoint y Estructura

URL del Servicio

[POST] https://legacy.apigateway.cl/api/v1/libredte/dte/envios/estado

Parámetro de Query

Parámetro Tipo Default Descripción
certificacion int 0 1: Ambiente de certificación
0: Ambiente de producción

Estructura del Request

Para Documentos NO Boletas

Para facturas, guías de despacho, notas de crédito/débito:

{
    "auth": {
        "cert": {
            "cert-data": "certificado_en_base64",
            "pkey-data": "llave_privada_en_base64"
        }
    },
    "emisor": "76192083-9",
    "track_id": "82484882"
}

Para Boletas Electrónicas

Las boletas requieren información adicional:

{
    "auth": {
        "cert": {
            "cert-data": "certificado_en_base64",
            "pkey-data": "llave_privada_en_base64"
        }
    },
    "emisor": "76192083-9",
    "track_id": 14112302429,
    "dte": 39,
    "folio": 112
}

Diferencias Clave

Tipo Documento Campos Requeridos Observación
Facturas y otros emisor, track_id Consulta simple
Boletas emisor, track_id, dte, folio Requiere tipo y folio

Estructura de la Respuesta

Respuesta Típica

{
    "track_id": "82484882",
    "certificacion": 0,
    "revision_estado": "DOK - Documento Recibido",
    "revision_detalle": null
}

Respuesta con Error

{
    "track_id": "82484883",
    "certificacion": 0,
    "revision_estado": "RCT - Rechazado por Error en Caratula",
    "revision_detalle": "ERROR EN RUT RECEPTOR: DIGITO VERIFICADOR INCORRECTO"
}

Estados Posibles

Estados Principales (No Boletas)

Estado Código Significado Acción Requerida
Aceptado DOK Documento procesado correctamente Generar PDF, notificar
Aceptado con Reparos DNK Válido pero con observaciones Revisar reparos, continuar
Rechazado RCH, RCT, RCF Documento con errores Corregir y reenviar
En Proceso EPR Aún procesando Consultar nuevamente

Códigos de Rechazo Detallados

Código Descripción Causa Común
RCH Rechazado por Error en Schema Estructura XML incorrecta
RCT Rechazado por Error en Carátula Datos del envío incorrectos
RCF Rechazado por Error en Firma Problema con certificado digital
SOK Schema Validado Primera validación OK (temporal)

Estados de Boletas Electrónicas

Consulta de Boletas

Para boletas, el campo folio tiene un comportamiento especial:

Valor folio Comportamiento Uso Recomendado
Número específico Busca ese folio exacto Consulta individual
0 o no incluido Estado general del envío Consulta masiva

Particularidades de Boletas

  • Pueden enviarse múltiples boletas en un solo envío
  • El estado general puede diferir del estado individual
  • Importante verificar cada folio si hay problemas

Estados Boletas Electrónicas

On this page

Last updated on 28/08/2025 by Anonymous