Boletín Concursal (v1.0)

Download OpenAPI description
Overview
Languages
Servers
Production

https://api.khipu.com/

Procedure

Request

Este método retorna datos de un procedimiento con sus publicaciones asociadas para un Rol Tributario Nacional (RUT) chileno, tipo de procedimiento y rango de fecha específico usando el sitio web de Boletín Concursal.

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.

DebtorIdentifierstring^\d{1,2}(\.){0,1}\d{3}(\.){0,1}\d{3}[-][0-9kK...requerido

Rol Único Nacional chileno (RUN). Se puede pasar con o sin puntos.

Ejemplo: "11.222.333-k"
ProcedureTypestringrequerido

Tipo de procedimiento.

Ejemplo: "Liquidación voluntaria"
DebtorNamestringrequerido

Nombre del deudor.

Ejemplo: "SOCIEDAD COMERCIAL AA LIMITADA"
PublicationDateStartstringrequerido

Fecha de inicio en formato ISO 8601 (YYYY-MM-DD) utilizada para obtener las publicaciones.

Ejemplo: "2024-01-01"
PublicationDateEndstringrequerido

Fecha de término en formato ISO 8601 (YYYY-MM-DD) utilizada para obtener las publicaciones.

Ejemplo: "2024-03-01"
Regionstring

Región.

Ejemplo: "Región Metropolitana"
Courtstring

Nombre del tribunal.

Ejemplo: "1° Juzgado Civil de Puente Alto"
Rolstring

Rol.

Ejemplo: "C-19999-9999"
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/boletinconcursal.cl/publications-procedure \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "DebtorIdentifier": "11.222.333-k",
      "ProcedureType": "Liquidación voluntaria",
      "DebtorName": "SOCIEDAD COMERCIAL AA LIMITADA",
      "PublicationDateStart": "2024-01-01",
      "PublicationDateEnd": "2024-03-01"
    }
  }'

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 de procedure.

Procedureobjectrequerido

Contenedor de procedure.

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": { "Procedure": { "DebtorIdentifier": "76.111.111-1", "DebtorName": "SOCIEDAD COMERCIAL AAA LIMITADA", "Court": "1° Juzgado Civil de Puente Alto", "Rol": "C-19999-9999", "ProcedureType": "Liquidación voluntaria - Empresa Deudora", "Publication": [ {} ] } }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }

Publications

Request

Este método retorna publicaciones para un Rol Tributario Nacional (RUT) chileno, usando el sitio web de Boletín Concursal.

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.

DebtorIdentifierstring^\d{1,2}(\.){0,1}\d{3}(\.){0,1}\d{3}[-][0-9kK...requerido

Rol Único Nacional chileno (RUN). Se puede pasar con o sin puntos.

Ejemplo: "11.222.333-k"
ProcedureTypestring

Tipo de procedimiento.

Ejemplo: "Liquidación voluntaria"
DebtorNamestring

Nombre del deudor.

Ejemplo: "SOCIEDAD COMERCIAL AA LIMITADA"
PublicationDateStartstring

Fecha de inicio en formato ISO 8601 (YYYY-MM-DD) utilizada para obtener las publicaciones.

Ejemplo: "2024-01-01"
PublicationDateEndstring

Fecha de término en formato ISO 8601 (YYYY-MM-DD) utilizada para obtener las publicaciones.

Ejemplo: "2024-03-01"
Regionstring

Región.

Ejemplo: "Región Metropolitana"
Courtstring

Nombre del tribunal.

Ejemplo: "1° Juzgado Civil de Puente Alto"
Rolstring

Rol.

Ejemplo: "C-19999-9999"
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/boletinconcursal.cl/publications \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "DebtorIdentifier": "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

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 de publicaciones.

PublicationArray of objectsrequerido

Contenedor de publicaciones.

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": { "Publication": [ { "DebtorIdentifier": "76.111.111-1", "ProcedureType": "Liquidación voluntaria - Empresa Deudora", "DebtorName": "SOCIEDAD COMERCIAL AAA LIMITADA", "PublicationDate": "2022-02-13", "PublicationName": "Cuenta provisoria del liquidador", "Overseer": "John Doe" } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }