caso 01 · venta de entradas · Uruguay

Entradas online
para un parque acuático

acuamania.uy vende sus entradas en WooCommerce. Cada compra se cobra con Plexo, recibe su factura electrónica y llega al cliente como una entrada con QR que se valida en la puerta.

acuamania.uy
Página de inicio de acuamania.uy, tienda online de entradas del parque acuático Acuamanía en Uruguay
4.500+pedidos pagados
16.000+entradas emitidas
entrada válida
Cliente

Acuamanía, parque acuático en Uruguay

Equipo

Desarrollador en DeepZide, junto a otros dos devs

Mi papel

Plugin del beneficio BROU, arreglos en la factura electrónica (plugin de otro equipo), checkout, rendimiento y Docker

Entornos

Local, staging en Coolify y producción en Docker

// el reto

Una venta
cuatro sistemas

El parque vende casi todo online y en temporada. Una compra no termina al pagar: tiene que pasar por la pasarela local, por la facturación que exige la ley y por la puerta del parque, sin que el cliente note nada de eso.

Si una pieza falla, el problema aparece en la cola de la entrada, con el cliente delante.

01

Pago local

Tarjetas uruguayas con Plexo, la pasarela que usan los bancos del país.

02

Factura por ley

Cada pedido pagado emite su comprobante fiscal electrónico. Cada reembolso, su nota de crédito.

03

Beneficios

Convenios y BROU Recompensa, el beneficio del Banco República que depende de la tarjeta con la que se paga.

04

Puerta rápida

Una entrada con QR por persona, que el personal valida en segundos desde el móvil.

// recorrido de un pedido

Del carrito
a la puerta

Cinco pasos que el cliente vive como uno. Baja y míralos en orden.

01 · carrito

Carrito y convenios

El checkout separa consumidor final y empresa, y valida los datos que pide cada factura. Los convenios se aplican aquí. Si la tarjeta es de BROU (lo dice el BIN, sus primeros dígitos), el pedido entra en BROU Recompensa sin tocar los precios.

plugin BROU · construidocheckout · mejorado
02 · pago

Pago con Plexo

La pasarela local cobra la tarjeta. Los pagos con BROU Recompensa se enrutan al comercio de BROU y el resto al comercio general, así cada uno liquida por su lado.

enrutado por BIN · construidoPlexo · pasarela
03 · factura

Factura electrónica

Al confirmarse el pago, un plugin de factura (hecho por otro equipo) pide el comprobante fiscal a Gsoft y lo guarda en el pedido, con su QR fiscal. Un reembolso genera la nota de crédito. Cada intento queda en un registro dentro del admin, para encontrar un fallo sin abrir el servidor.

plugin de factura · de otro equipo, arregladoregistro · de otro equipo
04 · entrada

Entrada con QR

FooEvents emite una entrada en PDF por persona, cada una con su QR, y el cliente la recibe por correo junto al pedido.

FooEvents · tercerosBrevo · terceros
05 · puerta

Control en la puerta

El personal escanea con la app de check-in, que habla con la API de FooEvents. Un mu-plugin carga solo lo imprescindible en esas llamadas, para que la validación no espere al resto del sitio.

mu-plugin de check-in · construidoapp FooEvents · terceros
carritopaso 1 / 5
× 2
× 1
4••• •••• •••• ••••
comprobando BIN…
consumidor finalempresa · RUT
total · los precios no cambian$ ••••
pagopaso 2 / 5
Tiendapedido #•••••
Plexopasarela local
¿BIN de una tarjeta BROU?sí
→ comercio BROU
→ comercio generalresto de pagos

esquema del enrutado · sin datos reales

factura electrónicapaso 3 / 5
e-ticket · CFEserie • nº •••••
QR fiscal
wc · pedido pagado
→ solicitud a Gsoft
✓ CFE emitido · guardado en el pedido
si hay reembolso → nota de crédito
entradaspaso 4 / 5
3 asistentesun PDF por persona, por correo
entrada 3 de 3
puertapaso 5 / 5
escaneandocheck-in
entrada 1 de 3✓ check-in
entrada 2 de 3✓ check-in
entrada 3 de 3…

