OneTrace.pro Centro de ayuda

Tiendas y ventas en tienda

Las compras en sus tiendas se pueden enviar a OneTrace.pro junto con los datos en línea. El ticket de caja llega al perfil del cliente junto a sus visitas al sitio, sus vistas de productos y sus correos. De ahí sale el informe ROPO: cuántas ventas de las tiendas hicieron clientes que antes se habían informado del producto en línea. Las compras en tienda están disponibles para los segmentos y los recorridos.

La sección está en Datos → Tiendas. Pueden verla los roles con permiso para ver el catálogo y las recomendaciones, y cambiar la regla y la lista, los roles con permiso para gestionarlos.

Sección «Tiendas»: regla de compra en tienda, tickets por punto de venta y lista de tiendas

Cómo distinguir una compra en tienda

Un ticket de tienda es el mismo evento de compra que un pedido del sitio, por ejemplo order_completed con el importe y los productos. Para que OneTrace.pro lo distinga de un pedido en línea, el ticket lleva una propiedad aparte. La regla se define en el bloque Cómo distinguir una compra en tienda:

  • Propiedad del evento de compra (por defecto): el ticket se envía con el evento de compra y la propiedad channel con el valor offline. La propiedad y el valor se pueden cambiar. El evento de compra se toma de la configuración de predicciones.
  • Evento independiente: si los tickets ya llegan con su propio evento, por ejemplo store_purchase, elíjalo.
  • Propiedad con el id de la tienda (por defecto store_id) vincula el ticket con un punto de venta de la lista.

La regla se aplica a todo a la vez: el informe ROPO, la condición del segmento, el disparador del recorrido y la carga del archivo de tickets.

Cómo enviar los tickets

El cliente del ticket se identifica por el teléfono, el correo electrónico o el número de la tarjeta de fidelidad. Si aún no hay un perfil con esos datos, se crea uno nuevo. Cuando el cliente deje el mismo teléfono o correo electrónico en el sitio, los perfiles se fusionarán y su historial en línea se unirá con las compras en la tienda; consulte Fusión de perfiles. Un ticket sin teléfono, correo electrónico ni tarjeta no se puede vincular con el historial en línea, por lo que no sirve para el informe.

Hay cuatro formas:

Forma Cuándo conviene
Extensión para 1C tickets de 1C:Retail, 1C:Small Business Management o 1C:Trade Management, de forma automática cada 15 minutos
API una caja o un sistema contable propios que puedan enviar solicitudes
Fuente de datos con la plantilla Tickets de tienda una exportación de tickets que el sistema deja cada noche en un archivo; consulte Importación de archivos y fuentes de datos
Carga de un archivo carga puntual de tickets de un período pasado, por ejemplo para ver el informe antes de conectar la caja

Elija la forma que elija, reenviar el mismo ticket en un plazo de 24 horas no crea un duplicado.

Extensión para 1C

Una extensión de configuración para 1C:Retail 2.3 y 3.0, 1C:Small Business Management (UNF) 1.6 y 3.0 y 1C:Trade Management 11, con la plataforma 1C:Enterprise 8.3.21 o posterior. La configuración no se modifica: todo está en la extensión.

  • Cada 15 minutos envía los nuevos «Чек ККМ» contabilizados: fecha, número, tienda, importe y productos. El cliente se identifica por el teléfono, el correo electrónico y la tarjeta de fidelidad del ticket.
  • Una vez al día envía la lista de tiendas.
  • Un ticket sin cliente se omite y se anota en el registro con el motivo. Los demás tickets se envían.
  • Si OneTrace.pro no está disponible o la clave es incorrecta, los tickets no se pierden: se enviarán en la siguiente ejecución.

Si el bloque Subir un archivo de tickets tiene el enlace la extensión para 1C, en él encontrará la extensión y las instrucciones de instalación y configuración. La extensión necesita una clave de API secreta con el permiso «Carga y eliminación de productos»: se requiere para la lista de tiendas. En el módulo de configuración de la extensión indique la dirección de OneTrace.pro y la clave, compruebe la conexión y guarde la configuración.

El producto del ticket se envía con el artículo de la nomenclatura, el código o el identificador único: elija en la configuración el que coincida con los id de producto del catálogo. De lo contrario, el informe ROPO no encontrará los productos que el cliente vio en el sitio.

