Para casos individuales, resulta conveniente buscar información sobre contratistas directamente en el de Listas de Quiebras del iMSiG.pl
Sin embargo, a mayor escala (por ejemplo, cientos o miles de contratistas, integración con sistemas CRM o de cobro de deudas), la gestión manual se vuelve ineficiente.
En estos casos, recomendamos utilizar la interfaz API , que permite:
- verificación automática del estado de los deudores,
- descarga cíclica de contenido publicitario,
- Integración de datos con sistemas internos (CRM, ERP, sistemas de cobro de deudas).
En esta guía aprenderá cómo descargar el texto completo de los anuncios de quiebra y reestructuración de un deudor específico en función de sus números de registro (NIP, KRS, REGON, PESEL).
¿Qué es la API de lista de quiebras?
Una API (Interfaz de Programación de Aplicaciones) es una interfaz de programación de aplicaciones , es decir, un conjunto de reglas y protocolos que permiten que diferentes sistemas informáticos se comuniquen directamente entre sí.
Actúa como un " puente digital " que permite que su software (por ejemplo, CRM o ERP) utilice automáticamente las funciones y los recursos de la base de datos de MGBI sin intervención humana.
El mecanismo de la API se puede comparar con una ventanilla en una oficina donde su sistema "introduce" el identificador del deudor y, en respuesta, recibe inmediatamente un conjunto de documentos.
Clave de autorización
Cada solicitud de API debe autenticarse. Esto se realiza mediante una clave de API (clave de autorización/token), que identifica su suscripción y controla los límites de solicitudes disponibles.
Para obtener una clave API, inicie sesión en el iMSiG.pl , vaya a la pestaña " Lista de quiebras " y luego abra " Parámetros del servicio ".
En la parte inferior de la página, en la sección " API ", encontrará su clave de autorización y un enlace a la documentación completa ("Versión de la API").
Recuerda que la clave API es común a todos los usuarios dentro de una misma suscripción , lo que significa que la cuenta principal y todas las subcuentas operan con la misma clave (token).
Descarga de avisos de deudores
El contenido de los anuncios se descarga mediante GET (utilizadas para leer datos) dirigidas al punto final de la API .
1. Punto final principal
OBTENER /v2/anuncios
El punto final mencionado anteriormente se utiliza para buscar y descargar anuncios del Monitor Judicial y Económico (MSiG) y del Registro Nacional de Deuda (KRZ).
En la documentación técnica se puede encontrar una descripción detallada de los parámetros: Lista de quiebras - Documentación de la API .
2. Identificación del deudor
Para descargar anuncios de una entidad específica, debe proporcionar al menos un número de identificación :
- " nip= " – número de identificación fiscal (p. ej. 5213482472).
- " pesel= " – Número PESEL (personas naturales, incluyendo la quiebra personal).
- " krs= " – Número de registro del Tribunal Nacional (empresas, fundaciones, asociaciones),
- " regon= " – Número REGON (de 9 o 14 dígitos),
3. Parámetro importante: append_first_entry
En el Monitor de Tribunales y Comercio, los identificadores de deudor (NIP, KRS, REGON) a menudo aparecen solo en el primer anuncio de un caso determinado.
Los anuncios posteriores (por ejemplo, sobre un plan de reembolso o un cambio de administrador fiduciario) podrían no incluir números de identificación.
es necesario establecer el parámetro en la consulta :
agregar_primera_entrada=verdadero
Gracias a esto, la API encuentra el primer anuncio del procedimiento, identifica al deudor en función de él y devuelve todos los anuncios relacionados con ese procedimiento , incluso si no contienen un identificador en el contenido.
Sin este parámetro, la respuesta puede ser incompleta .
4. Consulta de ejemplo
Supongamos que desea descargar anuncios de quiebra y reestructuración de una entidad en función de su Número de Identificación Fiscal .
La solicitud HTTP debería tener este aspecto:
GET /v2/announcements?nip=1234567890&append_first_entry=true HTTP/1.1 Host: api.imsig.pl Authorization: [authorization key]
De manera similar, en lugar del parámetro " nip= ", puede usar " krs= ", " regon= " o " pesel= ".
Estructura de datos
La API devuelve los datos en formato JSON , lo que permite su procesamiento automático en cualquier sistema informático.
Secciones de respuesta principal
En la respuesta de la API se pueden distinguir los siguientes grupos de datos:
- id - identificador único del anuncio en la base de datos de MGBI
- metadatos : información técnica sobre el registro, incluyendo la fecha de publicación y las fechas de la primera y última actualización del anuncio en el sistema.
- entidad - datos detallados de la entidad (o entidades) en cuestión: nombre, forma jurídica, código PKD y domicilio social.
- Procedimiento : detalles del procedimiento judicial: nombre del tribunal, número de caso y datos del administrador o supervisor (nombre o nombre y apellidos, cargo).
- Orden : datos relativos a una decisión judicial específica, por ejemplo, su fecha.
- krz_entry / msig_entry : parámetros de publicación detallados según la fuente (capítulo, sección, enlace al anuncio original en el portal del gobierno).
- Contenido : el contenido completo del anuncio se proporciona en dos formatos: texto y HTML.
Puedes encontrar la lista completa y la descripción de los campos en la documentación de la API, en la sección " GET /v2/announcements" : Consulta la documentación.
Códigos de respuesta HTTP
Los códigos de respuesta más comunes que su sistema debería manejar:
- 200 (Éxito): Consulta ejecutada exitosamente.
- 401 / 403 (Error de autorización): Clave API incorrecta o faltante.
- 429 (Límite excedido): Has agotado tu límite de consultas para el mes.
Respuesta de ejemplo
{ "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 El Tribunal de Distrito de Wrocław-Fabryczna, 8.ª División Mercantil, calle Poznańska 16, 53-630 Wrocław, anuncia que la decisión del Tribunal sobre la apertura de un procedimiento de remediación, dictada en el procedimiento WR1F/GR/16/2023, el 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 de un procedimiento de reestructuración, adquiere firmeza y carácter vinculante el 25 de julio de 2023. "https://www.imsig.pl/lista-upadlosci/ogloszenia/651d667e2323c65e8e17e295" } }
Límites
Cada solicitud a la API dirigida al punto final "/v2/announcements" reduce el grupo de solicitudes mensuales asignado a su suscripción.
El sistema distingue dos límites básicos de API, dependiendo de la fecha de publicación del anuncio:
1️⃣ Anuncios actuales : publicados antes del primer día del mes de activación de su servicio.
2️⃣ Anuncios archivados : incluye datos anteriores al primer día del mes en que se activa el servicio. Su descarga consume un límite de consultas independiente para anuncios archivados. Este límite depende de tu plan de suscripción.
El límite se reduce cada vez que se llama a la función , independientemente del número de anuncios devueltos en la respuesta y de si la consulta se refería a una sola entidad o a todo el período.
Generar una consulta que no devuelva resultados (lista vacía) también reduce el límite disponible.
Las búsquedas en el Listas de quiebras y las consultas realizadas automáticamente por la API utilizan el mismo grupo de consultas disponibles .
Recomendamos comprobar periódicamente el estado de los límites , especialmente durante la fase de pruebas de integración, durante el primer lanzamiento de procesos automáticos y al trabajar con un gran número de identificadores.
Superar el límite
Después de utilizar el grupo de solicitudes disponible, la API devolverá un código de respuesta: " 429 – Demasiadas solicitudes ".
Este código significa que has alcanzado tu límite mensual y no se procesarán más solicitudes hasta que lo renueves en un nuevo período de facturación o actualices tu suscripción (en cualquier momento).
Se trata de un bloqueo deliberado derivado de las normas de facturación del servicio y debe interpretarse como una señal para detener las consultas posteriores .
👉 Más información sobre los límites: ¿Cómo comprobar el uso de los límites en la Lista de Quiebras?
👉 Consulta la oferta y la lista de precios actuales: Lista de quiebras - lista de precios
