Reportes operacionales

Tracium expone una serie de endpoints de reporting agregados sobre los eventos capturados. Estos son reportes operacionales (alerts, documents, supplier performance, yields, inventory). No son paquetes regulatorios pre-formateados por normativa.

Endpoints disponibles

Todos en /api/v1/reports/*, autenticados con bearer JWT:

Endpoint	Qué devuelve
`GET /api/v1/reports/alerts`	Resumen de alertas de AI Insights
`GET /api/v1/reports/documents`	Inventario de documentos (NFT metadata + event metadata + certificados)
`GET /api/v1/reports/data-references`	Reporte de data references (auditoría cross-system de punteros)
`GET /api/v1/reports/supplier-performance`	Métricas agregadas de performance por organización
`GET /api/v1/reports/production-yields`	Agregación de yields por proceso/lot
`GET /api/v1/reports/inventory-by-location`	Inventario agrupado por custodian

Estos endpoints son agregaciones genéricas. Sirven para dashboards internos, BI, monitoreo operacional. No son paquetes de compliance regulatorios.

Paquetes regulatorios por normativa

Los paquetes formateados por normativa regulatoria (FSMA 204 CTE/KDE, EUDR DDS, USMCA Cert of Origin, IATF 16949 quality records, ESPR DPP) se generan en un servicio dedicado de reportes regulatorios, separado del servicio de eventos.

Normativa	Disponibilidad
FSMA 204	Disponible
EUDR DDS	Disponible bajo demanda
USMCA Cert of Origin	Disponible bajo demanda
IATF 16949 quality records	Disponible bajo demanda
ESPR DPP	Disponible bajo demanda

Si tu integración requiere los paquetes “bajo demanda” en producción, contactá al equipo en tech@darwinevolution.io para coordinar la activación.

Generar un reporte operacional

# Ejemplo: inventory by location
curl "$BASE_URL/api/v1/reports/inventory-by-location" \
  -H "Authorization: Bearer $TOKEN"

# Ejemplo: supplier performance
curl "$BASE_URL/api/v1/reports/supplier-performance" \
  -H "Authorization: Bearer $TOKEN"

Para los schemas exactos de respuesta, ver Reference (autogenerada del OpenAPI spec).

Cómo se arman los paquetes

Cada normativa tiene un mapeo de eventos canónicos a puntos de datos requeridos. La lógica de mapeo codifica el conocimiento regulatorio aplicado:

Para FSMA 204: qué eventos califican como CTEs, qué campos califican como KDEs, cómo armar el rastro de TLC.
Para EUDR DDS: qué puntos de datos de GPS a nivel parcela satisfacen geolocalización, cómo concatenar al import.
Para USMCA: cómo se computa el BOM-by-origin desde el grafo de custodia multi-tier.
Para IATF 16949: qué registros de QC mapean a PPAP / FAI / SPC.
Para ESPR DPP: cómo composición + reciclabilidad + footprint fluyen al pasaporte JSON-LD.

Qué es público, qué está controlado

La lista de endpoints y disponibilidad por normativa es pública (esta página). La lógica de mapeo por normativa está controlada, ya que codifica el conocimiento regulatorio aplicado en producción.

Lógica de mapping de compliance

La lógica exacta de transformación de eventos canónicos a paquetes regulatorios por normativa, mapeo propio para regulaciones que no están listadas, y trazabilidad de puntos de datos específicos en nuestros paquetes de vuelta a tus eventos capturados. Hablanos y caminamos tu posición de compliance.

Hablanos →

Deep dives por vertical

Para ejemplos de cadena completa por vertical:

Trazabilidad alimentaria: FSMA 204 + EUDR end-to-end
Automotriz: USMCA + IATF 16949 end-to-end
Textil: ESPR DPP + RWS + OEKO-TEX end-to-end

Cross-links

Conceptos de normativas de compliance: qué es cada normativa + obligaciones
Webhooks: automatizar generación de reportes al landing del evento