API

Envíe el ticket con el evento track y una clave secreta. El cliente se pasa en context.traits; userId no hace falta:

{
  "event": "order_completed",
  "messageId": "check-ber01-000123",
  "timestamp": "2026-10-29T15:04:00+01:00",
  "properties": {
    "channel": "offline",
    "store_id": "BER-01",
    "order_id": "000123",
    "amount": 89.90,
    "products": [{ "product_id": "SKU-1", "price": 89.90, "quantity": 1 }]
  },
  "context": { "traits": { "phone": "+49 151 2345 6789", "loyalty_card": "2770 0001 5002" } }
}
  • La solicitud es POST /api/v1/track; por lotes, POST /api/v1/batch. Consulte Integración desde el servidor.
  • Al cliente se le busca por context.traits solo en las solicitudes con clave secreta. Con la clave de escritura del sitio no se puede: de lo contrario, un visitante podría hacerse pasar por otro con su teléfono.
  • messageId es el id permanente del ticket, por ejemplo la tienda y el número de ticket. Una repetición con el mismo messageId se descarta.
  • Si el cliente inició sesión en su cuenta del sitio y la caja conoce su id, envíe también userId.

Las tiendas se envían a la lista con la solicitud POST /api/v1/stores con el cuerpo {"items": [{"id": "BER-01", "name": "Berlin Mitte", "city": "Berlin", "address": "…"}]}: hasta 1000 puntos por vez, y un punto con el mismo id se actualiza. Hace falta el permiso «Carga y eliminación de productos».

Carga de un archivo de tickets

  1. En Datos → Tiendas, pulse Elegir un archivo en el bloque Subir un archivo de tickets. Sirve un CSV de hasta 50 MB o un Excel (.xlsx, .xls, primera hoja) de hasta 10 MB. La primera fila contiene los nombres de las columnas.
  2. Indique qué contiene cada columna: fecha y hora del ticket (obligatorio), teléfono, tarjeta de fidelidad, correo electrónico o id del cliente (al menos una columna), tienda, número de ticket, importe, productos. Las columnas con nombres parecidos se asocian solas. Omita las columnas innecesarias; las demás se pueden guardar como propiedades del ticket.
  3. Pulse Cargar tickets. El avance de la carga y los errores de las filas se ven en la página. Las últimas cargas aparecen bajo el formulario.

Carga de un archivo de tickets: asignación de columnas

  • La hora sin zona horaria, por ejemplo 2026-10-28 18:42 o 28.10.2026 18:42, se toma como la hora del proyecto: la caja suele registrar la hora local.
  • Los productos de una misma celda se separan con ;, , o |.
  • Cada fila se convierte en un ticket según la regla de compra en tienda. Una fila sin cliente se omite con un error.
  • La carga está disponible para los roles con permiso para modificar perfiles. Los tickets cargados cuentan en la cuota mensual de eventos del plan.

Lista de tiendas

La lista da a los puntos de venta nombres claros en el informe ROPO en lugar de los id de los tickets. Una tienda tiene un Id de la tienda (el valor de store_id en los tickets), un Nombre, una Ciudad y una Dirección. Se puede añadir una tienda con el botón Añadir tienda, mediante la API o con la extensión para 1C.

El bloque Tickets de los últimos 30 días muestra cuántos tickets y clientes hubo en cada punto y cuándo llegó el último ticket. Un punto que no está en la lista se marca como «No está en la lista», y el botón Ponerle nombre lo añade. Si elimina una tienda, sus tickets se conservan y el informe mostrará su id en lugar del nombre.

Segmentos y recorridos

  • La condición de segmento Compra en tienda selecciona a los clientes de las tiendas de los últimos N días. El campo «Contactos en línea antes del ticket»: «Cualquiera» para todos los clientes, «Después de un contacto en línea» o «Sin contactos en línea». Se pueden elegir la ventana de contactos, sus tipos y la tienda. Consulte Segmentos.
  • El disparador de recorrido Compra en tienda inicia el recorrido con cada ticket de una tienda. Se puede limitar la tienda y el importe mínimo, por ejemplo para pedir una valoración de la tienda o proponer productos para comprar. Consulte Recorridos.