Recursos · API y desarrolladores
Integración de None con otros sistemas.
Sistemas contables, puntos de venta, plataformas de automatización (n8n, Zapier, Make) o el sistema académico de una institución pueden leer lo que None registra y recibir un aviso en el momento en que ocurre un hecho. Cada organización crea y revoca sus propias llaves.
1. Crear una llave
En Asistencia › Cuenta › Conectar con otros sistemas, seleccione «Nueva llave», asígnele un nombre (por ejemplo, «Contabilidad») y elija sus alcances:
reportes:leer— lectura de los reportes de asistencia, del reporte diario y de los informes de Lucy.eventos:confirmar— confirmación de avisos atendidos y registro del motivo de un retardo.transportation:reportar— exclusivo del proveedor de GPS del transporte escolar; lo configura None.
La llave se muestra una sola vez. None conserva únicamente su huella criptográfica; si se extravía, se emite otra y la anterior queda revocada.
2. Consultar la API
Cada solicitud incluye la llave en la cabecera Authorization: Bearer <llave>. Todas las rutas se sirven sobre https://nonelogistics.com.
| Ruta | Respuesta | Alcance |
|---|---|---|
GET /integraciones/n8n/reportes/semanal | La semana: llegadas, retardos y faltas por colaborador. | reportes:leer |
GET /integraciones/n8n/reportes/diario?fecha=AAAA-MM-DD | Un día. | reportes:leer |
GET /integraciones/n8n/reportes/resumen?desde=&hasta= | Un periodo, resumido por persona (la misma base de la prenómina). | reportes:leer |
GET /integraciones/n8n/reportes/os?fecha=AAAA-MM-DD | El reporte diario del negocio: ventas, personal, bodega y resultado. | reportes:leer |
GET /integraciones/n8n/lucy/informes/:id | Un informe de Lucy o de los agentes (su identificador llega en el aviso). | reportes:leer |
POST /integraciones/n8n/eventos/:id/procesado | Confirma que un aviso fue atendido. | eventos:confirmar |
GET /integraciones/n8n/motivos/opciones · POST /integraciones/n8n/motivos | Los motivos de retardo disponibles y el registro del motivo que indicó el colaborador. | eventos:confirmar |
La API no entrega sueldos, cálculos de nómina ni colegiaturas: esa información se consulta en las pantallas de su módulo. El reporte diario sí incluye las ventas y el resultado del día del negocio.
3. Recibir avisos (webhook)
En la misma sección de Cuenta se registra la dirección del sistema receptor (solo https). None envía un POST con JSON cada vez que ocurre un hecho y, si el sistema no responde, lo reintenta con esperas crecientes. Cada aviso incluye tres cabeceras:
X-None-Evento— el tipo de hecho (lista inferior).X-None-Entrega— el identificador del aviso, para confirmarlo o evitar procesarlo dos veces.X-None-Firma—t=<unix>,v1=<HMAC-SHA256>del texto<t>.<cuerpo>, con el secreto entregado al registrar la dirección. Se recomienda rechazar avisos con más de cinco minutos de antigüedad.
El cuerpo describe el hecho y su sujeto. Salvo el recordatorio de cobranza escolar, que incluye el saldo a propósito, los avisos no transportan importes: el sistema receptor los consulta por la API con su llave, y esa consulta queda registrada.
Tipos de aviso disponibles
Asistencia
attendance.event.created attendance.incidence.created attendance.late attendance.absence attendance.shift_ended attendance.opening_summary attendance.day_closed attendance.overtime_suspected attendance.branch.late_opening attendance.branch.under_coverage enrollment.completed enrollment.mismatch employee.limit_reached employee.created employee.terminated document.expiring
Caja y bodega
pos.venta.cobrada pos.venta.cancelada pos.corte.cerrado pos.caja.movimiento inventory.consumo.registrado
Nómina
payroll.calculation.ready payroll.cycle_authorized payroll.cycle_released
Agenda
agenda.cita.agendada agenda.cita.reprogramada agenda.cita.cancelada agenda.cita.recordatorio agenda.csat.solicitada agenda.recontacto
Instituciones educativas
scholastic.circular scholastic.cobranza.recordatorio
billing.pago.registrado membership.socio.inscrito membership.socio.renovado membership.socio.cancelado
workorders.orden.creada workorders.orden.lista workorders.orden.entregada workorders.orden.cancelada
purchasing.orden.enviada purchasing.orden.recibida assets.mantenimiento.generado
Seguridad
security.alert — existe un acceso a la organización que ya no debería estar vigente. Incluye la clase del hallazgo y cuántos hay, nunca un nombre. El detalle se consulta en Shield.
Reportes y Lucy
os.daily_report lucy.informe.creado pulse.message
Cuenta con None
payment.received payment.failed payment.due subscription.payment.failed service.grace_started service.suspended service.cancelled service.reactivated service.address_changed account.activation_link account.password_reset installation.requested installation.approved installation.rejected installation.completed
4. Límites de la integración
- None no envía correos ni mensajes de WhatsApp: avisa al sistema receptor y ese sistema decide a quién escribir.
- La API no entrega nombres de menores ni la nómina de ninguna persona.
- No se aceptan direcciones que apunten a redes privadas ni sin
https; el destino se verifica al registrarse y en cada entrega. - Una llave revocada deja de funcionar de inmediato; las solicitudes que la usen quedan registradas.
5. Qué viaja en un evento y a dónde puede ir
- Datos mínimos en los eventos. La mayoría de los eventos no transporta importes: el sistema receptor los consulta por la API con una llave autorizada, y esa consulta queda registrada.
- Destinos verificados. Las direcciones de destino se validan al guardarse y al entregarse, para impedir solicitudes hacia redes internas; un cambio de destino vuelve a pasar por la misma comprobación.
- Llaves por empresa. Cada empresa crea y revoca sus propias llaves, con alcances de lectura o confirmación; una llave no puede leer datos de otra empresa.