> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/es/iot-query/schema-overview/bronze-layer/raw-business-data.md). # Esquema raw\_business\_data raw\_business\_data contiene más de 40 tablas que abarcan usuarios, objetos, vehículos, tareas y geocercas. Revise la definición del esquema y las descripciones clave de las tablas para el análisis SQL Este esquema contiene más de 40 tablas cuidadosamente seleccionadas para cubrir diversos aspectos del negocio y casos de uso. Estas tablas representan sus entidades centrales del negocio, su estructura organizacional y sus datos operativos. {% hint style="info" %} El diagrama interactivo del esquema raw\_business\_data está disponible en **dbdiagram.io**: {% endhint %} Encuentre a continuación los detalles del esquema de datos empresariales sin procesar. {% code title="esquema de raw\_business\_data" expandable="true" %} ```sql Tabla "vehicle_service_tasks" { "record_added_at" marca de tiempo [no nulo] "start_mileage" numérico "comentario" "character varying(255)" "estado" "carácter variable(10)" [no nulo] "fecha_de_finalización" marca de tiempo "horas_de_motor_iniciales" numérico "id_de_tarea_de_servicio" entero [no nulo] "notificaciones_push_están_activadas" booleano [no nulo] "intervalo_de_notificación_de_fecha" intervalo "fecha_hora_prevista" marca de tiempo "costo" numérico [no nulo] "límite_de_kilometraje" numérico "correos_electrónicos_de_notificación" texto "is_unplanned" boolean [not null] "is_repeat" boolean [not null] "completion_engine_hours" integer "engine_hours_limit" numeric "Kilometraje_repeat_interval" integer "vehicle_id" integer [not null] "engine_hours_notification_interval" integer "start_date" timestamp "Kilometraje_notification_interval" integer "date_repeat_interval" interval "description" "character varying(255)" "notification_sms_phone_numbers" text "end_date" timestamp "engine_hours_repeat_interval" integer "completion_Kilometraje" integer } Tabla "Garajes" { "record_added_at" marca de tiempo [no nulo] "garage_id" integer [not null] "longitude" numeric "mechanic_name" "character varying(255)" "radius" integer [not null] "latitud" numérico "organization_label" "character varying(255)" "user_id" entero [no nulo] "dispatcher_name" "character varying(255)" "dirección" "character varying(255)" } Tabla "driver_history" { "server_datetime" marca de tiempo [no nulo] "dirección" "character varying(255)" "updated_by" entero [no nulo] "object_id" entero "longitude" numeric "latitud" numérico "driver_history_id" entero [no nulo] "clave_hardware" "character varying(64)" "id_nuevo_empleado" integer "fecha_hora_cambio" timestamp "record_added_at" marca de tiempo [no nulo] "id_empleado_anterior" integer } Tabla "departamentos" { "record_added_at" marca de tiempo [no nulo] "etiqueta_departamento" "character varying(255)" [not null] "latitud" numérico "id_departamento" integer [not null] "dirección" "character varying(255)" "radius" integer [not null] "longitude" numeric "user_id" entero [no nulo] } Tabla "registros_de_entrada" { "radius" integer [not null] "latitud" numeric [not null] "id_empleado" integer [not null] "longitud" numeric [not null] "record_added_at" marca de tiempo [no nulo] "fecha_hora_real" timestamp [not null] "user_id" entero [no nulo] "id_formulario" integer [not null] "dirección" "character varying(255)" "fecha_hora_programada" timestamp [not null] "id_objeto" integer [not null] "id_registro_de_entrada" integer [not null] "comentario" text } Tabla "estados" { "orden" integer [not null] "id_listado" integer [not null] "color" "character varying(6)" [not null] "id_estado" integer [not null] "etiqueta_estado" "character varying(200)" [not null] "record_added_at" marca de tiempo [no nulo] "es_eliminado" boolean [not null] } Tabla "campos_de_entidad_vinculados_a_lugares" { "valor" bigint [not null] "record_added_at" marca de tiempo [no nulo] "id_ubicacion" integer [not null] "id_campo" integer [not null] } Tabla "campos_de_texto_de_lugares" { "id_ubicacion" integer [not null] "record_added_at" marca de tiempo [no nulo] "valor" text [not null] "id_campo" integer [not null] } Tabla "usuarios2zonas" { "id_zona" integer [not null] "record_added_at" marca de tiempo [no nulo] "user_id" entero [no nulo] } Tabla "objetos" { "record_added_at" marca de tiempo [no nulo] "fecha_hora_creacion" timestamp [not null] "id_cliente" integer [not null] "id_grupo" integer "etiqueta_objeto" "character varying(100)" "modelo" "character varying(64)" "es_clon" boolean [not null] "es_eliminado" boolean [not null] "id_dispositivo" integer [not null] "id_objeto" integer [not null] } Tabla "nombre_salida_dispositivo" { "id_dispositivo" integer [not null] "record_added_at" marca de tiempo [no nulo] "etiqueta" "character varying(100)" [not null] "numero" integer [not null] } Tabla "puntos_de_zona" { "longitud" numeric [not null] "numero" integer [not null] "id_zona" integer [not null] "record_added_at" marca de tiempo [no nulo] "latitud" numeric [not null] } Tabla "campos_personalizados" { "record_added_at" marca de tiempo [no nulo] "id_entidad" integer [not null] "es_requerido" boolean [not null] "etiqueta_del_campo_personalizado" text [not null] "parametros" jsonb "tipo_de_campo_personalizado" integer [not null] "descripcion" text "id_campo_personalizado" integer [no nulo] } Tabla "campos_decimales_de_lugares" { "id_campo" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_ubicacion" integer [not null] "valor" numeric [no nulo] } Tabla "historial_de_tareas" { "id_tarea" integer [no nulo] "actividad" integer [no nulo] "id_historial_de_tarea" integer [no nulo] "record_added_at" marca de tiempo [no nulo] "user_id" entero [no nulo] "fecha_y_hora_del_evento" timestamp [no nulo] "carga_util" text } Tabla "etiquetas" { "etiqueta" "character varying(64)" [no nulo] "color" "character varying(6)" "user_id" entero [no nulo] "record_added_at" marca de tiempo [no nulo] "id_etiqueta" integer [no nulo] } Tabla "lugares" { "descripcion" text "campos_personalizados" jsonb "id_ubicacion" integer [not null] "id_externo" "character varying(32)" "record_added_at" marca de tiempo [no nulo] "id_usuario" integer "latitud" numérico "radio" integer "nombre_de_ubicacion" "character varying(256)" "fecha_y_hora_asignada" timestamp "direccion" "character varying(256)" "longitude" numeric } Tabla "listados_de_estado" { "user_id" entero [no nulo] "es_controlado_por_supervisor" boolean [no nulo] "es_eliminado" boolean [not null] "id_del_listado_de_estado" integer [no nulo] "es_controlado_por_empleado" boolean [no nulo] "record_added_at" marca de tiempo [no nulo] "etiqueta_del_listado_de_estado" "character varying(200)" [no nulo] } Tabla "modelos" { "record_added_at" marca de tiempo [no nulo] "id_modelo" integer [no nulo] "tiene_nivel_de_bateria" boolean [no nulo] "etiqueta_alternativa" "character varying(50)" [no nulo] "proveedor" "character varying(30)" [no nulo] "es_clon" boolean "tiene_altitud" boolean [no nulo] "tiene_telefono" boolean [no nulo] "tipo_de_control_de_salida" "character varying(30)" [no nulo] "tiene_roaming_gsm" boolean [no nulo] "tiene_nivel_gsm" boolean [no nulo] "modelo" "character varying(255)" [no nulo] "tipo_de_control_especial" "character varying(255)" [no nulo] "cantidad_digital" integer [no nulo] "tiene_boton_de_desacople" boolean [no nulo] "tiene_nombre_gsm" boolean [no nulo] "cantidad_analogica" integer [no nulo] "cantidad_de_salidas" integer [no nulo] } Tabla "historial_de_rastreadores_de_vehiculo" { "vehicle_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_objeto" integer [not null] "fecha_y_hora_del_cambio" timestamp [no nulo] "id_historial_de_rastreador_de_vehiculo" integer [no nulo] } Tabla "grupos" { "id_grupo" integer [no nulo] "color_del_Grupo" "character varying(6)" [no nulo] "etiqueta_del_Grupo" "character varying(255)" [no nulo] "id_cliente" integer [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "descripción_del_sensor" { "record_added_at" marca de tiempo [no nulo] "parametros" jsonb "id_de_entrada" integer [no nulo] "exactitud" numeric [no nulo] "unidades_del_sensor" "character varying(10)" "multiplicador" doubleprecision [no nulo] "etiqueta_de_entrada" "character varying(64)" "etiqueta_del_sensor" "character varying(100)" "tipo_de_unidades" integer [no nulo] "divisor" doubleprecision [no nulo] "id_grupo" integer [no nulo] "id_del_sensor" integer [no nulo] "id_dispositivo" integer [not null] "tipo_de_sensor" "character varying(45)" [no nulo] "tipo_del_Grupo" integer [no nulo] "datos_de_calibración" jsonb } Tabla "entidades" { "etiqueta_de_entidad" jsonb "record_added_at" marca de tiempo [no nulo] "id_entidad" integer [not null] "tipo_integrado" integer [no nulo] "user_id" entero [no nulo] } Tabla "zonas" { "dirección" "character varying(255)" "radius" integer [not null] "id_zona" integer [not null] "latitud_del_centro_del_círculo" numeric [no nulo] "id_cliente" integer [not null] "etiqueta_de_zona" "character varying(100)" "color" "character varying(6)" [not null] "tipo_de_zona" "character varying(20)" [no nulo] "longitud_del_centro_del_círculo" numeric [no nulo] "latitud" numeric [not null] "record_added_at" marca de tiempo [no nulo] "longitud" numeric [not null] } Tabla "Gestión de vehículos" { "vehicle_id" integer [not null] "longitud_de_la_carga_útil" numeric "VIN" "character varying(20)" "número_de_póliza_de_Seguro_gratuito" "character varying(50)" "etiqueta_del_vehículo" "character varying(100)" "ancho_de_la_carga_útil" numeric "color" "character varying(6)" "remolque" "character varying(255)" "object_id" entero "id_del_estado_del_vehículo" integer "vigencia_del_Seguro_de_responsabilidad_hasta" timestamp "año_de_fabricación" integer "grado_de_Combustible" "character varying(16)" "costo_del_Combustible" numeric "volumen_del_tanque_de_Combustible" numeric "modelo" "character varying(100)" "id_del_garaje" integer "altura_de_la_carga_útil" numeric "velocidad_máxima" numeric "número_de_matrícula" "character varying(32)" "tamaño_de_llanta" "character varying(50)" "capacidad_de_pasajeros" integer "record_added_at" marca de tiempo [no nulo] "número_de_matrícula_del_remolque" "character varying(32)" "fecha_de_vigencia_del_Seguro_gratuito" timestamp "peso_bruto" numeric "consumo_estándar_de_Combustible" numeric "tipo_de_Combustible" integer "peso_de_la_carga_útil" numeric "información_adicional" text "subtipo_vehiculo" "character varying(32)" "numero_poliza_seguro_responsabilidad_civil" "character varying(50)" "numero_bastidor" "character varying(32)" "user_id" entero [no nulo] "tipo_vehiculo" integer [no nulo] "numero_chasis" "character varying(32)" "numero_llantas" integer "disposicion_ruedas" "character varying(16)" } Tabla "enlaces_etiquetas" { "id_entidad" integer [not null] "record_added_at" marca de tiempo [no nulo] "tipo_entidad" integer [no nulo] "ordinal" integer [no nulo] "id_etiqueta" integer [no nulo] } Tabla "reglas" { "id_regla" integer [no nulo] "id_objeto" integer [not null] "parametros" jsonb "telefono_alerta" "character varying(210)" [no nulo] "tipo_evento" "character varying(100)" [no nulo] "id_cliente" integer [not null] "push_habilitado" boolean [no nulo] "comentario_evento1" "character varying(255)" [no nulo] "etiqueta_evento" "character varying(255)" [no nulo] "descripcion" "character varying(255)" [no nulo] "record_added_at" marca de tiempo [no nulo] "sms_alerta" text [no nulo] "grupo_evento" integer [no nulo] "creado_en" timestamp [no nulo] "maximo" integer [no nulo] "es_eliminado" boolean [not null] "correo_alerta" text [no nulo] "comentario_evento2" "character varying(255)" [no nulo] } Tabla "historial_estado" { "longitude" numeric "id_nuevo_estado" integer "id_historial_estado" integer [no nulo] "id_dispositivo" integer [not null] "updated_by" entero [no nulo] "dirección" "character varying(255)" "latitud" numérico "record_added_at" marca de tiempo [no nulo] "server_datetime" marca de tiempo [no nulo] "fecha_hora_cambio" timestamp "id_estado_anterior" integer } Tabla "reglas2zonas" { "id_zona" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_regla" integer [no nulo] } Tabla "formularios" { "id_objeto" integer [not null] "descripcion" text "etiqueta_formulario" "character varying(255)" [no nulo] "campos" text "creado_en" timestamp [no nulo] "direccion_envio" "character varying(255)" "latitud_envio" numeric "id_formulario" integer [not null] "longitud_envio" numeric "envio_en_zona" boolean [no nulo] "valores" text "record_added_at" marca de tiempo [no nulo] "id_tarea" integer "enviado_en" timestamp } Tabla "reglas2objetos" { "parametros_objeto" jsonb "numero_grupo_parametros" integer [no nulo] "id_objeto" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_regla" integer [no nulo] } Tabla "tareas" { "hora_desde" timestamp "duracion_estancia_minutos" interval "id_externo" "character varying(100)" "object_id" entero "tipo_tarea" integer "duracion_llegada_minutos" interval "estado" integer "fecha_hora_llegada" timestamp "record_added_at" marca de tiempo [no nulo] "id_tarea" integer [no nulo] "id_usuario" integer "fecha_cambio_estado" timestamp "orden" integer "hora_hasta" timestamp "maximo_retraso_minutos" integer "control_estancia_habilitado" boolean "dirección" "character varying(255)" "etiqueta_tarea" "character varying(200)" [no nulo] "longitude" numeric "creado_por" integer "descripcion" text [no nulo] "radio" integer "latitud" numérico "duracion_estancia" integer "creado_en" timestamp [no nulo] "campos_personalizados" jsonb "id_tarea_padre" integer } Tabla "campos_bigint_lugares" { "id_campo" integer [not null] "valor" bigint [not null] "id_ubicacion" integer [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "dispositivos" { "sim_bloqueada" boolean [no nulo] "id_dispositivo" integer [not null] "imei_dispositivo" "character varying(64)" [no nulo] "etiqueta_red" "character varying(50)" [no nulo] "id_del_listado_de_estado" integer [no nulo] "nivel_senal" numeric [no nulo] "telefono" "character varying(32)" [no nulo] "tiene_roaming" boolean [no nulo] "creado_en" timestamp [no nulo] "id_propietario" integer [no nulo] "record_added_at" marca de tiempo [no nulo] } Tabla "parametros_descripcion" { "descripcion" "character varying(150)" "record_added_at" marca de tiempo [no nulo] "tipo" "character varying(100)" [no nulo] "clave" integer [no nulo] } Tabla "usuarios" { "etiqueta_empresa" "character varying(255)" [no nulo] "fecha_hora_registro" timestamp "nombre" "character varying(100)" [no nulo] "id_principal" integer "apellido" "character varying(100)" [no nulo] "fecha_nacimiento" timestamp "etiqueta_zona_horaria" "character varying(30)" "segundo_nombre" "character varying(100)" [no nulo] "user_id" entero [no nulo] "locale" "character varying(10)" [no nulo] "record_added_at" marca de tiempo [no nulo] } Tabla "contadores" { "id_sensor" integer "multiplicador" numeric [no nulo] "id_contador" integer [no nulo] "id_dispositivo" integer [not null] "tipo_contador" integer [no nulo] "record_added_at" marca de tiempo [no nulo] } Tabla "empleados" { "licencia_conductor_vigente_hasta" timestamp "record_added_at" marca de tiempo [no nulo] "apellido" "character varying(100)" "id_departamento" integer "numero_identificacion_ciudadana" "character varying(32)" "nombre" "character varying(100)" "categorias_licencia_conductor" "character varying(32)" "user_id" entero [no nulo] "numero_telefono" "character varying(32)" "object_id" entero "es_eliminado" boolean [not null] "fecha_emision_licencia_conductor" boolean "clave_hardware" "character varying(64)" "segundo_nombre" "character varying(100)" "dirección" "character varying(255)" "latitud" numérico "id_empleado" integer [not null] "numero_personal" "character varying(15)" "costo_combustible" doubleprecision "número_de_licencia_de_Conductor" "carácter variable(32)" "email" "character varying(100)" "fuel_consumption" doubleprecision "radius" integer [not null] "longitude" numeric } Tabla "places_longtext_fields" { "id_campo" integer [not null] "valor" text [not null] "record_added_at" marca de tiempo [no nulo] "id_ubicacion" integer [not null] } Tabla "groups_objects" { "groups_client_id" entero "objects_client_id" entero Índices { (groups_client_id, objects_client_id) [pk] } } Tabla "device_settings" { "id_dispositivo" integer [not null] "key" "character varying" [no nulo] «valor» texto Índices { (device_id, key) [pk] } } Tabla "event_description" { "event_id" entero [no nulo, pk] "descripcion" text } Ref:"employees"."employee_id" < "checkins"."employee_id" Ref:"objects"."object_id" < "checkins"."object_id" Ref:"forms"."form_id" < "checkins"."form_id" Ref:"sensor_description"."sensor_id" < "counters"."sensor_id" Ref:"devices"."device_id" < "counters"."device_id" Ref:\"entidades\".\"entity_id\" < \"campos_personalizados\".\"entity_id\" Ref:\"Departamentos\".\"department_id\" < \"empleados\".\"department_id\" Ref:\"usuarios\".\"user_id\" < \"Departamentos\".\"user_id\" Ref:\"parámetros_de_descripción\".\"key\" < \"contadores\".\"counter_type\" Ref:\"parámetros_de_descripción\".\"key\" < \"campos_personalizados\".\"custom_field_type\" Ref:\"parámetros_de_descripción\".\"key\" < \"historial_del_Conductor\".\"updated_by\" Ref:\"parámetros_de_descripción\".\"key\" < \"entidades\".\"builtin_type\" Ref:\"parámetros_de_descripción\".\"key\" < \"descripción_del_sensor\".\"units_type\" Ref:\"parámetros_de_descripción\".\"key\" < \"historial_de_estado\".\"updated_by\" Ref:\"parámetros_de_descripción\".\"key\" < \"Tareas\".\"status\" Ref:"description_parameters"."key" < "Tareas"."created_at" Ref:"description_parameters"."key" < "tareas"."tarea_type" Ref:"description_parameters"."key" < "vehicles"."fuel_type" Ref:"description_parameters"."key" < "task_history"."activity" Ref:"description_parameters"."key" < "sensor_description"."group_type" Ref:"devices"."device_id" < "device_output_name"."device_id" Ref:"status_listings"."status_listing_id" < "devices"."status_listing_id" Ref:"employees"."employee_id" < "driver_history"."new_employee_id" Ref:"employees"."employee_id" < "driver_history"."old_employee_id" Ref:"objects"."object_id" < "driver_history"."object_id" Referencia: «objects».«object_id» < «employees».«object_id» Ref:"users"."user_id" < "employees"."user_id" Ref:"users"."user_id" < "entities"."user_id" Ref:"tasks"."task_id" < "forms"."task_id" Ref:"objects"."object_id" < "forms"."object_id" Ref:"objects"."object_id" < "tasks"."object_id" Ref:"users"."user_id" < "garajes"."user_id" Ref:"groups"."client_id" < "groups_objects"."groups_client_id" Ref:"objects"."client_id" < "groups_objects"."objects_client_id" Ref:"models"."model" < "objects"."model" Ref:"devices"."device_id" < "objects"."device_id" Ref:"users"."user_id" < "Lugares"."user_id" Ref:"custom_fields"."custom_field_id" < "places_bigint_fields"."field_id" Ref:"places"."place_id" < "places_bigint_fields"."place_id" Ref:"custom_fields"."custom_field_id" < "Lugares_decimal_fields"."field_id" Ref:"Lugares"."ubicación_id" < "Lugares_decimal_fields"."ubicación_id" Ref:"custom_fields"."custom_field_id" < "places_linked_entity_fields"."field_id" Ref:"places"."place_id" < "places_linked_entity_fields"."place_id" Ref:"custom_fields"."custom_field_id" < "Lugares_longtext_fields"."field_id" Ref:"lugares"."ubicación_id" < "lugares_longtext_fields"."ubicación_id" Ref:"custom_fields"."custom_field_id" < "places_text_fields"."field_id" Ref:"Lugares"."Ubicación_id" < "Lugares_text_fields"."Ubicación_id" Ref:"rules"."rule_id" < "rules2zones"."rule_id" Ref:"objects"."object_id" < "rules2objects"."object_id" Ref.:"rules"."rule_id" < "rules2objects"."object_id" Ref:"zones"."zone_id" < "rules2zones"."zone_id" Ref:"devices"."device_id" < "sensor_description"."device_id" Ref:"statuses"."status_id" < "status_history"."new_status_id" Ref:"statuses"."status_id" < "status_history"."old_status_id" Ref:"devices"."device_id" < "status_history"."device_id" Ref:"users"."user_id" < "status_listings"."user_id" Ref:"status_listings"."status_listing_id" < "statuses"."listing_id" Ref:"tags"."tag_id" < "tag_links"."tag_id" Ref:"users"."user_id" < "tags"."user_id" Ref:"Tareas"."Tarea_id" < "Tarea_history"."Tarea_id" Ref:"users"."user_id" < "task_history"."user_id" Ref:"tasks"."parent_task_id" < "tasks"."task_id" Ref:"users"."user_id" < "tareas"."user_id" Ref:"users"."master_id" < "users"."user_id" Ref:"users"."user_id" < "users2zones"."user_id" Ref:"zonas"."zona_id" < "usuarios2zonas"."zona_id" Ref:"Gestión de vehículos"."vehículo_id" < "vehículo_servicio_Tareas"."vehículo_id" Ref:"Objetos"."objeto_id" < "vehículo_rastreadores_historial"."objeto_id" Ref:"Gestión de vehículos"."vehículo_id" < "vehículo_rastreadores_historial"."vehículo_id" Ref:"Garajes"."garaje_id" < "Gestión de vehículos"."garaje_id" Ref:"Objetos"."objeto_id" < "Gestión de vehículos"."objeto_id" Ref:"usuarios"."usuario_id" < "Gestión de vehículos"."usuario_id" Ref:"zonas"."zona_id" < "Zona_puntos"."zona_id" Ref:"usuarios"."usuario_id" < "dispositivos"."Propietario_id" Ref:"usuarios"."usuario_id" < "Objetos"."cliente_id" ``` {% endcode %} ## Frecuencia de actualización Los datos de este esquema se sincronizan con la base de datos principal. Las actualizaciones ocurren de forma incremental a medida que se producen cambios en la base de datos MySQL de origen, normalmente en menos de 5 minutos desde el cambio de origen. ## `description_parameters` El sistema incluye datos de referencia para estandarizar los valores en toda la base de datos:
Tipo de referenciaDescripciónValores de ejemplo
Definiciones de tiposTipos de entidad estándarvehicle_type: auto, camión, autobús
Códigos de estadoValores de estado de la tarea y del sistemaestado de tareas: sin asignar, asignadas, completadas
Definiciones de unidadesUnidades de medida para sensoresunits_type: litro, galón, celsius
Clasificaciones de entidadesCategorías de entidades comercialesentities_type: ubicación, tarea, cliente
## Tablas clave por categoría Las tablas del **`raw_business_data`** esquema se organizan en categorías funcionales para facilitar la navegación. La tabla siguiente resume las tablas clave según su propósito de negocio: Entidades principales de negocio
usuarios **Descripción**: Cuentas de usuario que contienen información del Perfil, afiliación a la empresa, configuraciones de localización (zona horaria, configuración regional) y relaciones jerárquicas mediante master\_id para estructuras de cuentas multinivel
AtributoDetalles
Campos clave- user_id - Identificador único del usuario
- company_label - Nombre de la empresa asociada con el usuario
- first_name - Nombre de usuario
- last_name - Apellido del usuario
- middle_name - Patronímico del usuario
- locale - Configuración de idioma del usuario
- timezone_label - Zona horaria en formato IANA
- master_id - ID del usuario principal (si el actual es un subordinado)
- registration_datetime - Fecha de registro en el sistema
- birth_date - Fecha de nacimiento del usuario
RelacionesUsuario principal mediante master_id, vinculado a empleados, Departamentos, Lugares, Tareas a través de user_id
Notas especialesEntidad central que conecta datos organizacionales; master_id permite jerarquías de usuarios para estructuras de cuenta multinivel
empleados **Descripción**: Registros de empleados y conductores usados para representar a las personas que trabajan para la organización, incluida la información personal, los detalles de licencia, las asignaciones de departamento, las llaves de hardware para la identificación con iButton/RFID y los datos de ubicación con compatibilidad con geocercas
AtributoDetalles
Campos clave- employee_id - Identificador de la entidad del empleado
- user_id - Identificador de entidad de usuario
- object_id - Objeto identificador de entidad
- department_id - Un ID del departamento al que se asignó el empleado
- first_name - El atributo first_name de la tabla de empleados
- last_name - El atributo last_name de la tabla de empleados
- middle_name - El atributo middle_name de la tabla de empleados
- numero_de_licencia_de_Conductor - Número de licencia de Conductor
- categorias_de_licencia_de_Conductor - Categorías de licencia de Conductor
- fecha_de_emision_de_la_licencia_de_Conductor - Fecha de emisión de una licencia de Conductor
- fecha_de_vencimiento_de_la_licencia_de_Conductor - Fecha hasta la que es válida una licencia de Conductor
- clave_de_hardware - Una llave de hardware
- correo electrónico - Correo electrónico del empleado
- número de teléfono - Número de teléfono del empleado sin el signo "+"
- dirección - Dirección de la ubicación
- número de personal - Número de personal del empleado/conductor
- número de identificación ciudadana - Número de la Seguridad Social
- latitud - Ubicación asociada a este empleado
- longitud - Ubicación asociada a este empleado
- radio - Ubicación asociada con este empleado en metros
- consumo_de_combustible - El atributo fuel_consumption de la tabla de empleados
- costo_de_combustible - El atributo fuel_cost de la tabla de empleados
- está eliminado - El atributo is_deleted de la tabla employees
RelacionesEnlaces a usuarios, Departamentos, objetos (Dispositivo asignado), rastreado en historial_del_conductor y registros de entrada
Notas especialesLa llave de hardware permite la identificación del conductor mediante iButton o RFID; admite geocercas con latitud, longitud, radio campos
Departamentos **Descripción**: Unidades organizativas con datos de ubicación geográfica (latitud, longitud, radio) que permiten análisis basados en Zona para reportes a nivel de departamento y asociación de ubicación de empleados
AtributoDetalles
Campos clave- department_id - Identificador de la entidad de departamento
- user_id - Identificador de entidad de usuario
- department_label - El atributo department_label de la tabla Departamentos
- latitud - Ubicación asociada con estos Departamentos
- longitud - Ubicación asociada con estos Departamentos
- radio - Tamaño de la geolocalización en metros
- dirección - El atributo address de la tabla Departamentos
RelacionesVincula a los empleados con la estructura organizativa mediante department_id
Notas especialesLos campos de ubicación admiten análisis basados en Zona para reportes a nivel de departamento
Seguimiento y monitoreo
dispositivos **Descripción**: registro físico de dispositivos de seguimiento con identificadores de hardware (IMEI), información de la tarjeta SIM, estado de conectividad de red (intensidad de señal, roaming, operador) y asignaciones de listado de estados para la gestión del ciclo de vida del dispositivo
AtributoDetalles
Campos clave- device_id - ID del dispositivo
- owner_id - ID del propietario del dispositivo en cuya cuenta se agregó la baliza
- device_imei - IMEI del dispositivo
- teléfono - El número de la tarjeta SIM del dispositivo
- status_listing_id - ID del Estado del dispositivo
- network_label - El nombre de la red a la que está conectada la tarjeta SIM
- signal_level - Intensidad de la señal del dispositivo
- has_roaming - Indicador de disponibilidad de roaming
- is_sim_blocked - Indicador de bloqueo de la tarjeta SIM
- created_at - Fecha y hora en que se creó el registro
RelacionesEntidad principal vinculada a objetos, modelos, sensor_description, contadores; owner_id referencias users.user_id
Notas especialesTodos los datos telemáticos en raw_telematics_data el esquema hace referencia a esta tabla mediante device_id
objetos **Descripción**: Registro central de entidades monitoreadas (Gestión de vehículos, activos, personal) que vincula dispositivos físicos con la estructura organizativa mediante client\_id y group\_id, y representa la «unidad rastreable» con un Objeto activo por dispositivo
AtributoDetalles
Campos clave- object_id - Objeto identificador de entidad
- client_id - Identificador de la entidad cliente
- device_id - Identificador de entidad del dispositivo
- etiqueta del objeto - Nombre del objeto
- modelo - Modelo del dispositivo
- grupo_id - Grupo de ID de entidad
- create_datetime - Fecha y hora de creación de una nueva fila en el servidor
- está eliminado - El atributo is_deleted de la tabla de objetos
- is_clone - Marca de clon
RelacionesCentro neurálgico que conecta los dispositivos con los usuarios (client_id), detalles del vehículo, historial de seguimiento, tareas y reglas
Notas especialesRepresenta la «unidad rastreable» en el sistema; un objeto por dispositivo en uso activo
modelos **Descripción**: Registro central de entidades monitoreadas (Gestión de vehículos, activos, personal) que vincula dispositivos físicos con la estructura organizativa mediante client\_id y group\_id, y representa la «unidad rastreable» con un Objeto activo por dispositivo
AtributoDetalles
Campos clave- model_id - Identificador del modelo de entidad
- modelo - El atributo model de la tabla models
- vendor - El nombre de la empresa que lanzó el rastreador
- alternative_label - El atributo alternative_label de la tabla models
- analog_amount - Número de entradas analógicas del rastreador
- digital_amount - Número de entradas discretas del rastreador
- outputs_amount - Número de salidas discretas del rastreador
- has_battery_level - Determina si el rastreador transmite lecturas del nivel de batería
- has_altitude - Determina si el rastreador transmite altitud
- has_phone - ¿Hay una tarjeta SIM?
- has_gsm_level - ¿Puede un rastreador transmitir la intensidad de la señal GSM?
- has_gsm_name - ¿Puede el rastreador transmitir el nombre de la red GSM o el código del operador (MCC + MNC)?
- has_gsm_roaming - ¿Puede el rastreador transmitir el estado de roaming?
- has_detach_button - ¿El rastreador tiene un sensor de desconexión?
- type_output_control - Perfil de control de salidas del rastreador
- type_special_control - Contiene configuraciones especializadas y módulos funcionales para modelos de dispositivos individuales, como el modo de manejo peligroso (hbm_telfm) para equipos Teltonika
- is_clone - ¿El modelo es un clon de otro modelo?
ContenidoLas banderas booleanas de capacidad indican qué campos de datos están disponibles para este tipo de dispositivo
Notas especialesUse las banderas de capacidad para determinar los sensores y entradas válidos al consultar datos telemáticos
sensor_description **Descripción**: Configuración integral de sensores que vincula las entradas del dispositivo con la lógica de negocio, incluidas las asignaciones de entradas, las unidades de medida, los factores de conversión (multiplicador/divisor), las tablas de calibración para sensores de combustible, los umbrales de precisión y la lógica de agrupación para lecturas agregadas de sensores
AtributoDetalles
Campos clave- sensor_id - Identificador de la entidad sensor
- device_id - Identificador de entidad del dispositivo
- sensor_label - Nombre del sensor para la interfaz
- input_label - El nombre del campo de mensaje (atributo) del que se toman los Datos del sensor. Si es igual a "input_status", es un Sensor digital
- sensor_type - Tipo de sensor
- units_type - Unidades de medida
- multiplier - Multiplicador - el número por el cual multiplicar el valor del campo. Solo para Sensores de medición
- divider - Divisor - el número por el cual dividir el valor del campo. Solo para Sensores de medición
- precisión - Un porcentaje especificado para calcular el error absoluto del volumen del tanque. Este error se usa para determinar cuándo se están produciendo llenados o drenajes. Esto se usa solo para sensores de combustible
- datos_de_calibración - El atributo calibration_data de la tabla sensor_description
- input_id - Número de entrada para Sensor digital
- grupo_id - Se considera que los sensores del mismo tipo con el mismo group_id y source_id pertenecen al mismo grupo. Sus datos se suman o se promedian, según el valor de group_type. Esto es necesario para los sensores agregados. Se utiliza en sensores de medición
- tipo_de_grupo - 0 - sumar los valores de los sensores dentro de un Grupo, 1 - promedio
- sensor_units - Nombre de la unidad ingresado por el usuario si units_type=0 (personalizado)
- parámetros - Objeto opcional con parámetros adicionales: parent_ids: arreglo opcional de parent_ids para un sensor compuesto. volume: número de punto flotante. Opcional. Volumen para un sensor compuesto. parent_ids: opcional. Arreglo de enteros. Arreglo de parent_ids para un sensor compuesto. volume: opcional. Número de punto flotante. Volumen para un sensor compuesto. min: opcional. Número de punto flotante. Valor mínimo aceptable sin procesar para un sensor. max: opcional. Número de punto flotante. Valor máximo aceptable sin procesar para un sensor. max_lowering_by_time: opcional. Número de punto flotante. Disminución máxima permitida del valor por hora. max_lowering_by_mileage: opcional. Número de punto flotante. Disminución máxima permitida del valor por cada 100 km. ignore_drains_in_move: opcional. Booleano. El valor predeterminado es false. Si es true, no se detectarán los drenajes de Combustible durante el Movimiento. ignore_refuels_in_move: opcional. Booleano. El valor predeterminado es false. Si es true, no se detectarán los reabastecimientos durante el Movimiento. refuel_gap_minutes: opcional. Entero. El valor predeterminado es 5. El tiempo en minutos después del inicio del Movimiento durante el cual se detectarán los reabastecimientos durante el Movimiento. custom_field_name: opcional. Booleano. El valor predeterminado es false. El parámetro determina si el campo input_name es un valor personalizado ingresado por el usuario. Esto solo tiene sentido si el modelo del Dispositivo tiene la función has_custom_fields
RelacionesVincula las entradas del dispositivo (desde raw_telematics_data.inputs) a la lógica de negocio a través de device_id y input_label coincidente
Notas especialesdatos_de_calibración (JSONB) almacena tablas de calibración específicas del sensor para sensores de nivel de combustible; multiplier y divider convertir valores brutos a unidades
Gestión de Activo
Gestión de vehículos **Descripción**: Registro integral de vehículos que contiene especificaciones (dimensiones, peso, capacidad), documentación (VIN, registro, Seguro), parámetros operativos (Consumo de combustible, volumen del tanque) y la asignación actual del Dispositivo mediante object\_id para la Gestión de flotas y el Seguimiento del cumplimiento
AtributoDetalles
Campos clave- vehicle_id - Identificador de la entidad del vehículo
- user_id - Identificador de entidad de usuario
- object_id - Objeto identificador de entidad
- garage_id - Identificador de la entidad del garaje
- etiqueta del vehículo - El atributo vehicle_label de la tabla Gestión de vehículos
- número de registro - Número de registro/ matrícula de un vehículo
- VIN - El atributo VIN de la tabla de Gestión de vehículos
- año de fabricación - el atributo manufacture_year de la tabla de Gestión de vehículos
- tipo_de_Combustible - El atributo fuel_type de la tabla Gestión de vehículos
- costo_de_combustible - El atributo fuel_cost de la tabla Gestión de vehículos
- volumen_del_tanque_de_combustible - El atributo fuel_tank_volume de la tabla Gestión de vehículos
- velocidad máxima - El atributo max_speed de la tabla de Gestión de vehículos
- modelo - El atributo modelo de la tabla de vehículos
- color - El atributo color de la tabla de vehículos
- remolque - El atributo remolque de la tabla de vehículos
- información_adicional - El atributo información_adicional de la tabla de vehículos
- tipo_de_vehículo - El atributo tipo_de_vehículo de la tabla de vehículos
- subtipo_de_vehículo - El atributo subtipo_de_vehículo de la tabla de vehículos
- id_del_estado_del_vehículo - Identificador de entidad del estado del vehículo
- número_de_chasis - El atributo número_de_chasis de la tabla de vehículos
- número_de_bastidor - El atributo número_de_bastidor de la tabla de vehículos
- número_de_registro_del_remolque - El atributo número_de_registro_del_remolque de la tabla de vehículos
- peso_de_carga - El atributo peso_de_carga de la tabla de vehículos
- altura_de_carga - El atributo altura_de_carga de la tabla de vehículos
- longitud_de_carga - El atributo longitud_de_carga de la tabla de vehículos
- ancho_de_carga - El atributo ancho_de_carga de la tabla de vehículos
- capacidad_de_pasajeros - Un número máximo de pasajeros
- peso_bruto - El atributo peso_bruto de la tabla de vehículos
- consumo_estándar_de_combustible - Consumo normal promedio de combustible en litros por 100 km
- grado_de_combustible - El atributo grado_de_combustible de la tabla de vehículos
- disposición_de_ruedas - El atributo disposición_de_ruedas de la tabla de vehículos
- tamaño_de_llanta - Tamaño del vehículo: dimensiones y tamaño de la llanta
- número_de_llantas - Número de ruedas
- número_de_póliza_del_seguro_de_responsabilidad_civil - El atributo número_de_póliza_del_seguro_de_responsabilidad_civil de la tabla de vehículos
- seguro_de_responsabilidad_civil_vigente_hasta - La fecha hasta la cual es válido el seguro de responsabilidad civil
- número_de_póliza_del_seguro_gratuito - El atributo número_de_póliza_del_seguro_gratuito de la tabla de vehículos
- fecha_de_vigencia_del_seguro_gratuito - La fecha hasta la cual es válido el seguro gratuito
RelacionesEnlaces a objetos (rastreador actual), Garajes (ubicación del servicio), tareas_del_servicio_del_vehículo; rastreado en historial_de_rastreadores_de_vehículos
Notas especialesCampos de dimensiones físicas (longitud_de_carga, ancho_de_carga, altura_de_carga, peso_bruto) admiten el análisis de planificación de cargas; las fechas de Seguro permiten el Seguimiento del cumplimiento
Garajes **Descripción** : Ubicaciones de instalaciones de servicio y Mantenimiento con coordenadas geográficas (latitud, longitud, radio), información de contacto para mecánicos y despachadores, que permiten la detección de visitas de servicio basada en Zona y el análisis de proximidad
AtributoDetalles
Campos clave- garage_id - Identificador de la entidad del garaje
- user_id - Identificador de entidad de usuario
- latitud - Objeto de ubicación
- longitud - Objeto de ubicación
- radio - Tamaño de la geolocalización en metros
- dirección - Objeto de ubicación
- etiqueta de organización - ID del garaje
- nombre del mecánico - Nombre del mecánico
- dispatcher_name - Nombre del despachador
RelacionesReferenciado por Gestión de vehículos.garage_id para la asignación de ubicación de servicio
Notas especialesLos campos de ubicación permiten la detección de visitas de servicio basadas en Zona y el análisis de proximidad
tareas_del_servicio_del_vehículo **Descripción**: programación de Mantenimiento y Seguimiento del historial de servicio con múltiples tipos de activación (basados en fecha, basados en Kilometraje, basados en horas del motor), intervalos recurrentes de Tarea, notificaciones multicanal (correo electrónico, SMS, push) y distinción entre eventos de mantenimiento planificados (is\_repeat) y no planificados
AtributoDetalles
Campos clave- service_task_id - identificador de entidad de tarea de servicio
- vehicle_id - Identificador de la entidad del vehículo
- descripción - El atributo de descripción de la tabla vehicle_service_tasks
- estado - El valor de estado del atributo de estado
- costo - El atributo de costo de la tabla vehicle_service_tasks
- start_date - La fecha y la hora asociadas al atributo start_date
- end_date - La fecha y hora asociadas al atributo end_date
- completion_date - La fecha y hora asociadas al atributo completion_date
- predicted_datetime - La fecha y hora asociadas al atributo predicted_datetime
- Kilometraje_limit - El atributo Kilometraje_limit de la tabla vehicle_service_Tareas
- engine_hours_limit - El atributo engine_hours_limit de la tabla vehicle_service_Tareas
- kilometraje inicial - El atributo start_mileage de la tabla vehicle_service_tasks
- start_engine_hours - El atributo start_engine_hours de la tabla vehicle_service_tasks
- intervalo_de_notificación_de_kilometraje - El atributo mileage_notification_interval de la tabla vehicle_service_tasks
- intervalo de notificación de horas del motor - El atributo engine_hours_notification_interval de la tabla vehicle_service_tareas
- intervalo de notificación de fecha - Convertir un entero N a N días
- kilometraje_repeat_interval - El atributo kilometraje_repeat_interval de la tabla vehicle_service_tareas
- engine_hours_repeat_interval - El atributo engine_hours_repeat_interval de la tabla vehicle_service_tareas
- date_repeat_interval - Convertir un entero N a N días
- notification_emails - El atributo notification_emails de la tabla vehicle_service_tareas
- notification_sms_phone_numbers - El atributo notification_sms_phone_numbers de la tabla vehicle_service_tareas
- is_notification_push_enabled - El atributo is_notification_push_enabled de la tabla vehicle_service_tasks
- kilometraje_de_finalización - El atributo kilometraje completado de la tabla tareas de servicio del vehículo
- completion_engine_hours - El atributo completion_engine_hours de la tabla vehicle_service_tareas
- es_repetido - El atributo is_repeat de la tabla vehicle_service_tasks
- no planificado - El atributo is_unplanned de la tabla vehicle_service_tareas
- comentario - El atributo de comentario de la tabla vehicle_service_tasks
ContenidoAdmite tres tipos de activación: por fecha, por Kilometraje, y por horas de motor; configuraciones de notificación para correo electrónico, SMS y push
Notas especialeses_repetido y los campos de intervalo permiten programaciones recurrentes de Mantenimiento; no planificado distingue entre mantenimiento programado y reactivo
Ubicación y enrutamiento
zonas **Descripción**: Áreas geocercadas que definen perímetros virtuales usando círculos o polígonos para monitorear eventos de entrada y salida de vehículo/Activo, con automatización basada en reglas y analítica de ubicación con codificación por color para diferenciación visual
AtributoDetalles
Campos clave- zone_id - Identificador de la entidad de la zona
- client_id - Identificador de la entidad cliente
- etiqueta de zona - El atributo zone_label de la tabla de zonas
- zone_type - El atributo zone_type de la tabla de zonas
- latitud - Objeto opcional, el cuadro delimitador que puede contener por completo el resultado devuelto
- longitud - Objeto opcional, el cuadro delimitador que puede contener por completo el resultado devuelto
- circle_center_latitude - El atributo circle_center_latitude de la tabla de zonas
- circle_center_longitude - El atributo circle_center_longitude de la tabla de zonas
- radio - Tamaño de la geolocalización en metros
- dirección - El atributo address de la tabla de zonas
- color - El atributo color de la tabla de zonas
ContenidoLos tipos de zona incluyen círculo, polígono (definido mediante puntos_de_Zona), y clasificaciones de áreas especiales
RelacionesReferenciado por reglas2zonas, usuarios2zonas; vértices del polígono almacenados en puntos_de_Zona
Notas especialesLas funciones de PostGIS pueden usarse para comprobar la relación punto-en-polígono en análisis complejos de Zona
Lugares **Descripción**: Puntos de interés con coordenadas geográficas, definiciones de radio y compatibilidad con campos personalizados extensibles para almacenar información de contacto del cliente y datos específicos del negocio, lo que permite la integración con CRM/ERP mediante external\_id y reportes basados en la ubicación
AtributoDetalles
Campos clave- Ubicación_id - Identificador de entidad de Ubicación
- user_id - Identificador de entidad de usuario
- etiqueta de ubicación - El atributo place_label de la tabla Lugares
- latitud - Objeto de ubicación
- longitud - Objeto de ubicación
- radio - Tamaño de la geolocalización en metros
- dirección - El atributo address de la tabla de Lugares
- descripción - El atributo de descripción de la tabla de Lugares
- external_id - ID para la integración con sistemas externos (CRM)
- campos personalizados - Campos adicionales
- assigned_datetime - Fecha y hora de asignación del punto de interés al usuario
RelacionesAmpliado con valores de campos personalizados mediante Lugares_text_fields, Lugares_decimal_fields, Lugares_bigint_fields, Lugares_longtext_fields, Lugares_linked_entity_fields
Notas especialescampos personalizados JSONB proporciona acceso rápido; las tablas relacionadas permiten filtrar y ordenar atributos personalizados
puntos_de_Zona **Descripción**: Coordenadas ordenadas de los vértices (el campo numérico determina la secuencia) que definen los límites del polígono para formas complejas de Zona, lo que permite perímetros geográficos precisos más allá de zonas circulares simples, usadas con PostGIS ST\_MakePolygon para operaciones geométricas
AtributoDetalles
Campos clave- zone_id - Un ID de la zona a la que está adjunto este Formulario
- número - Número de serie
- latitud - Ubicación
- longitud - Ubicación
RelacionesMúltiples registros por zone_id define los límites del polígono; número el campo determina el orden de los vértices
Notas especialesConsulta con ORDER BY number para reconstruir la ruta del polígono; úselo con PostGIS ST_MakePolygon para operaciones geométricas
Tarea y gestión del flujo de trabajo
Tareas **Descripción**: Asignaciones de órdenes de trabajo con validación de ubicación (latitud, longitud, radio), ventanas de tiempo (time\_from, time\_to), requisitos de duración de visita (stay\_duration\_minutes, arrival\_duration\_minutes), estructura jerárquica mediante parent\_task\_id y seguimiento del estado para la gestión de Servicio de campo y las operaciones de entrega
AtributoDetalles
Campos clave- id_de_tarea - Identificador de la entidad Tarea
- user_id - Identificador de entidad de usuario
- object_id - Objeto identificador de entidad
- id_de_tarea_padre - Identificador de la entidad de la tarea principal
- etiqueta_de_tarea - El atributo task_label de la tabla de Tareas
- estado - El valor de estado del atributo de estado
- tipo_de_tarea - Tipo de Tarea, Tarea, Ruta o Punto de chequeo
- latitud - El atributo de latitud de la tabla de Tareas
- longitud - El atributo de longitud de la tabla de Tareas
- radio - Tamaño de la geolocalización en metros
- arrival_datetime - Cuando el Dispositivo llega al área de la Tarea. SE IGNORA al crear/actualizar
- created_at - El atributo created_at de la tabla de Tareas
- status_change_datetime - Fecha y hora de actualización de la Tarea
- time_from - La fecha y hora asociadas con el atributo time_from
- time_to - La fecha y hora asociadas con el atributo time_to
- stay_duration - El atributo stay_duration de la tabla de tareas
- stay_duration_minutes - Duración de la visita. El tiempo que un trabajador móvil debe pasar en el sitio de asignación para completar la tarea con éxito. Varias visitas son acumulativas
- arrival_duration_minutes - Ignore las visitas aleatorias más cortas que la duración especificada. Al calcular la duración mínima, se ignorarán las visitas más cortas que la duración especificada
- max_delay_minuts - Retraso aceptable. La cantidad máxima de tiempo que un empleado puede llegar tarde. Cualquier tarea completada durante este tiempo se marcará como «con retraso»
- is_stay_control_enabled - El atributo is_stay_control_enabled de la tabla de tareas
- dirección - El atributo address de la tabla de Tareas
- descripción - El atributo Description de la tabla de Tareas
- campos personalizados - El atributo custom_fields de la tabla de Tareas
- external_id - Identificador de la entidad externa
- order_sort - El atributo order_sort de la tabla de Tareas
- created_by - Origen de la tarea creada
ContenidoAdmite Tareas jerárquicas mediante id_de_tarea_padre; ventanas de tiempo definidas por time_from/time_to; validación de Zona con ubicación y radio
RelacionesEnlaces a formularios (recopilación de datos), historial_de_Tarea (cambios de estado), objetos (rastreador asignado)
Notas especialesstay_duration y arrival_duration_minutes activar el monitoreo de cumplimiento para tareas de entrega y servicio
formularios **Descripción**: Formularios configurables de recopilación de datos para capturar información estructurada al completar Tareas o durante Los check-ins de la aplicación móvil, con campos y valores almacenados como JSON, validación de ubicación opcional (is\_submission\_in\_zone) y requisitos de envío obligatorios cuando se adjuntan a Tareas
AtributoDetalles
Campos clave- formulario_id - Identificador de entidad de Formulario
- id_de_tarea - Un ID de la Tarea a la que está adjunto este Formulario
- object_id - Objeto identificador de entidad
- etiqueta_del_formulario - Etiqueta del formulario definida por el usuario
- campos - Si es true, el formulario solo se puede enviar en la zona de la tarea
- valores - Un mapa con los IDs de campo como claves y objetos field_value como valores. Clave usada para vincular el campo y su valor correspondiente
- submitted_at - Fecha en que se enviaron por última vez los valores del Formulario
- latitud de envío - Ubicación en la que se enviaron por última vez los valores del formulario
- longitud_de_envío - Ubicación en la que se enviaron por última vez los valores del formulario
- dirección_de_envío - Ubicación en la que se enviaron por última vez los valores del formulario
- es_envío_en_zona - Si es true, el formulario solo se puede enviar en la zona de la tarea
- descripción - Fecha en que se creó este formulario (o se adjuntó a la tarea)
- created_at - Fecha en que se creó este formulario (o se adjuntó a la tarea)
Contenidocampos define la estructura del formulario (JSON); valores contiene los datos enviados (JSON)
RelacionesEnlaces a Tareas (orden de trabajo asociada), objetos (remitente), referenciado en registros de entrada
Notas especialesIndicador de validación de ubicación es_envío_en_zona habilita reglas de envío de Formulario basadas en Zona
registros de entrada **Descripción**: Registros de asistencia y actividad basados en la ubicación, enviados mediante la aplicación móvil, que hacen seguimiento de los tiempos de llegada planificados frente a los reales (planned\_datetime vs actual\_datetime) con coordenadas geográficas y mediciones de precisión de la ubicación (radio) para reportes de puntualidad
AtributoDetalles
Campos clave- checkin_id - Identificador de la entidad de check-in
- employee_id - El identificador de la entidad de empleado también es el identificador de Conductores
- object_id - Dispositivo del empleado
- formulario_id - Identificador de entidad de Formulario
- user_id - Usuario del empleado
- planned_datetime - Hora del dispositivo cuando se realizó el check-in
- actual_datetime - Hora del servidor cuando se procesó la solicitud/mensaje
- latitud - Ubicación en la que se enviaron los check-ins
- longitud - Ubicación en la que se enviaron los check-ins
- radio - Error de posicionamiento en un punto en metros
- dirección - Dirección de check-in
- comentario - El atributo de comentario de la tabla de check-ins
RelacionesConecta a los empleados con formularios y ubicaciones; rastrea la desviación del horario planificado
Notas especialesVariación temporal entre planned_datetime y actual_datetime permite el reporte de puntualidad; el radio define la tolerancia de ubicación aceptable
historial_de_Tarea **Descripción** : Registro completo de auditoría de eventos del ciclo de vida de la Tarea que captura todos los cambios de estado, asignaciones, actualizaciones y modificaciones de campos con marcas de tiempo (event\_datetime), atribución de usuario y tipos de actividad (create, update, assign, status\_change) almacenados en el campo payload para el cumplimiento y el análisis del flujo de trabajo
AtributoDetalles
Campos clave- task_history_id - Identificador de la entidad del historial de tareas
- id_de_tarea - Identificador de la entidad Tarea
- user_id - Identificador de entidad de usuario
- activity - Operación que ocurrió. Puede ser «create», «update», «assign» o «status_change»
- event_datetime - Fecha y hora del evento
- payload - Depende de la operación. Normalmente, contiene los campos que se cambiaron durante la operación
ContenidoTipos de actividad definidos en description_parameters; payload Almacena detalles específicos del evento (texto)
Notas especialesEsencial para el análisis de la finalización de tareas, la elaboración de reportes de transición de estado y el seguimiento de la actividad del usuario
Reglas y automatización
reglas **Descripción**: reglas de detección de eventos con condiciones de activación configurables (sobre exceso de velocidad, violaciones de Zona, umbrales de sensor, tiempo en ralentí) almacenadas en parámetros (JSONB), y configuraciones de notificación multicanal (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) para monitoreo y alertas automatizados basados en datos del dispositivo y del servidor
AtributoDetalles
Campos clave- rule_id - Identificador de la entidad de la regla
- object_id - Objeto identificador de entidad
- client_id - Identificador de la entidad cliente
- event_type - El atributo event_type de la tabla de reglas
- etiqueta del evento - El atributo event_label de la tabla de reglas
- grupo_de_eventos - El atributo event_group de la tabla de reglas
- descripción - Atributo de descripción de la tabla de reglas
- parámetros - Parámetros del evento. Para obtener más detalles sobre los parámetros disponibles, consulte Documentación de la API de Navixy.
- alert_email - Correo para notificaciones
- alert_sms - Números de teléfono para notificaciones por SMS
- alert_phone - Teléfonos para llamadas de voz
- is_push_enabled - Si es verdadero, las notificaciones push están disponibles
- created_at - El atributo created_at de la tabla de reglas
- está eliminado - El atributo is_deleted de la tabla de reglas
- máximo - Límites aplicados a varias reglas. Por ejemplo, para la regla de tiempo de inactividad con el motor en marcha, en minutos
- event_comment1 - El atributo event_comment1 de la tabla de reglas
- event_comment2 - El atributo event_comment2 de la tabla de reglas
ContenidoLos parámetros de la regla (JSONB) definen las condiciones de activación; admite correo electrónico, SMS, llamadas telefónicas y notificaciones push
RelacionesEnlaces a objetos mediante reglas2objetos, zonas a través de reglas2zonas
Notas especialesevent_type define un escenario específico de monitoreo (sobre exceso de velocidad, violación de Zona, umbral del sensor); máximo el campo permite la agregación de eventos para alertas basadas en umbrales
reglas2objetos **Descripción**: Relación de muchos a muchos que vincula reglas con Objeto monitoreados, con personalización de parámetros por Objeto mediante object\_params (JSONB), lo que permite usar diferentes valores de umbral (p. ej., límites de velocidad) para cada vehículo o Activo dentro de la misma regla
AtributoDetalles
Campos clave- rule_id - Identificador de la entidad de la regla
- object_id - Objeto identificador de entidad
- param_Grupo_número - El atributo param_group_number de la tabla rules2objects
- Objeto_parámetros - El atributo object_params de la tabla rules2objects
ContenidoObjeto_parámetros (JSONB) permite la personalización de reglas por Objeto (p. ej., límites de velocidad diferentes por vehículo)
Notas especialesLa relación de muchos a muchos permite que una regla monitoree varios objetos con diferentes parámetros
reglas2zonas **Descripción**: Relación de muchos a muchos que asocia reglas con zonas geocercadas, lo que permite que una sola regla supervise eventos de entrada y salida en múltiples áreas geográficas para escenarios complejos de monitoreo espacial
AtributoDetalles
Campos clave- rule_id - Identificador de la entidad de la regla
- zone_id - Identificador de la entidad de zona
Notas especialesLa relación muchos a muchos permite el monitoreo multizona para una sola regla (p. ej., alertar al ingresar en cualquiera de varias áreas restringidas)
Estado y categorización
estados **Descripción**: Definiciones de estados personalizados dentro de los listados de estados, incluidas propiedades de visualización (color para la visualización en el sitio web, order\_sort para el posicionamiento) utilizadas para representar estados de trabajo de dispositivos o empleados con compatibilidad para eliminación lógica mediante el indicador is\_deleted
AtributoDetalles
Campos clave- status_id - estado del identificador de la entidad
- listing_id - identificador de entidad del listado
- status_label - valor de estado del atributo status_label
- color - color utilizado para mostrarse en el sitio web
- order_sort - posición de orden dentro del estado del listado
- está eliminado - El atributo is_deleted de la tabla de estados
RelacionesGrupos de estados organizados por listing_id (referencias status_listings); se usa en status_history
Notas especialesorder_sort define la secuencia de visualización; el color permite diferenciar visualmente en los reportes
status_listings **Descripción**: Definiciones de conjuntos de estados que controlan qué valores de estado están disponibles para dispositivos o empleados, con banderas de permiso (is\_supervisor\_controlled, is\_employee\_controlled) que determinan si los supervisores, los empleados o ambos pueden cambiar los valores de estado
AtributoDetalles
Campos clave- status_listing_id - Identificador de la entidad de listado de estado
- user_id - Identificador de entidad de usuario
- status_listing_label - Valor de estado del atributo status_listing_label
- is_supervisor_controlled - Si es verdadero, los supervisores pueden cambiar el estado laboral, p. ej. usando la aplicación móvil de monitoreo
- is_employee_controlled - Si es verdadero, los empleados pueden cambiar su propio estado laboral, por ejemplo usando una aplicación móvil de rastreo
- está eliminado - El atributo is_deleted de la tabla status_listings
-
RelacionesReferenciado por devices.status_listing_id y statuses.listing_id
Notas especialesLas banderas de control determinan quién puede cambiar los estados: solo supervisores, autoservicio de empleados o ambos
status_history **Descripción**: Registro de auditoría de todas las transiciones de estado del dispositivo con marcas de tiempo (changed\_datetime en el dispositivo, server\_datetime en el servidor), atribución de usuario (updated\_by) y captura de ubicación (latitude, longitude, address) que permite el análisis geográfico de los cambios de estado y la generación de reportes de ubicación de inicio y fin de la jornada
AtributoDetalles
Campos clave- status_history_id - Identificador de entidad del historial de estados
- device_id - Identificador de entidad del dispositivo
- old_status_id - Identificador de entidad del estado anterior
- new_status_id - Identificador de entidad del nuevo estado
- updated_by - La fecha y hora asociadas al atributo updated_by
- changed_datetime - La fecha y hora de asignación de un nuevo estado en el dispositivo
- server_datetime - La fecha y hora de asignación del nuevo estado del servidor
- latitud - Localización de dispositivos durante los cambios de estado
- longitud - Localización de dispositivos durante los cambios de estado
- dirección - Localización de dispositivos durante cambios de estado
RelacionesEnlaces a dispositivos, estados (antiguo y nuevo), description_parameters (para updated_by Papel)
Notas especialesLa captura de ubicación permite el análisis geográfico de las transiciones de estado; útil para los reportes de ubicación de inicio y fin de la jornada laboral
Etiquetas **Descripción**: etiquetas de categorización definidas por el usuario con codificación por color que permiten filtrar y buscar rápidamente en múltiples tipos de entidades (Lugares, geocercas, empleados, Tareas, rastreadores, Gestión de vehículos) para una organización flexible
AtributoDetalles
Campos clave- Etiqueta_id - Etiqueta de ID de entidad
- user_id - Identificador de entidad de usuario
- etiqueta - El atributo tag_label de la tabla de Etiquetas
- color - El atributo de color de la tabla de Etiquetas
RelacionesAplicado a entidades mediante enlaces_de_etiquetas; alcance definido por el usuario
Notas especialesSistema de categorización flexible que admite múltiples Etiquetas por entidad
enlaces_de_etiquetas **Descripción**: Tabla de relación polimórfica que asocia Etiquetas con cualquier tipo de entidad mediante entity\_type y entity\_id, con el campo ordinal para la gestión del orden de visualización, lo que permite un etiquetado flexible de múltiples entidades
AtributoDetalles
Campos clave- Etiqueta_id - Etiqueta de ID de entidad
- entity_type - El atributo entity_type de la tabla tag_links
- entity_id - Identificador de entidad
- ordinal - El atributo ordinal de la tabla tag_links
Contenidoentity_type identifica la tabla (vehículo, empleado, tarea, etc.); ordinal define el orden de visualización
Notas especialesLa relación polimórfica permite etiquetar distintos tipos de entidades
Grupos y jerarquía
grupos **Descripción**: Estructura de agrupación organizativa para rastreadores que permite organizarlos visualmente en la interfaz de usuario mediante colores personalizables (group\_color) y una gestión jerárquica similar a la de carpetas; actualmente cumple una función puramente visual
AtributoDetalles
Campos clave- grupo_id - Grupo de Dispositivo (vinculado por objects.group_id). La división en grupos puede verse en la lista de balizas, por ejemplo
- client_id - Identificador de la entidad cliente
- etiqueta_grupo - Título del grupo especificado por el usuario, de 1 a 60 caracteres imprimibles, p. ej. «Employees»
- color del grupo - Color de Grupo en formato web (sin #), por ejemplo «FF6DDC». Determina el color de los marcadores del rastreador en el mapa
RelacionesReferenciado por objects.group_id; propiedad del cliente a través de client_id (referencias usuarios)
Notas especialesPermite organizar las entidades de monitoreo como carpetas para reportes y permisos
grupos_objetos **Descripción**: Relación de muchos a muchos entre grupos y objetos que usa una clave primaria compuesta (groups\_client\_id, objects\_client\_id), lo que permite que los objetos pertenezcan simultáneamente a varios grupos para estructuras organizativas flexibles
AtributoDetalles
Campos clave- groups_client_id - Identificador de entidad de cliente para grupos
- objects_client_id - Identificador de la entidad cliente para objetos
Notas especialesPermite que los objetos pertenezcan a varios grupos simultáneamente; consulte con ambos client_id valores para la pertenencia al Grupo
Campos personalizados y entidades
entidades **Descripción**: Registro de tipos de entidad que define qué entidades de negocio admiten campos personalizados y su estructura de distribución de campos (secciones, field\_order) almacenada en entity\_label (JSONB), lo que permite extender dinámicamente el esquema en lugares, tareas y otras entidades sin cambios en la base de datos
AtributoDetalles
Campos clave- entity_id - Identificador de entidad
- user_id - Identificador de entidad de usuario
- etiqueta de entidad - id - int. Identificador de entidad. type - enum. Actualmente, solo se admite "Ubicación". layout - Objeto que describe la disposición de los campos de la entidad. sections - arreglo de objetos. Cada sección puede contener uno o más campos. Debe existir al menos una sección en un diseño. label - cadena. Nombre de la sección. field_order - arreglo de cadenas. Campos integrados e identificadores de campos personalizados (como cadenas)
- builtin_type - El atributo builtin_type de la tabla de entidades
RelacionesReferenciado por campos personalizados para definir qué Campos personalizados se aplican a qué tipos de entidad
Notas especialesbuiltin_type enlaza con description_parameters para clasificaciones de entidades definidas por el sistema
campos personalizados **Descripción**: Definiciones de Campos personalizados que permiten la extensión dinámica del esquema para tipos de entidad, con tipos de campo configurables (custom\_field\_type), reglas de validación y opciones en parameters (JSONB), y banderas de obligatoriedad (is\_required) para la captura flexible de datos en Lugares, Tareas y otras entidades
AtributoDetalles
Campos clave- custom_field_id - Identificador de entidad del campo personalizado
- entity_id - Identificador de entidad
- custom_field_label - Nombre del campo
- tipo_de_campo_personalizado - Tipo de dato en el campo
- descripción - Descripción del campo
- es_requerido - ¿Es obligatorio o no?
- parámetros - Parámetros del campo
Contenidoparámetros (JSONB) almacena la configuración específica del tipo de campo (reglas de validación, opciones desplegables, etc.)
RelacionesDefine los atributos personalizados disponibles para las entidades; el tipo de campo se vincula con description_parameters
Notas especialesPermite la extensión dinámica del esquema sin cambios en la base de datos; se usa ampliamente en Lugares y Tareas
Seguimiento histórico
historial_del_conductor **Descripción**: Registro de auditoría completo de asignaciones de empleado a vehículo a lo largo del tiempo, con seguimiento de las transiciones de old\_employee\_id a new\_employee\_id con marcas de tiempo (changed\_datetime, server\_datetime), datos de ubicación (latitude, longitude, address), información de clave de hardware y atribución de usuario (updated\_by), lo que permite analíticas específicas del conductor cuando los conductores cambian entre vehículos
AtributoDetalles
Campos clave- Conductor_historial_id - Identificador de la entidad del historial de Conductor
- object_id - Objeto identificador de entidad
- old_employee_id - Identificador de la entidad de empleado anterior
- new_employee_id - Identificador de la entidad del nuevo empleado
- clave_de_hardware - El atributo hardware_key de la tabla historial_del_Conductor
- changed_datetime - Se realizaron cambios de fecha y hora en el dispositivo
- server_datetime - Fecha y hora de los cambios realizados en el servidor
- updated_by - La fecha y hora asociadas al atributo updated_by
- latitud - El atributo de latitud de la tabla driver_history
- longitud - El atributo de longitud de la tabla conductor_history
- dirección - El atributo de dirección de la tabla driver_history
RelacionesRastrea las asignaciones de Conductor a Gestión de vehículos a lo largo del tiempo; vincula con empleados y objetos
Notas especialesEsencial para la generación de reportes específicos por conductor cuando los conductores cambian de vehículo; la captura de ubicación permite el análisis de la ubicación del cambio de asignación
historial_de_rastreadores_de_vehículos **Descripción**: Seguimiento de auditoría que indica qué dispositivos GPS (object\_id) se instalaron en qué unidades de la Gestión de vehículos (vehicle\_id) a lo largo del tiempo, con marcas de tiempo de los cambios (changed\_datetime), lo que permite atribuir con precisión los datos históricos y calcular el Kilometraje cuando los rastreadores se trasladan entre unidades de la Gestión de vehículos
AtributoDetalles
Campos clave- vehicle_Dispositivo_history_id - Identificador de la entidad del historial del rastreador del vehículo
- vehicle_id - Identificador de la entidad del vehículo
- object_id - Objeto identificador de entidad
- changed_datetime - La fecha y la hora asociadas con el atributo changed_datetime
RelacionesRastrea qué dispositivo GPS se instaló en qué vehículo a lo largo del tiempo
Notas especialesEs crítico para el análisis de datos históricos cuando los rastreadores se transfieren entre vehículos; permite una atribución precisa del kilometraje y del uso
Datos de referencia y consulta
description_parameters **Descripción**: Datos de referencia de todo el sistema que proporcionan etiquetas legibles para las personas (descripción) de valores enteros enumerados (clave) utilizados en toda la base de datos, organizados por campo de tipo (por ejemplo, task\_status, fuel\_type, counter\_type, entity\_classification) para traducir los valores de manera coherente en los reportes y la interfaz de usuario
AtributoDetalles
Campos clave- clave - Valor posible en el atributo
- tipo - Un atributo compuesto que consiste en el nombre de la tabla seguido de un guion bajo y el nombre de un atributo de la tabla
- descripción - Valor implícito de un atributo
ContenidoProporciona etiquetas legibles para los valores codificados en toda la base de datos (estado de la tarea, tipos de combustible, tipos de contador, etc.)
RelacionesReferenciado mediante claves foráneas desde varias tablas para una categorización estandarizada
Notas especialesEsencial para traducir códigos enteros a valores legibles en los reportes; tipo grupos de campos y enumeraciones relacionadas
contadores **Descripción**: configuraciones del Odómetro y del contador de horas del motor que vinculan las lecturas de sensores del dispositivo (sensor\_id) con mediciones de distancia o tiempo, con coeficientes multiplicadores para la conversión de unidades (km, miles, horas) y counter\_type de description\_parameters que define el tipo de medición
AtributoDetalles
Campos clave- counter_id - ID interno
- device_id - Identificador de entidad del dispositivo
- counter_type - Tipo de contador
- sensor_id - Identificador de la entidad sensor
- multiplier - Coeficiente para convertir valores en una de las métricas (km, l, etc.)
RelacionesVincula dispositivos con lecturas de sensores que representan contadores de distancia o tiempo
Notas especialesmultiplier convierte los pulsos del sensor en unidades reales (km, miles, horas); counter_type de description_parameters define el tipo de medición
device_output_name **Descripción**: Etiquetas personalizadas para los canales de salida del dispositivo que asignan identificadores numéricos de salida (number) a nombres definidos por el usuario (label), como «Door Lock» o «Engine Block», para generar reportes y análisis legibles de los comandos y estados de salida del dispositivo
AtributoDetalles
Campos clave- device_id - Identificador de entidad del dispositivo
- número - El atributo number de la tabla device_output_name
- etiqueta - El atributo label de la tabla device_output_name
ContenidoAsigna números de canal de salida a nombres definidos por el usuario (p. ej., «Door Lock», «Engine Block»)
Notas especialesPermite generar reportes legibles al analizar los comandos y estados de salida del dispositivo
device_settings **Descripción**: Pares clave-valor de configuración del dispositivo sincronizados desde la plataforma de origen. Cada fila almacena un ajuste de configuración para un dispositivo específico.
AtributoDetalles
Campos clave- device_id - Identificador de entidad del dispositivo
- clave - Nombre del ajuste
- valor - Valor del ajuste
Clave primariaCompuesta: (device_id, key)
Notas especialesSe completa durante la sincronización completa del cliente. Use esta tabla para leer los valores de configuración a nivel de dispositivo junto con datos telemáticos o empresariales.
event_description **Descripción**: Tabla de referencia de códigos de eventos del rastreador con descripciones legibles por humanos. Contiene 134 entradas que abarcan eventos comunes del rastreador, como SOS, Modo ahorro energía, Ignición y cambios en las entradas/salidas digitales.
AtributoDetalles
Campos clave- event_id - Código de evento (clave primaria)
- descripción - Nombre del evento legible para humanos
Notas especialesUnirse a raw_telematics_data.tracking_data_core activado event_id para mostrar los nombres de los eventos en Reportes y paneles de control en lugar de códigos numéricos.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/analytics/es/iot-query/schema-overview/bronze-layer/raw-business-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.