Documentación de campos

1. Campos de la actividad base

Campos heredados de la actividad que representan la ejecución de la marcación o ronda interna.

• ss.*: Conjunto de campos propios de la actividad ejecutada, que contienen información operativa de la marcación (fecha, hora, dispositivo, ubicación, entre otros datos técnicos de ejecución).

2. Campos de identificación de planeación

Identificadores que relacionan la marcación con su planeación, ronda, subpunto y usuarios involucrados.

• id_account_customer_subpoint_planeacion_tag: Identificador único del registro de planeación del punto de marcación.

• id_ronda: Identificador de la ronda interna a la que pertenece el punto de marcación.

• id_account_customer_subpoint_tag: Identificador del subpunto del cliente asociado a la marcación.

• id_turno_jornada: Identificador del turno o jornada asignada a la marcación.

• id_assigned_user: Identificador del usuario asignado para realizar la marcación.

• id_user_done: Identificador del usuario que ejecutó efectivamente la marcación.

3. Campos de fechas de planeación

Fechas asociadas a la planificación de la marcación.

• plan_start_at: Fecha y hora planificada de inicio de la marcación.

• plan_done_at: Fecha y hora planificada de finalización de la marcación.

• plan_created_at: Fecha y hora de creación del registro de planeación.

• plan_created_by: Identificador del usuario que creó la planeación.

• plan_id_account: Identificador de la cuenta asociada a la planeación.

4. Campos de ejecución y alertas

Información relacionada con la ejecución real de la marcación y eventos asociados.

• id_survey_solution_subpoint_tag: Identificador de la solución de encuesta o subpunto ejecutado durante la marcación.

• alert_failure_at: Fecha y hora en que se generó una alerta de fallo asociada a la marcación.

5. Campos de fraude (valores en metros)

Valores numéricos que representan desviaciones o inconsistencias detectadas durante la ejecución.

• cheat_position_meters: Distancia en metros que excede la geocerca del cliente, asociada a fraude por ubicación fuera del perímetro permitido.

• cheat_proximity_meters: Distancia en metros asociada a fraude por desplazamiento o diferencia entre la posición planificada y la ejecutada.

• cheat_tolerance_meters: Distancia en metros que excede el umbral de tolerancia permitido para la marcación.

• cheat_altitude_meters: Diferencia en metros de altitud entre la posición planificada y la posición ejecutada.

6. Campos de estado calculados

Campos derivados que resumen el resultado de la marcación.

• estado_de_marcacion: Estado general de la marcación. Puede tomar los valores:

  • REALIZADO: Cuando la marcación fue ejecutada.

  • NO REALIZADO: Cuando la marcación no fue ejecutada.

7. Campos de fraude calculados

Indicadores lógicos derivados de los valores de fraude detectados.

• fraude_umbral: Indica si existe fraude por superar el umbral de tolerancia (Si, No o NULL).

• fraude_geocerca: Indica si existe fraude por geocerca del cliente (Si, No o NULL).

• fraude_desplazamiento: Indica si existe fraude por desplazamiento (Si, No o NULL).

• fraude_altitud: Indica si existe fraude por diferencia de altitud (Si, No o NULL).

• tiene_fraude: Indica si se detectó al menos un tipo de fraude (Si, No o NULL).

• estado_fraude: Estado descriptivo del fraude:

  • CON_FRAUDE: Existe al menos un fraude detectado.

  • SIN_FRAUDE: No se detectaron fraudes.

  • NULL: La marcación no fue ejecutada.
    

Nota importante

Los campos relacionados con fraude (fraude_umbral, fraude_geocerca, fraude_desplazamiento, fraude_altitud, tiene_fraude, estado_fraude) retornan NULL cuando la marcación no ha sido ejecutada, ya que el fraude solo puede evaluarse sobre marcaciones realizadas.

8. Campos del usuario asignado

Información del usuario planificado para realizar la marcación.

• assigned_user_first_name: Nombre del usuario asignado.

• assigned_user_last_name: Apellido del usuario asignado.

• assigned_user_username: Nombre de usuario del usuario asignado.

• assigned_user_is_active: Indica si el usuario asignado se encuentra activo.

• assigned_user_name: Nombre completo del usuario asignado.

9. Campos del usuario que ejecutó

Información del usuario que realizó efectivamente la marcación.

• done_user_first_name: Nombre del usuario que ejecutó la marcación.

• done_user_last_name: Apellido del usuario que ejecutó la marcación.

• done_user_username: Nombre de usuario del usuario que ejecutó la marcación.

• done_user_is_active: Indica si el usuario que ejecutó la marcación se encuentra activo.

• done_user_name: Nombre completo del usuario que ejecutó la marcación.

10. Campos del cliente

Información general del cliente asociado al punto de marcación.

• customer_name: Nombre del cliente.

• customer_business_name: Razón social del cliente.

• customer_code: Código único del cliente.

• customer_status: Estado del cliente en el sistema.

• customer_visibility: Nivel de visibilidad del cliente.

• customer_is_blocked: Indica si el cliente se encuentra bloqueado.

11. Campos del punto del cliente

Datos del punto físico donde se realiza la marcación.

• customer_point_name: Nombre del punto del cliente.

• customer_point_code: Código único del punto del cliente.

• customer_point_coords: Coordenadas geográficas del punto (latitud y longitud).

• customer_point_address: Dirección física del punto.

• customer_point_extra1: Campo adicional 1 del punto.

• customer_point_extra2: Campo adicional 2 del punto.

• customer_point_extra3: Campo adicional 3 del punto.

• customer_point_status: Estado del punto del cliente.

12. Campos de zona geográfica

Información de la zona a la que pertenece el punto.

• zone_name: Nombre de la zona geográfica.

• zone_code: Código único de la zona geográfica.

• zone_description: Descripción de la zona geográfica.

• zone_is_active: Indica si la zona se encuentra activa.

13. Campos de ciudad

Información de la ciudad asociada al punto.

• zone_city_name: Nombre de la ciudad.

• zone_city_code: Código único de la ciudad.

14. Campos de estado o provincia

Información del estado o provincia asociada al punto.

• zone_state_name: Nombre del estado o provincia.

• zone_state_code: Código único del estado o provincia.

15. Campos de país

Información del país asociado al punto.

• zone_country_name: Nombre del país.