Open Finance

Chile

Servicios

SII

Tax Situation

SII (v1.0)

Download OpenAPI description

openapi.json

openapi.yaml

Overview

Licencia

Khipu Open Data API

Servers

Production

https://api.khipu.com/

Tax Folder – Income Verification

Request

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

El uso del campo CallbackUrl 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 CallbackUrl 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.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

ReceivingInstitutionstringrequerido

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.

InstitutionNamestring

Nombre de la institución en caso de que 'ReceivingInstitution' sea 'OTRO'. Este parámetro debe enviarse solo si se incluye 'ReceivingInstitution'.

Ejemplo: "Nombre Institución"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/carpeta-tributaria/acreditar-renta \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "ReceivingInstitution": "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"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor para Carpeta Fiscal - Ingresos

AcreditarRentaobjectrequerido

Proporciona información de la carpeta de impuestos.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "AcreditarRenta": {
      "DatosContribuyente": {
        "Nombre": "Joe Taylor Hartmann",
        "Rut": "18365432-2",
        "InicioActividades": "2004-04-23",
        "Actividades": [ … ],
        "CategoriaTributaria": "Segunda categoría",
        "Domicilio": "AGUSTINAS 1234",
        "Sucursales": "Sucursal 1",
        "DocumentosTimbrados": [ … ]
      },
      "BienesRaices": [
        { … }
      ],
      "BoletasHonorarios": [
        { … }
      ],
      "F22": [
        { … }
      ],
      "Document": "JVBERi0xLjQKJcfs..."
    }
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Tax Folder – Loan Application

Request

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/carpeta-tributaria/solicitar-credito \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {}
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor para Carpeta Fiscal - Crédito

ConsultaCreditoobjectrequerido

Proporciona información de la carpeta de impuestos.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "ConsultaCredito": {
      "DatosContribuyente": {
        "Nombre": "Joe Taylor Hartmann",
        "Rut": "18365432-2",
        "InicioActividades": "2004-04-23",
        "Actividades": [ … ],
        "CategoriaTributaria": "Segunda categoría",
        "Domicilio": "AGUSTINAS 1234",
        "Sucursales": "Sucursal 1",
        "DocumentosTimbrados": [ … ]
      },
      "InformacionTributaria": {
        "RepresentantesLegales": [ … ],
        "ConformacionSociedad": [ … ],
        "ParticipaciónSociedadesVigentes": [ … ]
      },
      "BienesRaices": [
        { … }
      ],
      "BoletasHonorarios": [
        { … }
      ],
      "F29": [
        { … }
      ],
      "F22": [
        { … }
      ]
    }
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

F22 Compact Information

Request

Este método se conecta a la cuenta especificada por el usuario en el Servicio de Impuestos Internos (SII) y retorna la información específica solicitada para este propósito del "Formulario 22 Compacto" para el año tributario especificado.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

TaxYearstringrequerido

El año fiscal al que corresponde el F22.

Ejemplo: "2023"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/f22-compact-info \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "TaxYear": "2023"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

