Skip to content
Download OpenAPI description
Overview
Languages
Servers
Production

https://api.khipu.com/

Request

Este método se conecta a la cuenta especificada por el usuario en Administradora de Fondo de Cesantía (AFC) y retorna su "Saldo en cuenta".

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/jsonrequired
RequestDataobjectrequired

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.

AccountCredentialobjectDeprecated

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

One of:
Deprecated

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.

Example: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/afc.cl/balance \
  -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 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

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"
Example: "OK"
Dataobject or nullrequired

Contenedor para el saldo de las contribuciones.

ContributionsBalanceobjectrequired

Contenedor para el saldo de las contribuciones.

AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequired

null en peticiones sincrónicas.

Example: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "ContributionsBalance": { "CreationDate": "2017-07-22", "TotalBalance": "10000", "TotalBalanceCuota": "223.45", "Details": [ {} ] } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Request

Este método se conecta a la cuenta especificada por el usuario en Administradora de Fondo de Cesantía (AFC) y retorna el "Certificado de Movimientos" correspondiente al período consultado.

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/jsonrequired
RequestDataobjectrequired

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.

Periodstringrequired

Año para el periodo a obtener. Rango desde 1970 hasta el año actual.

Example: "2021"
AccountCredentialobjectDeprecated

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

One of:
Deprecated

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.

Example: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/afc.cl/contributions-certificate \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "Period": "2021"
    }
  }'

Responses

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

Bodyapplication/json
OperationIdstring<= 36 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

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"
Example: "OK"
Dataobject or nullrequired

Contenedor para movimientos de contribuciones.

ContributionsCertificateobjectrequired
AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequired

null en peticiones sincrónicas.

Example: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "ContributionsCertificate": { "IdentifierNumber": "49PW-50JX-WLO9-6JVP", "CreationDate": "2023-09-28", "Title": "Certificado de movimiento de Cuenta Individual por Cesantía", "Description": "AFC CHILE S.A. certifica que la Cuenta Individual de Cesantía perteneciente al afiliado(a) AAAAA BBBBB CCCCC DDDDD, RUT 11.222.333-N registra los siguientes movimientos en el período de FEBRERO/2022 a AGOSTO/2023:", "Movements": [ {} ], "Document": "<document>" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Request

Este método se conecta a la cuenta empleador especificada por el usuario en Administradora de Fondo de Cesantía (AFC) y retorna el "Saldo Aporte Empleador" para un Rol Único Nacional (RUN) de empleado.

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/jsonrequired
RequestDataobjectrequired

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.

EmployeeIdstringrequired

Identificador único e inmutable utilizado para identificar al empleado (RUT).

Example: "10.111.111-1"
ContributionStartDatestringrequired

Fecha de inicio de los aportes en formato ISO 8601 (YYYY-MM-DD).

Example: "2024-01-01"
AccountCredentialobjectDeprecated

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

One of:
Deprecated

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.

Example: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/afc.cl/employer/contributed-balance \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "EmployeeId": "10.111.111-1",
      "ContributionStartDate": "2024-01-01"
    }
  }'

Responses

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

Bodyapplication/json
OperationIdstring<= 36 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

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"
Example: "OK"
Dataobject or nullrequired

Contenedor de saldo aporte empleador.

EmployerContributionsBalanceobjectrequired

Proporciona información sobre el balance.

AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequired

null en peticiones sincrónicas.

Example: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "EmployerContributionsBalance": { "EmployeeId": "19.111.111-1", "NominalAmount": "65000", "Profitability": "20550", "AdministrationCosts": "7990", "EmployerContributionAmount": "99500", "Currency": "CLP" } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Request

Este método se conecta a la cuenta especificada por el usuario en Administradora de Fondo de Cesantía (AFC) y retorna las "Ultimas Contribuciones Acreditadas" correspondientes al período consultado.

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/jsonrequired
RequestDataobjectrequired

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.

Periodstring

Periodo para el cual se recuperarán las ultimas cotizaciones acreditadas. De no ser proporcionado, se recuperará la última disponible.

Example: "2024"
AccountCredentialobjectDeprecated

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

One of:
Deprecated

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.

Example: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/afc.cl/last-credited-contribution \
  -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 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

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"
Example: "OK"
Dataobject or nullrequired

Contenedor de cotizaciones pagadas.

PaidContributionsArray of objectsrequired

Conjunto de contribuciones pagadas. Puede estar vacío.

AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequired

null en peticiones sincrónicas.

Example: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "PaidContributions": [ { "ContributionDate": "2017-07", "EmployerId": "11.222.333-4", "EmployerName": "KHIPU SPA", "TaxableIncome": "10000", "TaxedAmount": "1000", "PaymentDate": "2017-07-22" } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Request

Este método se conecta a la cuenta especificada por el usuario en Administradora de Fondo de Cesantía (AFC) y retorna las "Cotizaciones pagadas" correspondientes al período consultado.

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/jsonrequired
RequestDataobjectrequired

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.

Periodstringrequired

Año para el periodo a obtener. Rango desde 1970 hasta el año actual.

Example: "2021"
AccountCredentialobjectDeprecated

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

One of:
Deprecated

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.

Example: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/services/afc.cl/paid-contributions-v2 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "Period": "2021"
    }
  }'

Responses

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

Bodyapplication/json
OperationIdstring<= 36 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

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"
Example: "OK"
Dataobject or nullrequired

Contenedor de cotizaciones pagadas.

PaidContributionsArray of objectsrequired

Conjunto de contribuciones pagadas. Puede estar vacío.

AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

Descripción asociada al código de error.

Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."
LifeSpanstring or nullrequired

null en peticiones sincrónicas.

Example: null
Response
application/json
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "PaidContributions": [ { "ContributionDate": "2017-07", "EmployerId": "11.222.333-4", "EmployerName": "KHIPU SPA", "TransactionCode": "101-01", "InvoiceNumber": "", "TaxableIncome": "10000", "TaxedAmount": "1000", "ChargedAmount": "1000", "PaymentDate": "2017-07-22", "PaymentType": "COMIS. PORC. SALDOS AFIL" } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }