Visitas de servicio
Cita en sitio programada o real para una orden de servicio, con ubicación, ventana y cuadrilla asignada.
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Orden | serviceorderId | Referencia | Sí | |
| Inicio de ventana | dateStart | Fecha | Sí | Fecha de calendario sin hora. |
| Fin de ventana | dateEnd | Fecha | Sí | Fecha de calendario sin hora. |
| Sucursal | customerbranchId | Referencia | ||
| Empleado | employeeId | Referencia | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Iniciado por | startedBy | Usuario | ||
| Iniciado el | startedAt | Fecha y Hora | ||
| Finalizado por | endedBy | Usuario | ||
| Finalizado el | endedAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Orden serviceorderId | Órdenes de servicio | poseído por |
Sucursal customerbranchId | Sucursales de cliente | referencia |
Empleado employeeId | Empleados | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook servicevisits.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una visita. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios de la visita. | App · API · MCP · CLI |
| Iniciar | start | Inicia el inicio y abre el trabajo. | App · API · MCP · CLI |
| Finalizar | end | Termina el fin. El trabajo se detiene. No se puede deshacer. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la visita y los datos que le pertenecen. No se puede deshacer. | App · WebMCP · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.