F22InformationCompactoobjectrequerido

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "F22InformationCompacto": {
      "PrimerApellidoRazonSocial": {
        "Value": "SANCHEZ",
        "Code": 101
      },
      "SegundoApellido": {
        "Value": "SANCHEZ",
        "Code": 101
      },
      "RolUnicoTributario": {
        "Value": "12345678-9",
        "Code": 101
      },
      "Nombres": {
        "Value": "JUAN PABLO",
        "Code": 101
      },
      "CalleDomicilioRenta": {
        "Value": "San Juan 13",
        "Code": 101
      },
      "FolioDeLaDeclaracion": {
        "Value": "124124123",
        "Code": 101
      },
      "ComunaDomicilioRenta": {
        "Value": "COLINA",
        "Code": 101
      },
      "ActividadProfesionOGiroNegocio": {
        "Value": "ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION DE INSTALACIO",
        "Code": 101
      },
      "CodigoActividadEconomica": {
        "Value": "620200",
        "Code": 101
      },
      "FechaVencimientoDeclaracion": {
        "Value": "2023-04",
        "Code": 101
      },
      "Region": {
        "Value": "13",
        "Code": 101
      },
      "CorreoElectronico": {
        "Value": "juanpablo@gmail.com",
        "Code": 101
      },
      "SaldoAFavor": {
        "Value": 179409,
        "Code": 101
      },
      "MontoDevolucionSolicitada": {
        "Value": 179409,
        "Code": 101
      },
      "RentasPercibidasArt42y48": {
        "Value": 3644594,
        "Code": 101
      },
      "SubTotalSiDeclaraIATrasladar": {
        "Value": 4867442,
        "Code": 101
      },
      "BaseImponibleAnualIUSCOIGC": {
        "Value": 4867442,
        "Code": 101
      },
      "RetencionesRentasCodigo110": {
        "Value": 637804,
        "Code": 101
      },
      "NombreInstitucionBancaria": {
        "Value": "SCOTIABANK",
        "Code": 101
      },
      "ResultadoLiquidacionAnual": {
        "Value": -179409,
        "Code": 101
      },
      "NumeroDeCuenta": {
        "Value": "821231202",
        "Code": 101
      },
      "FechaPresentacion": {
        "Value": "2023-05-05",
        "Code": 101
      },
      "HonorariosAnualesConRetencion": {
        "Value": 5206563,
        "Code": 101
      },
      "TotalHonorarios": {
        "Value": 3644594,
        "Code": 101
      },
      "ImpuestoRetenidoHonorariosAnuales": {
        "Value": 637804,
        "Code": 101
      },
      "GastosPresuntos54715UTA": {
        "Value": 1561969,
        "Code": 101
      },
      "TotalIngresosBrutos": {
        "Value": 5206563,
        "Code": 101
      },
      "TotalRentasYRetenciones": {
        "Value": 3644594,
        "Code": 101
      },
      "ImpuestoRetenidoTotalRentas": {
        "Value": 637804,
        "Code": 101
      },
      "TipoDeCuenta": {
        "Value": "V",
        "Code": 101
      },
      "CargoCotizacionesDL3500": {
        "Value": 458395,
        "Code": 101
      },
      "ReajusteArt72LIR": {
        "Value": 0,
        "Code": 101
      },
      "SaldoPuestoADisposicionSocios": {
        "Value": 0,
        "Code": 101
      },
      "ImpuestoAdeudado": {
        "Value": 0,
        "Code": 101
      },
      "TotalAPagarCod90y39": {
        "Value": 0,
        "Code": 101
      },
      "ReajustesDeclaracionFueraPlazo": {
        "Value": 0,
        "Code": 101
      },
      "InteresesYMultasFueraPlazo": {
        "Value": 0,
        "Code": 101
      },
      "TotalAPagarCod91y92y93": {
        "Value": 0,
        "Code": 101
      },
      "Telefono": {
        "Value": "987654321",
        "Code": 201
      },
      "ImpuestoGlobalComplementario": {
        "Value": 1340000,
        "Code": 202
      },
      "NumeroFax": {
        "Value": "224433221",
        "Code": 203
      },
      "IgcDebitoFiscal": {
        "Value": 980000,
        "Code": 204
      },
      "IgcSegunTbl": {
        "Value": 875000,
        "Code": 205
      },
      "CPTPositivoFinal": {
        "Value": 620000,
        "Code": 207
      },
      "InteresesPagadosPorCreditosConGaranHipo": {
        "Value": 240000,
        "Code": 208
      },
      "InteresesPagadosPorCredConGaranYOReb": {
        "Value": 315000,
        "Code": 209
      },
      "PerdidaEnOperacionesDeCapitalesMobiliarios": {
        "Value": -135000,
        "Code": 211
      },
      "ARentasDeCapitalesMob": {
        "Value": 320000,
        "Code": 212
      },
      "BMayoValorObtenido": {
        "Value": 420000,
        "Code": 213
      },
      "Document": "JVBERi0xLjQKJcfs..."
    }
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

F22 Information

Request

Este método se conecta a la cuenta especificada por el usuario en el Servicio de Impuestos Internos (SII) y retorna la información específica solicitada para este propósito del "Formulario 22" para el año tributario especificado.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/f22-info \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {}
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor para F22-Información.

F22Informationobjectrequerido

