---
title: "WooCommerce con Plexo, factura CFE y entradas QR · Uruguay"
description: "Caso acuamania.uy: tienda de entradas en WooCommerce con pago Plexo, factura electrónica CFE, beneficio BROU por BIN y QR en puerta. Más de 4.500 pedidos."
url: https://lazarosantana.dev/casos/acuamania/
---

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.

[Ver sitio en vivo](https://acuamania.uy) [Cómo funciona](https://lazarosantana.dev/casos/acuamania/#recorrido)

*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 · construido checkout · 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 · construido Plexo · 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, arreglado registro · 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 · terceros Brevo · 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 · construido app FooEvents · terceros

**carrito** paso 1 / 5

× 2

× 1

*4•••* •••• •••• ••••

comprobando BIN…

consumidor final empresa · RUT

total · los precios no cambian **$ ••••**

**pago** paso 2 / 5

**Tienda** pedido #•••••

**Plexo** pasarela local

¿BIN de una tarjeta BROU? sí

→ comercio BROU

→ comercio general resto de pagos

esquema del enrutado · sin datos reales

**factura electrónica** paso 3 / 5

e-ticket · CFE serie • nº •••••

QR fiscal

wc · pedido pagado

→ solicitud a Gsoft

**✓ CFE emitido · guardado en el pedido**

si hay reembolso → nota de crédito

**entradas** paso 4 / 5

3 asistentes un PDF por persona, por correo

entrada 3 de 3

**puerta** paso 5 / 5

**escaneando** check-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) · bfdfe8bc` construido

### 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) · 6bbf816b` construido

### 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) · 7c4063ee` mejorado

### 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) · 9fedfb40` mejorado

### 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) · 6ea4cadf` construido

### 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) · be9c558d` mejorado

### 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

cliente**Navegador** compra desde el móvil, con Turnstile contra bots

personal del parque**App de check-in** valida el QR contra la API de FooEvents

administración**Panel de WordPress** pedidos, convenios y el registro de facturación

// servidor

### WordPress + WooCommerce

Beneficio BROU*BIN + enrutado**construido*

mu-plugins*rendimiento y check-in**construido*

Factura electrónica (plugin de otro equipo)*CFE y notas de crédito**arreglado*

Tema hijo*checkout, convenios, correos**mejorado*

Registro de facturación*visor en el admin**de otro equipo*

FooEvents*entradas y QR**terceros*

docker compose

Redis 7 · construido PHP 8.2 · Apache · mejorado MariaDB 11.8 Traefik · Alloy · del equipo

pagos**Plexo** pasarela local; comercio BROU y comercio general

facturación**Gsoft** emite el comprobante fiscal

correo**Brevo** envío de pedidos y entradas

Nuevo Mejorado Existente

// 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.

01**Local** rama de trabajo

02**Staging** Coolify · *develop* · despliegue automático

03**Producción** *main* · backup y despliegue manual

### Protecciones

**Menos AJAX del carrito** se recortan las llamadas de fragmentos que WooCommerce hace en cada página

**Check-in ligero** las llamadas de la app cargan solo los plugins que necesitan

**XML-RPC cerrado** una puerta menos para ataques de fuerza bruta

**Cabeceras de seguridad** y PHP bloqueado en la carpeta de subidas

**Redis y opcache** caché 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

**4** servicios externos conectados: Plexo, Gsoft, Brevo y la app de check-in

**3** entornos: local, staging y producción

WordPress WooCommerce PHP 8.2 FooEvents Plexo Gsoft · CFE Redis MariaDB Docker Coolify Cloudflare Turnstile Brevo

// siguiente caso

02 · corporativo · Canadá

### ratioweb.ca

Tema a medida, bilingüe, auditado de punta a punta: seguridad, accesibilidad, rendimiento y SEO.

*ratioweb.ca*

Página de inicio de ratioweb.ca

[¿Necesitas algo así? → Tiendas WooCommerce para Uruguay](https://lazarosantana.dev/servicios/woocommerce-uruguay/)

[← todos los casos](https://lazarosantana.dev/#trabajo) caso 1 de 4

// 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.

[Pedir cotización](https://lazarosantana.dev/contacto/#formulario) [Ver servicios](https://lazarosantana.dev/servicios/)
