Guía de uso de ParkingGest: taquilla y API de barreras

Esta guía explica paso a paso cómo poner en marcha ParkingGest y cómo integrarlo con barreras y cajeros. Todas las opciones cuelgan del menú Parking.

1. Instalación

Sube el ZIP del plugin (Panel de control → Plugins → Añadir) y actívalo.
Al activarlo se crean automáticamente las tablas (plazas, tarifas, abonados y sesiones) y se genera un token para la API.

2. Configuración

En Parking → Configuración define el nombre del parking, la tarifa por defecto (la que se aplica a los vehículos de rotación), la moneda y si quieres permitir la API. Aquí también ves el token de la API y puedes regenerarlo, junto con ejemplos de los endpoints.

3. Tarifas

En Parking → Tarifas crea tus tarifas:

Rotación (por tiempo): indica el importe por fracción, los minutos por fracción y, opcionalmente, un máximo por día.
Abono (mensual): indica el precio mensual.

4. Plazas

En Parking → Plazas das de alta las plazas con su código, zona, planta y tipo (coche, moto, PMR, VIP). Su estado (libre, ocupada, reservada) refleja la ocupación.

5. Abonados

En Parking → Abonados registra los abonados con su matrícula, tarifa de abono y vigencia. Los vehículos de un abonado vigente salen sin coste (se resuelven por matrícula).

6. Taquilla / cabina

En Parking → Taquilla operas manualmente:

Registrar entrada: escribe la matrícula y pulsa Entrar; se genera un ticket con la hora de entrada.
Consultar y cobrar salida: busca por ticket o matrícula, revisa el importe calculado según el tiempo y la tarifa, elige el método de pago y pulsa Cobrar y abrir salida.

Arriba se muestran los contadores de plazas libres, ocupadas y vehículos dentro.

7. API de integración (barreras y cajeros)

Los sistemas de barreras y cajeros con lectura de matrícula (LPR) llaman a /ParkingGestApi incluyendo el token:

action=entrada&token=XXX&matricula=1234ABC → registra la entrada y devuelve el ticket. abrir=true para subir la barrera.
action=consulta&token=XXX&ticket=PK-XXXX (o matricula=...) → devuelve el importe pendiente.
action=pago&token=XXX&ticket=PK-XXXX&metodo=tarjeta → cierra la sesión (cobrada) y devuelve abrir=true para la barrera de salida.

Las respuestas son JSON. Un token inválido se rechaza con {"ok":false,"error":"token-invalido"}.

8. Recomendaciones

Crea primero la tarifa de rotación y márcala como tarifa por defecto en la configuración.
Regenera el token si crees que se ha comprometido; recuerda actualizarlo en tus barreras/cajeros.
Consulta el histórico de sesiones para revisar entradas, salidas, tiempos e importes.