API de terminal
El contrato genérico: el equipo manda lo que lee por HTTPS y recibe la respuesta para el trabajador. Lotes, identificadores locales para no duplicar y hora de lectura para trabajar sin conexión.
Cualquier lector sirve. El tuyo también.
Para MiFicha, todo lo que lee un lector es texto. Da igual que sea el QR de un móvil, una tarjeta o el código de la tarjeta que ya usa tu empresa: el servidor sabe de quién es y responde al lector con el nombre, la hora y una señal de bien o mal.
Lectores compatibles
| Lector | Cómo se conecta | Qué lee |
|---|---|---|
| Lector de códigos USB (HID) | Terminal web en un PC o tablet: escribe como un teclado | QR del móvil, tarjetas QR, códigos de barras |
| Lector de tarjetas RFID/NFC USB | Terminal web (como teclado) o agente | Número de la tarjeta, con transformación (hexadecimal, invertir bytes…) |
| Lector serie o USB-CDC | Terminal web con Web Serial (Chrome, Edge) o agente | Lo que envíe el lector |
| Android con lector integrado | App de MiFicha en modo terminal (Zebra, Honeywell, Sunmi, Urovo, Newland…) | QR, códigos y tarjetas |
| Tablet o PC con cámara | Terminal web: lee el QR con la cámara | QR del móvil y tarjetas QR |
| ZKTeco y compatibles | Protocolo ADMS («push») directo al servidor | Tarjeta y PIN (nunca huella ni cara) |
| Lector TCP, GPIO o programa del fabricante | Agente de MiFicha (Windows, Linux, Raspberry Pi) | Lo que entregue el equipo, una lectura por línea |
| Cualquier equipo con HTTPS | API de terminal o webhook con plantilla | Texto: tú decides el formato |
Los terminales con huella o reconocimiento facial se pueden usar con tarjeta o PIN, pero MiFicha nunca recibe ni guarda datos biométricos.
Conecta el tuyo
Cuatro formas de conectar un lector.
Webhook con plantilla
Para lectores que solo saben enviar su propio formato (JSON o formulario): en el panel indicas qué campo es el código, cuál la hora y cuál el tipo.
Protocolos de fabricante
ZKTeco ADMS incluido. El terminal se apunta a tu servidor de MiFicha y los fichajes llegan solos.
Agente de MiFicha
Un programa en Python para Windows, Linux o Raspberry Pi con adaptadores HID, serie, TCP, HTTP local, GPIO (relé, zumbador, LED) y «comando», que ejecuta el programa del fabricante y lee una lectura por línea. Puedes escribir los tuyos.
Dar de alta un lector
- En el panel, Terminales → Nuevo: nombre, centro y forma de conexión.
- Te damos un código de emparejamiento de 8 caracteres que vale 10 minutos.
- El terminal lo canjea y recibe su clave; desde ese momento, el panel te enseña su último contacto y el desfase de su reloj.
- Usa la prueba en vivo: ves el texto exacto que llega del lector y de quién sería.
Si vas a comprar un lector
- Para el QR del móvil, un lector 2D que lea pantallas (GM65, GM805 o similares) o una tablet con cámara.
- Ponlo a la altura de la mano, con buena luz y lejos de reflejos directos sobre la pantalla del móvil.
- Si ya tenéis tarjetas RFID, aprovéchalas: se registran pasándolas una vez en modo alta.
- Evita los equipos que solo funcionan con huella o cara: no los necesitas.
Empieza a registrar la jornada hoy.
Prueba MiFicha gratis durante 30 días, con todo tu equipo y sin compromiso.
También en el móvil
