Reconocimiento de productos
Cuando un socio sube la foto de un ticket, IncentIA lee cada línea (por ejemplo YOG NAT 4X125G) y la asocia a un producto de tu catálogo. Esta pantalla sirve para que esa asociación sea fiable: cargas tu maestro de productos, revisas lo que el sistema no tiene claro y compruebas cuánto se reconoce sin ayuda. Menú: Reconocimiento de productos.
Permiso Reconocimiento de productos para ver la pantalla · Editando reconocimiento de productos para actuar (importar, aceptar, ignorar, añadir o borrar nombres de ticket, deshabilitar, cambiar umbrales). Solo desde una cuenta de cliente.
Sin el permiso de edición ves los datos, pero no los botones de acción ni el editor de umbrales.
Cómo funciona
- Cada texto de ticket se normaliza (mayúsculas, sin acentos, formato
4X125G) y se busca entre los nombres de ticket conocidos (la pestaña Alias): textos de ticket que ya apuntan a un producto, opcionalmente por cadena de tiendas. - Si el texto no coincide con seguridad, el sistema guarda una sugerencia (candidato) con una puntuación de confianza y la deja en Pendientes.
- Cuando tú la aceptas, el texto pasa a ser un nombre de ticket conocido y las siguientes líneas iguales se reconocen solas.
La puntuación se muestra como porcentaje con un color: verde si alcanza el umbral de aceptación automática, ámbar si alcanza el de revisión y gris si queda por debajo o no hay sugerencia. Los umbrales se editan en la pestaña Métricas.
Flujo típico
- En Productos, pulsa Importar productos y sube tu maestro (ver Importar productos). Se crean los productos y sus nombres de ticket iniciales.
- A medida que llegan tickets, las líneas dudosas aparecen en Pendientes.
- Revisa cada texto: Aceptar la sugerencia, Elegir producto si es otro, Ignorar o No es nuestro. Para sugerencias de alta confianza usa Aceptar en bloque.
- En la pestaña Alias (nombres de ticket) corrige lo aprendido (deshabilitar, dividir) o añade uno a mano, y en Conflictos resuelve los textos ambiguos.
- En Métricas comprueba la cobertura de reconocimiento automático y ajusta los umbrales.
Pestañas
Pendientes
Es la pestaña inicial. Agrupa por texto de ticket las sugerencias a la espera de revisión, de más a menos frecuentes.
| Columna | Qué es |
|---|---|
| Texto del ticket | Un ejemplo de cómo aparece la línea en el ticket. |
| Ocurrencias | Veces que se ha visto ese texto. |
| Cadenas | Cadenas de tiendas en las que aparece. |
| Sugerencia | Producto propuesto y su puntuación de confianza. |
Filtros: búsqueda por texto y desplegable de cadena (Todas las cadenas).
| Acción | Qué hace |
|---|---|
| Aceptar | Crea el nombre de ticket hacia el producto sugerido. Desactivado si no hay sugerencia. |
| Elegir producto | Abre un buscador para asignar otro producto distinto del sugerido. |
| Ignorar | Descarta la sugerencia sin enseñar nada al sistema. |
| No es nuestro | Marca el texto como un producto que no es tuyo (tras confirmar). Si había un producto sugerido, se guarda un nombre de ticket negativo para no volver a proponerlo. |
| Aceptar en bloque | Acepta de una vez todas las sugerencias con puntuación igual o superior al valor del deslizador Aceptar sugerencias desde (entre 50 % y 100 %). Respeta el filtro de cadena y pide confirmación. |
Cada operación procesa como máximo 500 elementos y avisa de cuántos se han procesado.
Alias
La pestaña Alias lista los nombres de ticket ya conocidos (los textos tal como salen impresos en el recibo) y el producto al que apuntan.
| Columna | Qué es |
|---|---|
| Texto del ticket | Texto normalizado del nombre de ticket (con la marca Deshabilitado si lo está). |
| Producto | Producto al que apunta. |
| Cadena | Cadena concreta, o Todas las cadenas si vale para cualquiera. |
| Origen | Manual, OCR (EAN), Aprendido, IA (LLM), Importación o Retroactivo. |
| Confianza | Confianza del nombre de ticket. |
| Confirmaciones / rechazos | Veces que se ha confirmado o corregido a mano. |
Filtros: texto, cadena, origen, confianza (≥ 90 % o ≥ 60 %) y estado (Activo / Deshabilitado).
Acciones por fila: Deshabilitar / Habilitar (un nombre de ticket deshabilitado deja de usarse, sin borrarlo), Borrar (solo en los de origen Manual; pide confirmación con «¿Borrar este nombre de ticket manual?» y elimina el registro) y Dividir, para un texto ambiguo que en cada cadena significa un producto distinto: eliges un producto por cadena con Añadir cadena.
Productos
Tu maestro de productos para el reconocimiento.
- Dos indicadores: Productos con código de barras y Productos con alias (porcentaje sobre el total).
- Tabla con Nombre (y variante), Tamaño, Códigos de barras (el principal, resaltado) y número de Alias. Los productos inactivos se muestran atenuados.
- Búsqueda por texto y el botón Importar productos (solo con permiso de edición).
Conflictos
Lista de textos de ticket que, en una misma cadena, apuntan a varios productos a la vez, con la confianza y las confirmaciones/rechazos de cada nombre de ticket. Si no hay ninguno verás «Sin conflictos: ningún texto de ticket apunta a varios productos». Para resolverlos, ve a Alias y deshabilita o divide el que sobre.
Métricas
Resumen del periodo elegido (Periodo (días): 7, 30 o 90; por defecto 30) sobre las líneas de ticket procesadas:
| Indicador | Qué mide |
|---|---|
| Cobertura de auto-reconocimiento | Porcentaje de líneas reconocidas sin intervención humana. |
| Líneas desconocidas | Líneas que no se pudieron asociar a un producto, con su evolución por día. |
| Correcciones manuales | Rechazos registrados sobre nombres de ticket en el periodo. |
| Precisión estimada | 100 % menos las correcciones sobre las líneas reconocidas automáticamente. Es una estimación, no una medida exacta. |
| Cadenas con más líneas sin alias | Dónde conviene empezar a revisar o importar nombres de ticket. |
Esta pantalla solo cuenta las líneas, no las lista una a una. Si ves «Aún no hay líneas de ticket en este periodo», todavía no se han procesado tickets.
En esta pestaña está el editor de Umbrales de confianza (solo con permiso de edición):
| Campo | Qué hace | Valor por defecto |
|---|---|---|
| Aceptar automáticamente desde | Puntuación a partir de la cual una línea se acepta sin revisión. | 0,90 |
| Revisar desde | Puntuación mínima para que se proponga como sugerencia a revisar. | 0,60 |
| Confirmaciones para aprender un alias | Confirmaciones humanas que necesita un nombre de ticket aprendido para aplicarse solo. | 1 |
| Exigir doble confirmación humana | Pide una segunda confirmación antes de aprender. | Desactivado |
Los dos umbrales deben estar entre 0 y 1, y Revisar desde no puede ser mayor que Aceptar automáticamente desde. Los valores son por cuenta.
Productos sin código de barras
El EAN no es obligatorio. Muchos tickets no lo imprimen, y aun así cada línea se intenta reconocer. Para cada línea, IncentIA prueba estos pasos en orden y se queda con el primero que da respuesta:
- EAN, si el ticket lo trae impreso y coincide con un producto de tu maestro.
- Nombre de ticket de la cadena: un texto ya conocido para esa cadena de tiendas.
- Nombre de ticket global: un texto ya conocido que vale para cualquier cadena.
- Parecido de texto: se compara la línea con los nombres de tus productos, teniendo en cuenta el tamaño y, si hay datos, el precio.
- Búsqueda por significado y, como último recurso, IA. Ambas opciones son opcionales y vienen desactivadas por defecto; si no están activas, este paso no se usa. Lo que proponen siempre se revisa a mano.
Si el texto coincide con un nombre de ticket conocido, la línea se reconoce al momento. Si solo hay parecido de texto o una propuesta de IA, la línea se propone y una persona la confirma; entra en Pendientes en vez de aceptarse sola. Si dos productos puntúan casi igual, tampoco se decide sola.
Un producto, muchos nombres
Un mismo producto aparece con nombres distintos según la cadena o el ticket. Cada nombre es un nombre de ticket (la pestaña y los contadores de la pantalla lo llaman «alias»): un texto de ticket normalizado, el producto al que apunta y, de forma opcional, una cadena concreta. Puedes tener tantos nombres de ticket por producto como necesites. Se crean de estas formas:
| Forma | Cómo funciona |
|---|---|
| Importación | Al importar productos se generan nombres de ticket a partir del nombre, la variante y el tamaño. Valen para todas las cadenas. |
| Elegir producto | En Pendientes, asignas un producto concreto al texto con Elegir producto. Se crea el nombre de ticket con tu confirmación. |
| Dividir | En Alias, Dividir reparte un texto ambiguo en un producto distinto por cadena. Los nombres de ticket nuevos se marcan como Manual. |
| Aprendido en la revisión | Al confirmar o corregir una línea de ticket en la revisión de evidencias, el texto queda como nombre de ticket de ese producto en esa cadena (origen Aprendido). |
| Añadir nombre de ticket | En Alias, lo escribes a mano (ver Añadir un nombre de ticket a mano). Origen Manual. |
| Lista de candidatos | Pendientes reúne los textos que se repiten sin reconocer, con un producto sugerido si lo hay. Puedes Aceptar o Ignorar uno a uno, o Aceptar en bloque. |
Añadir un nombre de ticket a mano
En la pestaña Alias, el botón Añadir nombre de ticket (solo con permiso de edición) abre un formulario con tres campos: Producto, Texto del ticket (el nombre «tal como sale impreso en el recibo») y Cadena (por defecto Todas las cadenas). Al guardar se crea con origen Manual y confianza 100 %. El texto se normaliza igual que los de los tickets. Se rechaza si:
- El texto está vacío: «Escribe el nombre de ticket tal como aparece impreso en el recibo.»
- Ya lo usa otro producto en esa cadena: «Ese nombre de ticket ya pertenece a otro producto en esta cadena. Quítalo primero allí.» (uno deshabilitado no cuenta).
- Está marcado como negativo para ese producto («no es este producto»): «Ese nombre de ticket está marcado como «no es este producto» para este producto. Quita primero esa marca.»
- La cadena no existe: «No se encontró la cadena.»
Si ya existía para ese producto y cadena deshabilitado, se reactiva como Manual en lugar de duplicarse.
Borrar un nombre de ticket manual
Borrar solo aparece en los de origen Manual (los añadidos a mano o creados con Dividir). Tras confirmar, se elimina de verdad; no se puede deshacer. Para los demás orígenes usa Deshabilitar.
Cuándo se aplica un nombre de ticket solo
Los nombres de ticket que ha aprendido la máquina (origen Aprendido o IA (LLM)) no se aplican solos hasta tener las confirmaciones humanas que marca Confirmaciones para aprender un alias (por defecto, 1). Mientras no las tengan, la línea se propone para que la confirmes con un clic. Los nombres de ticket manuales y de importación se aplican directamente.
- Si el ticket trae además un EAN que coincide con el producto del nombre de ticket, una confirmación basta.
- Con Exigir doble confirmación humana, todo nombre de ticket que no sea manual necesita al menos 2 confirmaciones, de personas distintas, y el atajo del EAN deja de valer.
- Aceptar una sugerencia en Pendientes cuenta como confirmación humana.
Nombres de ticket negativos y caducidad
- Nombre de ticket negativo. Con No es nuestro declaras que un texto no es ese producto. Se guarda como nombre de ticket con la marca Negativo y el sistema no vuelve a proponer ese producto para ese texto. Si el texto no coincide con ningún otro producto, la línea queda como desconocida.
- Caducidad. Un proceso diario baja la confianza de los nombres de ticket que llevan mucho tiempo sin verse en ningún ticket. Un nombre de ticket que nunca se ha confirmado y se ha rechazado repetidamente se deshabilita. No se borra nada: puedes volver a Habilitar el nombre de ticket en la pestaña Alias.
Ejemplo
Tu marca vende «Yogur natural 4x125 g». Tienes la cadena ficticia «Supermercados Norte».
- Importas tu maestro. El producto ya tiene nombres de ticket de importación como
YOGUR NATURAL. - Llega un ticket de Supermercados Norte con la línea
YOG NAT 4X125Gy sin EAN. No hay un nombre de ticket exacto, así que el sistema la compara por texto y propone «Yogur natural 4x125 g». Queda en Pendientes con su puntuación. - Una persona pulsa Aceptar. Se crea el nombre de ticket
YOG NAT 4X125Gpara Supermercados Norte y apunta a ese producto. - En el siguiente ticket de esa cadena, la misma línea se reconoce sola, sin intervención.
- Más tarde ves que en otra cadena ficticia, «Tiendas del Sur», el texto
YOG NATes otro producto. Con Dividir asignas cada cadena a su producto.
Importar productos
En Productos › Importar productos. Es un asistente en tres pasos.
- Subir y leer archivo. Archivo
.csvo.xlsx, de hasta 5 MB y 10.000 filas de datos. La primera fila debe ser la cabecera. - Mapeo. IncentIA asocia las columnas por el nombre de la cabecera; revisa qué columna alimenta cada campo y ajústalo. Pulsa Previsualizar.
- Previsualización e importación. Ves cada fila como Crear, Actualizar o Sin cambios, y los errores por fila. Pulsa Importar. La previsualización caduca a los 30 minutos.
| Campo | Cabeceras reconocidas (ejemplos) | Reglas |
|---|---|---|
| Nombre | nombre, name, producto, descripcion | Obligatorio. Máximo 256 caracteres. |
| Código de barras (EAN/GTIN/CN) | ean, gtin, barcode, cn, codigo | Varios códigos en la misma celda, separados por ;. Si tiene longitud de EAN/GTIN (8, 12, 13 o 14 dígitos) se valida el dígito de control. Un código de 6-7 dígitos se trata como código nacional de farmacia. |
| Tamaño | tamano, size, formato, contenido | Número positivo; admite coma o punto y también 165g con la unidad pegada. |
| Unidad | unidad, unit | g, kg, ml, cl, l, ud… Los kilos y litros se convierten a gramos y mililitros. |
| Pack | pack, multipack | Entero de 1 a 999. |
| Variante | variante, sabor, variant | Máximo 256 caracteres. |
| Categoría | categoria, category | Máximo 256 caracteres. |
| SKU | sku, referencia, ref | Máximo 100 caracteres. |
Solo el nombre es obligatorio.
Errores de fila que impiden importarla: falta el nombre, nombre demasiado largo, código de barras no válido (dígito de control), código o SKU repetido en el archivo, código que ya pertenece a otro producto, unidad desconocida, tamaño o pack no válidos y valores demasiado largos. Marca Importar solo las filas válidas y omitir las que tienen errores para importar el resto; si no, hay que corregir el archivo.
Qué hace al importar:
- Un producto existente se localiza primero por SKU y, si no, por su código de barras principal; si lo encuentra, lo actualiza y, si no, lo crea. Volver a importar el mismo archivo no cambia nada.
- Por cada producto genera automáticamente nombres de ticket de importación (nombre, nombre con variante, versiones abreviadas y con tamaño) válidos para todas las cadenas, con confianza del 90 %.
- Al terminar ves el resumen: Creados, Actualizados, Sin cambios, Omitidos, Códigos de barras añadidos y Alias añadidos. Las filas que cambiaron entre la previsualización y la importación se listan como rechazadas.
Estados y límites
- Importación: 5 MB, 10.000 filas, sesión de previsualización de 30 minutos. Requiere un programa de fidelización creado.
- Aceptar, ignorar y marcar como «no es nuestro»: máximo 500 candidatos por operación.
- Los productos de la importación se crean en el primer programa de fidelización de la cuenta.
Permisos
| Quiero… | Permiso | Clave |
|---|---|---|
| Ver la pantalla y sus pestañas | Reconocimiento de productos | Pages.Loyalty.ProductRecognition |
| Importar, aceptar, ignorar, dividir, deshabilitar, añadir o borrar nombres de ticket y cambiar umbrales | Editando reconocimiento de productos | Pages.Loyalty.ProductRecognition.Edit |