Guía técnica para integradores

Integra hardware de control de acceso escolar con CoEsSe®

Compatibilidad certificada con las marcas líderes, flujo de integración vía API REST y un programa de referidos con comisión del 30%.

Compatibilidad

Hardware certificado

CoEsSe integra las gamas completas de los principales fabricantes de control de acceso y biometría.

ZKTeco

Push API · BioTime 8.0 · ZKBio CVSecurity

SpeedFace V5L, ProFace X, TS2000 Pro, ZK-D3180

Hikvision

ISAPI · HCP OpenAPI · ONVIF S/T

DS-K1T500S, DS-K3G501, DS-K3B501TX, DS-2CD4A26FWD

Dahua

HTTP API · DSS Pro REST · CGI

DHI-ASI7214Y-V3, DHI-ASG2100T, DHI-ITC952-PH8B

HID

OSDP v2.2 · Wiegand 26/34 · iCLASS SE

HID Vertx, iCLASS SE Readers, MultiCLASS SE

Suprema

BioStar 2 REST API · Wiegand · OSDP

FaceStation F2, BioEntry W2, X-Station

Integración vía API REST

Flujo de integración

Desde el alta del plantel hasta la sincronización de accesos en tiempo real.

1

Alta del plantel

El administrador crea el plantel y la licencia en CoEsSe. Se asigna tier y features activas.

2

Registro de hardware

En Dashboard → Hardware se registra el dispositivo (marca, modelo, protocolo, endpoint URL).

3

Conectividad

Se elige un modo de conexión (IP pública, DDNS o Agente Bridge). CoEsSe valida el endpoint y bloquea SSRF.

4

Credenciales del dispositivo

Se guardan en SecretosDispositivo (cifrado, rotación programada). El bridge las descarga por token.

5

Sincronización de accesos

CoEsSe lee eventos del terminal, los clasifica y notifica al tutor por WhatsApp en segundos.

Modos de conectividad del terminal

IP pública + puerto

Port-forwarding en el router del plantel. Simple pero requiere IP pública fija.

DDNS (IP dinámica)

Hostname que sigue la IP cambiante. Sigue requiriendo IP pública (no CGNAT).

Agente Bridge + túnel (recomendado)

Sin IP pública ni abrir puertos. Funciona tras CGNAT. Recomendado para producción.

Endpoints públicos intencionales

Estos endpoints no admiten sesión de usuario porque quien los invoca no es un usuario de la plataforma (un invitado, el bridge, Stripe o ZKTeco). Se validan con secrets, firmas o tokens criptográficos.

activarInvitacion

Activa invitaciones de acceso vía token criptográfico.

hikvisionBridgeCredentials

El bridge descarga credenciales del terminal con bridge_token de 122 bits.

zktecoWebhook

Recibe eventos de acceso en tiempo real desde terminales ZKTeco (Push API).

stripeWebhook

Confirma pagos de colegiatura validando firma HMAC de Stripe.

enviarSolicitudDemo

Registra solicitudes de demo con honeypot + rate-limiting anti-bot.

Programa de referidos

Gana una comisión del 30%

Regístrate como integrador y empieza a referir planteles escolares.

30% de comisión

Comisión sobre la suscripción anual de cada plantel que refieras.

Acceso al canal técnico

Contacto directo con el equipo de ingeniería para acompañar tus integraciones.

Cobertura sin pauta

Vendes hardware + instalación + CoEsSe sin invertir en publicidad.

Regístrate como integrador

El alta al programa de referidos la realiza el equipo de CoEsSe tras verificar tu información. Escríbenos por WhatsApp o correo y te registraremos para empezar a referir planteles con comisión del 30%.

¿Ya eres administrador? Inicia sesión

¿Necesitas soporte técnico directo?

Habla con nuestro equipo de ingeniería por WhatsApp para resolver dudas de integración en tiempo real.

Contactar por WhatsApp

contacto@cesdml.com

Horario de soporte: L-V 8:00 a 20:00 (CDMX)