Proporciona información sobre el F22.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "F22Information": {
      "Identifier": "string",
      "CashBalance": {
        "Value": "87030458",
        "Code": "101"
      },
      "CashCapital": {
        "Value": "87030458",
        "Code": "101"
      },
      "CurrentAccountBalance": {
        "Value": "87030458",
        "Code": "101"
      },
      "EBITDA": {
        "Value": "87030458",
        "Code": "101"
      },
      "EndingInventory": {
        "Value": "87030458",
        "Code": "101"
      },
      "FinancialAssets": {
        "Value": "87030458",
        "Code": "101"
      },
      "FinancialDepreciation": {
        "Value": "87030458",
        "Code": "101"
      },
      "IncomeBeforeTaxes": {
        "Value": "87030458",
        "Code": "101"
      },
      "InterestAdjustmentsPaid": {
        "Value": "87030458",
        "Code": "101"
      },
      "InterestPaid": {
        "Value": "87030458",
        "Code": "101"
      },
      "OtherFinancialExpenses": {
        "Value": "87030458",
        "Code": "101"
      },
      "ReceivedIncome": {
        "Value": "87030458",
        "Code": "101"
      },
      "RevenuesOperationsReceived": {
        "Value": "87030458",
        "Code": "101"
      },
      "TaxableIncomeIDPC": {
        "Value": "87030458",
        "Code": "101"
      },
      "TotalAssets": {
        "Value": "87030458",
        "Code": "101"
      },
      "TotalLiabilities": {
        "Value": "87030458",
        "Code": "101"
      }
    }
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Purchases and Sales Record

Request

Este método retorna el "Registro de Compras y Ventas" del periodo especificado para un Rol Tributario Nacional (RUT) chileno, utilizando el sitio web del Servicio de Impuestos Internos (SII).

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

RolUnicoTributariostring[ 1 .. 12 ] charactersrequerido

Rol Único Tributario (RUT) chileno. Se puede pasar con o sin puntos.

Ejemplo: "11.222.333-k"

Periodstringrequerido

Año y mes del periodo a consultar en formato ISO 8601 (YYYY-MM).

Ejemplo: "2024-03"

Typestringrequerido

Tipo de registros que se desea consultar.

Enum"CompraRegistro""CompraPendientes""CompraNoIncluir""CompraReclamados""Venta"

Ejemplo: "CompraRegistro"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/registro-de-compras-y-ventas \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoTributario": "11.222.333-k",
      "Period": "2024-03",
      "Type": "CompraRegistro"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor de registros.

RecordArray of CompraRegistro (objects) or Array of CompraPendientes (objects) or Array of CompraNoIncluir (objects) or Array of CompraReclamados (objects) or Array of Venta (objects)requerido

