Consolidado Carpeta Tributaria (intercarpeta)

Este endpoint devuelve el resultado consolidado de todas las Carpetas Tributarias SUCCEEDED de un RUT: las declaraciones de IVA (Formulario 29) y de Renta (Formulario 22) de todas las carpetas se fusionan en un único resultado, extendiendo el histórico y completando los períodos que una sola carpeta no cubre.

• Por cada período (mes para IVA, año para Renta) se conserva la declaración de la Carpeta Tributaria con fechaGeneracion más reciente.
• La cabecera (carpetaTributariaId, rut, estado y contribuyente) corresponde a la Carpeta Tributaria más reciente del RUT.
• Tiene el mismo formato que Resultado Carpeta Tributaria, salvo que no incluye el bloque verificacion ni los campos verificadoIva, verificadoRenta, motivoValidacionIva y motivoValidacionRenta: la verificación SII es un atributo de cada carpeta y no tiene un significado único al mezclar carpetas por período.
• Si el RUT no tiene ninguna Carpeta Tributaria SUCCEEDED, el campo data será un objeto vacío {}.

Detalle de API

Request

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

Parámetros

• rut (requerido, path): El RUT del cual se desea obtener el consolidado 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/intercarpeta' \
  -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",
      "contribuyente": {
        "rut": "12345678-9",
        "inicioActividades": "01-03-2010",
        "fechaGeneracion": "20-06-2026 10:15:00",
        "actividadesEconomicas": [
          {
            "nombre": "ACTIVIDADES DE APOYO A LA AGRICULTURA"
          }
        ],
        "categoriaTributaria": "Primera Categoría",
        "domicilio": "AVENIDA EJEMPLO 1234, SANTIAGO",
        "sucursales": ["CALLE EJEMPLO 817 OF 41 , PUNTA ARENAS"],
        "docTimbrados": [
          {
            "nombre": "Factura Electronica",
            "fecha": "20-10-2025"
          }
        ],
        "obsTributarias": [],
        "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%"
          }
        ],
        "socVigentes": [],
        "bienesRaices": []
      },
      "declaracionIva": [
        {
          "periodo": "05-2026",
          "fechaPresentacion": "12-06-2026"
        },
        {
          "periodo": "04-2026",
          "fechaPresentacion": "12-05-2026"
        },
        {
          "periodo": "03-2026",
          "fechaPresentacion": "13-04-2026"
        }
      ],
      "declaracionRenta": [
        {
          "periodo": "2025"
        },
        {
          "periodo": "2024"
        }
      ]
    }
  }

  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 consolidado de las Carpetas Tributarias del RUT. {} si no hay ninguna.

  Campos dentro de data:

  Campo	Tipo	Descripción
  carpetaTributariaId	number	Identificador de la Carpeta Tributaria más reciente del RUT, de la cual se toma la cabecera.
  rut	string	RUT del contribuyente.
  estado	string	Siempre SUCCEEDED: el consolidado solo considera carpetas procesadas correctamente.
  contribuyente	object	Datos del contribuyente según la Carpeta Tributaria más reciente. Misma estructura que en Resultado Carpeta Tributaria.
  declaracionIva	array	Declaraciones de IVA mensuales (Formulario 29) de todas las carpetas, una por período (MM-YYYY), ordenadas por período descendente. Misma estructura de cada elemento que en Resultado Carpeta Tributaria.
  declaracionRenta	array	Declaraciones de Renta anuales (Formulario 22) de todas las carpetas, una por período (YYYY), ordenadas por período descendente. Misma estructura de cada elemento que en Resultado Carpeta Tributaria.

  Criterio de fusión

  Si dos o más carpetas contienen el mismo período, se conserva la declaración de la carpeta con fechaGeneracion más reciente (en caso de empate, la cargada más recientemente en Sheriff). Es el mismo criterio que utiliza la plataforma para combinar carpetas de un mismo contribuyente.

  Verificación SII

  El consolidado no informa verificación SII. Para conocer el estado de verificación de cada carpeta que lo compone, utiliza Historial Carpeta Tributaria (resumen) o Resultado Carpeta Tributaria con ?carpetaTributariaId= (detalle).

  nota

  El análisis con IA se genera siempre sobre una carpeta en particular, nunca sobre el consolidado. Ver Generar Análisis con IA.

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