Mascotas
Completo
14 min de lectura
6 videos
Videos tutoriales
Los videos se reproducen si la carpeta media/ está disponible en el servidor.
¿Para qué sirve este módulo?
El módulo Mascotas registra y administra las mascotas de sus clientes: datos de identificación, foto, observaciones e historial clínico o de servicios. Es la base para negocios como veterinarias, peluquerías caninas, spas de mascotas o cualquier servicio donde cada atención va ligada a un animal concreto.
- Mantener un listado central de todas las mascotas con búsqueda y filtros.
- Asociar cada mascota a un cliente (dueño o responsable del pago).
- Guardar ficha completa: especie, raza, sexo, nacimiento, microchip, tamaño, peso, medidas y foto.
- Llevar un historial de eventos (consultas, vacunas, baños, etc.) con fecha, tipo y detalle.
- Integrarse con Órdenes de servicio (atenciones, facturación e historial automático) y con tiqueteras (paquetes por mascota).
Antes de registrar mascotas: configure al menos las especies y, si lo necesita, las razas y los tipos de historial en el menú Catálogo. Así los formularios mostrarán listas ordenadas y coherentes.
Relación con otros módulos
| Acción | Módulo / pantalla |
|---|---|
| Dueño de la mascota | Clientes — cada mascota pertenece a un cliente |
| Ver mascotas de un cliente | Clientes → ficha del cliente → bloque «Mascotas»; icono del menú secundario → listado filtrado |
| Atender y facturar servicios | Órdenes de servicio — modo sujeto «solo mascota» o «cliente y mascota» |
| Historial al cerrar factura | Órdenes de servicio → Configuración — opción «Historial al facturar» para mascota |
| Paquetes prepagados | Órdenes de servicio → Tiqueteras — planes con alcance por mascota |
| Crear cliente al registrar mascota | Mascotas → Nueva mascota → botón verde + → formulario de cliente |
| Notas desde una orden | Panel de la orden puede añadir notas a la ficha (campo observaciones estructurado) |
Inicio rápido
- Catálogo → cree especies (Perro, Gato, …), razas por especie y tipos de historial (Consulta, Vacuna, Baño, …).
- Nueva mascota → busque el cliente → complete nombre (obligatorio) y demás datos → Guardar.
- Listado → use búsqueda o filtros → botón amarillo Ver para abrir la ficha.
- En la ficha → botón + del bloque Historial para registrar un evento manual.
- Si usa órdenes de servicio → Nueva orden de servicio desde la ficha o desde recepción, eligiendo la mascota.
Menú principal (iconos)
Debajo del título Mascotas aparecen los accesos rápidos del módulo:
| Icono / nombre | Para qué sirve | Cuándo usarlo |
|---|---|---|
 Listado | Todas las mascotas con filtros de búsqueda y estado. | |
 Nueva mascota | Formulario de alta (desde el icono Nuevo). | |
 Catálogo | Especies, razas y tipos de historial clínico. | |
 Ayuda | Esta guía de ayuda | Consultar procedimientos. |