One of:

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Record": [
      {
        "Nro": "1",
        "TipoDoc": "33",
        "TipoCompra": "Del Giro",
        "RutProveedor": "44444444-4",
        "RazonSocial": "Empresa LTDA",
        "Folio": "1234567",
        "FechaDocto": "25/03/2024",
        "FechaRecepcion": "24/03/2024 22:53:38",
        "FechaAcuse": "",
        "MontoExento": "0",
        "MontoNeto": "13165",
        "MontoIvaRecuperable": "2501",
        "MontoIvaNoRecuperable": "",
        "CodigoIvaNoRec": "",
        "MontoTotal": "15666",
        "MontoNetoActivoFijo": "",
        "IvaActivoFijo": "",
        "IvaUsoComun": "",
        "ImptoSinDerechoACredito": "",
        "IvaNoRetenido": "0",
        "TabacosPuros": "",
        "TabacosCigarrillos": "",
        "TabacosElaborados": "",
        "NceONdeSobreFactDeCompra": "0",
        "CodigoOtroImpuesto": "",
        "ValorOtroImpuesto": "",
        "TasaOtroImpuesto": ""
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Tax Return Status

Request

Este método inicia sesión en la cuenta especificada por el usuario en el Servicio de Impuestos Internos (SII) y retorna una captura de pantalla en formato base64 que muestra la situación actual de la declaración de renta para el año tributario especificado.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

TaxYearstringrequerido

El año fiscal que se quiere consultar.

Ejemplo: "2023"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/tax-return-status \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "TaxYear": "2023"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

TaxReturnStatusobjectrequerido

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "TaxReturnStatus": {
      "CurrentTaxSituation": "iVBORw0KGgoAAAANSUhEUgAABPQAAAL..."
    }
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Tax Situation

Request

Este método retorna la "Situación tributaria de terceros" para un Rol Tributario Nacional (RUT) chileno, utilizando el sitio web del Servicio de Impuestos Internos (SII).

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

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.

RolUnicoTributariostring[ 1 .. 12 ] charactersrequerido

Rol Único Tributario (RUT) chileno. Se puede pasar con o sin puntos.

Ejemplo: "11.222.333-k"

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/tax-situation \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "RolUnicoTributario": "11.222.333-k"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor para situación fiscal.

TaxSituationobjectrequerido

Proporciona información sobre la situación fiscal.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "TaxSituation": {
      "RolUnicoTributario": "11222333-K",
      "Name": "Khipu.S.A",
      "Remark": "Como recomendación general, siempre que se realicen transacciones comerciales con cualquier contribuyente, el SII aconseja verificar, en las opciones anteriores habilitadas, el timbraje del documento y que la actividad económica esté vigente en las bases de datos del Servicio. Además, se recomienda verificar que el domicilio y la actividad económica consignados en la factura o boleta que reciba, correspondan al vendedor o prestador del servicio ofrecido.  Para un mayor resguardo, se recomienda efectuar el pago con cheque nominativo o vale vista a favor del proveedor, anotando al reverso el RUT del emisor y número del documento recibido.",
      "Activities": [
        { … }
      ]
    }
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Account LinkDeprecado

Request

Este método se está descontinuando y se retirará en los próximos meses. Migre su implementación actual para usar tokens OAuth en su lugar.

Este método se conecta a la cuenta del usuario en SII y retorna un token vinculado a esa cuenta que puede ser usado en operaciones futuras, evitando la necesidad de enviar sus credenciales en texto plano al llamar a los servicios bancarios.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

Usernamestring[ 1 .. 12 ] charactersrequerido

Identificación del usuario con acceso a la cuenta en el sitio web (RUN, DNI).

Ejemplo: "11.111.111-1"

Passwordstring[ 1 .. 24 ] charactersrequerido

Contraseña de la cuenta para el sitio web.

Ejemplo: "wxyz1234!@#$"

LoginChoicestring

Especifica el método que se utilizará para iniciar sesión en el sitio web del SII, donde CU significa "Clave Única" y CT significa "Clave Tributaria". Si no se proporciona ningún método de inicio de sesión, se utilizará por defecto CU.

Enum"CU""CT"

Ejemplo: "CU"

curl -i -X POST \
  https://api.khipu.com/v1/cl/services/sii.cl/token \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Username": "11.111.111-1",
    "Password": "wxyz1234!@#$"
  }'

Responses

Operación exitosa. Retorna un objeto JSON con el token de la cuenta en el campo Data.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobjectrequerido

Si la autenticación se ha realizado correctamente, incluye el 'Account Link' para la cuenta.

AccountLinkstringrequerido

Token generado para acceder a la cuenta del sitio web.

Ejemplo: "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "AccountLink": "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

SII (v1.0)

Tax Folder – Income Verification

Request

Responses

¿Fue útil esta info?

Tax Folder – Loan Application

Request

Responses

¿Fue útil esta info?

F22 Compact Information

Request

Responses

¿Fue útil esta info?

F22 Information

Request

Responses

¿Fue útil esta info?

Purchases and Sales Record

Request

Responses

¿Fue útil esta info?

Tax Return Status

Request

Responses

¿Fue útil esta info?

Tax Situation

Request

Responses

¿Fue útil esta info?

Account LinkDeprecado

Request

Responses

¿Fue útil esta info?

SII (v1.0)

Tax Folder – Income Verification

RequestExpandir todo

Responses

¿Fue útil esta info?

Tax Folder – Loan Application

RequestExpandir todo

Responses

¿Fue útil esta info?

F22 Compact Information

RequestExpandir todo

Responses

¿Fue útil esta info?

F22 Information

RequestExpandir todo

Responses

¿Fue útil esta info?

Purchases and Sales Record

RequestExpandir todo

Responses

¿Fue útil esta info?

Tax Return Status

RequestExpandir todo

Responses

¿Fue útil esta info?

Tax Situation

RequestExpandir todo

Responses

¿Fue útil esta info?

Account LinkDeprecado

Request

Responses

¿Fue útil esta info?

Request

Request

Request

Request

Request

Request

Request