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ón0 : 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
On this page
Last updated on 28/08/2025
by Anonymous