Conectar tu TPV e importar ventas
Importa las ventas de tu TPV con un CSV o Excel (funciona con cualquiera) y vincula cada producto del TPV con tu inventario o tus escandallos para descontar stock.
Quién puede usarlo: «Gestionar equipo» o «Gestionar TPV» (incluido en Noddal Pro). En Perfil, la entrada «Conexión con TPV» solo la ve el propietario; quien tenga el permiso puede abrirla desde Ventas TPV → «Conectar TPV».
En esta guía
Las vías de conexión
- CSV / Excel
- Funciona con cualquier TPV. Exportas las ventas desde tu TPV y las subes aquí. Es la vía recomendada para empezar.
- API del TPV
- Para Revo, HioPOS Cloud, Ágora, SumUp y otros con API: escribes la clave y la dirección que te da tu proveedor de TPV y pruebas la conexión.
- Conectores estándar
- Shopify POS, Lightspeed y Square aparecen como «Próximamente»: aún no se pueden conectar. Con Solicitar activación nos avisas de que lo necesitas.
- Paso 1: Exportar ventas del TPV
- Paso 2: Importar CSV/Excel
- Paso 3: Vincular productos
- Paso 4: Stock y márgenes al día
Importar ventas con CSV o Excel
- Paso 1: Abre Perfil → Conexión con TPV (o Ventas TPV → Conectar TPV).
- Paso 2: Despliega CSV / Excel y pulsa Descargar plantilla CSV para ver el formato.
- Paso 3: Exporta las ventas desde tu TPV y ajusta el archivo a esas columnas (o comprueba que ya las tiene).
- Paso 4: Sube el archivo (.csv, .xlsx o .xls, hasta 50.000 filas). Noddal lo valida y propone el mapeo de productos al momento.
- Paso 5: Elige si añadirlo a una conexión que ya tienes o — Crear nueva — con su nombre.
- Paso 6: Revisa el resultado de la validación y pulsa Importar N filas (o Importar de todos modos si quedan productos sin mapear: se guardan, pero no descuentan stock hasta que los mapees). Verás «Importadas X ventas nuevas · Y líneas».
- ID TicketObligatorio
- Número del ticket. El mismo ticket con la misma fecha se sustituye al reimportar (no se duplica).
- FechaObligatorio
- Fecha de la venta.
- Nombre productoObligatorio
- Como se llama en tu TPV. Es lo que se vincula con tu inventario.
- CantidadObligatorio
- Unidades vendidas. Las negativas se importan como devolución (vuelven al stock).
- PVP unitarioObligatorio
- Precio de venta por unidad.
- SKU / Código
- Opcional: el código del producto en el TPV.
- PVP total
- Opcional.
Nota: Se omiten las filas con cantidad 0, precio inválido o fecha ilegible. Un mismo número de ticket con otra fecha se rechaza.
Conectar por API
- Paso 1: Despliega API del TPV y elige tu TPV (o API genérica).
- Paso 2: Rellena Nombre para identificar la conexión, API key / Token (obligatoria), Endpoint / URL base y, si lo tienes, ID de tienda / local. Estos datos te los da tu proveedor de TPV.
- Paso 3: Pulsa Probar conexión. Con Ver respuesta JSON del TPV puedes comprobar qué devuelve.
- Paso 4: Si todo va bien, pulsa Conectar automáticamente.
- Paso 5: Comprueba en TPVs conectados → Estado del job programado y en Ventas TPV que llegan ventas. Si no llegan, importa por CSV/Excel y escríbenos desde Ayuda y soporte.
Si tu TPV no aparece en la lista, pulsa Contactar con soporte en «Otro TPV».
Vincular los productos del TPV (mapeo)
El mapeo dice a Noddal qué es cada producto de tu TPV: un producto del inventario (una caña de barril) o una receta de Escandallos (un plato). Sin mapear, una venta se guarda pero no descuenta stock ni calcula margen.
- Paso 1: Pulsa Gestionar mapeo de productos (en TPVs conectados) o Revisar mapeo en Ventas TPV.
- Paso 2: Elige la Conexión y deja el filtro Sin mapear.
- Paso 3: En cada producto del TPV, en Vincular con…, elige el producto o la receta. Las sugerencias vienen marcadas por confianza.
- Paso 4: En uds indica cuánto descuenta cada venta (1 por defecto; por ejemplo 0,33 si una caña gasta 0,33 l de un barril contado en litros).
- Paso 5: Pulsa Vincular. Las ventas anteriores de ese producto pasan a «mapeado» y descuentan su stock.
Nota: Al importar, Noddal vincula sola lo que reconoce con seguridad. Esos vínculos aparecen en Ventas TPV como «se mapearon automáticamente»: revísalos con Ver detalle y pulsa Marcar todo revisado cuando estén bien. El filtro Sospechosos muestra los que conviene mirar.
Pausar o eliminar una conexión
En TPVs conectados puedes desmarcar Activa o eliminar la conexión con la papelera. Eliminar borra sus ventas, sus líneas, sus mapeos y los movimientos de stock que generaron: el stock vuelve a como estaba sin ventas de ese TPV.
Guías relacionadas
- Ventas TPV: qué se ha vendido y qué deja margenVentas por día, ticket medio, productos más vendidos y productos vendidos por debajo del coste, con exportación a PDF.
- Escandallos: coste y margen de cada platoCrea la receta de cada plato con sus ingredientes y su precio de venta: Noddal calcula el coste con tus precios de compra y te avisa si el margen baja.