{"api":"API de Datos Anónimos — Navitrans","version":"1.0.0","descripcion":"API REST de SOLO LECTURA sobre la base de datos anonimizada del ERP (D365 F&O + Annata + Dataverse) y del cubo BI. Misma estructura que producción, datos pseudonimizados: ideal para desarrollo, prototipos y análisis sin exponer información personal.","baseUrl":"/api/v1","autenticacion":{"tipo":"Bearer token permanente","header":"Authorization: Bearer <token>","nota":"Requerido en los endpoints de datos (rows, count, query). El catálogo es de solo metadatos."},"soloLectura":"Garantía triple: el endpoint SQL del lakehouse es de solo lectura, la identidad de la API solo tiene GRANT SELECT, y la API no expone ninguna operación de escritura.","anonimizacion":{"identificadores":"Hash determinístico de longitud preservada (cuentas de cliente/proveedor, facturas, órdenes, VIN, placas, NIT, seriales…). Mismo valor real = mismo pseudónimo en TODOS los servicios ⇒ los joins funcionan.","nombres":"Personas/empresas → \"Cliente <hash8>\".","contacto":"Correos → \"<hash8>@anonimo.local\"; teléfonos y direcciones de calle → NULL.","intactos":"Montos, fechas, cantidades, estados y catálogos (marca, modelo, grupo, sede, ciudad DANE…)."},"organizacion":{"esquemas":{"fenix":"Tablas crudas del ERP D365 F&O + Dataverse + Annata (columnas en minúsculas).","entidades":"Vistas tipo OData materializadas, columnas PascalCase (las más cómodas para apps).","cubos":"Marts y dimensiones del cubo BI, nombres en español (espacios reemplazados por \"_\")."},"conteoPorEsquema":{"fenix":176,"entidades":16,"cubos":18},"totalServicios":210,"totalDominios":12},"descubrimiento":{"catalogoCompleto":"/api/v1/catalogo","dominios":"/api/v1/dominios","detalleDominio":"/api/v1/dominios/{dominio}","servicios":"/api/v1/servicios","detalleServicio":"/api/v1/servicios/{id}   (id = \"<schema>.<tabla>\", incluye columnas reales en vivo)","busqueda":"/api/v1/buscar?q=<texto>   (busca en nombres, tablas, campos, dominios)"},"datos":{"filas":"/api/v1/servicios/{id}/rows?limit&offset&orderBy&order&select + filtros de igualdad (?campo=valor)","conteo":"/api/v1/servicios/{id}/count (+ filtros)","sqlCrudo":"POST /api/v1/query {\"sql\":\"SELECT ...\",\"params\":{...}} — solo SELECT/WITH","compatibilidad":"/api/v1/schemas/{schema}/tables/{tabla}/rows (rutas genéricas equivalentes)"},"comoEmpezar":["1. GET /api/v1/dominios — mira los dominios de negocio disponibles.","2. GET /api/v1/buscar?q=<lo que necesitas> — encuentra el servicio.","3. GET /api/v1/servicios/{id} — revisa campos clave, relaciones y columnas reales.","4. GET /api/v1/servicios/{id}/rows?limit=100 — consume los datos (con token)."],"dominios":[{"id":"ventas","nombre":"Ventas y facturación a clientes","descripcion":"Cubre el ciclo comercial completo de Navitrans hacia sus clientes: cotizaciones, pedidos de venta, entregas (albaranes/remisiones) y facturación de vehículos, maquinaria pesada, repuestos y servicios de taller. Incluye las tablas crudas del ERP D365 F&O (esquema fenix), las entidades OData equivalentes (esquema entidades) y los marts de BI de ventas (esquema cubos) con dimensiones de negocio como sede, canal, marca, línea de negocio y zona. Los identificadores de cliente, pedido, factura y vehículo están pseudonimizados con la misma sal en los tres esquemas, por lo que los cruces entre tablas y entre esquemas funcionan.","palabrasClave":["ventas","facturación","facturas","pedidos de venta","órdenes de venta","cotizaciones","clientes","albaranes","remisiones","entregas","ingresos","costo de ventas","margen","sede","canal","marca","línea de negocio","vehículos vendidos"],"servicios":12,"ruta":"/api/v1/dominios/ventas"},{"id":"clientes-cartera","nombre":"Clientes, terceros y cartera","descripcion":"Reúne la información maestra de clientes y terceros de Navitrans junto con el estado de su cartera (cuentas por cobrar): maestro de clientes, libreta de direcciones global (partys), direcciones postales y electrónicas, movimientos y saldos abiertos de cartera, liquidaciones o pagos aplicados y perfiles de contabilización, más los marts de BI de cartera con dimensiones de cliente, tercero, sede, marca y línea de negocio. Incluye tablas crudas del ERP D365 F&O (esquema fenix), entidades OData equivalentes (esquema entidades) y cubos BI de cartera (esquema cubos). Los identificadores de cliente, tercero, factura, comprobante y vehículo están pseudonimizados con la misma sal en los tres esquemas, por lo que los cruces entre tablas y esquemas funcionan.","palabrasClave":["clientes","terceros","cartera","cuentas por cobrar","saldos","facturas pendientes","vencimientos","edad de cartera","rotación de cartera","liquidaciones","pagos aplicados","libreta de direcciones","direcciones","correos","NIT","identificación","límite de crédito","condiciones de pago","grupo de clientes","segmento","sede","morosidad"],"servicios":15,"ruta":"/api/v1/dominios/clientes-cartera"},{"id":"compras-proveedores","nombre":"Compras, proveedores e importaciones","descripcion":"Cubre el ciclo completo de abastecimiento de Navitrans: solicitudes y órdenes de compra, maestro y transacciones de proveedores (cuentas por pagar), facturas de proveedor y el proceso custom SRF de importaciones (expedientes de importación, anticipos, BL estimado y bitácora de niveles de servicio). Incluye además tablas de análisis de tiempos de compra y de tránsito por origen, destino y modo de entrega, útiles para estimar la llegada de repuestos, vehículos y maquinaria importada.","palabrasClave":["compras","órdenes de compra","orden de compra","proveedores","proveedor","cuentas por pagar","facturas de proveedor","solicitudes de compra","requisiciones","importaciones","anticipos de importación","embarques","BL","bill of lading","nacionalización","tiempos de entrega","lead time","modo de entrega","purchase order","vendor"],"servicios":21,"ruta":"/api/v1/dominios/compras-proveedores"},{"id":"inventario-productos","nombre":"Inventario, productos y precios","descripcion":"Cubre el catálogo maestro de productos y repuestos de Navitrans (artículos, grupos, jerarquías de categorías y códigos de barras), las existencias y movimientos de inventario por sede y almacén (disponible, transacciones, diarios, transferencias) y los precios/costos por módulo. Incluye tanto las tablas crudas de D365 F&O (fenix) como la entidad de productos liberados (entidades) y los marts BI de artículo y consumo de inventario (cubos).","palabrasClave":["inventario","existencias","stock","disponible","productos","artículos","repuestos","precios","costos","almacén","bodega","sede","grupos de artículos","categorías de producto","códigos de barras","transferencias entre almacenes","diarios de inventario","consumo de inventario","kardex","clasificación ABC","marcas","catálogo de productos"],"servicios":26,"ruta":"/api/v1/dominios/inventario-productos"},{"id":"almacen-logistica","nombre":"Almacén y logística (WHS/WMS)","descripcion":"Operación de bodega y logística de Navitrans sobre los módulos de gestión avanzada de almacenes (WHS/WMS) de Dynamics 365 F&O: cargas y envíos de salida, trabajos de picking/put-away con sus líneas y conteos cíclicos, ubicaciones físicas, zonas y operarios de radiofrecuencia. Incluye la configuración de jerarquías de reservas por artículo y tablas custom de Navitrans para zonas y grupos de trabajo. Útil para analizar productividad de bodega, estado de despachos y exactitud de inventario.","palabrasClave":["almacén","bodega","WMS","WHS","logística","carga","embarque","envío","despacho","picking","put-away","trabajo de almacén","conteo cíclico","ubicación","zona","operario","radiofrecuencia","jerarquía de reservas","transportista"],"servicios":12,"ruta":"/api/v1/dominios/almacen-logistica"},{"id":"vehiculos-equipos","nombre":"Vehículos y equipos (Annata)","descripcion":"Maestro de vehículos, camiones y maquinaria pesada gestionados con la vertical Annata sobre D365 F&O: la hoja de vida de cada equipo (VIN/chasis, placa, serie, motor, modelo y año), sus catálogos de marca/clase/modelo/configuración, especificaciones técnicas, flotas, custodios, garantías y lecturas de horómetro/odómetro. Incluye la estructura de negocios y talleres Annata, el vínculo del equipo con el inventario (artículo/serie) y la dimensión BI de vehículo para análisis de ventas y posventa.","palabrasClave":["vehículos","equipos","maquinaria","camiones","Annata","device","VIN","chasis","placa","serie","motor","marca","modelo","flota","custodio","garantía","especificaciones técnicas","horómetro","odómetro","taller"],"servicios":22,"ruta":"/api/v1/dominios/vehiculos-equipos"},{"id":"ordenes-servicio","nombre":"Órdenes de servicio y taller","descripcion":"Cubre el ciclo completo de servicio posventa en los talleres de Navitrans: órdenes de servicio (casos Annata) sobre camiones y maquinaria, sus operaciones y trabajos, razones de ingreso, ubicaciones de taller, reclamaciones de garantía, entradas y salidas de vehículos al taller y las transacciones de servicio (mano de obra, repuestos y servicios facturados). Permite analizar tiempos en taller, estados de las órdenes, productividad y valor de las transacciones por sede, línea, marca y cliente.","palabrasClave":["orden de servicio","OT","taller","servicio posventa","mantenimiento","reparación","garantía","reclamación","claim","entrada a taller","días en taller","vehículo","equipo","caso de servicio","Annata","operaciones de taller","mano de obra","repuestos","workshop"],"servicios":9,"ruta":"/api/v1/dominios/ordenes-servicio"},{"id":"proyectos","nombre":"Proyectos","descripcion":"Cubre la gestión de proyectos de D365 F&O (módulo Project management & accounting) en Navitrans: la cabecera de proyectos y sus categorías, las transacciones posteadas de costo, horas, artículos e ingresos con sus importes de costo y de venta, y todo el proceso de facturación de proyecto (propuestas, diarios de factura y sus líneas y detalles por tipo de transacción). Permite analizar costos, ingresos, facturación y rentabilidad por proyecto, categoría, cliente y periodo, incluidos los proyectos asociados a las órdenes de servicio de taller.","palabrasClave":["proyecto","project","PMA","project management and accounting","gestión de proyectos","costos de proyecto","ingresos de proyecto","horas","mano de obra","categoría de proyecto","transacciones de proyecto","facturación de proyecto","factura de proyecto","propuesta de factura","consumo de artículos","on-account","fee","costo y venta","rentabilidad de proyecto","contabilidad de proyectos"],"servicios":24,"ruta":"/api/v1/dominios/proyectos"},{"id":"crm","nombre":"CRM: cuentas, contactos, leads y casos","descripcion":"Reúne la información de CRM (Dataverse) de Navitrans: cuentas y contactos comerciales, oportunidades y leads del pipeline de venta de camiones y maquinaria, y casos de servicio al cliente (incidentes) con sus colas de atención. Incluye además las tablas de agentes de IA y Copilot (evaluaciones, interacciones de conocimiento, resultados del agente de leads y elementos de trabajo de Omnicanal) usadas para medir y automatizar la interacción con clientes. Nombres, correos y consecutivos están pseudonimizados con la misma sal que los demás esquemas, por lo que los joins hacia los clientes y ventas del ERP funcionan.","palabrasClave":["CRM","Dataverse","cuenta","account","contacto","contact","lead","prospecto","oportunidad","opportunity","pipeline","embudo de ventas","caso","incidente","incident","cola","queue","atención al cliente","servicio al cliente","Customer Service","Sales","Copilot","agente de IA","evaluación","omnicanal","Omnichannel"],"servicios":25,"ruta":"/api/v1/dominios/crm"},{"id":"finanzas-contabilidad","nombre":"Finanzas, contabilidad y dimensiones","descripcion":"Cubre la información contable y financiera de Navitrans: el marco de dimensiones financieras de D365 F&O (atributos, valores, combinaciones y conjuntos que segmentan cada asiento por sede, línea, marca, canal o centro), los tipos de cambio entre monedas y el modelo BI de contabilidad con la dimensión de cuentas contables, el calendario y la tabla de hechos con débitos, créditos y saldos por empresa y tercero. Es el dominio de referencia para análisis de libro mayor, estados financieros, rentabilidad por dimensión y conversión de moneda.","palabrasClave":["finanzas","contabilidad","libro mayor","cuentas contables","plan de cuentas","dimensiones financieras","centro de costo","sede","línea","marca","canal","asientos contables","débito","crédito","saldos","tipos de cambio","tasa de cambio","TRM","moneda","divisas","calendario","fechas","estados financieros","cubo contable"],"servicios":11,"ruta":"/api/v1/dominios/finanzas-contabilidad"},{"id":"rrhh-organizacion","nombre":"Empleados, usuarios y organización","descripcion":"Información de recursos humanos y de la estructura organizativa de Navitrans: maestro de empleados/trabajadores del ERP D365 F&O, usuarios y modelo de seguridad de Dataverse (roles, privilegios, equipos y unidades de negocio) y bots de Copilot Studio. Incluye además la dimensión de trabajador del modelo BI con sede, centro de costos y cargo de nómina, útil para cruzar ventas, servicio y proyectos con el empleado responsable.","palabrasClave":["empleados","trabajadores","recursos humanos","rrhh","nómina","usuarios","seguridad","roles","privilegios","permisos","equipos","unidades de negocio","organización","estructura organizativa","cargos","sedes","centro de costos","bots","copilot"],"servicios":13,"ruta":"/api/v1/dominios/rrhh-organizacion"},{"id":"referencia-sistema","nombre":"Geografía, calendarios y metadatos","descripcion":"Catálogos de referencia y apoyo del sistema: geografía de Colombia (países, departamentos, ciudades con código DANE, códigos postales y zonas de la localización colombiana), calendario laboral del ERP y metadatos de decodificación (etiquetas en español de enumeraciones de D365 F&O, conjuntos de opciones y estados de Dataverse). Incluye además el catálogo del portal de reportes Power BI de SRF (áreas de trabajo, grupos, reportes y parámetros). Es el dominio al que se acude para traducir códigos numéricos a texto legible, ubicar geográficamente clientes y sedes, y saber qué días son laborables.","palabrasClave":["geografía","ciudades","departamentos","países","código DANE","códigos postales","zonas","municipios","calendario","calendario laboral","días hábiles","festivos","enumeraciones","enums","etiquetas en español","option sets","conjuntos de opciones","estados","metadatos","decodificación","reportes Power BI","catálogo de reportes","parámetros de reporte","áreas de trabajo"],"servicios":20,"ruta":"/api/v1/dominios/referencia-sistema"}]}