¿Cómo automatizar el seguimiento de deudores con la API de la Lista de Quiebras?

¿Qué es una API?

API significa «Interfaz de Programación de Aplicaciones ». Es un conjunto de reglas y protocolos que permiten la comunicación entre diferentes sistemas informáticos.

Es una especie de puente que permite que una aplicación utilice la funcionalidad de otra sin tener que comprender todo el mecanismo de su funcionamiento.

Para simplificarlo, imaginemos que una API es el menú de un restaurante. El menú muestra los platos disponibles (es decir, las características), pero no es necesario saber cómo prepara cada plato el chef ni cómo funciona la cocina.

Pides un plato del menú y la cocina (otra app) lo prepara. Así, usas el menú (API) para pedir y recibir tu comida sin preocuparte por lo que ocurre en la cocina.

Una gran cantidad de sitios web y aplicaciones que visitamos utilizan diversas API. Las aplicaciones móviles para banca en línea, por ejemplo, lo hacen.

Gracias al acceso a la API interna del banco, la aplicación instalada en tu teléfono puede, por ejemplo, descargar datos sobre cuentas, transacciones y saldos, sin que el banco tenga que proporcionarle acceso a todo su sistema y a toda la información disponible en él.

¿Cómo puede la API de lista de quiebras de MGBI ayudarle con su trabajo?

el Registro Nacional de Deuda y el Monitor Judicial y Comercial en cualquier momento

Al conectar los sistemas que utiliza su empresa con nuestro servicio, podrá, por ejemplo:.

Descarga todos los nuevos anuncios publicados en KRZ y MSiG de forma continua,
Consulte nuestra API para obtener anuncios sobre deudores individuales en función de los números de registro (por ejemplo, NIP/PESEL),
Solicitar la elaboración de informes colectivos con anuncios que cumplan los criterios establecidos y descargarlos.

Uso de la API de la lista de quiebras de MGBI

Para utilizar la de la lista de quiebras de MGBI , primero debe obtener una clave API (también conocida como token).

Una clave API es un tipo de identificador que se utiliza para autorizar el acceso a una interfaz de programación de aplicaciones (API). Es una función de seguridad que ayuda a controlar qué aplicaciones o servicios tienen permiso para usar la API.

Para obtener la clave, inicie sesión en el servicio y vaya a la pestaña “ Parámetros del servicio ”.

Una vez que tenga la clave, puede comenzar a utilizar la API de lista de quiebras de MGBI.

Consulta de la API para deudores individuales

Para obtener una respuesta a través de la API sobre una única entidad comercial, debe conocer al menos uno de sus números de registro, por ejemplo, el NIP.

Si desea recuperar anuncios de quiebra y reestructuración de una entidad, la solicitud HTTP realizada mediante CURL debería verse así:

curl https://api.imsig.pl/v2/announcements/?nip=5213482472&append_first_entry=true -H "Autorización:<klucz-api> "

En el ejemplo anterior, https://api.imsig.pl/ denota la dirección del servidor API, v2/ la versión API y anuncia una única función API (denominada punto final) que permite descargar contenido de anuncios de MSiG y KRZ en formato JSON.

La clave API se pasa en el parámetro HTTP "Authorization", y el parámetro "nip" es, por supuesto, el número NIP de la entidad que nos interesa.

parámetro append_first_entry , lo que permite que la búsqueda incluya los datos de la entidad publicados en el primer anuncio dentro del mismo procedimiento.

Esto es importante porque, en el caso de los anuncios publicados en el Tribunal de Justicia de la Unión Europea, el número de registro del deudor suele aparecer solo en el primer anuncio que les concierne. Consultar la API sin configurar este parámetro puede provocar la omisión de algunos anuncios en la respuesta.

Si la autorización con el token mencionado se realiza correctamente, la API devolverá una lista de anuncios sobre procedimientos llevados a cabo contra la empresa indicada, asumiendo, por supuesto, que previamente se haya declarado en quiebra o iniciado una reestructuración.

Ejemplo de contenido de un solo anuncio:

{ "id": "651d667e2323c65e8e17e295", "meta": { "issue_date": "2023-10-04", "category": "K.0.3.16", "first_update_date": "2023-10-04", "last_update_date": "2023-11-05", "is_administrator_data_consistent": true, "is_correction": false, "is_entity_data_consistent": true }, "entity": [ { "info": { "cleaned_name": "VB Leasing SA", "legal_form": "joint-stock companies", "ownership_type": "other private domestic property", "primary_business": "64.91.Z Financial leasing", "commencement_date": "2008-04-02" }, "numbers": { "nip": "5213482474", "regon": "141374292", "krs": "0000307665" }, "address": { "state": "dolnośląskie", "powiat": "Wrocław", "gmina": "Wrocław-Fabryczna", "ciudad": "Wrocław", "calle": "ul. Fabryczna", "house_number": "6", "zip_code": "53-609" } } ], "procedimiento": { "court_name": "Tribunal de Distrito de Wrocław-Fabryczna en Wrocław", "court_department": "VIII División Comercial", "signatures": [ "WR1F/GR/16/2023", "WR1F/GRs/5/2023" ], "administrator_name": "Ams Restrukturyzacje sp. z o. o.", "administrator_function": "syndyk", "administrator_address": "ul. Pawła Włodkowica 10 lok. 3", "administrator_zip_code": "50-072", "administrator_town": "Wrocław" }, "order": {}, "krz_entry": { "chapter": 0, "section": 3, "subsection": 16, "signature": "20231004/00341", "issue_date": "2023-10-04", "URL": "https://krz.ms.gov.pl/#!/application/KRZPortalPUB/1.4/KrzRejPubGui.SzczegolyObwieszenia?params=JTdCJTIyaWRaZXduZXRyem55JTIyJTNBJTIyZWMzYTllODctOTljZC00YTg2LTljNzQtOThkZDQxZmI1MjFhJTIyJTdE" }, "content": { "text": "El Tribunal de Distrito de Wrocław-Fabryczna en Wrocław, 8.ª División Comercial, ul. Poznańska 16, 53-630 Wrocław, anuncia que la decisión del Tribunal sobre la apertura del procedimiento de reparación emitida en el procedimiento WR1F/GR/16/2023, el 25 de julio de 2023, con la designación La resolución WR1F/GR/16/2023/39, en lo que respecta a la apertura del procedimiento de reestructuración, es definitiva y vinculante a partir del 25 de julio de 2023.", "html": "El Tribunal de Distrito de Wrocław-Fabryczna, en Wrocław, 8.ª División Comercial, calle Poznańska 16, 53-630 Wrocław, anuncia que la Decisión del Tribunal sobre la apertura del procedimiento de reestructuración, emitida en el expediente WR1F/GR/16/2023, de fecha 25 de julio de 2023, con número de referencia WR1F/GR/16/2023/39, en el marco de la decisión sobre la apertura del procedimiento de reestructuración, adquiere firmeza y carácter vinculante a partir del 25 de julio de 2023.
", "url": "https://www.imsig.pl/lista-upadlosci/ogloczenia/651d667e2323c65e8e17e295" } }

La estructura del objeto JSON con el contenido del anuncio consta de varios grupos de información:

entidad : información sobre la entidad (o entidades) a la que se aplica el anuncio.
procedimiento - información sobre el procedimiento
orden - información sobre la decisión del tribunal
msig_entry : información sobre la fuente, si el anuncio se publicó en MSiG.
krz_entry : información sobre la fuente de datos, si el anuncio se publicó en KRZ.
contenido - el contenido sin procesar del anuncio
meta - información adicional sobre el anuncio

Los campos disponibles en los grupos de información individuales, así como todos los parámetros en función de los cuales se pueden buscar anuncios, se describen en la documentación de la API de la Lista de Quiebras para el punto final GET /v2/announcements .

Descargar todos los anuncios nuevos a través de API

La integración con la API de la Lista de Quiebras de MGBI es perfecta cuando existe la necesidad de importar periódicamente todos los anuncios publicados de forma continua en KRZ y MSiG al sistema informático interno.

Para asegurarte de no perderte ningún anuncio nuevo o actualizado, cada vez que ejecutes tu descargador de API, primero debes consultar el GET /v2/updates para obtener todas las actualizaciones nuevas desde la comprobación anterior hasta el momento actual.

Según la fuente de datos, las actualizaciones de la Lista de Quiebras de MGBI se realizan con una frecuencia específica:

Registro Nacional de Deudores: cada hora desde las 7:00 a. m. hasta las 9:00 p. m
Monitor Jurídico y Económico: una vez al día alrededor de las 11:00

Un ejemplo de consulta para una lista de actualizaciones de un período determinado se ve así:

curl https://api.imsig.pl/v2/updates?creation_datetime_from=2023-09-22T00:00:00Z&creation_datetime_to=2023-09-23T00:00:00Z -H "Authorization:<klucz-api> "

En respuesta, recibiremos una lista de todas las actualizaciones de datos que se introdujeron en nuestro servicio el 22 de septiembre de 2023:

[ { 'id': 8002, 'creation_datetime': '2023-09-22T22:17:13.915000+02:00', 'issue_date': '2023-09-22', 'announcements_count': 1, 'source': 'krz' }, { 'id': 8001, 'creation_datetime': '2023-09-22T20:17:25.733000+02:00', 'issue_date':'2023-09-22', 'announcements_count': 5, 'source': 'krz' }, { 'id': 8000, 'creation_datetime': '2023-09-22T18:17:25.001000+02:00', 'issue_date': '2023-09-22', 'announcements_count': 5, 'source': 'krz' }, { 'id': 7999, 'creation_datetime': '2023-09-22T17:17:24.751000+02:00', 'issue_date': '2023-09-22', 'announcements_count': 5, 'source': 'krz' }, ... ]

Una vez que la API devuelve una lista de actualizaciones, podemos determinar cuáles aún no se han descargado. Para ello, necesitamos registrar sus IDs en el "id" .

En el siguiente paso, para cada ID de actualización previamente desconocido, llamamos al GET /v2/announcements con el ID pasado en el "update_id" :

curl https://api.imsig.pl/v2/announcements?update_id=8002 -H "Authorization:<klucz-api> "

En respuesta, recibiremos una lista de todos los anuncios introducidos por la actualización con el ID indicado:

[ { "id": "650df6494634a8d43457cad8", "meta": { "issue_date": "2023-09-22", "category": "K.0.8.48", "first_update_date": "2023-09-22", "last_update_date": "2023-10-23", "is_administrator_data_consistent": true, "is_correction": false, "is_entity_data_consistent": true }, "entity": [ { "info": { "cleaned_name": "Geo-Term Polska SA", "legal_form": "joint-stock companies", "ownership_type": "mixed ownership in the private sector with a predominance of ownership by domestic individuals", "primary_business": "74.10.Z Specialized design activities", "commencement_date": "1995-06-20" }, "numbers": { "nip": "9540020399", "regon": "272624250", "krs": "0000426336" }, "address": { "state": "małopolskie", "powiat": "oświęcimski", "gmina": "Oświęcim", "town": "Oświęcim", "street": "ul. Chemików", "house_number": "1", "zip_code": "32-600" } } ], "procedimiento": { "court_name": "Tribunal de Distrito de Cracovia-Śródmieście en Cracovia", "court_department": "VIII División Comercial de Quiebras y Reestructuraciones", "signatures": [ "KR1S/GRz-nu/49/2023", "KR1S/GRz/71/2023" ], "administrator_name": "Wojciech Zymek", "administrator_function": "syndyk", "administrator_licence_number": 104, "administrator_address": "Asesor de reestructuración Wojciech Zymek ul. Jesionowa 22", "administrator_zip_code": "40-158", "administrator_town": "Katowice", "administrator_source_url": "https://krz-rdr-gui-krz-rdr-prod.apps.ocp.prod.ms.gov.pl/rdr-api/wyszukiwarka/doradcy/103" }, "order": { "order_date": "2023-09-22" }, "krz_entry": { "capítulo": 0, "sección": 8, "subsección": 48, "firma": "20230922/00445", "fecha_de_emisión": "2023-09-22", "url": "https://krz.ms.gov.pl/#!/application/KRZPortalPUB/1.4/KrzRejPubGui.SzczegolyObwieszenia?params=JTdCJTIyaWRaZXduZXRyem55JTIyJTNBJTIyZjI2NmQwNzItNWNlMC00OGNhLTg2MjItMjFkN2UzZGMzM2Q0JTIyJTdE" }, "contenido": { "texto": "Tribunal de Distrito de Cracovia-Śródmieście en Cracovia, 8.ª División Comercial Tribunal Comercial de Quiebras y Reestructuración Asuntos, ul. Przy Rondzie 7, 31-547 Cracovia, anuncia que mediante la orden de 22 de septiembre de 2023, emitida en el caso después de la presentación de una solicitud de aprobación de un acuerdo en el procedimiento para la aprobación de un acuerdo por parte del deudor, GEO-TERM POLSKA spółka akcyjna con su domicilio social en Oświęcim (KRS 0000426336), número de referencia de expediente KR1S/GRz/71/2023, decidió:\n\nsolicitud del artículo 165, apartado 1, en relación con el artículo 223, apartado 1, de la Ley de 15 de mayo de 2015 - Ley de Reestructuración, denegar la aprobación del acuerdo.\n\nEsta orden puede ser apelada ante el Tribunal de Distrito de Cracovia, XII Sala de Apelaciones Comerciales, a través del Tribunal de Distrito de Cracovia-Śródmieście en Cracovia, Octava División de Quiebras y Reestructuraciones Comerciales. La apelación deberá presentarse dentro de las dos semanas siguientes a la fecha de este anuncio. La apelación está sujeta a una tasa de 200,00 PLN. El tribunal rechazará la apelación si se presenta fuera de plazo, no se ha pagado o contiene deficiencias que no se subsanarán a pesar de la solicitud.", "html": "El Tribunal de Distrito de Cracovia-Śródmieście, 8.ª División Mercantil de Quiebras y Reestructuración, ul. Przy Rondzie 7, 31-547 Cracovia, anuncia que, mediante auto de 22 de septiembre de 2023, dictado en el caso, tras la presentación de una solicitud de aprobación de un convenio en el procedimiento de aprobación de un convenio del deudor, GEO-TERM POLSKA, sociedad anónima con domicilio social en Oświęcim (KRS 0000426336), número de referencia del expediente KR1S/GRz/71/2023, decidió:
De conformidad con el artículo 165, párrafo 1, en relación con el artículo 223, párrafo 1, de la Ley de 15 de mayo de 2015 - Ley de Reestructuración, denegar la aprobación del acuerdo.
Esta decisión puede ser recurrida ante el Tribunal de Distrito de Cracovia, XII.ª Sala de Apelaciones Mercantiles, a través del Tribunal de Distrito de Cracovia-Śródmieście, VIII.ª Sala de Quiebras y Reestructuraciones Mercantiles. El recurso debe presentarse en un plazo de dos semanas a partir de la fecha de este anuncio. El recurso está sujeto al pago de una tasa de 200,00 PLN. El tribunal desestimará el recurso si se presenta fuera de plazo, no se abona o presenta deficiencias que no se subsanan a pesar de la solicitud.
", "url": "https://www.imsig.pl/lista-upadlosci/ogloczenia/650df6494634a8d43457cad8" } }, ... ]

Para garantizar que todos los anuncios de una actualización determinada se hayan descargado correctamente, conviene comparar el número de anuncios devueltos por el punto final con el valor del "announcements_count" para esa actualización.

Si todo es correcto, los anuncios descargados se pueden importar a la base de datos del sistema informático interno.

Información detallada sobre otras capacidades de la API de Lista de Quiebras de MGBI está disponible en la documentación disponible en:

https://www.imsig.pl/inne/dokumentacja-api#tag/announcements_iapi