Resultado Carpeta Tributaria

Este endpoint devuelve el resultado estructurado de la Carpeta Tributaria de un RUT: los datos del contribuyente, sus declaraciones de IVA (Formulario 29) y de Renta (Formulario 22), y el estado de verificación contra el SII.

• Por defecto devuelve la Carpeta Tributaria SUCCEEDED más reciente del RUT.
• Si no existe ninguna SUCCEEDED, devuelve la última carga en cualquier estado, para que puedas ver su estado actual.
• Con el parámetro opcional carpetaTributariaId devuelve una Carpeta Tributaria puntual del historial del RUT (solo si está SUCCEEDED y pertenece a tu alcance). Los identificadores disponibles se obtienen con Historial Carpeta Tributaria.
• Si el RUT no tiene ninguna Carpeta Tributaria, o el carpetaTributariaId indicado no existe, no pertenece a tu alcance o no está SUCCEEDED, el campo data será un objeto vacío {}.

Alcance y acceso

Todos los endpoints de Carpeta Tributaria consideran únicamente las carpetas cargadas dentro de tu corporación y equipo. Requieren que tu plan incluya el ayudante Carpeta Tributaria y que el RUT tenga un perfil activo en tu cuenta de Sheriff; de lo contrario responden 403 (o 404 si el RUT no existe en el sistema).

Detalle de API

Request

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

nota

La carga de la Carpeta Tributaria (PDF) se realiza con POST en Cargar Carpeta Tributaria, bajo /webhook/carpetaTributaria/{rut}.

Parámetros

• rut (requerido, path): El RUT del cual se desea obtener el resultado de la Carpeta Tributaria. Formato del rut "12345678-9".
• carpetaTributariaId (opcional, query): Identificador de una Carpeta Tributaria específica del historial del RUT (número entero mayor o igual a 1). Si se omite, se devuelve la más reciente.

Ejemplo request con curl

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

