Guía de Onboarding: TCN-CSC-8C(V49)

📌 Pre-Arrival Prep (Sebas Remoto)

• ☐ Adaptadores: Confirmar si el enchufe es EU. Si es así, comprar 5 adaptadores (EU hembra -> AR macho). Si es SAA, no hace falta (mismo que AR).
• ☐ Conectividad: SIM local opcional (Personal/Movistar/Claro) con plan de datos mínimo si hiciera falta.
• ☐ Documentación API: Pedir a Justin (TCN) el "External Payment Integration Protocol" o "Remote Vend API".
• ☐ Assets: Cargar en OurVend > Product Catalog las fotos (JPG livianos, <500kb) y nombres de los productos.

🚚 Arrival Day: Checklist Presencial (En sitio)

1. Energía: Enchufar y encender. Verificar que el compresor de frío arranque.
2. SIM (opcional): Si hace falta, insertar SIM local. Entrar a Settings de Android -> Network -> APN y configurar según la operadora (Personal/Claro/Movistar).
3. ID de Máquina: Capturar foto de la etiqueta trasera (S/N) y de la pantalla System Info dentro del launcher de TCN. Pasar el Machine Number (ej. P0256...) a Sebas.
4. Prueba Mecánica: Ir al menú de administrador (usualmente código 888888) -> Diagnóstico > Motor Test. Hacer girar todos los motores vacíos para descartar daños de transporte.
5. Carga: Cargar productos físicos siguiendo el planograma.

💻 Arrival Day: Checklist Remoto (Sebas)

1. Vincular: En OurVend, asegurar que los 5 nuevos Machine Numbers aparezcan en la lista bajo la institución cc一级机构.
2. Configurar Tracks: En Products > Track Management, mapear cada slot al producto correspondiente del catálogo y setear precios en ARS (o la unidad configurada).
3. Sincronizar: Presionar el botón Sync en el panel de OurVend y confirmar con la persona en sitio que los precios/fotos se actualizaron en la pantalla.
4. Test de Pago: Realizar una compra real de $1 o monto mínimo para validar que el callback de despacho (vend) funcione correctamente.

✅ Estado del sistema Ballbox para pagos

Ya está

• Backend para crear QR / order.
• Webhook de MercadoPago.
• Persistencia de pagos aprobados.
• Admin para vending machines.
• Correlación base por vendingMachineId / txn.
• Modelo base para que Ballbox sea el cerebro de pago.

Falta crítico

• Conseguir de TCN / OurVend el External Payment Integration Protocol o Remote Vend API.
• Confirmar el contrato real de request de QR desde la máquina.
• Confirmar el callback o comando real de release / vend.
• Confirmar si Remote Track Configuration o features VIP son requisito para esto.
• Cerrar el mapping real machine ↔ slot ↔ product ↔ price.
• Hacer prueba end-to-end real: elegir producto → generar QR → pagar → recibir webhook → disparar vend → confirmar dispense.

Veredicto

• Preparado para integrar: sí.
• Preparado para operar en producción: todavía no.

Mínimo para decir “sí, estamos”

1. Pedir a Justin el doc/API real.
2. Identificar endpoint/callback exacto de vend.
3. Hacer una prueba real con una máquina.
4. Confirmar que no hay bloqueo VIP/licencia.