MGBI proporciona una API completa para recuperar datos de registros públicos, incluido el Registro Nacional de Tribunales (KRS). Puede encontrar una lista de las fuentes de datos disponibles en este servicio en:
👉 API de Registros Públicos
Esta guía se aplica a la API del Repositorio de Documentos Financieros del KRS , que proporcionamos como parte del producto:
👉 API del Registro Nacional de Tribunales (API del KRS) - Repositorio de Documentos Financieros
A continuación, describimos cómo descargar un archivo con el contenido de un documento financiero de una entidad específica del Registro Nacional de Sociedades (KRS) a través de la API , en función de su número KRS y otros parámetros.
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:
👉 API del Registro Nacional de Tribunales (API KRS) - Repositorio de Documentos Financieros
Paso 2: Llamar al punto final Obtener registros
Ponemos a disposición los datos del repositorio de documentos financieros de KRS en la API de MGBI en el modelo de datos con el identificador pl-krs-rdf-record .
Get Records para este modelo , que devuelve registros que contienen información sobre documentos financieros individuales que cumplen con los criterios especificados.
👉 Documentación del endpoint Get Records para el modelo pl-krs-rdf-record
Para descargar la lista de documentos disponibles en el Repositorio de Documentos Financieros KRS para una entidad seleccionada, es necesario proporcionar su número de registro: KRS, NIP o REGON Obtener Registros
Ejemplo de cómo llamar al punto final Obtener registros con el número KRS:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[número KRS] HTTP/1.1 Host: api.mgbi.pl Autorización: [clave de autorización]
Para limitar la lista a los documentos que le interesan, también puede utilizar parámetros adicionales, como por ejemplo:
- tipo - tipo de documento (por ejemplo, informe financiero anual, informe de gestión sobre las actividades de la entidad),
- period_major_year - el año de la mayor parte del período que abarca el documento.
En el ejemplo que se muestra a continuación, se utilizó Get Records
Ejemplo de cómo llamar al punto final Obtener registros con el número KRS, el tipo de documento y el año fiscal:
GET /v1/models/pl-krs-rdf-record/records?identifiers.pl_krs=[número KRS]&type=estado_financiero._año_principal=2025 HTTP/1.1 Host: api.mgbi.pl Autorización: [clave de autorización]
Paso 3: Lea la dirección para descargar el archivo del documento de la respuesta
punto final Get Records devuelve una lista de documentos que cumplen con los criterios especificados.
En los ejemplos anteriores, el punto final debería devolver una lista de resultados que contenga uno o más registros:
{ "count": [número de resultados], "pages": [número de páginas de resultados], "results": [ { "id": [identificador de registro], "identifiers": [identificadores de entidad], "document": [información del documento], "content": [contenido del documento], "files": [archivos con contenido del documento], "meta": [metadatos del registro] } ] }
La dirección del archivo con el contenido del documento en el formato original en el que se envió el documento al repositorio de documentos financieros de KRS se puede encontrar en el files.main_document.original.url .
Paso 4: Descarga el contenido del archivo y guárdalo o envíalo a tu navegador
Para descargar el contenido del archivo con la copia actual, realice una solicitud HTTP GET con la dirección leída del files.main_document.original.url y la clave de autorización de la API:
GET [dirección del archivo] HTTP/1.1 Host: api.mgbi.pl Autorización: [clave de autorización]
También puedes enviar directamente el contenido del archivo al navegador web del usuario de tu aplicación. En este caso, establece el valor del Content-Type , que informa al navegador sobre el formato del archivo transferido en función del contenido del files.main_document.original.content_type .
Obtenga más información:
👉 Estructura de datos en el modelo pl-krs-rdf-record
👉 Documentación de endpoints para el modelo pl-krs-rdf-record
