> 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 40+ tablas cuidadosamente seleccionadas para cubrir diversos aspectos y casos de uso del negocio. Estas tablas representan sus entidades empresariales principales, la estructura organizacional y los datos operativos.

{% hint style="info" %}
El diagrama interactivo del esquema raw\_business\_data está disponible en **dbdiagram.io**: <https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a>
{% endhint %}

Encuentre a continuación los detalles del esquema de datos empresariales brutos.

{% code title="esquema raw\_business\_data" expandable="true" %}

```sql
Tabla "tareas_de_servicio_de_vehículos" {
  "registro_agregado_en" timestamp [not null]
  "kilometraje_inicial" numeric
  "comentario" "character varying(255)"
  "estado" "character varying(10)" [not null]
  "fecha_de_finalización" timestamp
  "horas_iniciales_del_motor" numeric
  "id_tarea_de_servicio" integer [not null]
  "notificaciones_push_habilitadas" boolean [not null]
  "intervalo_de_notificación_por_fecha" interval
  "fecha_hora_predicha" timestamp
  "costo" numeric [not null]
  "límite_de_kilometraje" numeric
  "correos_electrónicos_de_notificación" text
  "es_no_planificado" boolean [not null]
  "es_repetitivo" boolean [not null]
  "horas_de_finalización_del_motor" integer
  "límite_de_horas_del_motor" numeric
  "intervalo_de_repetición_de_kilometraje" integer
  "id_vehículo" integer [not null]
  "intervalo_de_notificación_de_horas_del_motor" integer
  "fecha_de_inicio" timestamp
  "intervalo_de_notificación_de_kilometraje" integer
  "intervalo_de_repetición_de_fecha" interval
  "descripción" "character varying(255)"
  "números_de_teléfono_para_sms_de_notificación" text
  "fecha_de_fin" timestamp
  "intervalo_de_repetición_de_horas_del_motor" integer
  "kilometraje_de_finalización" integer
}

Tabla "garajes" {
  "registro_agregado_en" timestamp [not null]
  "id_garaje" integer [not null]
  "longitud" numeric
  "nombre_del_mecánico" "character varying(255)"
  "radio" integer [not null]
  "latitud" numeric
  "etiqueta_de_la_organización" "character varying(255)"
  "id_usuario" integer [not null]
  "nombre_del_despachador" "character varying(255)"
  "dirección" "character varying(255)"
}

Tabla "historial_de_conductor" {
  "fecha_hora_del_servidor" timestamp [not null]
  "dirección" "character varying(255)"
  "actualizado_por" integer [not null]
  "id_objeto" integer
  "longitud" numeric
  "latitud" numeric
  "id_historial_de_conductor" integer [not null]
  "clave_de_hardware" "character varying(64)"
  "id_nuevo_empleado" integer
  "fecha_hora_del_cambio" timestamp
  "registro_agregado_en" timestamp [not null]
  "id_empleado_anterior" integer
}

Tabla "departamentos" {
  "registro_agregado_en" timestamp [not null]
  "etiqueta_del_departamento" "character varying(255)" [not null]
  "latitud" numeric
  "id_departamento" integer [not null]
  "dirección" "character varying(255)"
  "radio" integer [not null]
  "longitud" numeric
  "id_usuario" integer [not null]
}

Tabla "registros_de_entrada" {
  "radio" integer [not null]
  "latitud" numeric [not null]
  "id_empleado" integer [not null]
  "longitud" numeric [not null]
  "registro_agregado_en" timestamp [not null]
  "fecha_hora_real" timestamp [not null]
  "id_usuario" integer [not null]
  "id_formulario" integer [not null]
  "dirección" "character varying(255)"
  "fecha_hora_planificada" 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_del_estado" "character varying(200)" [not null]
  "registro_agregado_en" timestamp [not null]
  "eliminado" boolean [not null]
}

Tabla "campos_de_entidad_vinculados_de_lugares" {
  "valor" bigint [not null]
  "registro_agregado_en" timestamp [not null]
  "id_lugar" integer [not null]
  "id_campo" integer [not null]
}

Tabla "campos_de_texto_de_lugares" {
  "id_lugar" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "valor" text [not null]
  "id_campo" integer [not null]
}

Tabla "usuarios2zonas" {
  "id_zona" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_usuario" integer [not null]
}

Tabla "objetos" {
  "registro_agregado_en" timestamp [not null]
  "fecha_hora_de_creación" timestamp [not null]
  "id_cliente" integer [not null]
  "id_grupo" integer
  "etiqueta_del_objeto" "character varying(100)"
  "modelo" "character varying(64)"
  "es_clon" boolean [not null]
  "eliminado" boolean [not null]
  "id_dispositivo" integer [not null]
  "id_objeto" integer [not null]
}

Tabla "nombre_de_salida_del_dispositivo" {
  "id_dispositivo" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "etiqueta" "character varying(100)" [not null]
  "número" integer [not null]
}

Tabla "puntos_de_zona" {
  "longitud" numeric [not null]
  "número" integer [not null]
  "id_zona" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "latitud" numeric [not null]
}

Tabla "campos_personalizados" {
  "registro_agregado_en" timestamp [not null]
  "id_entidad" integer [not null]
  "es_requerido" boolean [not null]
  "etiqueta_del_campo_personalizado" text [not null]
  "parámetros" jsonb
  "tipo_de_campo_personalizado" integer [not null]
  "descripción" text
  "id_campo_personalizado" integer [not null]
}

Tabla "campos_decimales_de_lugares" {
  "id_campo" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_lugar" integer [not null]
  "valor" numeric [not null]
}

Tabla "historial_de_tareas" {
  "id_tarea" integer [not null]
  "actividad" integer [not null]
  "id_historial_de_tarea" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_usuario" integer [not null]
  "fecha_hora_del_evento" timestamp [not null]
  "carga" text
}

Tabla "etiquetas" {
  "etiqueta_de_la_etiqueta" "character varying(64)" [not null]
  "color" "character varying(6)"
  "id_usuario" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_etiqueta" integer [not null]
}

Tabla "lugares" {
  "descripción" text
  "campos_personalizados" jsonb
  "id_lugar" integer [not null]
  "id_externo" "character varying(32)"
  "registro_agregado_en" timestamp [not null]
  "id_usuario" integer
  "latitud" numeric
  "radio" integer
  "etiqueta_del_lugar" "character varying(256)"
  "fecha_hora_asignada" timestamp
  "dirección" "character varying(256)"
  "longitud" numeric
}

Tabla "listados_de_estado" {
  "id_usuario" integer [not null]
  "controlado_por_supervisor" boolean [not null]
  "eliminado" boolean [not null]
  "id_listado_de_estado" integer [not null]
  "controlado_por_empleado" boolean [not null]
  "registro_agregado_en" timestamp [not null]
  "etiqueta_del_listado_de_estado" "character varying(200)" [not null]
}

Tabla "modelos" {
  "registro_agregado_en" timestamp [not null]
  "id_modelo" integer [not null]
  "tiene_nivel_de_batería" boolean [not null]
  "etiqueta_alternativa" "character varying(50)" [not null]
  "proveedor" "character varying(30)" [not null]
  "es_clon" boolean
  "tiene_altitud" boolean [not null]
  "tiene_teléfono" boolean [not null]
  "tipo_de_control_de_salida" "character varying(30)" [not null]
  "tiene_roaming_GSM" boolean [not null]
  "tiene_nivel_GSM" boolean [not null]
  "modelo" "character varying(255)" [not null]
  "tipo_de_control_especial" "character varying(255)" [not null]
  "cantidad_digital" integer [not null]
  "tiene_botón_de_desconexión" boolean [not null]
  "tiene_nombre_GSM" boolean [not null]
  "cantidad_analógica" integer [not null]
  "cantidad_de_salidas" integer [not null]
}

Tabla "historial_de_rastreadores_de_vehículos" {
  "id_vehículo" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_objeto" integer [not null]
  "fecha_hora_del_cambio" timestamp [not null]
  "id_historial_de_rastreador_de_vehículo" integer [not null]
}

Tabla "grupos" {
  "id_grupo" integer [not null]
  "color_del_grupo" "character varying(6)" [not null]
  "etiqueta_del_grupo" "character varying(255)" [not null]
  "id_cliente" integer [not null]
  "registro_agregado_en" timestamp [not null]
}

Tabla "descripción_del_sensor" {
  "registro_agregado_en" timestamp [not null]
  "parámetros" jsonb
  "id_entrada" integer [not null]
  "precisión" numeric [not null]
  "unidades_del_sensor" "character varying(10)"
  "multiplicador" doubleprecision [not null]
  "etiqueta_de_entrada" "character varying(64)"
  "etiqueta_del_sensor" "character varying(100)"
  "tipo_de_unidades" integer [not null]
  "divisor" doubleprecision [not null]
  "id_grupo" integer [not null]
  "id_sensor" integer [not null]
  "id_dispositivo" integer [not null]
  "tipo_de_sensor" "character varying(45)" [not null]
  "tipo_de_grupo" integer [not null]
  "datos_de_calibración" jsonb
}

Tabla "entidades" {
  "etiqueta_de_entidad" jsonb
  "registro_agregado_en" timestamp [not null]
  "id_entidad" integer [not null]
  "tipo_integrado" integer [not null]
  "id_usuario" integer [not null]
}

Tabla "zonas" {
  "dirección" "character varying(255)"
  "radio" integer [not null]
  "id_zona" integer [not null]
  "latitud_del_centro_del_círculo" numeric [not null]
  "id_cliente" integer [not null]
  "etiqueta_de_la_zona" "character varying(100)"
  "color" "character varying(6)" [not null]
  "tipo_de_zona" "character varying(20)" [not null]
  "longitud_del_centro_del_círculo" numeric [not null]
  "latitud" numeric [not null]
  "registro_agregado_en" timestamp [not null]
  "longitud" numeric [not null]
}

Tabla "vehículos" {
  "id_vehículo" integer [not null]
  "longitud_de_carga" 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_carga" numeric
  "color" "character varying(6)"
  "remolque" "character varying(255)"
  "id_objeto" integer
  "id_estado_del_vehículo" integer
  "vigencia_del_seguro_de_responsabilidad" 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_garaje" integer
  "altura_de_carga" numeric
  "velocidad_máxima" numeric
  "número_de_registro" "character varying(32)"
  "tamaño_de_llanta" "character varying(50)"
  "capacidad_de_pasajeros" integer
  "registro_agregado_en" timestamp [not null]
  "número_de_registro_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_carga" numeric
  "información_adicional" text
  "subtipo_de_vehículo" "character varying(32)"
  "número_de_póliza_de_seguro_de_responsabilidad" "character varying(50)"
  "número_de_bastidor" "character varying(32)"
  "id_usuario" integer [not null]
  "tipo_de_vehículo" integer [not null]
  "número_de_chasis" "character varying(32)"
  "número_de_llantas" integer
  "disposición_de_las_llantas" "character varying(16)"
}

Tabla "enlaces_de_etiquetas" {
  "id_entidad" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "tipo_de_entidad" integer [not null]
  "ordinal" integer [not null]
  "id_etiqueta" integer [not null]
}

Tabla "reglas" {
  "id_regla" integer [not null]
  "id_objeto" integer [not null]
  "parámetros" jsonb
  "teléfono_de_alerta" "character varying(210)" [not null]
  "tipo_de_evento" "character varying(100)" [not null]
  "id_cliente" integer [not null]
  "push_habilitado" boolean [not null]
  "comentario_del_evento1" "character varying(255)" [not null]
  "etiqueta_del_evento" "character varying(255)" [not null]
  "descripción" "character varying(255)" [not null]
  "registro_agregado_en" timestamp [not null]
  "sms_de_alerta" text [not null]
  "grupo_de_evento" integer [not null]
  "creado_en" timestamp [not null]
  "máximo" integer [not null]
  "eliminado" boolean [not null]
  "correo_electrónico_de_alerta" text [not null]
  "comentario_del_evento2" "character varying(255)" [not null]
}

Tabla "historial_de_estado" {
  "longitud" numeric
  "id_nuevo_estado" integer
  "id_historial_de_estado" integer [not null]
  "id_dispositivo" integer [not null]
  "actualizado_por" integer [not null]
  "dirección" "character varying(255)"
  "latitud" numeric
  "registro_agregado_en" timestamp [not null]
  "fecha_hora_del_servidor" timestamp [not null]
  "fecha_hora_del_cambio" timestamp
  "id_estado_anterior" integer
}

Tabla "reglas2zonas" {
  "id_zona" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_regla" integer [not null]
}

Tabla "formularios" {
  "id_objeto" integer [not null]
  "descripción" text
  "etiqueta_del_formulario" "character varying(255)" [not null]
  "campos" text
  "creado_en" timestamp [not null]
  "dirección_de_envío" "character varying(255)"
  "latitud_de_envío" numeric
  "id_formulario" integer [not null]
  "longitud_de_envío" numeric
  "el_envío_está_en_la_zona" boolean [not null]
  "valores" text
  "registro_agregado_en" timestamp [not null]
  "id_tarea" integer
  "enviado_en" timestamp
}


Tabla "reglas2objetos" {
  "parámetros_del_objeto" jsonb
  "número_de_grupo_de_parámetros" integer [not null]
  "id_objeto" integer [not null]
  "registro_agregado_en" timestamp [not null]
  "id_regla" integer [not null]
}

Tabla "tareas" {
  "hora_desde" timestamp
  "duración_de_estancia_minutos" interval
  "id_externo" "character varying(100)"
  "id_objeto" integer
  "tipo_de_tarea" integer
  "duración_de_llegada_minutos" interval
  "estado" integer
  "fecha_hora_de_llegada" timestamp
  "registro_agregado_en" timestamp [not null]
  "id_tarea" integer [not null]
  "id_usuario" integer
  "fecha_hora_del_cambio_de_estado" timestamp
  "orden" integer
  "hora_hasta" timestamp
  "retraso_máximo_minutos" integer
  "control_de_estancia_habilitado" boolean
  "dirección" "character varying(255)"
  "etiqueta_de_tarea" "character varying(200)" [not null]
  "longitud" numeric
  "creado_por" integer
  "descripción" text [not null]
  "radio" integer
  "latitud" numeric
  "duración_de_estancia" integer
  "creado_en" timestamp [not null]
  "campos_personalizados" jsonb
  "id_tarea_padre" integer
}

Tabla "campos_bigint_de_lugares" {
  "id_campo" integer [not null]
  "valor" bigint [not null]
  "id_lugar" integer [not null]
  "registro_agregado_en" timestamp [not null]
}

Tabla "dispositivos" {
  "sim_bloqueada" boolean [not null]
  "id_dispositivo" integer [not null]
  "imei_del_dispositivo" "character varying(64)" [not null]
  "etiqueta_de_red" "character varying(50)" [not null]
  "id_listado_de_estado" integer [not null]
  "nivel_de_señal" numeric [not null]
  "teléfono" "character varying(32)" [not null]
  "tiene_roaming" boolean [not null]
  "creado_en" timestamp [not null]
  "id_propietario" integer [not null]
  "registro_agregado_en" timestamp [not null]
}

Tabla "parámetros_de_descripción" {
  "descripción" "character varying(150)"
  "registro_agregado_en" timestamp [not null]
  "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_usuario" integer [not null]
  "configuración_regional" "character varying(10)" [not null]
  "registro_agregado_en" timestamp [not null]
}

Tabla "contadores" {
  "id_sensor" integer
  "multiplicador" numeric [not null]
  "id_contador" integer [not null]
  "id_dispositivo" integer [not null]
  "tipo_de_contador" integer [not null]
  "registro_agregado_en" timestamp [not null]
}

Tabla "empleados" {
  "fecha_de_vigencia_de_licencia_de_conducir" timestamp
  "registro_agregado_en" timestamp [not null]
  "apellido" "character varying(100)"
  "id_departamento" integer
  "número_de_identificación_ciudadana" "character varying(32)"
  "nombre" "character varying(100)"
  "categorías_de_licencia_de_conducir" "character varying(32)"
  "id_usuario" integer [not null]
  "número_de_teléfono" "character varying(32)"
  "id_objeto" integer
  "eliminado" boolean [not null]
  "fecha_de_emisión_de_licencia_de_conducir" boolean
  "clave_de_hardware" "character varying(64)"
  "segundo_nombre" "character varying(100)"
  "dirección" "character varying(255)"
  "latitud" numeric
  "id_empleado" integer [not null]
  "número_de_personal" "character varying(15)"
  "costo_del_combustible" doubleprecision
  "driver_license_number" "character varying(32)"
  "email" "carácter variable(100)"
  "fuel_consumption" doubleprecision
  "radio" integer [not null]
  "longitud" numeric
}

Tabla "places_longtext_fields" {
  "id_campo" integer [not null]
  "valor" text [not null]
  "registro_agregado_en" timestamp [not null]
  "id_lugar" integer [not null]
}

Tabla "groups_objects" {
  "groups_client_id" entero
  "objects_client_id" integer

  Í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]
  "descripción" text
}

Ref:"employees"."employee_id" < "checkins"."employee_id"

Ref:"objetos"."objeto_id" < "checkins"."objeto_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"."id_entidad" < "campos_personalizados"."id_entidad"

Ref:"Departamentos"."id_departamento" < "empleados"."id_departamento"

Ref:"usuarios"."id_usuario" < "Departamentos"."id_usuario"

Ref:"parámetros_de_descripción"."clave" < "contadores"."tipo_de_contador"

Ref:"parámetros_de_descripción"."clave" < "campos_personalizados"."tipo_de_campo_personalizado"

Ref:"parámetros_de_descripción"."clave" < "historial_del_conductor"."actualizado_por"

Ref:"parámetros_de_descripción"."clave" < "entidades"."tipo_integrado"

Ref:"parámetros_de_descripción"."clave" < "descripción_del_sensor"."tipo_de_unidades"

Ref:"parámetros_de_descripción"."clave" < "historial_del_estado"."actualizado_por"

Ref:"parámetros_de_descripción"."clave" < "Tareas"."estado"

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" < "Conductor_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"

Referencia:"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:"Lugares"."Ubicación_id" < "Lugares_bigint_fields"."Ubicación_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" < "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" < "Etiquetas"."user_id"

Ref:"tasks"."task_id" < "task_history"."task_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:"zones"."zone_id" < "users2zones"."zone_id"

Referencia: "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" < "vehicles"."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 principal. Las actualizaciones ocurren de forma incremental a medida que se producen cambios en la base de datos MySQL de origen, por lo general en menos de 5 minutos desde el cambio en el origen.

## `parámetros de descripción`

El sistema incluye datos de referencia para estandarizar los valores en toda la base de datos:

<table><thead><tr><th width="167.1817626953125">Tipo de referencia</th><th width="173.9090576171875">Descripción</th><th>Valores de ejemplo</th></tr></thead><tbody><tr><td>Definiciones de tipo</td><td>Tipos de entidad estándar</td><td><code>vehicle_type: carro, camión, autobús</code></td></tr><tr><td>Códigos de estado</td><td>Valores de estado de la Tarea y del sistema</td><td><code>estado_de_tareas: sin asignar, asignadas, completadas</code></td></tr><tr><td>Definiciones de unidades</td><td>Unidades de medida para sensores</td><td><code>tipo de unidades: litro, galón, celsius</code></td></tr><tr><td>Clasificaciones de entidades</td><td>Categorías de entidades empresariales</td><td><code>entities_type: ubicación, tarea, cliente</code></td></tr></tbody></table>

## Tablas clave por categoría

Las tablas en la **`raw_business_data`** Los esquemas están organizados en categorías funcionales para facilitar la navegación. La tabla a continuación resume las tablas clave según su propósito de negocio:

Entidades centrales de negocio

<details>

<summary><strong><code>usuarios</code></strong></summary>

**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

<table><thead><tr><th width="145">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>user_id</code> - Identificador único de usuario<br>- <code>company_label</code> - Nombre de la empresa asociada con el usuario<br>- <code>first_name</code> - Nombre de usuario<br>- <code>last_name</code> - Apellido del usuario<br>- <code>middle_name</code> - Segundo nombre del usuario<br>- <code>locale</code> - Configuración de idioma del usuario<br>- <code>timezone_label</code> - Zona horaria en formato IANA<br>- <code>master_id</code> - ID de usuario principal (si el actual es un subordinado)<br>- <code>registration_datetime</code> - Fecha de registro en el sistema<br>- <code>birth_date</code> - Fecha de nacimiento del usuario</td></tr><tr><td><strong>Relaciones</strong></td><td>Usuario principal por medio de <code>master_id</code>, vinculado a <code>empleados</code>, <code>Departamentos</code>, <code>Lugares</code>, <code>Tareas</code> hasta <code>user_id</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Entidad central que conecta los datos organizacionales; <code>master_id</code> permite jerarquías de usuarios para estructuras de cuentas multinivel</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>empleados</code></strong></summary>

**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 identificación iButton/RFID y los datos de ubicación con compatibilidad con geocercas

<table><thead><tr><th width="143">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>employee_id</code> - Identificador de la entidad del empleado<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>department_id</code> - Un ID del departamento al que está asignado el empleado<br>- <code>first_name</code> - El atributo first_name de la tabla de empleados<br>- <code>last_name</code> - El atributo last_name de la tabla de empleados<br>- <code>middle_name</code> - El atributo middle_name de la tabla de empleados<br>- <code>número_de_licencia_de_Conductor</code> - Número de licencia de Conductor<br>- <code>categorías de la licencia de conducir</code> - Categorías de la licencia de conducir<br>- <code>fecha de emisión de la licencia de conducir</code> - Fecha de emisión de una licencia de conducir<br>- <code>fecha de vencimiento de la licencia de conducir</code> - Fecha de vencimiento de una licencia de conducir<br>- <code>llave de hardware</code> - Una llave de hardware<br>- <code>correo electrónico</code> - Correo electrónico del empleado<br>- <code>número de teléfono</code> - Teléfono del empleado sin el signo "+"<br>- <code>dirección</code> - Dirección de la ubicación<br>- <code>número de personal</code> - Número de personal del empleado/conductor<br>- <code>número de identificación ciudadana</code> - Número de Seguridad Social<br>- <code>latitud</code> - Ubicación asociada con este empleado<br>- <code>longitud</code> - Ubicación asociada con este empleado<br>- <code>radio</code> - Ubicación asociada con este empleado en metros<br>- <code>consumo_de_Combustible</code> - El atributo fuel_consumption de la tabla employees<br>- <code>costo_del_Combustible</code> - El atributo fuel_cost de la tabla employees<br>- <code>eliminado</code> - El atributo is_deleted de la tabla de empleados</td></tr><tr><td><strong>Relaciones</strong></td><td>Enlaces a <code>usuarios</code>, <code>Departamentos</code>, <code>objects</code> (rastreador asignado), rastreado en <code>historial_del_conductor</code> y <code>registros de entrada</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>La llave de hardware permite la identificación del conductor mediante iButton o RFID; admite zonas con <code>latitud</code>, <code>longitud</code>, <code>radio</code> campos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Departamentos</code></strong></summary>

**Descripción**: Unidades organizacionales con datos de ubicación geográfica (latitud, longitud, radio) que permiten análisis basados en zonas para reportes a nivel de departamento y asociación de ubicación de empleados

<table><thead><tr><th width="156">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>department_id</code> - Identificador de la entidad departamento<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>department_label</code> - El atributo department_label de la tabla Departamentos<br>- <code>latitud</code> - Ubicación asociada con este departamento<br>- <code>longitud</code> - Ubicación asociada con este departamento<br>- <code>radio</code> - Tamaño de la geolocalización en metros<br>- <code>dirección</code> - El atributo de dirección de la tabla Departamentos</td></tr><tr><td><strong>Relaciones</strong></td><td>Vincula a los empleados con la estructura organizacional mediante <code>department_id</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Los campos de ubicación admiten análisis basados en Zona para reportes a nivel de departamento</td></tr></tbody></table>

</details>

Seguimiento y monitoreo

<details>

<summary><strong><code>dispositivos</code></strong></summary>

**Descripción** : registro de dispositivos físicos 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

<table><thead><tr><th width="138">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>device_id</code> - ID del dispositivo<br>- <code>propietario_id</code> - ID del propietario del dispositivo en cuya cuenta se agregó la baliza<br>- <code>device_imei</code> - IMEI del dispositivo<br>- <code>teléfono</code> - El número de la tarjeta SIM del dispositivo<br>- <code>status_listing_id</code> - ID del estado del dispositivo - <code>network_label</code> - El nombre de la red a la que está conectada la tarjeta SIM - <code>signal_level</code> - Intensidad de la señal del dispositivo - <code>has_roaming</code> - Indicador de disponibilidad de roaming - <code>is_sim_blocked</code> - Indicador de bloqueo de la tarjeta SIM - <code>created_at</code> - Fecha y hora en que se creó la entrada</td></tr><tr><td><strong>Relaciones</strong></td><td>Entidad principal vinculada a <code>objects</code>, <code>modelos</code>, <code>descripción del sensor</code>, <code>contadores</code>; <code>propietario_id</code> referencias <code>users.user_id</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Todos los datos telemáticos en <code>raw_telematics_data</code> el esquema hace referencia a esta tabla mediante <code>device_id</code></td></tr></tbody></table>

</details>

<details>

<summary><strong><code>objects</code></strong></summary>

**Descripción**: Registro central de entidades monitoreadas (Gestión de vehículos, activos, personal) que vincula dispositivos físicos con la estructura organizacional mediante client\_id y group\_id, y representa la «unidad rastreable» con un Objeto activo por dispositivo

<table><thead><tr><th width="148">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>client_id</code> - Identificador de la entidad del cliente<br>- <code>device_id</code> - Identificador de la entidad del dispositivo<br>- <code>etiqueta de objeto</code> - Nombre del Objeto<br>- <code>modelo</code> - Modelo del dispositivo<br>- <code>Grupo_id</code> - Grupo de ID de entidad<br>- <code>create_datetime</code> - Fecha y hora de creación de una nueva fila en el servidor<br>- <code>eliminado</code> - El atributo is_deleted de la tabla objects<br>- <code>is_clone</code> - Marca de clonación</td></tr><tr><td><strong>Relaciones</strong></td><td>Centro principal que conecta dispositivos con usuarios (<code>client_id</code>), detalles del vehículo, historial de Seguimiento, Tareas y reglas</td></tr><tr><td><strong>Notas especiales</strong></td><td>Representa la «unidad rastreable» en el sistema; un objeto por dispositivo en uso activo</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>modelos</code></strong></summary>

**Descripción**: Registro central de entidades monitoreadas (Gestión de vehículos, activos, personal) que vincula dispositivos físicos con la estructura organizacional mediante client\_id y group\_id, y representa la «unidad rastreable» con un Objeto activo por dispositivo

<table><thead><tr><th width="135">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>model_id</code> - Identificador del modelo de entidad<br>- <code>modelo</code> - El atributo model de la tabla models<br>- <code>proveedor</code> - El nombre de la empresa que lanzó el rastreador<br>- <code>alternative_label</code> - El atributo alternative_label de la tabla models<br>- <code>analog_amount</code> - Número de entradas analógicas del rastreador<br>- <code>digital_amount</code> - Número de entradas discretas del rastreador<br>- <code>outputs_amount</code> - Número de salidas discretas del rastreador<br>- <code>has_battery_level</code> - Determina si el rastreador transmite lecturas de carga de la batería<br>- <code>has_altitude</code> - Determina si el rastreador transmite la altitud<br>- <code>has_phone</code> - ¿Hay una tarjeta SIM?<br>- <code>has_gsm_level</code> - ¿Puede un rastreador transmitir la intensidad de la señal GSM?<br>- <code>has_gsm_name</code> - ¿Puede el rastreador transmitir el nombre de la red GSM o el código del operador (MCC + MNC)?<br>- <code>has_gsm_roaming</code> - ¿Puede el rastreador transmitir el estado de roaming?<br>- <code>has_detach_button</code> - ¿El rastreador tiene un sensor de extracción?<br>- <code>type_output_control</code> - Perfil de control de salidas del rastreador<br>- <code>type_special_control</code> - Contiene configuraciones especializadas y módulos funcionales para modelos de dispositivo individuales, como el modo de manejo peligroso (hbm_telfm) para equipos Teltonika<br>- <code>is_clone</code> - ¿El modelo es un clon de otro modelo?</td></tr><tr><td><strong>Contenido</strong></td><td>Los indicadores booleanos de capacidad indican qué campos de datos están disponibles en este tipo de dispositivo</td></tr><tr><td><strong>Notas especiales</strong></td><td>Use los indicadores de capacidad para determinar los sensores y entradas válidos al consultar datos telemáticos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>descripción del sensor</code></strong></summary>

**Descripción**: Configuración integral de sensores que vincula las entradas del dispositivo con la lógica de negocio, incluidos los mapeos 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

<table><thead><tr><th width="142">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>sensor_id</code> - Identificador de la entidad del sensor<br>- <code>device_id</code> - Identificador de la entidad del dispositivo<br>- <code>sensor_label</code> - Nombre del sensor para la interfaz de usuario<br>- <code>input_label</code> - 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<br>- <code>sensor_type</code> - Tipo de sensor<br>- <code>units_type</code> - Unidades de medida<br>- <code>multiplier</code> - Multiplicador - el número por el cual multiplicar el valor del campo. Solo para sensores de medición<br>- <code>divider</code> - Divisor - el número por el cual dividir el valor del campo. Solo para sensores de medición<br>- <code>accuracy</code> - Un porcentaje especificado para calcular el error absoluto del volumen del tanque. Este error se usa para determinar cuándo se producen recargas o drenajes. Esto se usa solo para sensores de combustible<br>- <code>calibration_data</code> - El atributo calibration_data de la tabla sensor_description<br>- <code>input_id</code> - Número de entrada para sensor digital<br>- <code>Grupo_id</code> - Los sensores del mismo tipo con el mismo group_id y source_id se consideran parte del mismo Grupo. Sus datos se suman o promedian, según el valor de group_type. Esto es necesario para los sensores agregados. Se usa en los sensores de medición<br>- <code>tipo de grupo</code> - 0 - sumar los valores de los sensores dentro de un Grupo, 1 - promedio<br>- <code>sensor_units</code> - Nombre de la unidad ingresado por el usuario si units_type=0 (personalizado)<br>- <code>parámetros</code> - Objeto opcional con parámetros adicionales: parent_ids, arreglo opcional de parent_ids para un sensor compuesto. volume, double. Opcional. Volumen para un sensor compuesto. parent_ids, opcional. Arreglo de int. Arreglo de parent_ids para un sensor compuesto. volume, opcional. Double. Volumen para un sensor compuesto. min, opcional. Double. Valor mínimo aceptable sin procesar para un sensor. max, opcional. Double. Valor máximo aceptable sin procesar para un sensor. max_lowering_by_time, opcional. Double. Disminución máxima permitida por hora. max_lowering_by_mileage, opcional. Double. Disminución máxima permitida por cada 100 km. ignore_drains_in_move, opcional. Boolean. El valor predeterminado es false. Si es true, no se detectarán los drenajes 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. Tiempo en minutos después del inicio del Movimiento durante el cual se detectarán las recargas mientras el vehículo está en Movimiento. custom_field_name, opcional. Boolean. El valor predeterminado es false. El parámetro determina si el campo input_name contiene un valor personalizado ingresado por el usuario. Esto solo tiene sentido si el modelo del Dispositivo tiene la función has_custom_fields</td></tr><tr><td><strong>Relaciones</strong></td><td>Vincula las entradas del dispositivo (de <code>raw_telematics_data.inputs</code>) a la lógica de negocio mediante <code>device_id</code> y <code>input_label</code> coincidente</td></tr><tr><td><strong>Notas especiales</strong></td><td><code>calibration_data</code> (JSONB) almacena tablas de calibración específicas del sensor para sensores de nivel de combustible; <code>multiplier</code> y <code>divider</code> convertir valores sin procesar a unidades</td></tr></tbody></table>

</details>

Gestión de activos

<details>

<summary><strong><code>vehículos</code></strong></summary>

**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

<table><thead><tr><th width="144">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>vehicle_id</code> - Identificador de entidad del vehículo<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>garage_id</code> - Identificador de entidad del garaje<br>- <code>etiqueta del vehículo</code> - El atributo vehicle_label de la tabla de Gestión de vehículos<br>- <code>registration_number</code> - Número de registro/ Matrícula de un vehículo<br>- <code>VIN</code> - El atributo VIN de la tabla de Gestión de vehículos<br>- <code>año de fabricación</code> - El atributo manufacture_year de la tabla de Gestión de vehículos<br>- <code>tipo_de_combustible</code> - El atributo fuel_type de la tabla Gestión de vehículos<br>- <code>costo_del_Combustible</code> - El atributo fuel_cost de la tabla Gestión de vehículos<br>- <code>volumen_del_tanque_de_combustible</code> - El atributo volumen_del_tanque_de_combustible de la tabla Gestión de vehículos<br>- <code>velocidad máxima</code> - El atributo velocidad_máxima de la tabla Gestión de vehículos<br>- <code>modelo</code> - El atributo modelo de la tabla Gestión de vehículos<br>- <code>color</code> - El atributo color de la tabla Gestión de vehículos<br>- <code>remolque</code> - El atributo remolque de la tabla Gestión de vehículos<br>- <code>información_adicional</code> - El atributo información_adicional de la tabla Gestión de vehículos<br>- <code>vehicle_type</code> - El atributo vehicle_type de la tabla de Gestión de vehículos<br>- <code>vehicle_subtype</code> - El atributo vehicle_subtype de la tabla de Gestión de vehículos<br>- <code>vehicle_status_id</code> - Identificador de entidad de estado del vehículo<br>- <code>chassis_number</code> - El atributo chassis_number de la tabla de Gestión de vehículos<br>- <code>frame_number</code> - El atributo frame_number de la tabla de Gestión de vehículos<br>- <code>trailer_reg_number</code> - El atributo trailer_reg_number de la tabla de Gestión de vehículos<br>- <code>payload_weight</code> - El atributo payload_weight de la tabla de Gestión de vehículos<br>- <code>payload_height</code> - El atributo payload_height de la tabla de Gestión de vehículos<br>- <code>payload_length</code> - El atributo payload_length de la tabla de Gestión de vehículos<br>- <code>payload_width</code> - El atributo payload_width de la tabla de Gestión de vehículos<br>- <code>capacidad_de_pasajeros</code> - Un número máximo de pasajeros<br>- <code>peso_bruto</code> - El atributo peso_bruto de la tabla de vehículos<br>- <code>consumo_estandar_de_combustible</code> - Consumo promedio normal de combustible en litros por cada 100 km<br>- <code>grado_de_combustible</code> - El atributo grado_de_combustible de la tabla de vehículos<br>- <code>configuracion_de_las_ruedas</code> - El atributo configuracion_de_las_ruedas de la tabla de vehículos<br>- <code>tamaño_de_llanta</code> - Tamaño del vehículo: dimensiones y tamaño de las llantas<br>- <code>número_de_llantas</code> - Número de ruedas<br>- <code>número_de_póliza_del_Seguro_de_responsabilidad_civil</code> - El atributo número_de_póliza_del_Seguro_de_responsabilidad_civil de la tabla de Gestión de vehículos<br>- <code>número_de_póliza_del_Seguro_gratuito</code> - La fecha hasta la que es válido el Seguro gratuito<br>- <code>número_de_póliza_del_Seguro_gratuito</code> - El atributo número_de_póliza_del_Seguro_gratuito de la tabla de Gestión de vehículos<br>- <code>fecha_de_vigencia_del_seguro_gratuito_hasta</code> - La fecha hasta la que es válido el seguro gratuito</td></tr><tr><td><strong>Relaciones</strong></td><td>Enlaces a <code>objects</code> (rastreador actual), <code>garajes</code> (ubicación del servicio), <code>tareas_de_servicio_del_vehículo</code>; rastreado en <code>historial_de_rastreadores_del_vehículo</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Los campos de dimensión física (<code>payload_length</code>, <code>payload_width</code>, <code>payload_height</code>, <code>peso_bruto</code>) admiten análisis de planificación de carga; las fechas de seguro permiten el seguimiento del cumplimiento</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>garajes</code></strong></summary>

**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

<table><thead><tr><th width="135">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>garage_id</code> - Identificador de entidad del garaje<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>latitud</code> - Objeto de ubicación<br>- <code>longitud</code> - Objeto de ubicación<br>- <code>radio</code> - Tamaño de la geolocalización en metros<br>- <code>dirección</code> - Objeto de ubicación<br>- <code>etiqueta de organización</code> - ID del Garaje<br>- <code>nombre_del_mecánico</code> - Nombre del mecánico<br>- <code>nombre_del_despachador</code> - Nombre del despachador</td></tr><tr><td><strong>Relaciones</strong></td><td>Referenciado por <code>gestión de vehículos.garage_id</code> para la asignación de la ubicación del servicio</td></tr><tr><td><strong>Notas especiales</strong></td><td>Los campos de ubicación permiten la detección de visitas de servicio basada en Zona y el análisis de proximidad</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>tareas_de_servicio_del_vehículo</code></strong></summary>

**Descripción**: programación de mantenimiento y seguimiento del historial de servicio con múltiples tipos de activadores (basados en fecha, basados en kilometraje, basados en horas del motor), intervalos recurrentes de tareas, notificaciones multicanal (correo electrónico, SMS, push) y distinción entre eventos de mantenimiento planificados (is\_repeat) y no planificados

<table><thead><tr><th width="132">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>service_task_id</code> - Identificador de entidad de tarea de servicio<br>- <code>vehicle_id</code> - Identificador de entidad del vehículo<br>- <code>descripción</code> - El atributo description de la tabla vehicle_service_tareas<br>- <code>estado</code> - El valor de estado del atributo status<br>- <code>costo</code> - El atributo de costo de la tabla vehicle_service_Tareas<br>- <code>fecha_de_inicio</code> - La fecha y la hora asociadas con el atributo start_date<br>- <code>end_date</code> - La fecha y la hora asociadas con el atributo end_date<br>- <code>fecha_de_finalización</code> - La fecha y la hora asociadas con el atributo completion_date<br>- <code>predicted_datetime</code> - La fecha y hora asociadas con el atributo predicted_datetime<br>- <code>límite_de_kilometraje</code> - El atributo mileage_limit de la tabla vehicle_service_tasks<br>- <code>engine_hours_limit</code> - El atributo engine_hours_limit de la tabla vehicle_service_tasks<br>- <code>kilometraje inicial</code> - El atributo start_mileage de la tabla vehicle_service_tasks<br>- <code>horas_de_arranque_del_motor</code> - El atributo start_engine_hours de la tabla vehicle_service_tareas<br>- <code>intervalo de notificación de kilometraje</code> - El atributo mileage_notification_interval de la tabla vehicle_service_tasks<br>- <code>engine_hours_notification_interval</code> - El atributo engine_hours_notification_interval de la tabla vehicle_service_tareas<br>- <code>date_notification_interval</code> - Convirtiendo un entero N a N días<br>- <code>Kilometraje_repeat_interval</code> - El atributo mileage_repeat_interval de la tabla vehicle_service_tasks<br>- <code>engine_hours_repeat_interval</code> - El atributo engine_hours_repeat_interval de la tabla vehicle_service_tasks<br>- <code>date_repeat_interval</code> - Convirtiendo un entero N a N días<br>- <code>correos electrónicos de notificación</code> - El atributo notification_emails de la tabla vehicle_service_tasks<br>- <code>notification_sms_phone_numbers</code> - El atributo notification_sms_phone_numbers de la tabla vehicle_service_Tareas<br>- <code>is_notification_push_enabled</code> - El atributo is_notification_push_enabled de la tabla vehicle_service_tasks<br>- <code>Kilometraje_de_finalización</code> - El atributo completion_mileage de la tabla vehicle_service_tasks<br>- <code>horas del motor al finalizar</code> - El atributo completion_engine_hours de la tabla vehicle_service_tasks<br>- <code>es_repetido</code> - El atributo is_repeat de la tabla vehicle_service_tasks<br>- <code>no_planificado</code> - El atributo is_unplanned de la tabla vehicle_service_tasks<br>- <code>comentario</code> - El atributo de comentario de la tabla vehicle_service_tasks</td></tr><tr><td><strong>Contenido</strong></td><td>Admite tres tipos de activación: por fecha, por Kilometraje y por horas del motor; ajustes de notificación para correo electrónico, SMS y push</td></tr><tr><td><strong>Notas especiales</strong></td><td><code>es_repetido</code> y los campos de intervalo permiten programaciones de Mantenimiento recurrentes; <code>no_planificado</code> distingue entre mantenimiento programado y reactivo</td></tr></tbody></table>

</details>

Ubicación y enrutamiento

<details>

<summary><strong><code>zonas</code></strong></summary>

**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/activo, con automatización basada en reglas y análisis de ubicación con codificación por colores para diferenciación visual

<table><thead><tr><th width="150">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>zone_id</code> - Identificador de la entidad de la zona<br>- <code>client_id</code> - Identificador de la entidad del cliente<br>- <code>zone_label</code> - El atributo zone_label de la tabla de zonas<br>- <code>zone_type</code> - El atributo zone_type de la tabla de zonas<br>- <code>latitud</code> - Objeto opcional, el cuadro delimitador que puede contener completamente el resultado devuelto<br>- <code>longitud</code> - Objeto opcional, el cuadro delimitador que puede contener completamente el resultado devuelto<br>- <code>circle_center_latitude</code> - El atributo circle_center_latitude de la tabla de zonas<br>- <code>circle_center_longitude</code> - El atributo circle_center_longitude de la tabla zones<br>- <code>radio</code> - Tamaño de la geolocalización en metros<br>- <code>dirección</code> - El atributo de dirección de la tabla de zonas<br>- <code>color</code> - El atributo de color de la tabla de zonas</td></tr><tr><td><strong>Contenido</strong></td><td>Los tipos de zona incluyen círculo, polígono (definido mediante <code>puntos_de_zona</code>), y clasificaciones de áreas especiales</td></tr><tr><td><strong>Relaciones</strong></td><td>Referenciado por <code>reglas2zonas</code>, <code>users2zones</code>; vértices del polígono almacenados en <code>puntos_de_zona</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Las funciones de PostGIS se pueden usar para comprobar si un punto está dentro de un polígono para análisis complejos de Zona</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Lugares</code></strong></summary>

**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

<table><thead><tr><th width="129">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>ubicación_id</code> - Identificador de la entidad de ubicación<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>etiqueta_de_ubicación</code> - El atributo etiqueta_de_ubicación de la tabla de Lugares<br>- <code>latitud</code> - Objeto de ubicación<br>- <code>longitud</code> - Objeto de ubicación<br>- <code>radio</code> - Tamaño de la geolocalización en metros<br>- <code>dirección</code> - El atributo de dirección de la tabla de Lugares<br>- <code>descripción</code> - El atributo de descripción de la tabla de Lugares<br>- <code>external_id</code> - ID para la integración con sistemas externos (CRM)<br>- <code>custom_fields</code> - Campos adicionales<br>- <code>assigned_datetime</code> - Fecha y hora de asignación del punto de interés al usuario</td></tr><tr><td><strong>Relaciones</strong></td><td>Ampliado con valores de campos personalizados mediante <code>lugares_campos_de_texto</code>, <code>Lugares_campos_decimales</code>, <code>Lugares_bigint_fields</code>, <code>campos_de_texto_largo_de_lugares</code>, <code>Lugares_campos_de_entidad_vinculada</code></td></tr><tr><td><strong>Notas especiales</strong></td><td><code>custom_fields</code> JSONB proporciona acceso rápido; las tablas relacionadas permiten filtrar y ordenar por atributos personalizados</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>puntos_de_zona</code></strong></summary>

**Descripción**: Coordenadas ordenadas de vértices (el campo numérico determina la secuencia) que definen los límites de la zona para formas complejas de geocerca, lo que permite perímetros geográficos precisos más allá de zonas circulares simples, usadas con PostGIS ST\_MakePolygon para operaciones geométricas

<table><thead><tr><th width="133">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>zone_id</code> - Un ID de la zona a la que está adjunto<br>- <code>número</code> - Número de serie<br>- <code>latitud</code> - Ubicación<br>- <code>longitud</code> - Ubicación</td></tr><tr><td><strong>Relaciones</strong></td><td>Múltiples registros por <code>zone_id</code> definen los límites del polígono; <code>número</code> el campo determina el orden de los vértices</td></tr><tr><td><strong>Notas especiales</strong></td><td>Consultar con <code>ORDER BY número</code> para reconstruir el contorno del polígono; úselo con PostGIS ST_MakePolygon para operaciones geométricas</td></tr></tbody></table>

</details>

Gestión de Tarea y flujo de trabajo

<details>

<summary><strong><code>Tareas</code></strong></summary>

**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 del Servicio de campo y las operaciones de entrega

<table><thead><tr><th width="130">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>id_tarea</code> - Identificador de la entidad de tarea<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>id_de_tarea_padre</code> - Identificador de la entidad de la tarea principal<br>- <code>etiqueta de tarea</code> - El atributo task_label de la tabla de Tareas<br>- <code>estado</code> - El valor de estado del atributo status<br>- <code>tipo de tarea</code> - Tipo de tarea, tarea, ruta o punto de chequeo<br>- <code>latitud</code> - El atributo de latitud de la tabla de Tareas<br>- <code>longitud</code> - El atributo de longitud de la tabla de Tareas<br>- <code>radio</code> - Tamaño de la geolocalización en metros<br>- <code>arrival_datetime</code> - Cuando el Dispositivo llega al área de la Tarea. SE IGNORA al crear/actualizar<br>- <code>created_at</code> - El atributo created_at de la tabla Tareas<br>- <code>status_change_datetime</code> - Fecha y hora de actualización de la tarea<br>- <code>time_from</code> - La fecha y hora asociadas al atributo time_from<br>- <code>time_to</code> - La fecha y hora asociadas al atributo time_to<br>- <code>stay_duration</code> - El atributo stay_duration de la tabla de tareas<br>- <code>stay_duration_minutes</code> - 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. Las visitas múltiples se acumulan<br>- <code>arrival_duration_minutes</code> - Ignore las visitas aleatorias más cortas que la duración especificada. Al calcular la duración mínima, las visitas más cortas que la duración especificada se ignorarán<br>- <code>max_delay_minuts</code> - Retraso aceptable. La cantidad máxima de tiempo que un empleado puede llegar tarde. Cualquier tarea completada durante este tiempo se marcará como «tarde»<br>- <code>is_stay_control_enabled</code> - El atributo is_stay_control_enabled de la tabla de tareas<br>- <code>dirección</code> - El atributo address de la tabla de tareas<br>- <code>descripción</code> - El atributo Description de la tabla de tareas<br>- <code>custom_fields</code> - El atributo custom_fields de la tabla de tareas<br>- <code>external_id</code> - Identificador de entidad externa<br>- <code>order_sort</code> - El atributo order_sort de la tabla de tareas<br>- <code>created_by</code> - Origen de la tarea creada</td></tr><tr><td><strong>Contenido</strong></td><td>Admite Tareas jerárquicas mediante <code>id_de_tarea_padre</code>; ventanas de tiempo definidas por <code>time_from</code>/<code>time_to</code>; validación de zona con ubicación y radio</td></tr><tr><td><strong>Relaciones</strong></td><td>Enlaces a <code>formularios</code> (recolección de datos), <code>historial de tareas</code> (cambios de estado), <code>objects</code> (rastreador asignado)</td></tr><tr><td><strong>Notas especiales</strong></td><td><code>stay_duration</code> y <code>arrival_duration_minutes</code> activar el monitoreo del cumplimiento para las tareas de entrega y servicio</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>formularios</code></strong></summary>

**Descripción**: Formularios configurables de recopilación de datos para capturar información estructurada durante la finalización de Tareas 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 obligatorios de envío cuando se adjuntan a Tareas

<table><thead><tr><th width="141">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>id_formulario</code> - Identificador de entidad del formulario<br>- <code>id_tarea</code> - Un ID de la tarea a la que está adjunto este Formulario<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>etiqueta del formulario</code> - Etiqueta de formulario definida por el usuario<br>- <code>campos</code> - Si es verdadero, el Formulario solo puede enviarse en la zona de Tarea<br>- <code>valores</code> - Un mapa con identificadores de campo como claves y objetos field_value como valores. Clave usada para vincular el campo y su valor correspondiente<br>- <code>submitted_at</code> - Fecha en que se enviaron por última vez los valores del formulario<br>- <code>submission_latitude</code> - Ubicación en la que se enviaron por última vez los valores del formulario<br>- <code>submission_longitude</code> - Ubicación en la que se enviaron por última vez los valores del formulario<br>- <code>submission_address</code> - Ubicación en la que se enviaron por última vez los valores del formulario<br>- <code>is_submission_in_zone</code> - Si es verdadero, el Formulario solo puede enviarse en la zona de Tarea<br>- <code>descripción</code> - Fecha en que se creó este formulario (o se adjuntó a la Tarea)<br>- <code>created_at</code> - Fecha en que se creó este formulario (o se adjuntó a la Tarea)</td></tr><tr><td><strong>Contenido</strong></td><td><code>campos</code> define la estructura del formulario (JSON); <code>valores</code> contiene los datos enviados (JSON)</td></tr><tr><td><strong>Relaciones</strong></td><td>Enlaces a <code>Tareas</code> (orden de trabajo asociada), <code>objects</code> (solicitante), referenciado en <code>registros de entrada</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Indicador de validación de ubicación <code>is_submission_in_zone</code> habilita las reglas de envío de Formularios basadas en Zona</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>registros de entrada</code></strong></summary>

**Descripción**: Registros de asistencia y actividad basados en la ubicación enviados mediante la aplicación móvil, que hacen 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 reportes de puntualidad

<table><thead><tr><th width="129">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>checkin_id</code> - Identificador de la entidad de check-in<br>- <code>employee_id</code> - El identificador de la entidad de empleado también es el identificador de Conductores<br>- <code>object_id</code> - Dispositivo del empleado<br>- <code>id_formulario</code> - Identificador de entidad del formulario<br>- <code>user_id</code> - Usuario del empleado<br>- <code>planned_datetime</code> - Hora del dispositivo cuando se realizó el check-in<br>- <code>actual_datetime</code> - Hora del servidor cuando se procesó la solicitud/mensaje<br>- <code>latitud</code> - Ubicación en la que se enviaron los check-ins<br>- <code>longitud</code> - Ubicación en la que se enviaron los check-ins<br>- <code>radio</code> - Error de posicionamiento en un punto, en metros<br>- <code>dirección</code> - Dirección del check-in<br>- <code>comentario</code> - El atributo comment de la tabla checkins</td></tr><tr><td><strong>Relaciones</strong></td><td>Conecta a los empleados con formularios y ubicaciones; rastrea la desviación del horario planificado</td></tr><tr><td><strong>Notas especiales</strong></td><td>Variación de tiempo entre <code>planned_datetime</code> y <code>actual_datetime</code> permite generar reportes de puntualidad; el radio define la tolerancia de ubicación aceptable</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>historial de tareas</code></strong></summary>

**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

<table><thead><tr><th width="137">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>id_del_historial_de_tareas</code> - Identificador de la entidad del historial de Tarea<br>- <code>id_tarea</code> - Identificador de la entidad de tarea<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>actividad</code> - Operación que ocurrió. Puede ser "create", "update", "assign" o "status_change"<br>- <code>event_datetime</code> - Fecha y hora del evento<br>- <code>carga útil</code> - Depende de la operación. Por lo general, contiene los campos que se modificaron durante la operación</td></tr><tr><td><strong>Contenido</strong></td><td>Tipos de actividad definidos en <code>parámetros de descripción</code>; <code>carga útil</code> almacena detalles específicos del evento (texto)</td></tr><tr><td><strong>Notas especiales</strong></td><td>Esencial para el análisis de finalización de tareas, la elaboración de reportes de transición de estados y el seguimiento de actividad del usuario</td></tr></tbody></table>

</details>

Reglas y automatización

<details>

<summary><strong><code>reglas</code></strong></summary>

**Descripción**: Reglas de detección de eventos con condiciones de activación configurables (exceso de velocidad, violaciones de 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

<table><thead><tr><th width="131">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>rule_id</code> - Identificador de la entidad de regla<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>client_id</code> - Identificador de la entidad del cliente<br>- <code>event_type</code> - El atributo event_type de la tabla de reglas<br>- <code>event_label</code> - El atributo event_label de la tabla de reglas<br>- <code>Grupo de eventos</code> - El atributo event_group de la tabla de reglas<br>- <code>descripción</code> - Atributo de descripción de la tabla de reglas<br>- <code>parámetros</code> - Parámetros del evento. Para más detalles sobre los parámetros disponibles, consulte <a href="https://www.navixy.com/docs/navixy-api/user-api/resources/tracking/tracker/rules/rule_types/">Documentación de la API de Navixy</a>.<br>- <code>correo electrónico de alerta</code> - Correo para notificaciones<br>- <code>alert_sms</code> - Números de teléfono para notificaciones por SMS<br>- <code>alert_phone</code> - Teléfonos para llamadas de voz<br>- <code>is_push_enabled</code> - Si es verdadero, las notificaciones push están disponibles<br>- <code>created_at</code> - El atributo created_at de la tabla de reglas<br>- <code>eliminado</code> - El atributo is_deleted de la tabla de reglas<br>- <code>máximo</code> - Límites aplicados a varias reglas. Por ejemplo, para la regla de tiempo en ralentí con el motor en marcha, en minutos<br>- <code>event_comment1</code> - El atributo event_comment1 de la tabla de reglas<br>- <code>event_comment2</code> - El atributo event_comment2 de la tabla de reglas</td></tr><tr><td><strong>Contenido</strong></td><td>Los parámetros de la regla (JSONB) definen las condiciones de activación; admite notificaciones por correo electrónico, SMS, teléfono y push</td></tr><tr><td><strong>Relaciones</strong></td><td>Enlaces a objetos mediante <code>rules2objects</code>, zonas mediante <code>reglas2zonas</code></td></tr><tr><td><strong>Notas especiales</strong></td><td><code>event_type</code> define un escenario específico de monitoreo (exceso de velocidad, violación de Zona, umbral del sensor); <code>máximo</code> el campo permite la agregación de eventos para alertas basadas en umbrales</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2objects</code></strong></summary>

**Descripción**: Relación de muchos a muchos que vincula las reglas con los 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

<table><thead><tr><th width="140">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>rule_id</code> - Identificador de la entidad de regla<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>param_Grupo_número</code> - El atributo param_group_number de la tabla rules2objects<br>- <code>objeto_params</code> - El atributo object_params de la tabla rules2objects</td></tr><tr><td><strong>Contenido</strong></td><td><code>objeto_params</code> (JSONB) permite la personalización de reglas por Objeto (p. ej., distintos límites de velocidad por vehículo)</td></tr><tr><td><strong>Notas especiales</strong></td><td>La relación de muchos a muchos permite que una regla monitoree múltiples objetos con distintos parámetros</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>reglas2zonas</code></strong></summary>

**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

<table><thead><tr><th width="144">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>rule_id</code> - Identificador de la entidad de regla<br>- <code>zone_id</code> - Identificador de entidad de zona</td></tr><tr><td><strong>Notas especiales</strong></td><td>La relación de muchos a muchos permite el monitoreo de varias zonas para una sola regla (p. ej., alerta al entrar en cualquiera de varias áreas restringidas)</td></tr></tbody></table>

</details>

Estado y categorización

<details>

<summary><strong><code>estados</code></strong></summary>

**Descripción**: Definiciones personalizadas de estados dentro de los listados de estados, incluidas propiedades de visualización (color para mostrar en el sitio web, order\_sort para el posicionamiento) usadas para representar estados de trabajo de dispositivos o empleados, con compatibilidad con eliminación lógica mediante la marca is\_deleted

<table><thead><tr><th width="128">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>status_id</code> - Identificador de la entidad de estado<br>- <code>listing_id</code> - Identificador de la entidad de listado<br>- <code>status_label</code> - Valor de estado del atributo status_label<br>- <code>color</code> - Color usado para mostrar en el sitio web<br>- <code>order_sort</code> - Posición de orden dentro del listado de estados<br>- <code>eliminado</code> - El atributo is_deleted de la tabla de estados</td></tr><tr><td><strong>Relaciones</strong></td><td>Grupos de estados organizados por <code>listing_id</code> (referencias <code>status_listings</code>); se usa en <code>status_history</code></td></tr><tr><td><strong>Notas especiales</strong></td><td><code>order_sort</code> define la secuencia de visualización; el color permite la diferenciación visual en los reportes</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_listings</code></strong></summary>

**Descripción**: Definiciones de conjuntos de estados que controlan qué valores de estado están disponibles para dispositivos o empleados, con indicadores de permiso (is\_supervisor\_controlled, is\_employee\_controlled) que determinan si los supervisores, los empleados o ambos pueden cambiar los valores de estado

<table><thead><tr><th width="144">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>status_listing_id</code> - Identificador de la entidad de listado de estados<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>status_listing_label</code> - Valor del estado del atributo status_listing_label<br>- <code>is_supervisor_controlled</code> - Si es verdadero, los supervisores pueden cambiar el estado de trabajo, por ejemplo, usando la aplicación móvil de monitoreo<br>- <code>is_employee_controlled</code> - Si es verdadero, los empleados pueden cambiar su propio estado de trabajo, por ejemplo, usando la aplicación móvil de seguimiento<br>- <code>eliminado</code> - El atributo is_deleted de la tabla status_listings</td></tr><tr><td><strong>Relaciones</strong></td><td>Referenciado por <code>devices.status_listing_id</code> y <code>statuses.listing_id</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Las banderas de control determinan quién puede cambiar los estados: solo el supervisor, autoservicio del empleado o ambos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_history</code></strong></summary>

**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 del usuario (updated\_by) y captura de ubicación (latitud, longitud, dirección), lo que permite el análisis geográfico de los cambios de estado y la elaboración de reportes de ubicación de inicio y fin de la jornada laboral

<table><thead><tr><th width="143">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>status_history_id</code> - Identificador de la entidad del historial de estado<br>- <code>device_id</code> - Identificador de la entidad del dispositivo<br>- <code>old_status_id</code> - Identificador de la entidad del estado anterior<br>- <code>new_status_id</code> - Identificador de la entidad del estado nuevo<br>- <code>updated_by</code> - La fecha y hora asociadas con el atributo updated_by<br>- <code>changed_datetime</code> - Fecha y hora de asignación de un nuevo estado en el dispositivo<br>- <code>server_datetime</code> - Fecha y hora de asignación del nuevo estado del servidor<br>- <code>latitud</code> - Localización de dispositivos durante cambios de estado<br>- <code>longitud</code> - Localización de dispositivos durante cambios de estado<br>- <code>dirección</code> - Localización de dispositivos durante cambios de estado</td></tr><tr><td><strong>Relaciones</strong></td><td>Enlaces a <code>dispositivos</code>, <code>estados</code> (antiguo y nuevo), <code>parámetros de descripción</code> (para <code>updated_by</code> Papel)</td></tr><tr><td><strong>Notas especiales</strong></td><td>La captura de ubicación permite el análisis geográfico de las transiciones de estado; útil para reportes de ubicación al inicio y al final de la jornada laboral</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Etiquetas</code></strong></summary>

**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

<table><thead><tr><th width="149">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>id_de_etiqueta</code> - Etiqueta de ID de entidad<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>Etiqueta</code> - El atributo tag_label de la tabla Etiquetas<br>- <code>color</code> - El atributo de color de la tabla de Etiquetas</td></tr><tr><td><strong>Relaciones</strong></td><td>Aplicado a las entidades mediante <code>enlaces_de_etiqueta</code>; alcance definido por el usuario</td></tr><tr><td><strong>Notas especiales</strong></td><td>Sistema flexible de categorización que admite múltiples etiquetas por entidad</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>enlaces_de_etiqueta</code></strong></summary>

**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 para múltiples entidades

<table><thead><tr><th width="127">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>id_de_etiqueta</code> - Etiqueta de ID de entidad<br>- <code>tipo de entidad</code> - El atributo entity_type de la tabla tag_links<br>- <code>entity_id</code> - Identificador de entidad<br>- <code>ordinal</code> - El atributo ordinal de la tabla tag_links</td></tr><tr><td><strong>Contenido</strong></td><td><code>tipo de entidad</code> identifica la tabla (vehículo, empleado, Tarea, etc.); <code>ordinal</code> define el orden de visualización</td></tr><tr><td><strong>Notas especiales</strong></td><td>La relación polimórfica permite el etiquetado entre distintos tipos de entidades</td></tr></tbody></table>

</details>

Grupos y jerarquía

<details>

<summary><strong><code>grupos</code></strong></summary>

**Descripción**: Estructura de agrupación organizativa para rastreadores que permite una organización visual en la interfaz de usuario con colores personalizables (group\_color) y una gestión jerárquica similar a la de carpetas, que actualmente cumple una función puramente visual

<table><thead><tr><th width="148">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>Grupo_id</code> - Grupo de Dispositivo (vinculado por objects.group_id). La división en grupos se puede ver en la lista de balizas, por ejemplo<br>- <code>client_id</code> - Identificador de la entidad del cliente<br>- <code>etiqueta de Grupo</code> - Título de grupo especificado por el usuario, de 1 a 60 caracteres imprimibles, por ejemplo, «Empleados»<br>- <code>grupo_color</code> - Color del Grupo en formato web (sin #), por ejemplo "FF6DDC". Determina el color de los marcadores del rastreador en el mapa</td></tr><tr><td><strong>Relaciones</strong></td><td>Referenciado por <code>objects.group_id</code>; propiedad del cliente a través de <code>client_id</code> (referencias <code>usuarios</code>)</td></tr><tr><td><strong>Notas especiales</strong></td><td>Permite organizar las entidades de monitoreo como carpetas para reportes y permisos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>groups_objects</code></strong></summary>

**Descripción**: Relación de muchos a muchos entre grupos y objetos usando 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

<table><thead><tr><th width="135">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>groups_client_id</code> - Identificador de la entidad del cliente para grupos<br>- <code>objects_client_id</code> - Identificador de la entidad del cliente para objetos</td></tr><tr><td><strong>Notas especiales</strong></td><td>Permite que los objetos pertenezcan simultáneamente a varios grupos; consulte con ambos <code>client_id</code> valores para la pertenencia al grupo</td></tr></tbody></table>

</details>

Campos personalizados y entidades

<details>

<summary><strong><code>entidades</code></strong></summary>

**Descripción**: Registro de tipos de entidad que define qué entidades de negocio admiten Campos personalizados y la estructura de diseño de sus campos (sections, field\_order) almacenada en entity\_label (JSONB), lo que permite la extensión dinámica del esquema en Lugares, Tareas y otras entidades sin cambios en la base de datos

<table><thead><tr><th width="141">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>entity_id</code> - Identificador de entidad<br>- <code>user_id</code> - Identificador de la entidad de usuario<br>- <code>entity_label</code> - id - int. Identificador de la entidad. type - enum. Actualmente, solo "ubicación" es compatible. layout - objeto describe la estructura 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 layout. label - string. Nombre de la sección. field_order - arreglo de cadenas. Campos integrados e identificadores de Campos personalizados (como cadenas)<br>- <code>builtin_type</code> - El atributo builtin_type de la tabla entities</td></tr><tr><td><strong>Relaciones</strong></td><td>Referenciado por <code>custom_fields</code> para definir qué Campos personalizados se aplican a qué tipos de entidad</td></tr><tr><td><strong>Notas especiales</strong></td><td><code>builtin_type</code> se vincula con <code>parámetros de descripción</code> para clasificaciones de entidad definidas por el sistema</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>custom_fields</code></strong></summary>

**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

<table><thead><tr><th width="146">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>custom_field_id</code> - Identificador de la entidad del campo personalizado<br>- <code>entity_id</code> - Identificador de entidad<br>- <code>custom_field_label</code> - Nombre del campo<br>- <code>custom_field_type</code> - Tipo de dato en el campo<br>- <code>descripción</code> - Descripción del campo<br>- <code>is_required</code> - ¿Es obligatorio o no?<br>- <code>parámetros</code> - Parámetros del campo</td></tr><tr><td><strong>Contenido</strong></td><td><code>parámetros</code> (JSONB) almacena la configuración específica del tipo de campo (reglas de validación, opciones del menú desplegable, etc.)</td></tr><tr><td><strong>Relaciones</strong></td><td>Define los atributos personalizados disponibles para las entidades; el tipo de campo enlaza con <code>parámetros de descripción</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Permite la extensión dinámica del esquema sin cambios en la base de datos; se utiliza ampliamente en <code>Lugares</code> y <code>Tareas</code></td></tr></tbody></table>

</details>

Seguimiento histórico

<details>

<summary><strong><code>historial_del_conductor</code></strong></summary>

**Descripción**: Historial de auditoría completo de las asignaciones de empleado a Gestión de vehículos 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 los conductores cambian entre Gestión de vehículos

<table><thead><tr><th width="146">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>driver_history_id</code> - Identificador de la entidad de historial del conductor<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>old_employee_id</code> - Identificador anterior de la entidad de empleado<br>- <code>nuevo_id_de_empleado</code> - Identificador de la entidad del nuevo empleado<br>- <code>llave de hardware</code> - El atributo hardware_key de la tabla driver_history<br>- <code>changed_datetime</code> - Se realizaron cambios de fecha y hora en el dispositivo<br>- <code>server_datetime</code> - Fecha y hora de los cambios realizados en el servidor<br>- <code>updated_by</code> - La fecha y hora asociadas con el atributo updated_by<br>- <code>latitud</code> - El atributo de latitud de la tabla historial del conductor<br>- <code>longitud</code> - El atributo de longitud de la tabla conductor_history<br>- <code>dirección</code> - El atributo de dirección de la tabla driver_history</td></tr><tr><td><strong>Relaciones</strong></td><td>Rastrea las asignaciones de Conductor a Gestión de vehículos a lo largo del tiempo; enlaza con <code>empleados</code> y <code>objects</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Esencial para reportes específicos por conductor cuando los conductores cambian de Gestión de vehículos; la captura de ubicación permite analizar la ubicación del cambio de asignación</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>historial_de_rastreadores_del_vehículo</code></strong></summary>

**Descripción**: Seguimiento de auditoría que registra qué dispositivos GPS (object\_id) se instalaron en qué vehículos (vehicle\_id) de Gestión de vehículos 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 vehículos

<table><thead><tr><th width="144">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>vehicle_tracker_history_id</code> - Identificador de entidad del historial del rastreador del vehículo<br>- <code>vehicle_id</code> - Identificador de entidad del vehículo<br>- <code>object_id</code> - Objeto identificador de entidad<br>- <code>changed_datetime</code> - La fecha y la hora asociadas al atributo changed_datetime</td></tr><tr><td><strong>Relaciones</strong></td><td>Registra qué dispositivo GPS se instaló en qué vehículo a lo largo del tiempo</td></tr><tr><td><strong>Notas especiales</strong></td><td>Crítico para el análisis de datos históricos cuando los rastreadores se mueven entre Gestión de vehículos; permite una atribución precisa del Kilometraje y del uso</td></tr></tbody></table>

</details>

Datos de referencia y consulta

<details>

<summary><strong><code>parámetros de descripción</code></strong></summary>

**Descripción**: Datos de referencia de todo el sistema que proporcionan etiquetas legibles para las personas (descripción) para valores enteros enumerados (clave) utilizados en toda la base de datos, organizados por campo de tipo (p. ej., task\_status, fuel\_type, counter\_type, entity\_classification) para traducir los valores de manera coherente en los reportes y la interfaz de usuario

<table><thead><tr><th width="146">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>clave</code> - Valor posible en el atributo<br>- <code>tipo</code> - 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<br>- <code>descripción</code> - Valor implícito de un atributo</td></tr><tr><td><strong>Contenido</strong></td><td>Proporciona etiquetas legibles para los valores codificados en toda la base de datos (estado de la tarea, tipos de combustible, tipos de contador, etc.)</td></tr><tr><td><strong>Relaciones</strong></td><td>Referenciado mediante claves foráneas desde varias tablas para una categorización estandarizada</td></tr><tr><td><strong>Notas especiales</strong></td><td>Esencial para traducir códigos enteros a valores legibles en reportes; <code>tipo</code> enumeraciones relacionadas con grupos de campos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>contadores</code></strong></summary>

**Descripción**: configuraciones de Odómetro y del contador de horas de 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, millas, horas) y counter\_type de description\_parameters que define el tipo de medición

<table><thead><tr><th width="140">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>counter_id</code> - ID interno<br>- <code>device_id</code> - Identificador de la entidad del dispositivo<br>- <code>counter_type</code> - Tipo de contador<br>- <code>sensor_id</code> - Identificador de la entidad del sensor<br>- <code>multiplier</code> - Coeficiente para convertir valores en una de las métricas (km, l, etc.)</td></tr><tr><td><strong>Relaciones</strong></td><td>Vincula los dispositivos con lecturas de sensores que representan contadores de distancia o tiempo</td></tr><tr><td><strong>Notas especiales</strong></td><td><code>multiplier</code> convierte los pulsos del sensor en unidades reales (km, millas, horas); <code>counter_type</code> de <code>parámetros de descripción</code> define el tipo de medición</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_output_name</code></strong></summary>

**Descripción**: Etiquetas personalizadas para canales de salida del dispositivo que asignan identificadores numéricos de salida (number) a nombres definidos por el usuario (label) como «Cierre de puerta» o «Bloqueo del motor» para generar reportes legibles y analizar comandos y estados de salida del dispositivo

<table><thead><tr><th width="140">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>device_id</code> - Identificador de la entidad del dispositivo<br>- <code>número</code> - El atributo number de la tabla device_output_name<br>- <code>label</code> - El atributo label de la tabla device_output_name</td></tr><tr><td><strong>Contenido</strong></td><td>Asigna los números de los canales de salida a nombres definidos por el usuario (p. ej., «Cierre de puerta», «Bloqueo del motor»)</td></tr><tr><td><strong>Notas especiales</strong></td><td>Permite generar reportes legibles al analizar comandos y estados de salida del dispositivo</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_settings</code></strong></summary>

**Descripción**: Pares clave-valor de configuración del dispositivo sincronizados desde la plataforma de origen. Cada fila almacena un parámetro de configuración para un dispositivo específico.

<table><thead><tr><th width="140">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>device_id</code> - Identificador de la entidad del dispositivo<br>- <code>clave</code> - Nombre del parámetro<br>- <code>value</code> - Valor del parámetro</td></tr><tr><td><strong>Clave primaria</strong></td><td>Compuesto: <code>(device_id, key)</code></td></tr><tr><td><strong>Notas especiales</strong></td><td>Se llena 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.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>event_description</code></strong></summary>

**Descripción**: Tabla de referencia de códigos de eventos del rastreador con descripciones legibles. Contiene 134 registros que abarcan eventos comunes del rastreador como SOS, Modo ahorro energía, Ignición y cambios en la entrada/salida digital.

<table><thead><tr><th width="140">Atributo</th><th>Detalles</th></tr></thead><tbody><tr><td><strong>Campos clave</strong></td><td>- <code>event_id</code> - Código del evento (clave primaria)<br>- <code>descripción</code> - Nombre del evento legible</td></tr><tr><td><strong>Notas especiales</strong></td><td>Unir con <code>raw_telematics_data.tracking_data_core</code> en <code>event_id</code> para mostrar los nombres de los eventos en los reportes y paneles de control en lugar de códigos numéricos.</td></tr></tbody></table>

</details>


---

# 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=<question>&goal=<user_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.
