Construído para conectarse.

Lectores, terminais, programas de nóminas ou de RR. HH.: todo o que necesitas para integrar MiFicha, documentado e con exemplos.

Protocolo de terminal

Emparella un equipo, manda lecturas (en lote e sen conexión) e recibe a resposta para o traballador. Inclúe o webhook con modelo e ZKTeco ADMS.

PROTOCOLO_TERMINAL.md

API da app

A mesma API que usa a app de MiFicha: entrar, fichar, rexistros, correccións, resumos, ausencias e equipo. JSON, tokens e erros con código.

API.md

Claves de integración

Claves con permisos (en probas e en real) para ler traballadores, marcaxes, xornadas e resumos, ou dar de alta marcaxes desde o teu sistema.

Avisos asinados

Webhooks con HMAC-SHA256 e reintentos: marcaxe creada, corrección resolta, resumo pechado ou asinado, ausencia resolta.

Mandar unha lectura

Coa clave que recibe o terminal ao emparellarse:

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": "…"}

Axente de MiFicha

Para o que non chega ao navegador: un axente en Python con adaptadores HID, serie, TCP, HTTP local, GPIO e «comando», e unha interface mínima para escribir os teus. Entrégase coa instalación propia e baixo petición na nube.

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

Fabricas lectores ou tes un programa de RR. HH.? Escríbenos e integrámolo xuntos./gl/contacto/

Comeza hoxe a rexistrar a xornada.

Proba MiFicha de balde durante 30 días, con todo o teu equipo e sen compromiso.

Crear a miña conta Prefires telo no teu servidor?

Tamén no móbil