Reintentar Verificación SII

Este endpoint permite reintentar la verificación contra el SII (Formulario 22 y/o Formulario 29) de la Carpeta Tributaria SUCCEEDED más reciente de un RUT.

• Opera sobre la Carpeta Tributaria SUCCEEDED más reciente del RUT.
• Puedes reintentar la verificación de IVA (F29), de Renta (F22) o de ambas.
• El resultado actualizado también se entrega vía webhook (processTaxFolder), sin generar envíos duplicados.

Detalle de API

Request

• URL: /helper/carpetaTributaria/{rut}/reintentarVerificacion
• Método: POST
• Content-Type: application/json

Parámetros

• rut (requerido, path): El RUT cuya Carpeta Tributaria se desea reverificar. Formato del rut "12345678-9".

Cuerpo de la solicitud

El cuerpo es opcional. Si se omite, se reintenta la verificación de ambas secciones.

Campo	Tipo	Requerido	Descripción
section	string	No	Sección a reintentar: iva (solo F29), renta (solo F22) o both. Por defecto both.

Ejemplo request con curl

curl -X 'POST' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/carpetaTributaria/12345678-9/reintentarVerificacion' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1' \
  -d '{
    "section": "both"
  }'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "verificacion": {
        "iva": {
          "estado": "VERIFICADO",
          "verificado": true,
          "motivo": null
        },
        "renta": {
          "estado": "VERIFICADO",
          "verificado": true,
          "motivo": null
        },
        "fechaVerificacion": "24-06-2026 20:10:00"
      }
    }
  }

  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 de la verificación SII ejecutada.

  Campos dentro de data:

  Campo	Tipo	Descripción
  verificacion	object	Estado de la verificación SII ejecutada (ver estructura abajo).

  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.

  Estas tablas son idénticas a las documentadas en Resultado Carpeta Tributaria.

  tip

  Para obtener la Carpeta Tributaria completa con la verificación actualizada, consulta el endpoint de Resultado Carpeta Tributaria o espera la entrega automática por webhook.

  Errores

  Para este endpoint, un 404 indica que no existe una Carpeta Tributaria en estado SUCCEEDED para el RUT en tu equipo o corporación.

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