Función Enterprise

Exportación BI para Power BI, Tableau y Excel

Un único endpoint OData v4. Seis conjuntos de entidades. Encabezados de respuesta a prueba de auditoría que vinculan cada cifra con una fila del registro de auditoría de CarbonTrace. Conecta tu herramienta de BI favorita en menos de diez minutos.

Configurar la exportación BI Inicio rápido

Endpoint

https://carbontrace.cloud/api/v1/odata

Autentícate con una clave de API de CarbonTrace (que empieza por ct_live_) que tenga habilitada la exportación BI. Usa autenticación HTTP Basic: la clave de API como nombre de usuario, contraseña vacía. O Authorization: Bearer ct_live_….

Cuatro paneles por perfil

Crea estos paneles en Power BI o Tableau usando el mismo modelo de datos que entregamos con nuestros widgets integrados (N70).

CIO

Huella de TI total, tendencia interanual, categorías más emisoras, ratio gasto/carbono.

•Huella total (kg CO₂e)
•Crecimiento interanual %
•Coste por kg CO₂e

Responsable de ESG

Progreso SBTi vs. trayectoria, declaraciones CSRD ESRS E1, desglose por alcance.

•Brecha de ritmo SBTi
•Alcance 3 Cat. 1 + 2 + 11
•Tablas listas para CSRD

Compras

Comparación de proveedores, reutilización vs. compra nueva, emisiones evitadas por reacondicionamiento.

•Media kg CO₂e por dispositivo
•Ahorro por reutilización %
•Principales proveedores

Auditoría

Trazabilidad metodológica, distribución de confianza, cobertura de fuentes de datos.

•% de filas con alta confianza
•Cobertura de fichas metodológicas
•Mezcla de fuentes (Blancco / PCF / paramétrico)

Inicio rápido

Power BI Desktop

Abre Power BI Desktop → Get Data → OData feed
URL: https://carbontrace.cloud/api/v1/odata
Autenticación: Basic. Nombre de usuario = tu clave de API. Deja la contraseña vacía.
Selecciona los conjuntos de entidades que quieras y haz clic en Load.
Crea visualizaciones. Haz clic en Refresh para obtener los datos más recientes.

Ejemplo de medida DAX:

Total Footprint (kg) = SUM( Assets[total_kg_co2e] )

YoY Growth % =
  VAR curr = CALCULATE( [Total Footprint (kg)], YEAR(Assets[purchase_date]) = YEAR(TODAY()) )
  VAR prev = CALCULATE( [Total Footprint (kg)], YEAR(Assets[purchase_date]) = YEAR(TODAY())-1 )
  RETURN DIVIDE( curr - prev, prev )

Tableau Desktop

Connect → Web Data Connector
URL: https://carbontrace.cloud/connectors/tableau/
Pega el endpoint OData y tu clave de API y haz clic en Connect to Tableau
Los seis conjuntos de entidades aparecen como tablas; arrástralos al lienzo.

Excel

Data → Get Data → From Other Sources → From OData Feed
URL: https://carbontrace.cloud/api/v1/odata
Autenticación: Basic. Nombre de usuario = clave de API, contraseña en blanco.
Selecciona tablas y cárgalas en la hoja de cálculo. Power Query se actualiza bajo demanda.

Conjuntos de entidades

Assets

Hecho de activo desnormalizado: cada dispositivo de tu inventario con un desglose de carbono completo.

asset_idbrand, mpn, categorytotal_kg_co2e + phase breakdownpurchase_date, retirement_datecountry, department, cost_center

Certificates

Certificados de CO₂ emitidos: declaraciones públicas + pista de auditoría de cumplimiento.

certificate_numberbrand, mpnfootprint_total_kgissued_atis_public

Products

La biblioteca de productos de tu organización.

brand, mpn, categoryweight_kglast_calculated_at

EmissionFactors

Factores de emisión visibles para tu organización (de plataforma + específicos de la organización).

factor_typevalue, unitsourcedata_year

SbtiTargets

Science-Based Targets: líneas base, objetivos y trayectorias.

baseline_year, target_yearbaseline_emissions_kgtarget_reduction_pctscope

MonthlyEmissions