ilustrativo · sin datos reales

// problemas reales

Lo que se rompe
en producción

Seis casos sacados de mis commits en este proyecto. Cada tarjeta lleva el commit que lo resolvió.

feat(acuamania-brou) · bfdfe8bcconstruido

Un cupón no puede sumarse al beneficio del banco

Si hay un cupón en el carrito, BROU Recompensa se bloquea. Un segundo arreglo cubre los cupones virtuales, que no tienen entrada en la base de datos.

feat(acuamania-brou) · 6bbf816bconstruido

Las tarjetas nuevas traen BIN de 8 dígitos

El plugin acepta BIN de 6 y de 8 dígitos y compara los 6 primeros, así ninguna tarjeta BROU se queda sin beneficio.

fix(efactura) · 7c4063eemejorado

Un dígito mal escrito dejaba el pedido sin factura

Si el documento del cliente no pasa el dígito verificador, la factura se emite sin él en vez de fallar. Los datos del receptor van en el XML que Gsoft acepta.

feat(checkout) · 9fedfb40mejorado

Pagar antes de rellenar la facturación

El bloque de pago queda cerrado hasta completar los datos de facturación, y los campos se desbloquean en orden.

perf(fooevents) · 6ea4cadfconstruido

La puerta esperaba a todo WordPress

En las llamadas REST de la app de check-in se cargan solo WooCommerce y FooEvents, y la validación responde antes.

feat(emails) · be9c558dmejorado

Un email al admin por cada pago abandonado

Los pedidos que caducan sin pagar ya no avisan como cancelados, y el buzón solo recibe lo que importa.

// bajo el capó

Lo que hay
detrás del botón comprar

Por dónde pasa un pedido

clienteNavegadorcompra desde el móvil, con Turnstile contra bots
personal del parqueApp de check-invalida el QR contra la API de FooEvents
administraciónPanel de WordPresspedidos, convenios y el registro de facturación
// servidor

WordPress + WooCommerce

Beneficio BROUBIN + enrutadoconstruido
mu-pluginsrendimiento y check-inconstruido
Factura electrónica (plugin de otro equipo)CFE y notas de créditoarreglado
Tema hijocheckout, convenios, correosmejorado
Registro de facturaciónvisor en el adminde otro equipo
FooEventsentradas y QRterceros
docker compose
Redis 7 · construidoPHP 8.2 · Apache · mejoradoMariaDB 11.8Traefik · Alloy · del equipo
pagosPlexopasarela local; comercio BROU y comercio general
facturaciónGsoftemite el comprobante fiscal
correoBrevoenvío de pedidos y entradas
NuevoMejoradoExistente
// operación

Rápido en temporada
seguro al publicar

De mi máquina a producción

Todo cambio pasa por staging antes de llegar a la tienda real. Producción se actualiza a mano y siempre con copia de la base de datos antes.

01Localrama de trabajo
02StagingCoolify · develop · despliegue automático
03Producciónmain · backup y despliegue manual

Protecciones

Menos AJAX del carritose recortan las llamadas de fragmentos que WooCommerce hace en cada página
Check-in ligerolas llamadas de la app cargan solo los plugins que necesitan
XML-RPC cerradouna puerta menos para ataques de fuerza bruta
Cabeceras de seguridady PHP bloqueado en la carpeta de subidas
Redis y opcachecaché de objetos y opcache por encima del número de ficheros del sitio
// resultado

Números
de la tienda

4.500+pedidos pagados
16.000+entradas emitidas con QR
4servicios externos conectados: Plexo, Gsoft, Brevo y la app de check-in
3entornos: local, staging y producción
WordPressWooCommercePHP 8.2FooEventsPlexoGsoft · CFERedisMariaDBDockerCoolifyCloudflare TurnstileBrevo
// tu proyecto

¿Quieres algo así para tu negocio?

Cuéntame qué necesitas. Te respondo en menos de 24 h y, si encaja, recibes una propuesta cerrada por escrito.