API de terminal
O contrato xenérico: o equipo manda o que le por HTTPS e recibe a resposta para o traballador. Lotes, identificadores locais para non duplicar e hora de lectura para traballar sen conexión.
Calquera lector serve. O teu tamén.
Para MiFicha, todo o que le un lector é texto. Dá igual que sexa o QR dun móbil, unha tarxeta ou o código da tarxeta que xa usa a túa empresa: o servidor sabe de quen é e responde ao lector co nome, a hora e un sinal de ben ou mal.
Lectores compatibles
| Lector | Como se conecta | Que le |
|---|---|---|
| Lector de códigos USB (HID) | Terminal web nun PC ou tableta: escribe coma un teclado | QR do móbil, tarxetas QR, códigos de barras |
| Lector de tarxetas RFID/NFC USB | Terminal web (como teclado) ou axente | Número da tarxeta, con transformación (hexadecimal, inverter bytes…) |
| Lector serie ou USB-CDC | Terminal web con Web Serial (Chrome, Edge) ou axente | O que envíe o lector |
| Android con lector integrado | App de MiFicha en modo terminal (Zebra, Honeywell, Sunmi, Urovo, Newland…) | QR, códigos e tarxetas |
| Tableta ou PC con cámara | Terminal web: le o QR coa cámara | QR do móbil e tarxetas QR |
| ZKTeco e compatibles | Protocolo ADMS («push») directo ao servidor | Tarxeta e PIN (nunca pegada nin cara) |
| Lector TCP, GPIO ou programa do fabricante | Axente de MiFicha (Windows, Linux, Raspberry Pi) | O que entregue o equipo, unha lectura por liña |
| Calquera equipo con HTTPS | API de terminal ou webhook con modelo | Texto: ti decides o formato |
Os terminais con pegada ou recoñecemento facial pódense usar con tarxeta ou PIN, pero MiFicha nunca recibe nin garda datos biométricos.
Conecta o teu
Catro xeitos de conectar un lector.
Webhook con modelo
Para lectores que só saben enviar o seu propio formato (JSON ou formulario): no panel indicas que campo é o código, cal a hora e cal o tipo.
Protocolos de fabricante
ZKTeco ADMS incluído. O terminal apúntase ao teu servidor de MiFicha e as fichaxes chegan soas.
Axente de MiFicha
Un programa en Python para Windows, Linux ou Raspberry Pi con adaptadores HID, serie, TCP, HTTP local, GPIO (relé, zumbador, LED) e «comando», que executa o programa do fabricante e le unha lectura por liña. Podes escribir os teus.
Dar de alta un lector
- No panel, Terminais → Novo: nome, centro e xeito de conexión.
- Dámosche un código de emparellamento de 8 caracteres que vale 10 minutos.
- O terminal cámbiao e recibe a súa clave; desde ese momento, o panel amósache o seu último contacto e o desfase do seu reloxo.
- Usa a proba en vivo: ves o texto exacto que chega do lector e de quen sería.
Se vas mercar un lector
- Para o QR do móbil, un lector 2D que lea pantallas (GM65, GM805 ou similares) ou unha tableta con cámara.
- Ponlo á altura da man, con boa luz e lonxe de reflexos directos sobre a pantalla do móbil.
- Se xa tedes tarxetas RFID, aproveitádeas: rexístranse pasándoas unha vez en modo alta.
- Evita os equipos que só funcionan con pegada ou cara: non os necesitas.
Comeza hoxe a rexistrar a xornada.
Proba MiFicha de balde durante 30 días, con todo o teu equipo e sen compromiso.
Tamén no móbil