Emisiones mensuales preagregadas por categoría y país, listas para gráficos de series temporales.

monthcategorycountrytotal_kg_co2e

Sintaxis de filtro admitida

Un subconjunto seguro de OData v4. Los operadores no admitidos devuelven 501 Not Implemented con la lista de lo que sí se admite en el cuerpo de la respuesta: sin fallos silenciosos.

Admitido	Ejemplo
eq	category eq 'laptop'
ne	status ne 'retired'
gt / ge / lt / le	total_kg_co2e gt 200
and / or	country eq 'BE' and category eq 'laptop'
startswith()	startswith(department, 'Finance')
contains()	contains(product_name, 'Pro')
endswith()	endswith(serial_number, 'X1')

No admitido	Motivo
$expand	Las entidades están predesnormalizadas. Usa MonthlyEmissions para las agregaciones.
$apply	La agregación del lado del servidor no está disponible en la v1: agrega en el lado del cliente.
$batch	La exportación BI es estrictamente de solo lectura. Usa una única solicitud por entidad.
any() / all() / has()	Los predicados de colección no se admiten en la v1.
$compute / $search	No está en la v1. Usa $select + cálculo del lado del cliente.

Encabezados de prueba forense

Cada respuesta OData incluye tres encabezados que vinculan las filas devueltas con el registro de auditoría de CarbonTrace. Úsalos en flujos de cumplimiento para demostrar que un valor concreto de un panel procede de una consulta específica y a prueba de manipulaciones.

X-CarbonTrace-ProofID de la fila audit_log que registra esta consulta. Encadenada por hash según N128.

X-CarbonTrace-Proof-HashSHA256 de las filas devueltas (determinista: las filas ya están ordenadas).

X-CarbonTrace-Data-FreshnessMarca de tiempo ISO de la última actualización subyacente de activo/cálculo.

Modo sandbox

Prueba tus paneles antes de enviar datos reales. Usa una clave de sandbox (ct_test_…) contra el mismo endpoint OData: obtienes 50 activos ficticios, 20 certificados, 15 productos y 24 meses de emisiones agregadas para una organización llamada SandboxCorp. Todas las respuestas son deterministas, por lo que los paneles se renderizan de forma idéntica en cada demostración para clientes.

Límites de frecuencia

Las herramientas de BI generan muchas llamadas pequeñas por actualización. La exportación BI utiliza una cuota dedicada de 500.000 solicitudes/día y 2.000/minuto por clave de API, independiente de la cuota normal de la API Enterprise (100k/día). Las claves de sandbox comparten una cuota menor de 20k/día.

Preguntas frecuentes

¿Por qué no hay compatibilidad con Looker?: LookML no habla OData. Hay previsto un bloque nativo de Looker como N86b; suscríbete a través de Ajustes → Notificaciones cuando quieras recibir un aviso.
¿Puedo escribir datos de vuelta?: No. La exportación BI es de solo lectura. POST/PUT/PATCH/DELETE devuelven 405. Usa la API REST habitual para las mutaciones.
¿Cómo programo una actualización?: Desde el lado de la herramienta de BI. Power BI Service, Tableau Server y Excel a través de Power Query pueden ejecutar actualizaciones OData según una programación.
¿Se almacenan los datos en caché?: No. Cada respuesta OData lee directamente de vistas de Postgres en vivo con seguridad a nivel de fila. Sin obsolescencia de vistas materializadas.
¿Qué ocurre con el RGPD / la residencia de datos?: Todos los datos permanecen en eu-west-1. Sin exportación a nubes de terceros. Tu clave de API está vinculada a tu organización; las consultas entre organizaciones se bloquean en la capa de seguridad a nivel de fila.
¿Puedo conectarme desde mi propia herramienta ETL?: Sí. OData v4 es un protocolo estándar del W3C. Funciona cualquier cliente HTTP capaz de hablar OData (o simplemente JSON). Consulta la especificación OpenAPI para ver el contrato completo.

¿Listo para conectar tu herramienta de BI?

Habilita la exportación BI en una clave de API en Ajustes y estarás listo para empezar.

Abrir los ajustes de exportación BI Documentación de la API REST