> 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 de raw\_business\_data raw\_business\_data contiene más de 40 tablas que abarcan usuarios, objetos, vehículos, tareas y geocercas. Explore la definición del esquema y las descripciones clave de las tablas para el análisis SQL Este esquema contiene 40+ tablas cuidadosamente seleccionadas para cubrir diversos aspectos del negocio y casos de uso. Estas tablas representan sus entidades comerciales principales, la estructura organizacional y los 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 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)" "status" "character varying(10)" [no nulo] "completion_date" marca de tiempo "start_engine_hours" numérico "service_tarea_id" entero [no nulo] "is_notification_push_enabled" boolean [no nulo] "date_notification_interval" intervalo "predicted_datetime" marca de tiempo "costo" numérico [no nulo] "mileage_limit" numérico "notification_emails" texto "is_unplanned" booleano [no nulo] "is_repeat" booleano [no nulo] "completion_engine_hours" entero "engine_hours_limit" numérico "Kilometraje_repeat_interval" entero "vehicle_id" entero [no nulo] "engine_hours_notification_interval" entero "start_date" marca de tiempo "Kilometraje_notification_interval" entero "date_repeat_interval" intervalo "descripción" "character varying(255)" "números_de_teléfono_para_notificaciones_sms" text "fecha_de_fin" timestamp "intervalo_de_repetición_de_horas_del_motor" integer "Kilometraje_de_finalización" integer } Tabla "Garajes" { "record_added_at" marca de tiempo [no nulo] "id_de_garaje" integer [not null] "longitud" numeric "nombre_del_mecánico" "character varying(255)" "radio" integer [not null] "latitud" numérico "etiqueta_de_organización" "carácter variable(255)" "id_de_usuario" entero [no nulo] "nombre_del_despachador" "carácter variable(255)" "dirección" "carácter variable(255)" } Tabla "historial_de_Conductor" { "fecha_hora_del_servidor" marca de tiempo [no nulo] "dirección" "carácter variable(255)" "actualizado_por" entero [no nulo] "id_de_Objeto" entero "longitud" numeric "latitud" numérico "id_de_historial_de_Conductor" entero [no nulo] "clave_hardware" "character varying(64)" "nuevo_empleado_id" integer "fecha_hora_cambio" timestamp "record_added_at" marca de tiempo [no nulo] "empleado_anterior_id" integer } Tabla "Departamentos" { "record_added_at" marca de tiempo [no nulo] "etiqueta_departamento" "character varying(255)" [not null] "latitud" numérico "departamento_id" integer [not null] "dirección" "carácter variable(255)" "radio" integer [not null] "longitud" numeric "id_de_usuario" entero [no nulo] } Tabla "checkins" { "radio" integer [not null] "latitud" numeric [not null] "empleado_id" integer [not null] "longitud" numeric [not null] "record_added_at" marca de tiempo [no nulo] "fecha_hora_real" timestamp [not null] "id_de_usuario" entero [no nulo] "Formulario_id" integer [not null] "dirección" "carácter variable(255)" "fecha_hora_programada" timestamp [not null] "Objeto_id" integer [not null] "checkin_id" integer [not null] "comentario" text } Tabla "estados" { "orden" integer [not null] "id_listado" integer [not null] "color" "character varying(6)" [not null] "estado_id" integer [not null] "etiqueta_estado" "character varying(200)" [not null] "record_added_at" marca de tiempo [no nulo] "eliminado" boolean [not null] } Tabla "Lugares_linked_entity_fields" { "valor" bigint [not null] "record_added_at" marca de tiempo [no nulo] "Ubicación_id" integer [not null] "campo_id" integer [not null] } Tabla "Lugares_text_fields" { "Ubicación_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "valor" text [not null] "campo_id" integer [not null] } Tabla "usuarios2zonas" { "zona_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_de_usuario" entero [no nulo] } Tabla "Objetos" { "record_added_at" marca de tiempo [no nulo] "fecha_hora_creacion" timestamp [not null] "cliente_id" integer [not null] "grupo_id" integer "etiqueta_objeto" "character varying(100)" "modelo" "character varying(64)" "es_clon" boolean [not null] "eliminado" boolean [not null] "dispositivo_id" integer [not null] "Objeto_id" integer [not null] } Tabla "nombre_salida_dispositivo" { "dispositivo_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "etiqueta" "character varying(100)" [not null] "número" integer [not null] } Tabla "puntos_de_zona" { "longitud" numeric [not null] "número" integer [not null] "zona_id" 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_obligatorio" boolean [not null] "etiqueta_campo_personalizado" text [not null] "parámetros" jsonb "tipo_campo_personalizado" integer [not null] "descripción" texto "custom_field_id" integer [no nulo] } Tabla "lugares_decimal_fields" { "campo_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "Ubicación_id" integer [not null] "value" numérico [no nulo] } Tabla "task_history" { "task_id" entero [no nulo] "actividad" entero [no nulo] "task_history_id" entero [no nulo] "record_added_at" marca de tiempo [no nulo] "id_de_usuario" entero [no nulo] "event_datetime" timestamp [not null] texto de «payload» } Tabla "Etiquetas" { "tag_label" "carácter variable(64)" [no nulo] "color" "character varying(6)" "id_de_usuario" entero [no nulo] "record_added_at" marca de tiempo [no nulo] "tag_id" entero [no nulo] } Tabla "Lugares" { "descripción" texto "custom_fields" jsonb "Ubicación_id" integer [not null] "external_id" "character varying(32)" "record_added_at" marca de tiempo [no nulo] "user_id" entero "latitud" numérico entero "radio" "ubicación_label" "character varying(256)" "assigned_datetime" timestamp "address" "character varying(256)" "longitud" numeric } Tabla "status_listings" { "id_de_usuario" entero [no nulo] "is_supervisor_controlled" boolean [not null] "eliminado" boolean [not null] "status_listing_id" integer [not null] "is_employee_controlled" boolean [not null] "record_added_at" marca de tiempo [no nulo] "status_listing_label" "character varying(200)" [not null] } Tabla "models" { "record_added_at" marca de tiempo [no nulo] "model_id" integer [not null] "has_battery_level" boolean [not null] "alternative_label" "character varying(50)" [no nulo] "vendor" "character varying(30)" [no nulo] "is_clone" boolean "has_altitude" boolean [no nulo] "has_phone" boolean [no nulo] "type_output_control" "character varying(30)" [no nulo] "has_gsm_roaming" boolean [no nulo] "has_gsm_level" boolean [no nulo] "model" "character varying(255)" [no nulo] "type_special_control" "character varying(255)" [no nulo] "digital_amount" entero [not null] "has_detach_button" boolean [no nulo] "has_gsm_name" boolean [no nulo] "analog_amount" integer [no nulo] "outputs_amount" entero [no nulo] } Tabla "vehicle_trackers_history" { "vehicle_id" entero [no nulo] "record_added_at" marca de tiempo [no nulo] "Objeto_id" integer [not null] "changed_datetime" marca de tiempo [no nulo] "vehicle_tracker_history_id" entero [no nulo] } Tabla "groups" { "group_id" entero [no nulo] "Grupo_color" "character varying(6)" [no nulo] "group_label" "character varying(255)" [no nulo] "cliente_id" integer [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "sensor_description" { "record_added_at" marca de tiempo [no nulo] "parámetros" jsonb "input_id" entero [no nulo] "accuracy" numérico [no nulo] "sensor_units" "character varying(10)" "multiplier" doubleprecision [no nulo] "input_label" "character varying(64)" "sensor_label" "character varying(100)" "units_type" entero [no nulo] "divider" doubleprecision [not null] "group_id" entero [no nulo] "sensor_id" entero [no nulo] "dispositivo_id" integer [not null] "sensor_type" "character varying(45)" [not null] "group_type" entero [no nulo] "calibration_data" jsonb } Tabla "entities" { "entity_label" jsonb "record_added_at" marca de tiempo [no nulo] "id_entidad" integer [not null] "builtin_type" entero [no nulo] "id_de_usuario" entero [no nulo] } Tabla "zones" { "dirección" "carácter variable(255)" "radio" integer [not null] "zona_id" integer [not null] "circle_center_latitude" numérico [no nulo] "cliente_id" integer [not null] "zone_label" "character varying(100)" "color" "character varying(6)" [not null] "zone_type" "character varying(20)" [no nulo] "circle_center_longitude" 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" entero [no nulo] "payload_length" numeric "vin" "character varying(20)" "free_Seguro_policy_number" "character varying(50)" "vehicle_label" "character varying(100)" "payload_width" numeric "color" "character varying(6)" "trailer" "character varying(255)" "id_de_Objeto" entero "vehicle_status_id" entero "liability_seguro_valid_till" marca de tiempo "manufacture_year" entero ""fuel_grade"" ""character varying(16)"" "fuel_cost" numérico "fuel_tank_volume" numérico "model" "character varying(100)" "garage_id" entero "payload_height" numérico "max_speed" numérico "número_de_registro" "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_registro_del_remolque" "character varying(32)" "free_Seguro_valid_till_date" timestamp "peso_bruto" numeric "consumo_estándar_de_Combustible" numeric "tipo_de_Combustible" integer "peso_de_carga" numeric "información_adicional" text "subtipo_de_vehiculo" "character varying(32)" "numero_de_poliza_de_seguro_de_responsabilidad_civil" "character varying(50)" "numero_de_bastidor" "character varying(32)" "id_de_usuario" entero [no nulo] "tipo_de_vehiculo" integer [not null] "numero_de_chasis" "character varying(32)" "numero_de_llantas" integer "disposicion_de_ruedas" "character varying(16)" } Tabla "enlaces_de_etiquetas" { "id_entidad" integer [not null] "record_added_at" marca de tiempo [no nulo] "tipo_de_entidad" integer [not null] "orden" integer [not null] "tag_id" entero [no nulo] } Tabla "reglas" { "id_de_regla" integer [not null] "Objeto_id" integer [not null] "parámetros" jsonb "telefono_de_alerta" "character varying(210)" [not null] "tipo_de_evento" "character varying(100)" [not null] "cliente_id" integer [not null] "push_activado" boolean [not null] "comentario_del_evento1" "character varying(255)" [not null] "etiqueta_del_evento" "character varying(255)" [not null] "descripcion" "character varying(255)" [not null] "record_added_at" marca de tiempo [no nulo] "sms_de_alerta" text [not null] "grupo_del_evento" integer [not null] "creado_el" timestamp [not null] "maximo" integer [not null] "eliminado" boolean [not null] "correo_electronico_de_alerta" text [not null] "comentario_del_evento2" "character varying(255)" [not null] } Tabla "historial_de_estados" { "longitud" numeric "id_del_nuevo_estado" integer "id_del_historial_de_estados" integer [not null] "dispositivo_id" integer [not null] "actualizado_por" entero [no nulo] "dirección" "carácter variable(255)" "latitud" numérico "record_added_at" marca de tiempo [no nulo] "fecha_hora_del_servidor" marca de tiempo [no nulo] "fecha_hora_cambio" timestamp "id_del_estado_anterior" integer } Tabla "reglas2zonas" { "zona_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_de_regla" integer [not null] } Tabla "formularios" { "Objeto_id" integer [not null] "descripción" texto "etiqueta_del_formulario" "character varying(255)" [not null] "campos" text "creado_el" timestamp [not null] "direccion_de_envio" "character varying(255)" "latitud_de_envio" numeric "Formulario_id" integer [not null] "longitud_de_envio" numeric "is_envio_en_zona" boolean [not null] "valores" text "record_added_at" marca de tiempo [no nulo] "id_de_tarea" integer "enviado_el" timestamp } Tabla "reglas2objetos" { "parametros_del_objeto" jsonb "numero_de_grupo_de_parametros" integer [not null] "Objeto_id" integer [not null] "record_added_at" marca de tiempo [no nulo] "id_de_regla" integer [not null] } Tabla "tareas" { "hora_desde" timestamp "duracion_de_estadia_minutos" interval "id_externo" "character varying(100)" "id_de_Objeto" entero "tipo_de_tarea" integer "duracion_de_llegada_minutos" interval "estado" integer "fecha_hora_de_llegada" timestamp "record_added_at" marca de tiempo [no nulo] "task_id" entero [no nulo] "user_id" entero "fecha_hora_de_cambio_de_estado" timestamp "orden_de_ordenamiento" integer "hora_hasta" timestamp "retraso_maximo_minuts" integer "is_control_de_estadia_activado" boolean "dirección" "carácter variable(255)" "etiqueta_de_la_tarea" "character varying(200)" [not null] "longitud" numeric "creado_por" integer "descripcion" text [not null] entero "radio" "latitud" numérico "duracion_de_estadia" integer "creado_el" timestamp [not null] "custom_fields" jsonb "id_de_tarea_padre" integer } Tabla "campos_bigint_de_lugares" { "campo_id" integer [not null] "valor" bigint [not null] "Ubicación_id" integer [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "dispositivos" { "is_sim_bloqueada" boolean [not null] "dispositivo_id" integer [not null] "imei_del_dispositivo" "character varying(64)" [not null] "etiqueta_de_red" "character varying(50)" [not null] "status_listing_id" integer [not null] "nivel_de_senal" numeric [not null] "telefono" "character varying(32)" [not null] "tiene_roaming" boolean [not null] "creado_el" timestamp [not null] "id_del_propietario" integer [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "parametros_de_descripcion" { "descripcion" "character varying(150)" "record_added_at" marca de tiempo [no nulo] "tipo" "character varying(100)" [not null] "clave" integer [not null] } Tabla "usuarios" { "etiqueta_de_la_empresa" "character varying(255)" [not null] "fecha_hora_de_registro" timestamp "nombre" "character varying(100)" [not null] "id_principal" integer "apellido" "character varying(100)" [not null] "fecha_de_nacimiento" timestamp "etiqueta_de_zona_horaria" "character varying(30)" "segundo_nombre" "character varying(100)" [not null] "id_de_usuario" entero [no nulo] "configuracion_regional" "character varying(10)" [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "contadores" { "id_del_sensor" integer "multiplicador" numeric [not null] "id_del_contador" integer [not null] "dispositivo_id" integer [not null] "tipo_de_contador" integer [not null] "record_added_at" marca de tiempo [no nulo] } Tabla "empleados" { "licencia_de_conducir_valida_hasta" timestamp "record_added_at" marca de tiempo [no nulo] "apellido" "character varying(100)" "id_de_departamento" integer "numero_de_documento_de_identidad" "character varying(32)" "nombre" "character varying(100)" "categorias_de_licencia_de_conducir" "character varying(32)" "id_de_usuario" entero [no nulo] "numero_de_telefono" "character varying(32)" "id_de_Objeto" entero "eliminado" boolean [not null] "fecha_de_emision_de_licencia_de_conducir" boolean "clave_hardware" "character varying(64)" "segundo_nombre" "character varying(100)" "dirección" "carácter variable(255)" "latitud" numérico "empleado_id" integer [not null] "numero_de_personal" "character varying(15)" "costo_del_combustible" doubleprecision "conductor_license_number" "character varying(32)" "email" "character varying(100)" "fuel_consumption" doble precisión "radio" integer [not null] "longitud" numeric } Tabla "Lugares_longtext_fields" { "campo_id" integer [not null] "valor" text [not null] "record_added_at" marca de tiempo [no nulo] "Ubicación_id" 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" { "dispositivo_id" integer [not null] "key" "cadena de caracteres variable" [no nulo] "valor" texto Índices { (device_id, key) [pk] } } Tabla "event_description" { "event_id" entero [no nulo, pk] "descripción" texto } 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:"entities"."entity_id" < "custom_fields"."entity_id" Ref:"Departamentos"."department_id" < "employees"."department_id" Ref:"users"."user_id" < "Departamentos"."user_id" Ref:"description_parameters"."key" < "counters"."counter_type" Ref:"description_parameters"."key" < "custom_fields"."custom_field_type" Ref:"description_parameters"."key" < "Conductor_history"."updated_by" Ref:"description_parameters"."key" < "entities"."builtin_type" Ref:"description_parameters"."key" < "sensor_description"."units_type" Ref:"description_parameters"."key" < "status_history"."updated_by" Ref:"description_parameters"."key" < "Tareas"."status" Ref:"description_parameters"."key" < "Tareas"."created_at" Ref:"description_parameters"."key" < "tasks"."task_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" Ref:"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" < "places_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" < "places_longtext_fields"."field_id" Ref:"lugares"."ubicación_id" < "lugares_longtext_fields"."ubicación_id" Ref:"custom_fields"."custom_field_id" < "Lugares_text_fields"."field_id" Ref:"Lugares"."place_id" < "places_text_fields"."place_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" < "Etiquetas"."user_id" Ref:"tareas"."tarea_id" < "historial_de_tareas"."tarea_id" Ref:"users"."user_id" < "task_history"."user_id" Ref:"tasks"."parent_task_id" < "tasks"."task_id" Ref:"users"."user_id" < "tasks"."user_id" Referencia:"users"."master_id" < "users"."user_id" Ref:"users"."user_id" < "users2zones"."user_id" Ref:"zones"."zone_id" < "users2zones"."zone_id" Ref:"vehicles"."vehicle_id" < "vehicle_service_tasks"."vehicle_id" Ref:"objects"."object_id" < "vehicle_trackers_history"."object_id" Ref:"Gestión de vehículos"."vehicle_id" < "vehicle_trackers_history"."vehicle_id" Ref:"Garajes"."garage_id" < "Gestión de vehículos"."garage_id" Ref:"objects"."object_id" < "vehicles"."object_id" Ref:"users"."user_id" < "Gestión de vehículos"."user_id" Ref:"zones"."zone_id" < "Zona_points"."zone_id" Ref:"users"."user_id" < "devices"."owner_id" Ref:"users"."user_id" < "objects"."client_id" ``` {% endcode %} ## Frecuencia de actualización Los datos de este esquema se sincronizan con la base de datos central. 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 después del 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 entidades estándarvehicle_type: auto, camión, autobús
Códigos de estadoValores de estado de la Tarea y del sistemaestado_de_tareas: sin asignar, asignado, completado
Definiciones de unidadesUnidades de medida para sensorestipo de unidades: litro, galón, celsius
Clasificaciones de entidadesCategorías de entidades comercialesentities_type: Ubicación, Tarea, cliente
## Tablas clave por categoría Las tablas en el **`raw_business_data`** Los esquemas se organizan en categorías funcionales para facilitar la navegación. La tabla siguiente resume las tablas clave según su propósito empresarial: Entidades empresariales principales
usuarios **Descripción**: Cuentas de usuario que contienen información de 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
- nombre - Nombre de usuario
- apellido - Apellido del usuario
- segundo nombre - Patronímico del usuario
- configuración regional - Configuración de idioma del usuario
- etiqueta de zona horaria - Zona horaria en formato IANA
- master_id - ID principal del usuario (si el actual es un subordinado)
- registration_datetime - Fecha de registro en el sistema
- birth_date - Fecha de nacimiento del usuario
RelacionesUsuario principal a través de master_id, vinculado a Empleados, Departamentos, Lugares, Tareas A través de user_id
Notas especialesEntidad central que conecta los datos organizacionales; master_id permite jerarquías de usuarios para estructuras de cuentas multinivel
Empleados **Descripción**: Registros de empleados y conductores utilizados para representar a las personas que trabajan para la organización, incluyendo información personal, detalles de licencia, asignaciones de Departamentos, llaves de hardware para la identificación con iButton/RFID y datos de ubicación con compatibilidad con geocercas
AtributoDetalles
Campos clave- employee_id - Identificador de la entidad de empleado
- user_id - Identificador de la entidad de usuario
- id de objeto - objeto identificador de entidad
- department_id - Un ID del departamento al que se asignó el empleado
- nombre - El atributo first_name de la tabla de empleados
- apellido - El atributo last_name de la tabla de empleados
- segundo nombre - El atributo middle_name de la tabla employees
- número de licencia de Conductor - número de licencia de Conductor
- categorías_de_licencia_de_Conductor - Categorías de licencia de Conductor - fecha_de_emisión_de_licencia_de_Conductor - Fecha de emisión de una licencia de Conductor - fecha_de_vencimiento_de_licencia_de_Conductor - Fecha hasta la que es válida una licencia de Conductor - clave_de_hardware - Una clave de hardware - correo electrónico - Correo electrónico del empleado - Número de teléfono - Teléfono del empleado sin el signo «+»
- Dirección - Dirección de la ubicación
- Número de empleado - Número de empleado/Conductor
- Número de identificación ciudadana - Número de la Seguridad Social
- latitud - Ubicación asociada con este empleado
- longitud - Ubicación asociada con este empleado
- Radio - Ubicación asociada con este empleado en metros
- consumo_de_combustible - El atributo consumo_de_combustible de la tabla de empleados
- costo_de_combustible - El atributo costo_de_combustible de la tabla de empleados
- is_deleted - El atributo is_deleted de la tabla de empleados
RelacionesEnlaces a usuarios, Departamentos, objetos (rastreador asignado), rastreado en historial_del_conductor y registros
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 geocercas 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 la entidad de usuario
- department_label - El atributo department_label de la tabla de departamentos
- latitud - Ubicación asociada con este departamento
- longitud - Ubicación asociada con este departamento
- Radio - Tamaño de la ubicación geográfica en metros
- Dirección - El atributo address de la tabla de departamentos
RelacionesVincula a los empleados con la estructura organizativa mediante department_id
Notas especialesLos campos de ubicación admiten analíticas basadas 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 la 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
- id_del_Propietario - 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 de 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ó la entrada
RelacionesEntidad principal vinculada a objetos, modelos, sensor_description, contadores; id_del_Propietario 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 (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- id de objeto - objeto identificador de entidad
- client_id - Identificador de la entidad del cliente
- device_id - Identificador de la entidad del dispositivo
- etiqueta de objeto - Nombre del objeto
- modelo - modelo del dispositivo
- group_id - Grupo de ID de entidad
- create_datetime - Fecha y hora de creación de una nueva fila en el servidor
- is_deleted - El atributo is_deleted de la tabla de objetos
- is_clone - Marca de clonación
RelacionesCentro central que conecta dispositivos con 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 (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 digitales del rastreador
- outputs_amount - Número de salidas digitales del rastreador
- has_battery_level - Determina si el rastreador transmite lecturas de carga de la 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 desenganche?
- type_output_control - Perfil de control de salidas del rastreador
- type_special_control - Contiene configuraciones especializadas y módulos funcionales para modelos de dispositivo 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 de 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 del sensor que vincula las entradas del dispositivo con la lógica de negocio, incluyendo asignaciones de entradas, unidades de medida, factores de conversión (multiplicador/divisor), tablas de calibración para sensores de combustible, umbrales de precisión y lógica de agrupación para lecturas agregadas de sensores
AtributoDetalles
Campos clave- sensor_id - Identificador de la entidad del sensor
- device_id - Identificador de la entidad del dispositivo
- sensor_label - Nombre del sensor para la interfaz de usuario
- input_label - El nombre del campo del 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 que se multiplica el valor del campo. Solo para sensores de medición
- divider - Divisor - el número por el que se divide el valor del campo. Solo para sensores de medición
- accuracy - Un porcentaje especificado para calcular el error absoluto del volumen del tanque. Este error se usa para determinar cuándo se producen llenados o drenajes. Esto se usa solo para sensores de combustible
- calibration_data - El atributo calibration_data de la tabla sensor_description
- input_id - Número de entrada para Sensor digital
- group_id - Los sensores del mismo tipo con el mismo group_id y source_id se consideran que 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 usa en los sensores de medición
- Tipo de Grupo - 0 - sumar los valores de los sensores dentro de un Grupo, 1 - promedio
- unidades del sensor - Nombre de la unidad ingresado por el usuario si units_type=0 (personalizado)
- parámetros - Objeto opcional con parámetros adicionales parent_ids: matriz opcional de parent_ids para el sensor compuesto. volume: double. Opcional. Volumen para el sensor compuesto. parent_ids: matriz opcional de int. Matriz de parent_ids para el sensor compuesto. volume: opcional. Double. Volumen para el sensor compuesto. min: opcional. Double. Valor sin procesar mínimo aceptable para un sensor. max: opcional. Double. Valor sin procesar máximo aceptable para un sensor. max_lowering_by_time: opcional. Double. Valor máximo legal de disminución por hora. max_lowering_by_mileage: opcional. Double. Valor máximo legal de disminución por cada 100 km. ignore_drains_in_move: opcional. Boolean. El valor predeterminado es false. Si es true, no se detectarán los drenes de combustible durante el movimiento. ignore_refuels_in_move: opcional. Boolean. El valor predeterminado es false. Si es true, no se detectarán las recargas durante el movimiento. refuel_gap_minutes: opcional. Integer. El valor predeterminado es 5. La hora en minutos después del inicio del movimiento; durante el movimiento se detectarán las recargas. custom_field_name: opcional. Boolean. El valor predeterminado es false. El parámetro determina si el campo input_name tiene un valor personalizado que ingresó el usuario. Esto solo tiene sentido si el modelo del rastreador tiene la función has_custom_fields
RelacionesVincula las entradas del dispositivo (de raw_telematics_data.inputs) a la lógica de negocio mediante device_id y input_label coincidencia
Notas especialescalibration_data (JSONB) almacena tablas de calibración específicas del sensor para sensores de nivel de combustible; multiplier y divider convertir valores sin procesar a unidades
Gestión de Activo
Gestión de vehículos **Descripción**: Registro vehicular integral 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 Gestión de flotas y Seguimiento de cumplimiento
AtributoDetalles
Campos clave- vehicle_id - Identificador de entidad del vehículo
- user_id - Identificador de la entidad de usuario
- id de objeto - objeto identificador de entidad
- garage_id - Identificador de entidad de garaje
- etiqueta del vehículo - El atributo vehicle_label de la tabla de Gestión de vehículos
- registration_number - 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 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 de vehículos
- volumen_tanque_combustible - El atributo fuel_tank_volume de la tabla de vehículos
- max_speed - El atributo max_speed de la tabla de Gestión de vehículos
- modelo - El atributo modelo de la tabla de Gestión de vehículos
- color - El atributo de color de la tabla de Gestión de vehículos
- remolque - El atributo trailer de la tabla de Gestión de vehículos
- additional_info - El atributo additional_info de la tabla de Gestión de vehículos
- vehicle_type - El atributo vehicle_type de la tabla de Gestión de vehículos
- vehicle_subtype - El atributo vehicle_subtype de la tabla de Gestión de vehículos
- vehicle_status_id - Identificador de entidad del estado del vehículo
- chassis_number - El atributo chassis_number de la tabla Gestión de vehículos
- frame_number - El atributo frame_number de la tabla Gestión de vehículos
- trailer_reg_number - El atributo trailer_reg_number de la tabla Gestión de vehículos
- payload_weight - El atributo payload_weight de la tabla Gestión de vehículos
- payload_height - El atributo payload_height de la tabla Gestión de vehículos
- payload_length - El atributo payload_length de la tabla de Gestión de vehículos
- payload_width - El atributo payload_width de la tabla de Gestión de vehículos
- capacidad de pasajeros - Un número máximo de pasajeros
- gross_weight - El atributo gross_weight de la tabla de Gestión de vehículos
- consumo_de_combustible_estándar - Consumo normal promedio de combustible en litros por 100 km
- grado de combustible - El atributo fuel_grade de la tabla de vehículos
- disposición de las ruedas - el atributo wheel_arrangement de la tabla de Gestión de vehículos
- tamaño de llanta - Tamaño del vehículo: dimensiones y tamaño de las llantas
- tyres_number - Número de ruedas
- número de póliza de Seguro de responsabilidad civil - El atributo liability_insurance_policy_number de la tabla de Gestión de vehículos
- seguro_de_responsabilidad_válido_hasta - La fecha hasta la que es válido el Seguro de responsabilidad civil
- número_de_póliza_de_Seguro_gratuito - El atributo free_insurance_policy_number de la tabla vehicles
- Seguro_gratuito_válido_hasta_la_fecha - La fecha hasta la cual es válido el Seguro gratuito
RelacionesEnlaces a objetos (dispositivo actual), garajes (ubicación del servicio), tareas_del_servicio_del_vehículo; rastreado en vehicle_trackers_history
Notas especialesCampos de dimensiones físicas (payload_length, payload_width, payload_height, gross_weight) admiten analítica de planificación de carga; las fechas de Seguro permiten Seguimiento del cumplimiento
garajes **Descripción**: ubicaciones de instalaciones de servicio y Mantenimiento con coordenadas geográficas (latitud, longitud, radio), información de contacto de 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 entidad de garaje
- user_id - Identificador de la entidad de usuario
- latitud - Objeto de ubicación
- longitud - Objeto de ubicación
- Radio - Tamaño de la ubicación geográfica en metros
- Dirección - Objeto de ubicación
- organization_label - ID de Garaje
- mechanic_name - Nombre del mecánico
- dispatcher_name - Nombre del despachador
RelacionesReferenciado por Gestión de vehículos.garage_id para la asignación de la ubicación de servicio
Notas especialesLos campos de ubicación permiten la detección de visitas de servicio basada 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 disparador (basados en fecha, en Kilometraje y en horas de 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 la entidad de tarea de servicio
- vehicle_id - Identificador de entidad del vehículo
- descripción - El atributo de descripción de la tabla vehicle_service_tasks
- estado - El valor del estado del atributo de estado
- costo - El atributo de costo de la tabla vehicle_service_tasks
- start_date - La fecha y la hora asociadas con el atributo start_date
- end_date - La fecha y hora asociadas al atributo end_date
- fecha de finalización - La fecha y la hora asociadas con el atributo completion_date
- predicted_datetime - La fecha y la hora asociadas al atributo predicted_datetime
- límite de Kilometraje - El atributo mileage_limit de la tabla vehicle_service_tasks
- límite de horas del motor - El atributo engine_hours_limit de la tabla vehicle_service_tasks
- 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_tareas
- intervalo de notificación de kilometraje - El atributo Kilometraje_notification_interval de la tabla vehicle_service_tasks
- engine_hours_notification_interval - El atributo engine_hours_notification_interval de la tabla vehicle_service_tasks
- date_notification_interval - Convirtiendo un entero N a N días
- intervalo_de_repetición_del_kilometraje - 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_tasks
- date_repeat_interval - Convirtiendo un entero N a N días
- correos electrónicos de notificación - 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_tasks
- is_notification_push_enabled - El atributo is_notification_push_enabled de la tabla vehicle_service_tasks
- kilometraje de finalización - El atributo completion_kilometraje de la tabla vehicle_service_tareas
- completion_engine_hours - El atributo completion_engine_hours de la tabla vehicle_service_tasks
- es repetido - El atributo is_repeat de la tabla vehicle_service_tasks
- no_planificado - El atributo is_unplanned de la tabla vehicle_service_tasks
- comentario - El atributo de comentario de la tabla vehicle_service_tasks
ContenidoAdmite tres tipos de activadores: basados en fecha, basados en Kilometraje, basados en horas de motor; configuración de notificaciones por correo electrónico, SMS y push
Notas especialeses repetido y los campos de intervalo permiten programaciones recurrentes de Mantenimiento; no_planificado distingue entre el mantenimiento programado y el 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ículos/Activos, con compatibilidad 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 zona
- client_id - Identificador de la entidad del cliente
- zone_label - El atributo zone_label de la tabla zones
- zone_type - El atributo zone_type de la tabla zones
- latitud - Objeto opcional, la caja delimitadora que puede contener completamente el resultado devuelto
- longitud - Objeto opcional, la caja delimitadora que puede contener completamente 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 ubicación geográfica en metros
- Dirección - El atributo de dirección de la tabla de zonas
- color - El atributo de color de la tabla de zonas
ContenidoLos tipos de zona incluyen círculo, polígono (definido mediante Zona_points), y clasificaciones de áreas especiales
RelacionesReferenciado por reglas2zonas, usuarios2zonas; vértices del polígono almacenados en Zona_points
Notas especialesLas funciones de PostGIS se pueden usar para comprobar si un punto está dentro de un 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 de clientes 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 Ubicación
- user_id - Identificador de la 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 ubicación geográfica en metros
- Dirección - El atributo de dirección de la tabla 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_campos_de_texto, lugares_campos_decimales, Lugares_bigint_campos, campos_de_texto_largo_de_lugares, campos_de_entidad_vinculada_de_lugares
Notas especialescampos personalizados JSONB proporciona acceso rápido; las tablas relacionadas permiten filtrar y ordenar atributos personalizados
Zona_points **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, utilizadas 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 definir los límites del polígono; número el campo determina el orden de los vértices
Notas especialesConsulta con ORDER BY número para reconstruir el trazado del polígono; utilícelo con PostGIS ST_MakePolygon para operaciones geométricas
Tarea y gestión de flujos de trabajo
Tareas **Descripción**: Asignaciones de órdenes de trabajo con validación de ubicación (latitude, longitude, radius), ventanas de tiempo (time\_from, time\_to), requisitos de duración de la 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 operaciones de entrega
AtributoDetalles
Campos clave- id_de_tarea - Identificador de entidad de Tarea
- user_id - Identificador de la entidad de usuario
- id de objeto - objeto identificador de entidad
- parent_Tarea_id - Identificador de entidad de la tarea principal
- etiqueta de tarea - El atributo task_label de la tabla Tareas
- estado - El valor del 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 ubicación geográfica 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 la 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 la asignación para completar con éxito la tarea. Varias visitas son acumulativas
- arrival_duration_minutes - Ignorar 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 «atrasada»
- is_stay_control_enabled - El atributo is_stay_control_enabled de la tabla Tareas
- Dirección - El atributo address de la tabla Tareas
- descripción - El atributo Description de la tabla Tareas
- campos personalizados - El atributo custom_fields de la tabla Tareas
- external_id - Identificador de entidad externa
- order_sort - El atributo order_sort de la tabla de Tareas
- creado_por - Origen de la tarea creada
ContenidoAdmite tareas jerárquicas mediante parent_Tarea_id; ventanas de tiempo definidas por time_from/time_to; validación de Zona con ubicación y radio
RelacionesEnlaces a formularios (recolección de datos), historial_de_tareas (cambios de estado), objetos (dispositivo asignado)
Notas especialesstay_duration y arrival_duration_minutes activar el monitoreo del cumplimiento para las tareas de entrega y servicio
formularios **Descripción**: Formularios de recopilación de datos configurables para capturar información estructurada durante la finalización de una Tarea o Los check-ins de la aplicación móvil, con campos y valores almacenados como JSON, validación opcional de ubicación (is\_submission\_in\_zone) y requisitos de envío obligatorio cuando se adjunta a Tareas
AtributoDetalles
Campos clave- Formulario_id - Identificador de entidad del Formulario
- id_de_tarea - Un ID de la Tarea a la que está adjunto este Formulario
- id de objeto - objeto identificador de entidad
- etiqueta del Formulario - Etiqueta de formulario definida por el usuario
- campos - Si es verdadero, el Formulario solo se puede enviar en la zona de 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
- submission_latitude - Ubicación en la que se enviaron por última vez los valores del formulario
- submission_longitude - Ubicación en la que se enviaron por última vez los valores del formulario
- submission_address - Ubicación en la que se enviaron por última vez los valores del formulario
- is_submission_in_zone - Si es verdadero, el Formulario solo se puede enviar en la zona de 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
Notas especialesIndicador de validación de ubicación is_submission_in_zone habilita reglas de envío de Formularios basadas en Zona
registros **Descripción**: registros de asistencia y actividad basados en la ubicación, enviados mediante la aplicación móvil, con Seguimiento de las horas de llegada planificadas frente a las reales (planned\_datetime vs actual\_datetime) con coordenadas geográficas y mediciones de precisión de la ubicación (radio) para informes 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
- id de objeto - Dispositivo del empleado
- Formulario_id - Identificador de entidad del 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 del check-in
- comentario - El atributo comment de la tabla de check-ins
RelacionesConecta a los empleados con formularios y ubicaciones; rastrea la desviación del horario planificado
Notas especialesDiferencia de tiempo entre planned_datetime y actual_datetime permite generar reportes de puntualidad; el radio define la tolerancia de ubicación aceptable
historial_de_tareas **Descripción**: Registro de auditoría completo 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- id_del_historial_de_tarea - Identificador de entidad del historial de Tarea
- id_de_tarea - Identificador de entidad de Tarea
- user_id - Identificador de la entidad de usuario
- actividad - Operación que ocurrió. Puede ser "create", "update", "assign" o "status_change"
- event_datetime - Fecha y hora del evento
- carga útil - Depende de la operación. Normalmente, contiene los campos que se cambiaron durante la operación
ContenidoTipos de actividad definidos en description_parameters; carga útil almacena detalles específicos del evento (texto)
Notas especialesEsencial para el análisis de finalización de Tarea, la generació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 (exceso de velocidad, violaciones de la Zona, umbrales de sensor, tiempo de inactividad) 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 entidad de regla
- id de objeto - objeto identificador de entidad
- client_id - Identificador de la entidad del 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_Grupo 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 API de Navixy.
- alert_email - Correo electrónico 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
- is_deleted - 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 rules2objects, zonas mediante 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
rules2objects **Descripción**: Muchas relaciones de muchos a muchos que enlazan reglas con objetos supervisados, con personalización de parámetros por objeto mediante object\_params (JSONB), lo que permite que haya 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 entidad de regla
- id de objeto - objeto identificador de entidad
- número del grupo de parámetros - El atributo param_group_number de la tabla rules2objects
- parámetros del objeto - El atributo de object_params de la tabla rules2objects
Contenidoparámetros del objeto (JSONB) permite la personalización de reglas por Objeto (p. ej., diferentes límites de velocidad por vehículo)
Notas especialesLa relación de muchos a muchos permite que una regla supervise múltiples objetos con distintos parámetros
reglas2zonas **Descripción**: Relación de muchos a muchos que asocia reglas con zonas geocercadas, lo que permite que una sola regla monitoree eventos de entrada y salida en múltiples áreas geográficas para escenarios complejos de monitoreo espacial
AtributoDetalles
Campos clave- rule_id - identificador de entidad de regla
- zone_id - identificador de entidad de zona
Notas especialesLa relación de muchos a muchos permite el monitoreo multizona para una sola regla (p. ej., alertar al entrar en cualquiera de varias áreas restringidas)
Estado y categorización
estados **Descripción**: Definiciones de estado personalizadas dentro de los listados de estados, incluidas propiedades de visualización (color para la visualización en el sitio web, order\_sort para la posición) utilizadas para representar los estados de trabajo del dispositivo o del empleado con compatibilidad para borrado suave mediante la bandera is\_deleted
AtributoDetalles
Campos clave- status_id - identificador de entidad de estado
- listing_id - identificador de entidad de listado
- status_label - Valor del estado del atributo status_label
- color - Color utilizado para su visualización en el sitio web
- order_sort - Posición de orden dentro del listado de estados
- is_deleted - El atributo is_deleted de la tabla de estados
RelacionesGrupos de estados organizados por listing_id (referencia a status_listings); se usa en status_history
Notas especialesorder_sort define la secuencia de visualización; el color permite diferenciación visual 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 estados
- user_id - Identificador de la 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, p. ej., usando la aplicación móvil de Seguimiento
- is_deleted - 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 (latitud, longitud, dirección) que permite el análisis geográfico de los cambios de estado y los reportes de ubicación de inicio y fin de jornada
AtributoDetalles
Campos clave- status_history_id - Identificador de entidad del historial de estado
- device_id - Identificador de la entidad del dispositivo
- old_status_id - Identificador de entidad del estado anterior
- new_status_id - Identificador de entidad del estado nuevo
- updated_by - La fecha y hora asociadas con el atributo updated_by
- changed_datetime - Fecha y hora de asignar un nuevo estado al dispositivo
- server_datetime - Fecha y hora de asignar el 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 los 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 entre múltiples tipos de entidad (Lugares, geocercas, empleados, Tareas, rastreadores, Gestión de vehículos) para una organización flexible
AtributoDetalles
Campos clave- id de etiqueta - Etiqueta de ID de entidad
- user_id - Identificador de la 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 Etiqueta_enlaces; alcance definido por el usuario
Notas especialesSistema flexible de categorización que admite múltiples etiquetas por entidad
Etiqueta_enlaces **Descripción**: tabla de relación polimórfica que asocia etiquetas con cualquier tipo de entidad mediante entity\_type y entity\_id, con un campo ordinal para la gestión del orden de visualización, lo que permite un etiquetado flexible de múltiples entidades
AtributoDetalles
Campos clave- id de etiqueta - 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 organizacional para rastreadores que permite una organización visual en la interfaz de usuario con colores personalizables (group\_color) y administración jerárquica tipo carpetas, que actualmente cumple una función puramente visual
AtributoDetalles
Campos clave- group_id - Grupo de Dispositivo (vinculado por objects.group_id). La división en grupos se puede ver en la lista de balizas, por ejemplo
- client_id - Identificador de la entidad del cliente
- etiqueta_de_grupo - Título del grupo especificado por el usuario, de 1 a 60 caracteres imprimibles, p. ej. «Empleados»
- color del Grupo - Color del Grupo en formato web (sin #), p. ej. «FF6DDC». Determina el color de los marcadores de Dispositivo en el mapa
RelacionesReferenciado por objects.group_id; propiedad del cliente a través de client_id (referencia a 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 usando una clave primaria compuesta (groups\_client\_id, objects\_client\_id), lo que permite que los objetos pertenezcan a varios grupos simultáneamente para estructuras organizativas flexibles
AtributoDetalles
Campos clave- groups_client_id - Identificador de entidad de cliente para grupos
- objects_client_id - Identificador de la entidad del cliente para objetos
Notas especialesPermite que los objetos pertenezcan simultáneamente a varios grupos; consulte con ambos client_id valores para la pertenencia a Grupo
Campos personalizados y entidades
entidades **Descripción**: Registro de tipos de entidad que define qué entidades empresariales admiten Campos personalizados y la estructura de diseño de sus campos (secciones, field\_order), almacenada en entity\_label (JSONB), lo que permite una extensión dinámica del 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 la entidad de usuario
- entity_label - id - int. Identificador de entidad. type - enum. Actualmente, solo se admite «Ubicación». layout - Objeto que describe el diseño de los campos para 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 se vincula a 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 entidades, con tipos de campo configurables (custom\_field\_type), reglas de validación y opciones en parámetros (JSONB), y banderas de requerimiento (is\_required) para una captura flexible de datos en lugares, tareas y otras entidades
AtributoDetalles
Campos clave- custom_field_id - Identificador de la entidad del campo personalizado
- entity_id - Identificador de entidad
- custom_field_label - Nombre del campo
- custom_field_type - Tipo de dato en el campo
- descripción - Descripción del campo
- is_required - ¿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 del menú desplegable, 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 las 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 la clave de hardware y atribución de usuario (updated\_by), lo que permite análisis específicos por Conductor cuando Conductores cambian entre Gestión de vehículos
AtributoDetalles
Campos clave- Conductor_history_id - Identificador de la entidad del historial del Conductor
- id de objeto - 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 del 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 con el atributo updated_by
- latitud - El atributo de latitud de la tabla driver_history
- longitud - El atributo de longitud de la tabla driver_history
- Dirección - El atributo de dirección de la tabla driver_history del Conductor
RelacionesRealiza un seguimiento de las asignaciones de Conductor a Gestión de vehículos a lo largo del tiempo; enlaza con Empleados y objetos
Notas especialesEsencial para los reportes específicos del 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
vehicle_trackers_history **Descripción**: Seguimiento de registro de auditoría de qué dispositivos GPS (object\_id) se instalaron en qué Gestión de vehículos (vehicle\_id) a lo largo del tiempo, con marcas de tiempo de cambio (changed\_datetime), lo que permite una atribución precisa de los datos históricos y el cálculo de Kilometraje cuando los rastreadores se mueven entre Gestión de vehículos
AtributoDetalles
Campos clave- vehicle_dispositivo_history_id - Identificador de entidad del historial del Dispositivo vehicular
- vehicle_id - Identificador de entidad del vehículo
- id de objeto - objeto identificador de entidad
- changed_datetime - La fecha y la hora asociadas con el atributo changed_datetime
RelacionesRegistra qué dispositivo GPS se instaló en qué vehículo a lo largo del tiempo
Notas especialesCrítico para el análisis histórico de datos cuando los rastreadores se mueven entre la Gestión de vehículos; permite una atribución precisa del Kilometraje y del uso
Datos de referencia y consulta
description_parameters **Descripción**: Los datos de referencia a nivel de sistema proporcionan etiquetas legibles por humanos (descripción) para valores enteros enumerados (key) usados en toda la base de datos, organizados por el campo type (por ejemplo, task\_status, fuel\_type, counter\_type, entity\_classification) para una traducción consistente de valores en los reportes y la visualización en 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 en la tabla
- descripción - Valor implícito de un atributo
ContenidoProporciona etiquetas legibles para 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 de los contadores de Odómetro y horas de motor que vinculan las lecturas de los 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 la entidad del dispositivo
- counter_type - Tipo de contador
- sensor_id - Identificador de la entidad del 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 pulsos del sensor en unidades reales (km, millas, 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 (número) a nombres definidos por el usuario (etiqueta), como «Bloqueo de puerta» o «Bloqueo del motor», para la generación de reportes legibles y el análisis de los comandos y estados de salida del dispositivo
AtributoDetalles
Campos clave- device_id - Identificador de la entidad del dispositivo
- número - El atributo number de la tabla device_output_name
- label - El atributo label de la tabla device_output_name
ContenidoAsigna los números de los canales de salida a nombres definidos por el usuario (p. ej., «Cerradura de puerta», «Bloque del motor»)
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 una configuración para un dispositivo específico.
AtributoDetalles
Campos clave- device_id - Identificador de la entidad del dispositivo
- clave - Nombre del ajuste
- value - Valor del ajuste
Clave primariaCompuesto: (device_id, key)
Notas especialesSe completa durante la sincronización completa del cliente. Use esta tabla para leer valores de configuración a nivel de dispositivo junto con datos telemáticos o de negocio.
descripción del evento **Descripción**: Tabla de referencia de los códigos de eventos del rastreador con descripciones legibles para humanos. Contiene 134 entradas que cubren eventos comunes del rastreador, como SOS, Modo ahorro energía, Ignición y cambios de entrada/salida digital.
AtributoDetalles
Campos clave- event_id - Código del evento (clave primaria)
- descripción - nombre del evento legible para humanos
Notas especialesUnirse a raw_telematics_data.seguimiento_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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.