Lojas e vendas offline
As compras feitas nas suas lojas podem ser enviadas ao OneTrace.pro junto com os dados online. O cupom do caixa vai para o perfil do cliente, ao lado das visitas ao site, das visualizações de produtos e dos e-mails. Disso vem o relatório ROPO: quantas vendas das lojas foram feitas por clientes que antes pesquisaram o produto online. As compras nas lojas ficam disponíveis para segmentos e jornadas.
A seção fica em Dados → Lojas. Ela pode ser vista por funções com permissão para ver produtos; a regra e a lista de lojas podem ser alteradas por funções com permissão para alterar produtos.

Como identificar uma compra na loja
O cupom de uma loja é o mesmo evento de compra que um pedido do site, por exemplo order_completed com valor e produtos. Para que o OneTrace.pro o distinga de um pedido online, o cupom tem uma propriedade própria. A regra é definida no bloco Como identificar uma compra na loja:
- Propriedade do evento de compra (padrão): o cupom é enviado como evento de compra com a propriedade
channele o valoroffline. A propriedade e o valor podem ser alterados. O evento de compra vem das configurações de previsões. - Evento separado: se os cupons já chegam com um evento próprio, por exemplo
store_purchase, escolha-o. - Propriedade com o id da loja (padrão
store_id) liga o cupom a um ponto de venda da lista.
A regra vale de imediato para tudo: o relatório ROPO, a condição de segmento, o gatilho de jornada e o envio de arquivo de cupons.
Como enviar os cupons
O cliente do cupom é identificado pelo telefone, pelo e-mail ou pelo número do cartão de fidelidade. Se ainda não existir um perfil com esses dados, um novo é criado. Quando o cliente informar o mesmo telefone ou e-mail no site, os perfis serão mesclados e o histórico online dele se unirá às compras na loja; veja Mesclagem de perfis. Um cupom sem telefone, e-mail e cartão não pode ser ligado ao histórico online, por isso não serve para o relatório.
Há quatro maneiras:
| Maneira | Quando serve |
|---|---|
| Extensão para o 1C | cupons do 1C:Retail, 1C:Small Business Management ou 1C:Trade Management, automaticamente a cada 15 minutos |
| API | caixa ou sistema de gestão próprio que pode enviar requisições |
| Fonte de dados com o modelo Cupons das lojas | exportação de cupons que o sistema coloca todas as noites em um arquivo; veja Fontes de dados |
| Envio de arquivo | envio único de cupons de um período passado, por exemplo para ver o relatório antes de conectar o caixa |
Seja qual for a maneira, reenviar o mesmo cupom em até 24 horas não cria duplicata.
Extensão para o 1C
Uma extensão de configuração para 1C:Retail 2.3 e 3.0, 1C:Small Business Management (UNF) 1.6 e 3.0 e 1C:Trade Management 11, na plataforma 1C:Enterprise 8.3.21 ou mais nova. A configuração não é alterada: tudo fica na extensão.
- A cada 15 minutos, envia os novos cupons fiscais lançados (documento «Чек ККМ»): data, número, loja, valor e produtos. O cliente é identificado pelo telefone, e-mail e cartão de fidelidade do cupom.
- Uma vez por dia, envia a lista de lojas.
- Um cupom sem cliente é ignorado e registrado no diário de registro com o motivo. Os demais cupons são enviados.
- Se o OneTrace.pro estiver indisponível ou a chave estiver incorreta, os cupons não se perdem: serão enviados na próxima execução.
Se o bloco Enviar um arquivo de cupons tiver o link a extensão para 1C, ele leva à extensão e às instruções de instalação e configuração. A extensão precisa de uma chave de API secreta com a permissão “Enviar e excluir produtos”: ela é necessária para a lista de lojas. No processamento de configuração da extensão, informe o endereço do OneTrace.pro e a chave, teste a conexão e salve as configurações.
O produto no cupom é enviado pelo código de artigo da nomenclatura, pelo código ou pelo identificador único; escolha nas configurações o que coincide com os ids dos produtos no catálogo. Caso contrário, o relatório ROPO não encontrará os produtos que o cliente viu no site.
API
Envie o cupom com um evento track e a chave secreta. O cliente vai em context.traits; userId não é necessário:
{
"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" } }
}
- A requisição é
POST /api/v1/track, em lotePOST /api/v1/batch; veja Integração pelo servidor. - Só requisições com a chave secreta encontram o cliente por
context.traits. Com a chave de gravação do site isso não é possível: caso contrário, um visitante poderia se passar por outro usando o telefone dele. messageIdé o id permanente do cupom, por exemplo a loja e o número do cupom. Uma repetição com o mesmomessageIdé descartada.- Se o cliente entrou na área do cliente no site e o caixa conhece o id dele, envie também
userId.
As lojas são enviadas para a lista com a requisição POST /api/v1/stores e o corpo {"items": [{"id": "BER-01", "name": "Berlin Mitte", "city": "Berlin", "address": "…"}]}: até 1000 pontos por vez, e um ponto com o mesmo id é atualizado. É preciso a permissão “Enviar e excluir produtos”.
Envio de arquivo de cupons
- Em Dados → Lojas, clique em Escolher um arquivo no bloco Enviar um arquivo de cupons. Serve um CSV de até 50 MB ou um Excel (.xlsx, .xls, primeira planilha) de até 10 MB. A primeira linha tem os nomes das colunas.
- Indique o que há em cada coluna: data e hora do cupom (obrigatório), telefone, cartão de fidelidade, e-mail ou id do cliente (pelo menos uma coluna), loja, número do cupom, valor, produtos. Colunas com nomes parecidos são associadas sozinhas. Ignore as colunas desnecessárias; as demais podem ser salvas como propriedades do cupom.
- Clique em Enviar cupons. O andamento do envio e os erros de linha aparecem na página. Os envios recentes ficam abaixo do formulário.

- Um horário sem fuso, por exemplo
2026-10-28 18:42ou28.10.2026 18:42, é considerado no fuso do projeto: o caixa costuma gravar o horário local. - Os produtos em uma mesma célula são separados por
;,,ou|. - Cada linha vira um cupom conforme a regra de compra na loja. Uma linha sem cliente é ignorada com um erro.
- O envio está disponível para funções com permissão para alterar perfis. Os cupons enviados contam na cota mensal de eventos do plano.
Lista de lojas
A lista dá aos pontos de venda nomes claros no relatório ROPO, no lugar dos ids dos cupons. Cada loja tem Id da loja (o valor de store_id nos cupons), Nome, Cidade e Endereço. Você pode adicionar uma loja com o botão Adicionar loja, pela API ou pela extensão para o 1C.
O bloco Cupons dos últimos 30 dias mostra quantos cupons e clientes cada ponto teve e quando chegou o último cupom. Um ponto que não está na lista é marcado como “Fora da lista”, e o botão Dar nome o adiciona. Se você excluir uma loja, os cupons dela permanecem, e no relatório aparece o id no lugar do nome.
Segmentos e jornadas
- A condição de segmento Compra na loja seleciona os clientes das lojas nos últimos N dias. O campo “Contatos online antes do cupom” tem as opções “Qualquer” (todos os clientes), “Depois de um contato online” ou “Sem contatos online”. Você pode escolher a janela dos contatos, os tipos deles e a loja. Veja Segmentos.
- O gatilho de jornada Compra na loja inicia a jornada a cada cupom de uma loja. Você pode limitar a loja e o valor mínimo, por exemplo para pedir uma avaliação da loja ou sugerir produtos complementares. Veja Jornadas.