Salidas y Transportes

Obtener el registro de entradas (arribos) de alumnos para un día, opcionalmente filtrado por grupo, sección o grado. El resultado se limita a los grupos autorizados del usuario de API.

Registrar el arribo (registro de entradas) de uno o más alumnos en la puerta. Acepta student_id (un alumno) o student_ids (un arreglo de alumnos, p. ej. una caseta que escanea un grupo). La respuesta siempre es un arreglo results con un elemento por alumno solicitado.

Si el alumno ya tiene una entrada registrada hoy, no se crea un registro nuevo y el elemento correspondiente trae already_existed: true con el entry_id existente.

door_id y doorman_id son opcionales: si se omiten se almacena NULLNULL para door_id y el id de sesión del usuario de API para doorman_id.

Nota: este endpoint NO dispara notificaciones push de arribo (a diferencia de la pantalla /bin).

El acceso se limita a los grupos autorizados del usuario de API; si cualquier alumno solicitado queda fuera del alcance, la petición completa se rechaza con 403 y no se escribe nada.

Eliminar un registro de entrada erróneo (quitar entrada). El registro se elimina físicamente. El acceso se limita a los grupos autorizados del usuario de API.

Obtener los eventos del registro de salidas (dismissal) de alumnos para un día, opcionalmente filtrado por grupo. Cada fila corresponde a un evento real del registro. El resultado se limita a los grupos autorizados del usuario de API.

Registrar o avanzar el evento de salida (registro de salidas) de un alumno. Crea un nuevo registro o avanza el estado de recogida de uno existente.

pickup_status admite ARRIVED (notificación), GOING (en camino) y CONFIRMED (adiós/entregado). La llamada es idempotente: si el registro ya tiene el estado solicitado, responde 200 con skipped: true sin cambios.

A diferencia de la pantalla /bin, este endpoint NO consulta el tablero de salidas ni dispara notificaciones push.

Si la configuración SYT_FORCE_PICKUP_USER está activa, un CONFIRMED sin pickup_user_id se rechaza con 422.

El acceso se limita a los grupos autorizados del usuario de API.

Deshacer o retroceder la recogida de un alumno (quitar adiós). Según el estado y el usuario que avanzó el registro, el estado retrocede un nivel (200 con el nuevo pickup_status) o el registro se elimina por completo (204).

Obtener las rutas de transporte (bus lines) de la institución, con sus paradas, horario, operador, supervisor y chofer.

Obtener la actividad diaria de las rutas (ascensos/descensos) para un día, opcionalmente filtrada por ruta o grupo. El resultado se limita a los grupos autorizados del usuario de API.

Obtener las rondas / carpools (super carpools) de la institución, con sus alumnos, horarios y choferes. Use carpool_id para una sola ronda.

Obtener los alumnos que un usuario (padre o chofer de rondín) puede recoger en la salida para una fecha (modo por defecto: requiere user_id y date), o una sugerencia de alumno por nombre dentro de un campus y sección (suggested=true: requiere name, campus_id, section_id). En el modo por defecto el resultado se limita a los grupos autorizados del usuario de API.