Construido para conectarse.

Lectores, terminales, programas de nóminas o de RR. HH.: todo lo que necesitas para integrar MiFicha, documentado y con ejemplos.

Protocolo de terminal

Empareja un equipo, manda lecturas (en lote y sin conexión) y recibe la respuesta para el trabajador. Incluye el webhook con plantilla y ZKTeco ADMS.

PROTOCOLO_TERMINAL.md

API de la app

La misma API que usa la app de MiFicha: entrar, fichar, registros, correcciones, resúmenes, ausencias y equipo. JSON, tokens y errores con código.

API.md

Claves de integración

Claves con permisos (en pruebas y en real) para leer trabajadores, marcajes, jornadas y resúmenes, o dar de alta marcajes desde tu sistema.

Avisos firmados

Webhooks con HMAC-SHA256 y reintentos: marcaje creado, corrección resuelta, resumen cerrado o firmado, ausencia resuelta.

Mandar una lectura

Con la clave que recibe el terminal al emparejarse:

curl -X POST https://mificha.app/api/v1/terminal/lecturas/ \
  -H "Authorization: Terminal mft_…" \
  -H "Content-Type: application/json" \
  -d '{"lecturas": [{"id_local": "a1",
       "texto": "MF1.k3Yd8Qm2xPa.118000000.…",
       "leido_en": "2026-11-14T08:59:02+01:00"}]}'

{"resultados": [{"id_local": "a1", "estado": "ok",
  "trabajador": "Ana López", "tipo": "entrada",
  "hora": "08:59", "mensaje": "Entrada registrada",
  "senal": "ok"}], "hora_servidor": "…"}

Agente de MiFicha

Para lo que no llega al navegador: un agente en Python con adaptadores HID, serie, TCP, HTTP local, GPIO y «comando», y una interfaz mínima para escribir los tuyos. Se entrega con la instalación propia y bajo petición en la nube.

class Adaptador:
    nombre = 'mi_lector'
    def __init__(self, config: dict): ...
    def lecturas(self) -> Iterator[Lectura]: ...
    def responder(self, resultado) -> None: ...

¿Fabricas lectores o tienes un programa de RR. HH.? Escríbenos y lo integramos juntos./contacto/

Empieza a registrar la jornada hoy.

Prueba MiFicha gratis durante 30 días, con todo tu equipo y sin compromiso.

Crear mi cuenta ¿Prefieres tenerlo en tu servidor?

También en el móvil