AppDTE - Servicio REST: trackingBoleta

El endpoint trackingboleta permite consultar el estado de una boleta electrónica enviada al SII. Para autenticar la solicitud, se utiliza un certificado digital (archivo PFX) codificado en Base64 y su contraseña asociada.

Nota: Se debe enviar el trackid obtenido al momento de subir la boleta con uploadboleta para consultar su estado.

Detalles del Servicio

Método: POST
Ruta: /api/trackingboleta
Tipo de contenido: application/json

Parámetros JSON de entrada

Parámetro Tipo Descripción
pfxBase64 String Certificado digital del emisor codificado en Base64 (archivo .pfx).
password String Contraseña del archivo PFX utilizada para firmar o autenticar la consulta.
rutemisor String RUT del emisor sin dígito verificador.
dvemisor String Dígito verificador del RUT del emisor.
trackid String Identificador de seguimiento (track ID) entregado por el SII al enviar la boleta.

Ejemplo de solicitud

{
  "pfxBase64": "MIIKBgIBAzCCCfEGCSqGSIb3DQEHAaCCCeIEggn...",
  "password": "clave123",
  "rutemisor": "76034567",
  "dvemisor": "5",
  "trackid": "238492751"
}

Ejemplo de respuesta

{
   "rut_emisor":"76040308-3",
   "rut_envia":"13968481-8",
   "trackid":"25542808",
   "fecha_recepcion":"28/10/2025 19:31:44",
   "estado":"EPR",
   "estadistica":[
      {
         "tipo":39,
         "informados":1,
         "aceptados":0,
         "rechazados":1,
         "reparos":0
      }
   ],
   "detalle_rep_rech":[
      {
         "tipo":39,
         "folio":1,
         "estado":"RCH",
         "descripcion":"DTE Rechazado",
         "error":[
            {
               "seccion":"DTE",
               "linea":0,
               "nivel":3,
               "codigo":101,
               "descripcion":"Folio para este Tipo de documento ya fue recibido en el SII",
               "detalle":null
            }
         ]
      }
   ]
}

Descripción de campos de respuesta

Campo Tipo Descripción
rut_emisor String RUT del emisor de la boleta.
rut_envia String RUT que envía la boleta (puede coincidir con el emisor).
trackid Integer Identificador de seguimiento asignado por el SII.
fecha_recepcion String Fecha y hora en que el SII recibió la boleta.
estado String Estado general del envío (ej. "EPR" = En proceso, "REC" = Recibido).
estadistica Array Estadísticas por tipo de DTE: informados, aceptados, rechazados y reparos.
detalle_rep_rech Array Detalle de DTE rechazados o con reparos, incluyendo errores específicos.

Respuesta de error

{
  "resultado": "ERROR",
  "mensaje": "No se pudo obtener el estado de la boleta"
}

Ejemplo de respuesta de error

{
  "resultado": "ERROR",
  "mensaje": "Certificado inválido o trackID no encontrado"
}

El campo estado puede contener valores como ACEPTADO, RECHAZADO o EN_PROCESO, dependiendo del resultado de la consulta en el SII.