Smooth Entree

Descripción

Pensado para cómo funciona de verdad un bar con música en vivo cada semana: una banda todos los domingos, una noche de trivia una vez al mes, boletos de unos cuantos euros y el personal de la barra escaneando en la puerta con el celular.

El plugin hace seis cosas, y las hace bien:

Calendario y venta de boletos. Cada evento tiene su propia página con su propia dirección, así que se puede encontrar por separado. Los eventos que se repiten se programan automáticamente con tres meses de anticipación. Los eventos gratuitos que requieren reservación forman parte del mismo sistema.

Pago sin cuenta intermediaria. El dinero va directamente del cliente a la cuenta del propio local. Se admiten Mollie y Stripe; iDEAL funciona con ambos, y el proveedor más usado en tu país aparece primero.

En el calendario del propio cliente. Cada evento tiene un enlace “Añadir al calendario”: un simple archivo .ics con la hora correcta, el local y la hora de apertura de puertas. Si un evento se cancela, la cita se marca como cancelada en lugar de desaparecer sin avisar.

Boletos que sí llegan. El correo con los boletos es uno de los pocos correos en los que la entrega importa de verdad. Por eso el plugin revisa SPF, DKIM y DMARC, procesa los rebotes y muestra en el escritorio qué cliente no recibió sus boletos.

Un escáner de la puerta que funciona offline. Los boletos se guardan firmados en el dispositivo, así que el escáner puede comprobar por sí solo si un código QR es auténtico, incluso sin wifi. Los escaneos se envían en cuanto vuelve a haber conexión. Reconoce un boleto de otro evento, y en un segundo escaneo te dice a qué hora fue el primero.

Y lo que pasa en la barra. Alguien llega sin boleto: véndele uno en la puerta, en efectivo o con tarjeta, y déjalo pasar directamente. Alguien hace una transferencia o paga después: marca ese pedido como pagado manualmente. Las dos cosas cuentan normalmente para los ingresos, la declaración del IVA y el conteo de la puerta.

Migrar desde otro plugin

¿Ya usas The Events Calendar con Event Tickets? El plugin convierte esos eventos sin moverlos: la misma página, la misma dirección, la misma imagen y los mismos campos SEO. No se pierde ningún resultado de búsqueda y los enlaces compartidos siguen funcionando. Los pedidos y los asistentes se importan como historial.

¿Vendes con Event Tickets Plus a través de WooCommerce? Eso también se importa: ahí un boleto es un producto de WooCommerce y un pedido es un pedido de WooCommerce, y se leen ambos. El resto de tu tienda no se toca. Empieza siempre con la simulación: no cambia nada y muestra lo que pasaría.

Lo que no hace, a propósito

Sin mapas de asientos, sin horarios de entrada, sin suscripciones. Está pensado para noches en las que la gente llega y entra, no para teatros con filas numeradas.

Servicios externos

Este plugin puede conectarse con los servicios externos que se indican a continuación. No se envía nada a ningún lado hasta que tú lo decidas.

Mollie (proveedor de pagos). Cuando conectas tu cuenta de Mollie, el plugin crea pagos y reembolsos en tu nombre a través de la API de Mollie. Con cada pago se envían el número de pedido, el monto, la descripción y el nombre de host de tu sitio. Consulta los términos y la política de privacidad de Mollie.

Stripe (proveedor de pagos). Cuando conectas tu cuenta de Stripe, los pagos y reembolsos se crean en tu cuenta de Stripe a través de smoothentree.com (ver más abajo), porque Stripe solo permite que la plataforma agregue el cargo por servicio. Con cada pago se envían el número de pedido, el monto, la descripción, el nombre de host de tu sitio y el correo electrónico del cliente. Consulta los términos y la política de privacidad de Stripe.

Postmark (envío de correo, opcional). Solo si eliges Postmark como método de envío en Venta de boletos, Ajustes e introduces un token de API, el plugin envía el correo a través de la API de Postmark (api.postmarkapp.com). Qué se envía, cada vez que se manda un correo: el nombre y la dirección del remitente que configuraste, el correo electrónico del destinatario, el asunto, el cuerpo del mensaje en texto y en HTML, y sus archivos adjuntos (las imágenes con los códigos QR de los boletos). El plugin también lee las notificaciones de entrega y de rebote que Postmark devuelve a tu sitio, para que el escritorio pueda mostrar qué cliente no recibió sus boletos. Consulta los términos y la política de privacidad de Postmark.

Resend (envío de correo, opcional). Solo si eliges Resend como método de envío e introduces una clave de API, el plugin envía el correo a través de la API de Resend (api.resend.com). Se envían los mismos datos que con Postmark: remitente, destinatario, asunto, las dos versiones del mensaje y los archivos adjuntos, cada vez que se manda un correo, además de las notificaciones de entrega y de rebote que regresan. Consulta los términos y la política de privacidad de Resend.

Pay. (proveedor de pagos, desactivado de forma predeterminada). El adaptador de Pay. (pay.nl) viene incluido con el plugin, pero no está disponible en los ajustes; un sitio solo lo obtiene si lo activa con el filtro smoothentree_experimental_gateways. Si está activado e introduces tus credenciales de Pay., los pagos y reembolsos se crean a través de la API de Pay. (rest.pay.nl): el número de pedido, el monto, una breve descripción del evento, tu ID de servicio de Pay. y las direcciones de retorno a este sitio. Consulta los términos y la política de privacidad de Pay.