En el listado, el icono de la tarjeta también abre Nueva mascota.
Conceptos clave
- Mascota activa / inactiva
- Las activas aparecen por defecto en el listado y pueden usarse en órdenes nuevas. Una mascota inactiva conserva su historial pero puede ocultarse del día a día (por fallecimiento, cambio de dueño no actualizado aún, etc.).
- Cliente obligatorio
- Toda mascota debe tener un cliente. Al crear, usted lo elige con el buscador; al editar, el cliente queda fijo en pantalla (no se puede cambiar desde este formulario).
- Catálogo vs. texto libre antiguo
- Las especies y razas vienen del catálogo. Si una ficha antigua tenía especie escrita a mano, verá un aviso para vincularla al catálogo.
- Historial clínico
- Registro cronológico de eventos: cada entrada tiene fecha/hora, tipo (del catálogo), detalle libre y empleado que la registró. Es distinto del campo Observaciones de la ficha (notas generales visibles en el listado).
- Historial automático al facturar
- Si está activo en Configuración de órdenes de servicio, al facturar una orden con mascota el sistema agrega una entrada al historial con resumen de servicios y totales.
- Tiqueteras por mascota
- Paquetes prepagados (baños, consultas, etc.) pueden vincularse a una mascota concreta. En la ficha se listan los paquetes de esa mascota y los del cliente aplicables.
Catálogo — especies, razas y tipos de historial
Pantalla correspondiente del menú. Administre tres listas independientes:
1. Especies
- Botón → modal Nueva especie.
- Campos: Nombre (obligatorio), Orden (para ordenar en listas), casilla Activa.
- Botón → editar especie existente.
- Solo las especies activas aparecen al registrar o editar una mascota.
2. Razas (por especie)
- Primero debe existir la especie. Luego → Nueva raza.
- Campos: Especie, Nombre de la raza, orden y estado activa/inactiva.
- En la ficha de la mascota, al cambiar la especie se recargan las razas disponibles (solo activas de esa especie).
3. Tipos de historial clínico
- Define las categorías del historial: Consulta, Vacuna, Baño, Desparasitación, Cirugía, etc.
- Solo los tipos activos aparecen al agregar una entrada manual al historial.
- El historial automático al facturar usa un tipo configurado en Órdenes de servicio (por defecto busca uno llamado «Servicio» o similar).
Desactivar una especie, raza o tipo no borra datos ya guardados; evita que se use en registros nuevos. Prefiera desactivar antes que eliminar registros históricos.
Listado y filtros
Pantalla correspondiente del menú.
Filtros
- Búsqueda: texto libre sobre nombre de la mascota, nombre del cliente, cédula, celular, microchip, especie, etc.
- Estado: Activas (predeterminado), Inactivas o Todas.
- Filtrar aplica los criterios; Limpiar quita la búsqueda pero mantiene el filtro por cliente si entró desde Clientes.
- Si la URL trae cliente (desde la ficha de un cliente), solo verá las mascotas de ese cliente.
Columnas de la tabla
| Columna | Contenido |
|---|---|
| ID | Identificador interno de la mascota |
| Mascota | Nombre |
| Especie / Raza | Del catálogo; «—» si no hay datos |
| Observaciones | Primeras líneas del campo observaciones (pase el mouse si está truncado) |
| Cliente | Nombre del dueño |
| Identificación cliente | Cédula o documento (con dígito verificador si aplica) |
| Teléfono / celular | Celular del cliente; si no hay, teléfono fijo |
| Acciones | Botón amarillo abre la ficha completa |
Nueva mascota
Pantalla correspondiente del menú.
Cliente (obligatorio)
- Campo de búsqueda con Select2: escriba al menos un carácter (nombre, cédula o teléfono) y elija de la lista.
- Botón verde +: abre Nuevo cliente. Al guardar el cliente, vuelve a nueva mascota con ese cliente ya seleccionado.
- Si entra con cliente en la URL (desde Clientes o desde una orden), el cliente ya viene preseleccionado.
Campos de la ficha
| Campo | Obligatorio | Notas |
|---|---|---|
| Nombre | Sí | Hasta 150 caracteres |
| Especie | No | Lista del catálogo (activas) |
| Raza | No | Depende de la especie elegida |
| Sexo | No | Macho, Hembra o N/D |
| Fecha nacimiento | No | Selector de fecha |
| Color | No | Texto libre |
| Microchip | No | Útil para identificación única; también se busca en el listado |
| Tamaño | No | Pequeño, Mediano, Grande o Extragrande |
| Medidas | No | Texto libre (altura, peso aproximado, etc.) |
| Peso (kg) | No | Número decimal; puede usar coma o punto |
| Foto | No | JPG, PNG, GIF o WEBP |
| Observaciones | No | Notas generales (alergias, temperamento, indicaciones permanentes) |
Al pulsar Guardar, el sistema valida nombre y cliente. Si llegó desde Nueva orden de servicio (retorno a nueva orden en la URL), tras crear la mascota regresa a la orden con cliente y mascota ya elegidos.
Ficha de la mascota (editar)
Abra la ficha con el botón amarillo del listado o desde el bloque Mascotas en Clientes.
- El cliente se muestra como texto; no se puede cambiar aquí.
- Enlace Nueva orden de servicio: abre recepción con cliente y mascota precargados.
- Los mismos campos del alta, más el selector Estado (Activa / Inactiva).
- Guardar actualiza la ficha. Mensajes verdes (éxito) o rojos (error) aparecen arriba.
Foto
- Suba un archivo nuevo para reemplazar la imagen.
- Marque Quitar imagen actual para eliminar la foto sin subir otra.
- Las imágenes se guardan en el servidor; en pantalla se muestran como miniatura.
Historial clínico
En la ficha de una mascota existente aparece la tarjeta Historial, debajo de los paquetes (si aplica).
Ver entradas
La tabla muestra: fecha y hora, tipo, detalle, empleado que registró y botón para eliminar la entrada (con confirmación).
Agregar entrada manual
- Botón en la cabecera del bloque Historial.
- Modal Nueva entrada en historial: fecha y hora, tipo (obligatorio, del catálogo), detalle (texto libre).
- Guardar — el empleado en sesión queda registrado como autor.
Historial automático desde órdenes de servicio
Cuando en Órdenes de servicio → Configuración está activo «Historial al facturar» para mascota, cada factura de una orden con mascota genera una entrada con:
- Número de orden y factura
- Total de la orden
- Listado de servicios e insumos con cantidades, valores y empleado por línea
- Observaciones de la orden, si las hay
El tipo de evento usado es el configurado en esa misma pantalla de configuración.
Paquetes / tiqueteras
Si su empresa tiene activo el módulo de tiqueteras en Órdenes de servicio y su usuario tiene permiso, en la ficha verá la tarjeta amarilla Paquetes / tiqueteras (esta mascota y paquetes del cliente).
- Vender paquete (verde): venta de un plan vinculado a esta mascota.
- Ver todas: listado filtrado en Tiqueteras.
- Tabla resumida: número, plan, usos disponibles/total, fecha de vencimiento, estado (Activa, Agotada, Vencida, Anulada) y botón Detalle.
Los planes pueden ser «por mascota» (solo esa mascota consume) o «por cliente» (válidos según reglas del plan). Configure planes en Órdenes de servicio → Tiqueteras → Planes.
Estado, foto y eliminar mascota
Inactivar en lugar de eliminar
Cambie Estado a Inactiva y guarde. La mascota deja de aparecer en el filtro «Activas» pero conserva historial y referencias. Recomendado para la mayoría de casos.
Eliminar definitivamente
Botón rojo Eliminar al pie del formulario. Pide confirmación: borra la mascota, todo su historial y la foto del servidor. Use solo si el registro se creó por error y no tiene órdenes o documentos que dependan de él.
Eliminar una entrada del historial
Icono de papelera en cada fila del historial. No afecta el resto de la ficha ni las órdenes ya facturadas.
Desde el módulo Clientes
- En la ficha del cliente aparece el bloque Mascotas con nombre, especie/raza, microchip y botón Ver.
- Icono + del bloque: nueva mascota con ese cliente ya asignado.
- En el menú secundario del cliente, el icono de listado abre Mascotas filtrado por ese cliente (Listado).
Desde Órdenes de servicio
- Modo sujeto: en Configuración de órdenes elija «solo mascota» o «cliente y mascota» para que recepción pida seleccionar la mascota.
- Nueva orden: al elegir cliente se cargan sus mascotas activas. Si no tiene ninguna, use Registrar mascota o + (modal o enlace al módulo Mascotas).
- Detalle de orden: panel izquierdo con ficha resumida de la mascota, foto, indicaciones/notas y enlace a la ficha completa en Mascotas.
- Notas de ficha: desde la orden puede agregar indicaciones permanentes (alergias, cuidados); se acumulan en observaciones con fecha y empleado.
- Consumo de tiquetera: al facturar, si la orden usa un paquete de esa mascota, se descuenta un uso según reglas del plan.
Preguntas frecuentes
Desde la ficha de Mascotas el cliente queda fijo después de crear el registro. Si el animal cambió de dueño, registre la mascota con el nuevo cliente o consulte a administración si existe procedimiento de traslado en su instalación.
Vaya a Catálogo, verifique que la especie esté activa y agregue la raza con el botón + en la sección Razas. Luego refresque la ficha de la mascota.
Revise en Órdenes de servicio → Configuración que «Historial al facturar» para mascota esté activo, que la orden tenga mascota seleccionada y que exista un tipo de historial configurado (o uno activo llamado «Servicio» en el catálogo).
El microchip debe estar guardado en la ficha. Use el cuadro de búsqueda del listado; busca en microchip, nombre, cliente, cédula, celular y especie. Pruebe con parte del número.
El módulo de tiqueteras debe estar activo en configuración de órdenes de servicio y su usuario debe tener permiso. Si no usa paquetes prepagados, es normal que no aparezca.
Use JPG, PNG, GIF o WEBP. Si el archivo es muy pesado, reduzca el tamaño. En caso de error del servidor, contacte al administrador (permisos de ).
Ejemplos prácticos
Ejemplo 1 — Spa canino nuevo cliente
- Recepción: Nueva orden → busca cliente → no tiene mascotas → Registrar mascota.
- Completa «Max», especie Perro, raza Golden, tamaño Grande → Guardar.
- Vuelve a la orden con Max seleccionado → agenda baño y factura.
- En Mascotas → ficha de Max → historial con entrada automática del servicio (si está configurado).
Ejemplo 2 — Veterinaria: vacuna manual
- Catálogo → tipo «Vacuna» activo.
- Listado → Ver mascota → Historial → + → tipo Vacuna, detalle «Triple felina, lote ABC» → Guardar.
Ejemplo 3 — Paquete de 10 baños por mascota
- Tiqueteras → Plan «10 baños» con alcance por mascota.
- Ficha de la mascota → Vender paquete → cobro y activación.
- Cada factura de baño consume un uso hasta agotar o vencer el paquete.
Ejemplo 4 — Mascota fallecida
- Ficha → Estado Inactiva → Guardar (conserva historial para consultas futuras).
- Listado con filtro Activas ya no la muestra en el día a día.
Buenas prácticas
- Configure el catálogo de especies, razas y tipos de historial antes del pico de recepción.
- Registre microchip y foto cuando existan; facilitan identificar al animal en mostrador.
- Use Observaciones para alertas permanentes (alergias, mordedores, medicación).
- Prefiera Inactiva antes que eliminar registros con historial o facturas.
- Mantenga tipos de historial claros y ordenados; el equipo los usará en cada anotación.
- Active historial al facturar si quiere trazabilidad automática sin anotar dos veces.
- Desde Clientes, revise el bloque Mascotas antes de atender a un cliente frecuente.
- Capacite a recepción en buscar clientes por cédula o celular al crear mascotas nuevas.