Para obtener una Carpeta Tributaria puntual del historial:

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/carpetaTributaria/12345678-9?carpetaTributariaId=12345' \
  -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,
      "rut": "12345678-9",
      "estado": "SUCCEEDED",
      "verificadoIva": true,
      "verificadoRenta": false,
      "motivoValidacionIva": null,
      "motivoValidacionRenta": "Diferencia detectada en F22 2023",
      "verificacion": {
        "iva": {
          "estado": "VERIFICADO",
          "verificado": true,
          "motivo": null
        },
        "renta": {
          "estado": "NO_VERIFICADO",
          "verificado": false,
          "motivo": "Diferencia detectada en F22 2023"
        },
        "fechaVerificacion": "24-06-2026 19:52:05"
      },
      "contribuyente": {
        "rut": "12345678-9",
        "inicioActividades": "01-03-2010",
        "fechaGeneracion": "20-06-2026 10:15:00",
        "actividadesEconomicas": [
          {
            "nombre": "ACTIVIDADES DE APOYO A LA AGRICULTURA"
          },
          {
            "nombre": "CONSTRUCCION DE CARRETERAS Y LINEAS DE FERROCARRIL"
          }
        ],
        "categoriaTributaria": "Primera Categoría",
        "domicilio": "AVENIDA EJEMPLO 1234, SANTIAGO",
        "sucursales": [
          "CALLE EJEMPLO 817 OF 41 , PUNTA ARENAS",
          "LOTE 1 K EJEMPLO , COYHAIQUE"
        ],
        "docTimbrados": [
          {
            "nombre": "Factura Electronica",
            "fecha": "20-10-2025"
          },
          {
            "nombre": "Guias De Despacho",
            "fecha": "13-04-2018"
          }
        ],
        "obsTributarias": [
          {
            "fecha": "01-07-2025",
            "glosa": "RETENEDOR C.S. PARA CUMPLIMIENTO DE IVA",
            "descripcion": "Según registros del SII, el contribuyente pertenece a la nómina de retenedores por cambio de sujeto para cumplimiento del IVA."
          }
        ],
        "representantesLegales": [
          {
            "nombre": "NOMBRE EJEMPLO",
            "rut": "12345678-9",
            "fecha": "26-04-2005"
          }
        ],
        "socios": [
          {
            "nombre": "EMPRESA EJEMPLO LIMITADA",
            "rut": "76123456-7",
            "fecha": "29-10-2012",
            "participacionCapital": "100%",
            "participacionUtilidades": "100%"
          },
          {
            "nombre": "NOMBRE PERSONA EJEMPLO",
            "rut": "12345678-9",
            "fecha": "13-08-2024",
            "participacionCapital": "0%",
            "participacionUtilidades": "0%"
          }
        ],
        "socVigentes": [
          {
            "nombre": "EMPRESA EJEMPLO LIMITADA",
            "rut": "76123456-7",
            "fecha": "29-10-2012",
            "participacionCapital": "100%",
            "participacionUtilidades": "100%"
          }
        ],
        "bienesRaices": [
          {
            "rol": "01234-00066",
            "direccion": "LOTE 1 K RIO EJEMPLO",
            "comuna": "COYHAIQUE",
            "destino": "SITIO ERIAZO",
            "avaluo": "47050599"
          },
          {
            "rol": "00567-00046",
            "direccion": "CALLE EJEMPLO 901",
            "comuna": "RENGO",
            "destino": "HABITACIONAL",
            "avaluo": "43573912"
          }
        ]
      },
      "declaracionIva": [
        {
          "periodo": "05-2026",
          "fechaPresentacion": "12-06-2026"
        }
      ],
      "declaracionRenta": [
        {
          "periodo": "2025"
        }
      ]
    }
  }

  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	object	Resultado estructurado de la Carpeta Tributaria. {} si no existe.

  Campos dentro de data:

  Campo	Tipo	Descripción
  carpetaTributariaId	number	Identificador de la carga (el mismo que entregan la carga y el webhook).
  rut	string	RUT del contribuyente.
  estado	string	Estado de la Carpeta Tributaria: SUCCEEDED, FAILED o IN PROGRESS.
  verificadoIva	bool	(Retrocompatibilidad) Resultado de la verificación de IVA contra el SII. Ver el bloque verificacion.
  verificadoRenta	bool	(Retrocompatibilidad) Resultado de la verificación de Renta contra el SII. Ver verificacion.
  motivoValidacionIva	string	(Retrocompatibilidad) Motivo asociado a la verificación de IVA. null si no hay observación.
  motivoValidacionRenta	string	(Retrocompatibilidad) Motivo asociado a la verificación de Renta. null si no hay observación.
  verificacion	object	Forma canónica del estado de verificación SII (ver estructura abajo).
  contribuyente	object	Datos del contribuyente (ver estructura abajo).
  declaracionIva	array	Declaraciones de IVA mensuales (Formulario 29).
  declaracionRenta	array	Declaraciones de Renta anuales (Formulario 22).

  nota

  Los campos verificadoIva, verificadoRenta, motivoValidacionIva y motivoValidacionRenta se mantienen por retrocompatibilidad. La forma canónica del estado de verificación es el bloque verificacion.

  Estructura del objeto verificacion:

  Campo	Tipo	Descripción
  iva	object	Estado de verificación de las declaraciones de IVA (F29).
  renta	object	Estado de verificación de las declaraciones de Renta (F22).
  fechaVerificacion	string	Fecha y hora de la verificación (DD-MM-YYYY HH:mm:ss, UTC). null si no aplica.

  Estructura de iva y renta:

  Campo	Tipo	Descripción
  estado	string	Estado de la verificación: VERIFICADO, NO_VERIFICADO o PENDIENTE.
  verificado	bool	true si VERIFICADO, false si NO_VERIFICADO, null si PENDIENTE.
  motivo	string	Motivo cuando la información no está verificada; null cuando no aplica.

  Relación entre estado y verificado:

  estado	verificado	Significado
  VERIFICADO	true	La información fue verificada correctamente contra el SII.
  NO_VERIFICADO	false	La verificación detectó diferencias.
  PENDIENTE	null	Aún no se ha ejecutado la verificación.

  tip

  Si la verificación quedó NO_VERIFICADO o PENDIENTE, puedes ejecutarla nuevamente con Reintentar Verificación SII.

  Estructura del objeto contribuyente:

  Campo	Tipo	Descripción
  rut	string	RUT del contribuyente.
  inicioActividades	string	Fecha de inicio de actividades (DD-MM-YYYY).
  fechaGeneracion	string	Fecha de generación de la Carpeta Tributaria (DD-MM-YYYY HH:mm:ss).
  actividadesEconomicas	array	Actividades económicas registradas del contribuyente (ver estructura abajo).
  categoriaTributaria	string	Categoría tributaria (ej: "Primera Categoría").
  domicilio	string	Domicilio del contribuyente.
  sucursales	array	Lista de string; cada elemento es la dirección de una sucursal con su comuna.
  docTimbrados	array	Documentos timbrados por el contribuyente (ver estructura abajo).
  obsTributarias	array	Observaciones tributarias del contribuyente (ver estructura abajo).
  representantesLegales	array	Representantes legales del contribuyente (ver estructura abajo).
  socios	array	Socios del contribuyente (ver estructura abajo).
  socVigentes	array	Socios vigentes del contribuyente. Misma estructura que socios.
  bienesRaices	array	Bienes raíces asociados al contribuyente (ver estructura abajo).

  Estructura de cada elemento de actividadesEconomicas:

  Campo	Tipo	Descripción
  nombre	string	Nombre de la actividad económica.

  Elementos de sucursales: cada elemento es un string con la dirección y comuna de la sucursal (ej: "CALLE EJEMPLO 817 OF 41 , PUNTA ARENAS").

  Estructura de cada elemento de docTimbrados:

  Campo	Tipo	Descripción
  nombre	string	Tipo de documento timbrado (ej: "Factura Electronica").
  fecha	string	Fecha del último timbraje del documento (DD-MM-YYYY).

  Estructura de cada elemento de obsTributarias:

  Campo	Tipo	Descripción
  fecha	string	Fecha de la observación (DD-MM-YYYY).
  glosa	string	Glosa o título de la observación tributaria del SII.
  descripcion	string	Descripción detallada de la observación.

  Estructura de cada elemento de representantesLegales:

  Campo	Tipo	Descripción
  nombre	string	Nombre del representante legal. Puede venir vacío ("").
  rut	string	RUT del representante legal.
  fecha	string	Fecha de registro del representante legal (DD-MM-YYYY).

  Estructura de cada elemento de socios y socVigentes:

  Campo	Tipo	Descripción
  nombre	string	Nombre o razón social del socio.
  rut	string	RUT del socio.
  fecha	string	Fecha de incorporación del socio (DD-MM-YYYY).
  participacionCapital	string	Porcentaje de participación en el capital (ej: "100%").
  participacionUtilidades	string	Porcentaje de participación en las utilidades (ej: "100%").

  Estructura de cada elemento de bienesRaices:

  Campo	Tipo	Descripción
  rol	string	Rol de avalúo de la propiedad (ej: "01234-00066").
  direccion	string	Dirección del bien raíz.
  comuna	string	Comuna donde se ubica el bien raíz.
  destino	string	Destino del bien raíz (ej: "HABITACIONAL", "OFICINA", "SITIO ERIAZO").
  avaluo	string	Avalúo fiscal de la propiedad, en pesos chilenos (ej: "47050599").

  Estructura de cada elemento de declaracionIva (Formulario 29, mensual):

  Campo	Tipo	Descripción
  periodo	string	Período mensual declarado (MM-YYYY).
  fechaPresentacion	string	Fecha de presentación de la declaración (DD-MM-YYYY).

  Cada elemento incluye además los demás campos de la declaración F29 mensual.

  Estructura de cada elemento de declaracionRenta (Formulario 22, anual):

  Campo	Tipo	Descripción
  periodo	string	Período anual declarado (YYYY).

  Cada elemento incluye además los demás campos de la declaración F22 anual.

  Declaraciones

  Los arreglos declaracionIva y declaracionRenta contienen una entrada por período: mensual (MM-YYYY) para IVA y anual (YYYY) para Renta, validadas contra el SII. Estarán vacíos si el contribuyente no registra declaraciones en el período cubierto por la carpeta.

  Historial y consolidado

  Para ver todas las Carpetas Tributarias cargadas para el RUT utiliza Historial Carpeta Tributaria. Para obtener las declaraciones de todas ellas fusionadas en un único resultado utiliza Consolidado Carpeta Tributaria.

  tip

  Este mismo objeto es el que se entrega vía webhook (processTaxFolder) cuando la carga se realizó a través de la API. Ver Cargar Carpeta Tributaria.

  Si el RUT no tiene ninguna Carpeta Tributaria (o el carpetaTributariaId indicado no está disponible en tu alcance), la respuesta será:

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

  Errores

  Para este endpoint, un 400 indica que el parámetro carpetaTributariaId no es un número entero válido (mayor o igual a 1).

  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"
  }