# Tax Folder – Income Verification

Este método se conecta a la cuenta especificada por el usuario en el  y retorna la información específica solicitada para este propósito desde el servicio "Carpeta tributaria - Acreditar Renta".

El uso del campo  desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir  con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo  pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Endpoint: POST /v1/cl/services/sii.cl/carpeta-tributaria/acreditar-renta
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `RequestData` (object, required)
    Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

  - `RequestData.ReceivingInstitution` (string, required)
    Institución a la que se envía la información. Este parámetro debe incluirse solo si se desea recibir el PDF de la carpeta tributaria en la respuesta.
    Example: "ABN AMRO | BANCO BBVA | BANCO CORPBANCA | BANCO CREDITO E INVERSIONES - TBANC | BANCO DE CHILE | BANCO DE TOKIO | BANCO DEL DESARROLLO | BANCO ESTADO | BANCO ITAU CHILE | BANCO SANTANDER-SANTIAGO | BANCO SECURITY | BICE | CITIBANK | CORFO | FALABELLA | FONASA | HSBC BANK CHILE | INDAP | INTERNACIONAL | PARIS | RIPLEY | SCOTIABANK | SENCE | SII | OTRO"

  - `RequestData.InstitutionName` (string)
    Nombre de la institución en caso de que 'ReceivingInstitution' sea 'OTRO'. Este parámetro debe enviarse solo si se incluye 'ReceivingInstitution'.
    Example: "Nombre Institución"

  - `RequestData.AccountCredential` (any)
    Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

  - `CallbackUrl` (string)
    URL para enviar el mensaje de respuesta utilizando un método POST.
    Example: "https://my-api.my-business.com/api/open-data-response"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación.  significa que el servicio se ha ejecutado correctamente aunque no devuelva datos.  indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
    Enum: "OK", "ERROR"

  - `Data` (object,null, required)
    Contenedor para Carpeta Fiscal - Ingresos

  - `Data.AcreditarRenta` (object, required)
    Proporciona información de la carpeta de impuestos.

  - `Data.AcreditarRenta.BienesRaices` (array, required)
    Ofrece información detallada sobre la inmobiliaria.

  - `Data.AcreditarRenta.BienesRaices.Comuna` (string)
    Comuna donde se encuentra el inmueble.
    Example: "Providencia"

  - `Data.AcreditarRenta.BienesRaices.Rol` (string)
    Example: "05643-00569"

  - `Data.AcreditarRenta.BienesRaices.Direccion` (string)
    Dirección.
    Example: "AGUSTINAS 1234"

  - `Data.AcreditarRenta.BienesRaices.Destino` (string)
    Propósito de uso.
    Example: "Habitacional"

  - `Data.AcreditarRenta.BienesRaices.AvaluoFiscal` (number)
    Valor de tasación.
    Example: "87030458"

  - `Data.AcreditarRenta.BienesRaices.CuotasVencidas` (string)
    Tiene cuotas vencidas por pagar.
    Example: "No"

  - `Data.AcreditarRenta.BienesRaices.CuotasVigentes` (string)
    Tiene cuotas pendientes de pago.
    Example: "No"

  - `Data.AcreditarRenta.BienesRaices.Condicion` (string)
    Estado del inmueble.
    Example: "Afecto"

  - `Data.AcreditarRenta.BoletasHonorarios` (array, required)
    Proporciona detalles de las facturas de servicios profesionales.

  - `Data.AcreditarRenta.BoletasHonorarios.Periodos` (string, required)
    Periodos.
    Example: "DICIEMBRE-23"

  - `Data.AcreditarRenta.BoletasHonorarios.HonorarioBruto` (number)
    Honorarios brutos.
    Example: 1243353

  - `Data.AcreditarRenta.BoletasHonorarios.RetencionTerceros` (string)
    Retención por parte de terceros.
    Example: 2453453

  - `Data.AcreditarRenta.BoletasHonorarios.PPMContribuyente` (number)
    Pagos provisionales mensuales del contribuyente.

  - `Data.AcreditarRenta.DatosContribuyente` (object, required)
    Proporciona información del contribuyente.

  - `Data.AcreditarRenta.DatosContribuyente.Nombre` (string, required)
    Nombre del contribuyente.
    Example: "Joe Taylor Hartmann"

  - `Data.AcreditarRenta.DatosContribuyente.Rut` (string, required)
    Example: "18365432-2"

  - `Data.AcreditarRenta.DatosContribuyente.InicioActividades` (string)
    Fecha de inicio de las actividades
    Example: "2004-04-23"

  - `Data.AcreditarRenta.DatosContribuyente.Actividades` (array)
    Actividades.
    Example: ["SERVICIOS PROFESIONALES DE INGENIERIA"]

  - `Data.AcreditarRenta.DatosContribuyente.CategoriaTributaria` (string)
    Categoría fiscal.
    Example: "Segunda categoría"

  - `Data.AcreditarRenta.DatosContribuyente.Domicilio` (string)
    Dirección.
    Example: "AGUSTINAS 1234"

  - `Data.AcreditarRenta.DatosContribuyente.Sucursales` (string)
    Sucursales.
    Example: "Sucursal 1"

  - `Data.AcreditarRenta.DatosContribuyente.DocumentosTimbrados` (array)
    Proporciona información de los Documentos Sellados.

  - `Data.AcreditarRenta.DatosContribuyente.DocumentosTimbrados.Descripcion` (string)
    Example: "BOLETAS DE HONORARIOS"

  - `Data.AcreditarRenta.DatosContribuyente.DocumentosTimbrados.Fecha` (string)
    Example: "2004-04-23"

  - `Data.AcreditarRenta.F22` (array, required)
    Contenedor para F22-info

  - `Data.AcreditarRenta.F22.Casillas` (array, required)
    Proporciona información sobre las casillas del F22

  - `Data.AcreditarRenta.F22.Casillas.Codigo` (number, required)
    Código de la caja.
    Example: 12

  - `Data.AcreditarRenta.F22.Casillas.Nombre` (string, required)
    Nombre de la caja.
    Example: "Capital efectivo"

  - `Data.AcreditarRenta.F22.Casillas.Valor` (string)
    Valor de la caja.
    Example: "13056"

  - `Data.AcreditarRenta.F22.Periodo` (string, required)
    Punto.
    Example: "2022"

  - `Data.AcreditarRenta.Document` (string)
    Archivo PDF de la carpeta tributaria. Esta respuesta solo se recibe si se incluye el parámetro 'ReceivingInstitution' en 'RequestData'.
    Example: "JVBERi0xLjQKJcfs..."

  - `AdditionalInformation` (string,null, required)
    Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo  está incompleto.

  - `Error` (object,null, required)
    Objeto con los detalles del error, utilizado cuando . Si  este campo será nulo. Puede leer una explicación completa de este objeto visitando [este enlace](https://docs.khipu.com/portal/en/errors/)

  - `Error.Code` (string)
    Código interno del sistema que identifica el error.
    Example: "E201"

  - `Error.Type` (string)
    Indica cómo tratar este código de error específico, en función del tipo de error.
    Enum: "RETRY_IMMEDIATELY", "DO_NOT_RETRY", "WAIT_4_HOURS_BEFORE_RETRY", "RETRY_AFTER_NOTIFICATION"

  - `Error.Description` (string)
    Descripción asociada al código de error.
    Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

  - `LifeSpan` (string,null, required)
    en peticiones sincrónicas.

## Response 202 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación. Al realizar solicitudes asíncronas, siempre devolverá .
    Example: "OK"

  - `Data` (object, required)
    en solicitudes asíncronas.

  - `AdditionalInformation` (string, required)
    Mensaje de la operación, puede usarse para mostrar información adicional.
    Example: "Data will be sent to the callback URL."

  - `Error` (object, required)
    en solicitudes asíncronas.

  - `LifeSpan` (string, required)
    Fecha máxima estimada de entrega para solicitudes asíncronas, en formato de fecha y hora ISO 8601, zona horaria UTC.
    Example: "2017-07-22T00:00:00-0400"