smoothentree.com (el servicio de conexión de este plugin). Cuando haces clic en “Conectar con Mollie” o “Conectar con Stripe”, tu navegador va a smoothentree.com, que te redirige a Mollie y recibe los tokens de acceso en tu nombre; después, los tokens se devuelven cifrados a tu sitio. A partir de ahí, tu sitio se comunica con smoothentree.com una vez al día, y antes de un pago cuando el token está por vencer, para renovar el token y consultar el cargo por servicio vigente. Qué se envía: el token de renovación (Mollie), la URL de tu sitio y un ID de conexión. Con Stripe, cada pago, revisión de estado y reembolso pasa por smoothentree.com, que lo reenvía a Stripe en nombre de tu cuenta. El servicio guarda un registro de qué sitios están conectados y cuándo se vieron por última vez; no almacena tus tokens. Sin la conexión no se pueden vender boletos de pago; las reservaciones gratuitas funcionan sin ningún servicio externo. Consulta los términos y la declaración de privacidad.

Cargo por servicio. Cada boleto de pago lleva un pequeño cargo por servicio fijo para Smooth Entree, que se separa durante el pago. De forma predeterminada lo paga el cliente y aparece como una línea aparte en el recibo, así que el local no paga nada; en los ajustes, el local puede elegir absorberlo. Este cargo es independiente de las comisiones por transacción de tu propio proveedor de pagos, que acuerdas con él y que no pasan por nosotros.

Software incluido

El escáner de la puerta usa jsQR (https://github.com/cozmo/jsQR, Apache License 2.0) para leer códigos QR en navegadores sin BarcodeDetector integrado, que en la práctica es sobre todo Safari en iOS. El código fuente sin minificar está en assets/vendor/jsqr.js, con la licencia al lado.

Capturas

Bloques

Este plugin proporciona 1 bloque.

  • Calendar

Instalación

  1. Sube la carpeta a /wp-content/plugins/ o instala el plugin desde la pantalla de administración.
  2. Activa el plugin.
  3. El escritorio muestra “Primeros pasos”: cinco pasos que se marcan solos.
  4. Ve a Venta de boletos, Ajustes y llena el nombre del local, una dirección de remitente en tu propio dominio y los datos de tu proveedor de pagos.
  5. Crea un evento y agrégale un boleto.
  6. En Escáneres de la puerta, configura un dispositivo para el personal de la barra.

Después, échale un vistazo a la pantalla Salud: te dice si el correo, la caché y las tareas en segundo plano están bien configurados.

Preguntas frecuentes

¿El dinero pasa por ustedes?

No. El plugin crea el pago en el proveedor del propio local, con las claves del propio local. El dinero va directamente a esa cuenta.

¿Qué pasa si dos personas compran el último boleto al mismo tiempo?

Solo una de ellas puede ganar, y eso lo garantiza la base de datos, no el código que la rodea. A la segunda se le avisa amablemente que se acaban de agotar.

¿Y si alguien paga cuando su reservación ya venció?

De forma predeterminada, ese pedido se acepta de todos modos y se marca como sobreventa; lo ves en el escritorio. Una persona de más en un bar suele dar menos problemas que devolver el dinero. También se puede reembolsar automáticamente: es un ajuste.

¿Puedo vender en la puerta?

Sí, en dos lugares. En la administración, en Pedidos: elige el evento y el boleto, la cantidad, efectivo o tarjeta, y si el cliente entra directamente. Y en el propio escáner de la puerta, porque quien trae el celular está en la puerta y no detrás de la barra: hay un botón “Vender un boleto” con los tipos de boleto de ese evento. En ambos casos, el correo electrónico puede quedar vacío; entonces no se envía ningún correo, porque el cliente está justo frente a ti.

Vendo con Event Tickets Plus a través de WooCommerce. ¿Puedo cambiarme?

Sí. Ahí los boletos son productos de WooCommerce y los pedidos son pedidos de WooCommerce, también cuando ya se guardan en las tablas propias de WooCommerce y no en las de WordPress. Se leen ambos, con los asistentes y con quién estaba adentro en su momento. Los demás productos de tu tienda no se tocan. Haz primero la simulación: no cambia nada y muestra lo que pasaría.

¿Qué idiomas habla?

Inglés, neerlandés, alemán, francés, español, italiano, portugués, polaco, checo, húngaro, rumano, griego, sueco, danés, noruego, finlandés, turco y japonés, con las variantes regionales de Bélgica, Austria, Suiza, Canadá, México y Brasil, y versiones formales del neerlandés y del alemán. El plugin sigue el idioma de tu sitio: las pantallas de administración, la página del evento, el pago, los correos con los boletos y el escáner de la puerta. Las fechas, los montos y las direcciones web de las páginas que crea también siguen ese idioma.

Las correcciones y mejoras son muy bienvenidas en translate.wordpress.org.

¿El escáner de la puerta funciona sin internet?

Sí. Los boletos de ese evento están en el dispositivo, con una firma que le permite comprobar por sí mismo si un código QR es de este local. Los escaneos se guardan y se envían en cuanto vuelve a haber conexión.

Reseñas

No hay reseñas para este plugin.

Colaboradores y desarrolladores

Este software es de código abierto. Las siguientes personas han contribuido a este plugin.

Colaboradores

“Smooth Entree” ha sido traducido a 3 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce “Smooth Entree” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

0.1.0

  • Primera versión.