Conectar Power BI a tus datos

Con una llave de API de tu empresa, Power BI —o cualquier herramienta que lea JSON por web— consulta tus datos en solo lectura. La llave solo ve los datos de tu empresa y de los productos que tienes contratados, y cada consulta queda registrada en la bitácora de la empresa.

1. Crea la llave

1. Entra a CORE › Administración › Integraciones y pulsa Administrar llaves de API (o ve directo a /admin/byoi). Necesitas el rol de administrador.
2. Pulsa Generar API key, ponle un nombre que diga para qué es (por ejemplo, «Power BI gerencia») y marca el alcance Datos de negocio (Power BI).
3. Copia la llave (empieza con sk_byoi_). Se muestra una sola vez: CORE guarda solo su huella, no la llave.

En la misma pantalla ves cuándo se usó cada llave por última vez y la puedes revocar. Una llave revocada deja de funcionar de inmediato (responde 401).

2. Los conjuntos de datos

La dirección de cada conjunto es https://core.lahrnexa.cl/api/byoi/v1/datos/<conjunto>.

No se exponen datos personales sensibles: ni datos de contacto de quien pide un servicio, ni firmas, fotos o documentos XML. Si pides un conjunto de un producto que no tienes contratado, la respuesta es 403.

Cada respuesta trae total, hay_mas, siguiente (la dirección de la página que sigue, o null) y filas. Por página van hasta 5.000 filas (?limite=, por omisión 1.000) y ?desde= indica desde qué fila. El límite por llave es de 300 consultas por hora.

3. Conecta Power BI

Para probar un conjunto (una sola página):

1. En Power BI Desktop: Obtener datos › Web › Avanzado.
2. En Elementos de la dirección URL, escribe https://core.lahrnexa.cl/api/byoi/v1/datos/ventas?limite=5000.
3. En Parámetros de encabezado de solicitud HTTP, agrega Authorization con el valor Bearer sk_byoi_… (tu llave).
4. Acepta. En el editor de Power Query, abre filas y conviértelo a tabla (A la tabla y luego expandir la columna).

Para traer todo el conjunto, página por página, usa Obtener datos › Consulta en blanco › Editor avanzado y pega:

let
    Llave = "sk_byoi_REEMPLAZA_POR_TU_LLAVE",
    Conjunto = "ventas",
    Pedir = (url as text) => Json.Document(Web.Contents(url, [Headers = [Authorization = "Bearer " & Llave]])),
    Paginas = List.Generate(
        () => Pedir("https://core.lahrnexa.cl/api/byoi/v1/datos/" & Conjunto & "?limite=5000&desde=0"),
        each _ <> null,
        each if _[siguiente] = null then null else Pedir(_[siguiente]),
        each _[filas]
    ),
    Filas = List.Combine(Paginas),
    Tabla = Table.FromRecords(Filas)
in
    Tabla

Cambia Conjunto por el que necesites y repite la consulta para cada uno. Al publicar en Power BI Service, configura la credencial de la fuente web como Anónima (la llave ya va en la cabecera) y programa la actualización.

Qué queda registrado

Cada consulta deja una fila en la bitácora de tu empresa (acción byoi.lectura) con el nombre de la llave, la dirección consultada y el resultado. Así sabes quién y cuándo leyó tus datos por la API.