MGBI proporciona una API completa para descargar datos de registros y archivos públicos, incluido el Registro Nacional de Deuda (KRZ).
Puede encontrar una lista de las fuentes de datos disponibles en este servicio en:
👉 API de Registros Públicos
Esta guía trata sobre la API del motor de búsqueda de entidades KRZ , que proporcionamos como parte del producto:
👉 API del Registro Nacional de Deudas (KRZ API) - Motor de búsqueda de entidades
A continuación, describimos cómo descargar una lista de procedimientos judiciales del Registro Nacional de Deudas (KRZ) para un deudor específico utilizando la API, en función de su número NIP o PESEL.
Paso 1: Obtenga una clave de autorización de API
Para obtener la clave de autorización necesaria para llamar a los endpoints disponibles en la API de MGBI, contáctenos a través del formulario de contacto en la página del producto:
👉 Krajowy Rejestr Zadłużonych API (KRZ API) - Entity Search Engine
Paso 2: Llamar al punto final Crear actualización
Ponemos los datos disponibles en el motor de búsqueda de entidades KRZ, disponible en la API de MGBI en el modelo de datos con el identificador pl-krz-wp-record .
Este modelo se sincroniza bajo demanda, lo que significa que no disponemos de una copia completa de los datos del registro de origen en nuestra colección.
Para obtener datos actualizados del modelo sobre un deudor específico, primero debe crear una solicitud para recuperarlos del KRZ utilizando el Create Refresh .
👉 Documentación del punto final Create Refresh
Ejemplo de llamada al punto final Create Refresh con el número de identificación fiscal:
POST /v1/refresh HTTP/1.1 Host: api.mgbi.pl Authorization: [authorization key] { "query: { "model": "pl-krz-wp-record", "identifiers.pl_nip": [Número NIP] } }
Si necesita información sobre los procedimientos iniciados contra un deudor individual, también puede utilizar el número PESEL.
Ejemplo de llamada al punto final Create Refresh con el número PESEL:
POST /v1/refresh HTTP/1.1 Host: api.mgbi.pl Authorization: [authorization key] { "query: { "model": "pl-krz-wp-record", "identifiers.pl_nip": [Número NIP] } }
punto final Create Refresh devuelve un diccionario en respuesta que contiene el identificador del pedido en el id .
Paso 3: Llamar al punto final Get Refresh
Las solicitudes para recuperar datos del registro de origen suelen tardar entre unos pocos y varios segundos desde el momento en que son creadas por el Create Refresh .
Para comprobar el estado actual de una solicitud, llame al Get Refresh , especificando el ID de solicitud obtenido en el paso anterior en la URL.
👉 Documentación del punto final Get Refresh
Ejemplo de cómo llamar al punto final Get Refresh con un identificador de pedido:
GET /v1/refresh/[ID de solicitud] HTTP/1.1 Host: api.mgbi.pl Autorización: [clave de autorización]
Si el campo status del diccionario devuelto tiene el valor pending , la tarea aún se está ejecutando y al punto final Get Refresh en unos segundos.
Si el campo de estado tiene el valor " éxito" , significa que el pedido se ha ejecutado y que los datos relativos al deudor indicado ya se han descargado del registro de origen.
Paso 4: Invocar el punto final Obtener registros
La API del pl-krz-wp-record proporciona un Get Records que devuelve registros con el contenido completo de la respuesta del motor de búsqueda de entidades KRZ para el deudor especificado.
👉 Documentación del endpoint Get Records para el modelo pl-krz-wp-record
Para recibir datos recuperados del registro de origen en un pedido creado previamente, llame al Obtener registros pasando el ID del pedido en el refresh_id .
Ejemplo de cómo llamar al punto final Obtener registros con un ID de pedido:
GET /v1/models/pl-krz-wp-record/records?refresh_id=[order ID] HTTP/1.1 Host: api.mgbi.pl Authorization: [authorization key]
Paso 5: Lea la lista de procedimientos realizados contra el deudor en la respuesta
llamada válida al punto final Get Records devuelve una lista de registros que cumplen con los criterios especificados. En el ejemplo anterior, el punto final debería devolver una lista de resultados que contenga un único registro:
{ "count": 1, "pages": 1, "results": [ { "id": [identificador de registro], "identifiers": [identificadores de deudores], "content": [contenido de la respuesta del motor de búsqueda], "meta": [metadatos del registro] } ] }
Los procedimientos judiciales registrados en el Registro Nacional de Deudas se agrupan en expedientes. Un solo expediente puede contener datos de uno o más procedimientos relacionados.
Dependiendo de la forma jurídica del deudor, encontrará la lista de archivos en el campo:
- content.raw_result.search-by-entity.list_of_participants.0.files - para entidades que no son personas físicas,
- content.raw_result.search-for-jdg.lista_uczestnikow.0.teczki - para personas que dirigen un negocio,
- content.raw_result.search-for-of.list_of_participants.0.files - para personas que no dirigen un negocio.
Para consultar la lista completa de todos los procedimientos llevados a cabo contra el deudor y que constan en el Registro Nacional de Registros, es necesario procesar cada elemento de la lista de procedimientos en cada uno de los expedientes.
Ejemplo de contenido del elemento de la lista de procedimientos:
{ "current-metrics": [datos del deudor], "starting-date": [fecha de inicio del procedimiento], "creation-date": [fecha de creación del procedimiento], "ending-date": [fecha de finalización del procedimiento], "id": [identificador interno del procedimiento], "external-id": [identificador externo del procedimiento], "type of the procedures": [información sobre el tipo de procedimiento], "state of the ProceedingsRegister": [estado actual del procedimiento], "signatureAkt": [número de referencia del procedimiento], "details": [información detallada sobre el procedimiento], "UPE-details": [información detallada sobre el procedimiento de ejecución suspendido] }
Obtenga más información:
👉 Estructura de datos en el modelo pl-krz-wp-record
👉 Documentación de endpoints para el modelo pl-krz-wp-record
