Si gestiona una amplia cartera de entidades y, por motivos de seguridad o normativas internas, no desea compartir sus identificadores externamente , la solución óptima es la denominada " descarga por lotes ".
En lugar de preguntar por cada cliente individualmente, usted descarga un conjunto completo de anuncios nuevos publicados en KRZ y MSIG en el período seleccionado .
- La posibilidad de buscar y descargar todos los anuncios actuales sin proporcionar datos del deudor (por ejemplo, NIP, PESEL) solo está disponible en los planes Pro y Enterprise de la Lista de Quiebras.
- Los planes Mini y Estándar siempre requieren una identificación específica.
En esta guía, aprenderá cómo descargar un conjunto completo de anuncios de quiebra y reestructuración para un período seleccionado sin proporcionar los identificadores de las entidades que le interesan.
¿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í.
Funciona como un " puente digital " que permite que su software (por ejemplo, CRM o ERP) utilice automáticamente las funciones y los recursos de la Lista de Quiebras sin intervención humana .
En la práctica, su sistema se "acerca" a una ventana de oficina virtual, se autentica con una clave única e inmediatamente recibe el conjunto de documentos solicitados en un formato legible por máquina.
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").
Tenga en cuenta que la clave API es compartida por 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.
Paso 1: Consultar la lista de actualizaciones
Para descargar datos de un período específico, primero debe determinar los identificadores de actualización que se introdujeron en nuestras colecciones durante ese período.
Parámetros de consulta:
- Inicio del rango de tiempo: fecha_hora_de_creación
- Fin del rango de tiempo: creation_datetime_to
Frecuencia de potencia base:
- Registro Nacional de Deuda (KRZ): los datos se actualizan cada hora en días laborables (de 7 a 21).
- Monitoreo Judicial y Económico (MSiG): se actualiza una vez al día, generalmente alrededor de las 11 a.m.
el Registro Nacional de Deudas se actualiza hasta altas horas de la noche, por lo que recomendamos descargar los datos del día anterior únicamente a la mañana siguiente.
El método más eficaz es ejecutar una herramienta cíclica que consulte la API por la mañana para obtener actualizaciones de las últimas 24 horas.
Consulta de muestra
GET /v2/updates?creation_datetime_from=2026-09-22T00:00:00Z&creation_datetime_to=2026-02-02T00:00:00Z HTTP/1.1 Host: api.imsig.pl Authorization: [authorization key]
En respuesta, recibirá una lista de todas las actualizaciones que se realizaron en nuestro servicio durante el rango de tiempo dado, con identificadores de actualización (id) y la cantidad de anuncios en cada una (announcements_count).
[ { "id": 8002, "fecha_de_creación": "2026-02-02T22:17:13.915000+02:00", "fecha_de_emisión": "2026-09-22", "número_de_anuncios": 1, "fuente": "krz" }, { "id": 8001, "fecha_de_creación": "2026-02-02T20:17:25.733000+02:00", "fecha_de_emisión": "2026-09-22", "número_de_anuncios": 5, "fuente": "krz" }, { "id": 8000, "fecha_de_creación": "2026-02-02T18:17:25.001000+02:00", "fecha_de_emisión": "2026-09-22", "announcements_count": 5, "source": "krz" }, { "id": 7999, "creation_datetime": "2026-02-02T17:17:24.751000+02:00", "issue_date": "2026-09-22", "announcements_count": 5, "source": "krz" }, ... ]
Paso 2: Descarga del contenido publicitario
Cuando la API devuelve la lista de actualizaciones:
- Determina cuáles de ellos aún no has descargado anuncios.
- Anote sus identificaciones: id (por ejemplo, 8002).
- Para cada ID de actualización, llame al punto final de anuncios principal GET /v2/announcements , pasándolo en el update_id .
Consulta de muestra
GET /v2/announcements?update_id=8002 HTTP/1.1 Host: api.imsig.pl Authorization: [authorization key]
Esta consulta devolverá el conjunto completo de anuncios (en formato JSON) contenidos en esta actualización en particular.
[ { "id": "650df6494634a8d43457cad8", "meta": { "issue_date": "2026-02-02", "category": "K.0.8.48", "first_update_date": "2026-02-02", "last_update_date": "2026-02-02", "is_administrator_data_consistent": true, "is_correction": false, "is_entity_data_consistent": true }, "entity": [ { "info": { "cleaned_name": "Geo-Term Polska SA", "legal_form": "sociedades anónimas", "ownership_type": "propiedad mixta en el sector privado con predominio de personas físicas nacionales", "primary_business": "74.10.Z Actividades de diseño especializado", "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", "firmas": [ "KR1S/GRz-nu/49/2026", "KR1S/GRz/71/2026" ], "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/1003" }, "order": { "order_date": "2026-02-02" }, "krz_entry": { "capítulo": 0, "sección": 8, "subsección": 48, "firma": "20260202/00445", "fecha_de_emisión": "2026-02-02", "url": "https://krz.ms.gov.pl/#!/application/KRZPortalPUB/1.4/KrzRejPubGui.SzczegolyObwieszenia?params=JTdCJTIyaWRaZXduZXRyem55JTIyJTNBJTIyZjI2NmQwNzItNWNlMC00OGNhLTg2MjItMjFkN2UzZGMzM2Q0JTIyJTdtE" }, "contenido": { "texto": "Tribunal de Distrito de Cracovia-Śródmieście en Cracovia VIII La División Comercial de Quiebras y Reestructuración, ul. Przy Rondzie 7, 31-547 Cracovia, anuncia que mediante auto de 22 de septiembre de 2026, emitido en el caso tras recibir una solicitud de aprobación de un acuerdo en el procedimiento de aprobación de un acuerdo por parte 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/2026, decidió:\n\nEn aplicación del artículo 165, apartado 1, en conjunció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\nEste auto puede ser apelado ante el Tribunal de Distrito de Cracovia, XII.ª División de Apelaciones Comerciales, a través del Tribunal de Distrito de Cracovia-Śródmieście en Cracovia, 8.ª División de Quiebras Comerciales y División de Reestructuración. El recurso debe presentarse en un plazo de dos semanas a partir de la fecha de este anuncio. El recurso está sujeto a una tasa de 200,00 PLN. El tribunal rechazará el recurso si se presenta fuera de plazo, no se ha pagado o contiene deficiencias que no se subsanen a pesar de la citación.", "html": "El Tribunal de Distrito de Cracovia-Śródmieście en Cracovia, 8.ª División Mercantil de Quiebras y Reestructuración, ul. Przy Rondzie 7, 31-547 Cracovia, anuncia que mediante auto de 2 de febrero de 2026, emitido en el caso tras la presentación de una solicitud de aprobación del convenio en el procedimiento de aprobación del convenio del deudor, que es GEO-TERM POLSKA, sociedad anónima con domicilio social en Oświęcim (KRS 0000426336), número de referencia del expediente KR1S/GRz/71/2026, decidió: sobre la base Del artículo 165, apartado 1, en conjunción con el artículo 223, apartado 1, de la Ley de Reestructuración, de 15 de mayo de 2015, se deniega la aprobación del acuerdo. Esta decisión puede recurrirse 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 Mercantiles y Reestructuración. El recurso debe presentarse en un plazo de dos semanas a partir de la fecha de este anuncio. El recurso está sujeto a una tasa de 200,00 PLN. El tribunal desestimará el recurso si se presenta fuera de plazo, no se ha abonado o presenta deficiencias que no se subsanen a pesar de la citación
Tras descargar los anuncios, conviene comparar su número con el valor del parámetro " anuncios_count " del primer paso para asegurarse de que el sistema ha recibido correctamente todos los datos de la actualización seleccionada.
Estructura de datos
Los datos se devuelven en JSON , lo que permite su importación directa a sistemas internos (por ejemplo, CRM o ERP).
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
- meta - información técnica sobre el registro, incluyendo la fecha de publicación (issue_date) 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 (conservando la estructura del original).
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.
Si recibe el código de error 429 (Demasiadas solicitudes), significa que ha alcanzado su límite mensual de solicitudes .
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 consultas manuales realizadas en el de Listas de quiebras y las consultas realizadas automáticamente a través de la API utilizan el mismo conjunto 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 agotar el grupo de solicitudes disponibles, 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 consultar sus límites en la Lista de Bancarrota?
👉 Consulte la oferta y la lista de precios actuales: Lista de Bancarrota - Lista de Precios
