Recicladora de efectivo integrada en Shopify POS: cobrar en efectivo desde el TPV

En una panadería el efectivo manda y la cola va rápida: el cobro tiene que ser de segundos y cuadrar solo al final del día. Para eso, la recicladora de efectivo (el cajón inteligente que cuenta, guarda y devuelve cambio) y el TPV de Shopify tienen que hablar entre sí: el cajero pulsa cobrar, el cliente mete el dinero, la máquina devuelve el cambio y la venta se cierra. Sin teclear importes ni cuadrar a mano.

Y ahí aparecen tres muros. Primero, Shopify POS solo permite que una extensión haga llamadas HTTPS con certificado de confianza —rechaza cualquier http://, incluso en la red local—, y la CashDro es un aparato cerrado de ICG que no puede tener certificado. Segundo, una recicladora de efectivo es una superficie de robo: si la app pudiera “sacar dinero”, una tablet desatendida sería un problema serio. Tercero, mantenerlo en muchas tiendas no puede ser un infierno de recompilar una app por tienda o vigilar un backend propio.

Construimos una extensión propia de Shopify POS que pilota la CashDro desde la tablet y resuelve los tres muros de raíz. No fue “que funcione en una demo”, sino que una tienda lo use cada día.

Contador de inserción en vivo

Mientras el cliente mete el dinero, la pantalla del cajero actualiza insertado / cambio / restante cada 500 ms. Nada de adivinar: se ve el cobro avanzar en tiempo real, y el cobro se abre ya con el total del carrito (productos, impuestos y descuentos).

Una sola app para todas las tiendas

La URL de la CashDro y las credenciales del TPV se introducen una vez por dispositivo en una pantalla de “Ajustes” dentro de la app y se guardan con la Storage API de POS. La misma app sirve a todas las tiendas: sin recompilar por tienda y sin backend propio que mantener.

Diseño a prueba de robos

La app no tiene ningún endpoint para sacar dinero. La única forma de que salga efectivo de la CashDro es como cambio de una venta real, lo que elimina por completo el riesgo de la “tablet desatendida”. Encima, el usuario del TPV se crea con permisos mínimos: puede iniciar y cerrar cobros, no retirar efectivo a mano.

El puente HTTPS dentro de la tienda

Para que Shopify acepte la conexión, un pequeño router siempre-encendido termina el HTTPS con un certificado real de confianza y lo reenvía a la CashDro por la red local —y de paso da WiFi a las tablets—. El puente nunca toca el PC de la máquina: hace exactamente las mismas llamadas que haría la tablet.

Comprobación previa y diagnóstico de un vistazo

Antes de que el cliente empiece a insertar, la app verifica que la CashDro responde, para que un puente caído salte al principio y no a mitad de cobro. Y un mosaico de diagnóstico en la Smart Grid muestra el estado al instante: Operativa / En uso / Revisar dispositivo / Sin conexión. Todo con un bundle de ~42 KB y 34 tests automáticos en verde cubriendo lo que más duele: construcción de llamadas, parseo de respuestas, decimales según idioma (18,25 vs 18.25) y casos límite.

Con honestidad

El último paso —marcar el pedido como pagado con el método “CashDro”— es manual, de tres toques. No es una limitación nuestra: Shopify no permite hoy que una extensión de terceros finalice un pago con método personalizado. Tres toques es el máximo de automatización que la plataforma permite, y lo dejamos documentado.

Por qué importa

La mayoría de agencias Shopify se mueven en el navegador. Este proyecto demuestra que sabemos bajar al mundo físico: integrar hardware real (una recicladora de efectivo cerrada), resolver la restricción de HTTPS de POS con un puente de red bien montado y diseñar pensando en la seguridad en lugar de solo “que funcione”. Es el tipo de trabajo —POS + hardware + omnicanal— donde el detalle marca la diferencia entre una demo y algo que una tienda usa cada día.