Historial Carpeta Tributaria

Este endpoint devuelve el historial de Carpetas Tributarias de un RUT: una lista liviana de todas las cargas procesadas correctamente, sin sus declaraciones, para descubrir qué carpetas existen y elegir un carpetaTributariaId.

• Incluye únicamente las Carpetas Tributarias en estado SUCCEEDED del RUT, dentro de tu corporación y equipo.
• Está ordenado por fechaGeneracion descendente (la carpeta más reciente primero).
• Si el RUT no tiene ninguna Carpeta Tributaria SUCCEEDED, el campo data será un arreglo vacío [].

Detalle de API

Request

• URL: /helper/carpetaTributaria/{rut}/all
• Método: GET

Parámetros

• rut (requerido, path): El RUT del cual se desea obtener el historial de Carpetas Tributarias. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/carpetaTributaria/12345678-9/all' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": [
      {
        "carpetaTributariaId": 12345,
        "fechaSubida": "20-06-2026 13:00:00",
        "fechaGeneracion": "20-06-2026 10:15:00",
        "verificacion": {
          "iva": "VERIFICADO",
          "renta": "PENDIENTE"
        }
      },
      {
        "carpetaTributariaId": 11980,
        "fechaSubida": "10-01-2026 09:00:00",
        "fechaGeneracion": "09-01-2026 18:20:10",
        "verificacion": {
          "iva": "VERIFICADO",
          "renta": "NO_VERIFICADO"
        }
      }
    ]
  }

  A continuación se describen los campos devueltos en la respuesta JSON.

  Campo	Tipo	Descripción
  success	bool	Indica si la operación fue exitosa.
  data	array	Historial de Carpetas Tributarias SUCCEEDED del RUT. [] si no hay ninguna.

  Estructura de cada elemento de data:

  Campo	Tipo	Descripción
  carpetaTributariaId	number	Identificador de la carga. Úsalo como carpetaTributariaId en el resultado, en la consulta del análisis con IA o al generar el análisis.
  fechaSubida	string	Fecha y hora en que la carpeta fue cargada en Sheriff (DD-MM-YYYY HH:mm:ss, UTC).
  fechaGeneracion	string	Fecha y hora de generación de la Carpeta Tributaria en el SII (DD-MM-YYYY HH:mm:ss). Es el criterio de orden y de fusión del consolidado.
  verificacion	object	Resumen del estado de verificación SII de la carpeta (ver estructura abajo).

  Estructura del objeto verificacion:

  Campo	Tipo	Descripción
  iva	string	Estado de verificación de las declaraciones de IVA (F29): VERIFICADO, NO_VERIFICADO o PENDIENTE.
  renta	string	Estado de verificación de las declaraciones de Renta (F22): VERIFICADO, NO_VERIFICADO o PENDIENTE.

  nota

  El historial no incluye el campo estado, ya que todas las carpetas listadas están en estado SUCCEEDED. A diferencia de Resultado Carpeta Tributaria, aquí verificacion.iva y verificacion.renta son directamente el estado de verificación (string), sin los campos verificado ni motivo.

  tip

  Con el carpetaTributariaId elegido puedes obtener el detalle completo de esa carpeta con Resultado Carpeta Tributaria (?carpetaTributariaId=), consultar su análisis con Análisis con IA Carpeta Tributaria o solicitarlo con Generar Análisis con IA. Para ver las declaraciones de todas las carpetas fusionadas utiliza Consolidado Carpeta Tributaria.

  Si el RUT no tiene ninguna Carpeta Tributaria SUCCEEDED, la respuesta será:

  {
    "success": true,
    "data": []
  }

  Errores

  400 - Solicitud inválida

  {
    "success": false,
    "code": 400,
    "error": "Solicitud inválida"
  }

  401 - No autorizado

  {
    "success": false,
    "code": 401,
    "error": "No autorizado"
  }

  403 - No tienes permiso para acceder a este recurso

  {
    "success": false,
    "code": 403,
    "error": "No tienes permiso para acceder a este recurso"
  }

  404 - Recurso no encontrado

  {
    "success": false,
    "code": 404,
    "error": "Recurso no encontrado"
  }

  408 - Tiempo de espera agotado

  {
    "success": false,
    "code": 408,
    "error": "Tiempo de espera agotado"
  }

  429 - Demasiadas solicitudes

  {
    "success": false,
    "code": 429,
    "error": "Demasiadas solicitudes"
  }

  500 - Error interno del servidor

  {
    "success": false,
    "code": 500,
    "error": "Error interno del servidor"
  }