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 campos seleccionados de los estados financieros de una entidad específica desde el 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 un registro con el contenido de los estados financieros del Repositorio de Documentos Financieros KRS para una entidad seleccionada, es necesario introducir de registro : KRS, NIP o REGON, y parámetros adicionales como:
- 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 los campos del informe seleccionados de la respuesta
punto final Get Records devuelve una lista de documentos que cumplen con los criterios especificados.
En el ejemplo anterior, el punto final debería devolver una lista de resultados que contenga un solo registro:
{ "count": 1, "pages": 1, "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] } ] }
Los campos disponibles en los informes financieros en formato XML que cumplen con las estructuras lógicas del Ministerio de Finanzas polaco se almacenan en dos diccionarios:
- contenido.campos_extraídos,
- contenido.campos_estandarizados.
diccionario content.extracted_fields contiene todos los campos disponibles en el informe según la estructura lógica utilizada.
Encontrará una lista completa de los campos disponibles en este diccionario en un archivo de Excel. Para obtener el enlace de descarga, el formulario de la página del producto
Ejemplo de contenido del content.extracted_fields :
{ "bs": { "a_ca_cfy": 0, "a_ca_pfy": 0, "a_fa_cfy": 0, "a_fa_pfy": 0, "a_ta_cfy": 0, "a_ta_pfy": 0, ... } }
Si necesita acceder a todos los campos financieros de un informe, utilice el content.extracted_fields . Si solo necesita los campos más importantes del balance o del estado de resultados, utilice el content.standardized_fields .
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
