Conectar tu ERP o pasarela de pago con AVEX
Dos caminos válidos: subida por archivo Excel para empezar el mismo día, o integración por API cuando tu operación ya tiene un sistema de origen.
Hay dos caminos válidos: carga por archivo Excel para empezar el mismo día, o integración por API cuando tu operación ya tiene un sistema de origen (ERP, pasarela, CRM) y quiere automatizar el flujo. No hay que elegir uno para siempre — pueden convivir.
Dos caminos, la misma plataforma
Al pensar en conectar un sistema existente con una plataforma de pases digitales, la pregunta suele ser: "¿cuánto trabajo le exige a mi equipo?". La respuesta depende del camino. Hay dos:
- Carga por archivo Excel (.xlsx o .xls) — sin desarrollo: exportas desde tu sistema y subes la plantilla.
- Integración por API — tu sistema de origen crea y actualiza pases sin intervención manual.
Ambos funcionan. El segundo no es mejor que el primero — es distinto, y tiene sentido cuando el volumen o la frecuencia lo justifican.
Camino 1: carga por archivo
Es el camino más corto. Exportas la lista de titulares desde el sistema que ya usas (puede ser un Excel armado a mano), la subes al panel, personalizas el diseño del pase una vez y envías los enlaces de instalación.
Desde ese momento, cada titular recibe su pase y tú lo gestionas desde el mismo panel. Para actualizar a un grupo, vuelves a subir un archivo con los cambios. Para enviar una notificación a todos, lo haces desde el panel en una acción.
Este camino funciona para operaciones pequeñas, para piloto, o para cualquier caso donde un equipo humano revisa cada emisión. Se puede quedar así indefinidamente si la frecuencia lo permite.
Camino 2: integración por API
Cuando la operación ya tiene un sistema de origen (un ERP que conoce los estudiantes, una pasarela que conoce las facturas, un CRM que conoce los miembros), tiene sentido que ese sistema le hable directamente a AVEX.
En ese caso exponemos un conjunto de endpoints REST autenticados: crear o actualizar titulares y pases (upsert), reportar eventos y snapshots de estado, revocar. También existen webhooks que avisan cuando un pase se instala, cuando su estado cambia y — en entradas de evento — cuando la entrada se valida en puerta.
La integración la hace el equipo técnico del cliente; nosotros la acompañamos de principio a fin. El tiempo depende del sistema de origen y del alcance que definas.
Cómo decidir
Si tu equipo está probando si los pases digitales sirven para su operación: empieza por el camino 1.
Si ya decidieron que sí y el volumen crece cada mes: el camino 2 automatiza el trabajo manual que, si no lo automatizas, va a crecer linealmente con el volumen.
No hay que elegir uno para siempre. Los dos caminos pueden convivir: empezar por archivo Excel mientras se termina la integración por API.
Sigue leyendo
Todas las guíasEl certificado WWDR de Apple: el intermedio que viaja dentro de cada .pkpass
El WWDR es el intermedio público de Apple que va dentro de la firma de cada .pkpass. Qué generación usar (G4), cuándo vence y cómo falla cuando falta.
Expirar un pase: voided, expirationDate, validTimeInterval — y qué ve el titular sin conexión
Apple evalúa voided y expirationDate dentro del pase; Google expira por validTimeInterval o state vía PATCH. Sin red, el titular ve lo último descargado.