Conecte o Odoo POS
O que isso faz
Conecte seu Odoo Ponto de Venda e os caixas que você escolher passam a fazer o trabalho de fidelidade por você. Sua equipe registra a venda como sempre, com um pequeno hábito a mais: coloca o cliente na venda. O Passtastic vê a venda e atualiza o cartão do cliente, normalmente em segundos — sem nenhum aparelho separado para acumular.
Uma recompensa que o cliente já conquistou também funciona no balcão: um cartão de carimbos completo, um item do seu catálogo de pontos, uma vantagem do nível dele. Sua equipe escolhe a recompensa na venda e ela sai do valor, sem sair do Odoo.
Duas lojas, para ficar concreto:
- Rolling Pin, uma padaria com cartão de carimbos. Cada café vale um carimbo. O caixa coloca a Marta na venda, registra o flat white, e o cartão dela ganha o carimbo antes de ela achar uma mesa. Na décima visita, o croissant grátis já está na lista de recompensas do caixa.
- Foglia Verde, um empório com pontos. Um ponto por euro, e o pote de pesto custa 300 pontos. O Luca pede, o caixa escolhe o pote na venda, ele sai da conta e um minuto depois o cartão mostra o saldo que sobrou.
Esta integração está incluída em todos os planos do Passtastic: Single Location, Multi-Location e Groups & Brands.
O que funciona no caixa — e o que ainda precisa de leitura
No caixa sua equipe pode dar:
- a recompensa de um cartão de carimbos completo,
- um item do seu catálogo de pontos,
- uma vantagem do nível do cliente.
Uma oferta de campanha não pode ser resgatada no caixa. Um café grátis de aniversário, um mimo de "sentimos sua falta", qualquer coisa que você envie como oferta: isso continua sendo entregue como sempre. Sua equipe abre o app Passtastic Scanner, lê o cartão do cliente e confirma a oferta ali. Deixe o app de leitura em um celular atrás do balcão exatamente para isso.
Quais cartões podem acumular com as vendas do Odoo
- Cartões de pontos e de níveis acumulam de acordo com a regra de pontos vinculada ao cartão, por exemplo um ponto por euro. Um cartão sem regra vinculada não acumula nada até você configurar uma.
- Cartões de carimbos acumulam um carimbo por venda paga — ou um por item que conte, se você escolher assim ao configurar o programa.
- Cupons, pacotes (carimbos pré-pagos / pontos pré-pagos) e assinaturas não podem acumular com as vendas do Odoo, então não aparecem na lista de programas que você pode ativar.
Antes de começar
- Odoo com Ponto de Venda, versão 17, 18 ou 19, e permissão para criar uma chave de API. Odoo.sh, servidor próprio e Community funcionam; em um plano do Odoo Online, a conexão já diz na hora se o seu banco de dados responde.
- Um acesso ao Odoo que possa criar um usuário e conceder permissões.
- Pelo menos um cartão de pontos, de níveis ou de carimbos publicado no Passtastic. Se você ainda não tem nenhum, crie em Programas → Novo programa.
- O app Passtastic Scanner gratuito em um celular ou tablet — você vai continuar usando para as ofertas de campanha.
- Opcional: um leitor de código de barras no caixa, para a equipe chamar o cliente lendo o cartão dele em vez de digitar o nome.
Passo 1 — Crie um usuário no Odoo e pegue a chave de API
Dê ao Passtastic um usuário próprio no Odoo em vez de usar o seu. Assim você vê o que ele fez, e desligá-lo depois é um clique.
1. No Odoo, crie um novo usuário — chame de algo como *Passtastic Integration* — e dê a ele a permissão de ponto de venda Point of Sale: User e a permissão da agenda Contacts.
2. Entre no Odoo com esse usuário.
3. Clique no avatar no canto superior direito e depois na entrada de configurações pessoais Preferences.
4. Abra a seção de segurança Account Security e clique em New API Key.
5. Quando o Odoo perguntar por quanto tempo a chave deve valer, escolha a opção sem validade Persistent Key e copie a chave.
O Odoo mostra a chave uma única vez e nunca mais. Copie antes de sair dessa tela; se perder, crie outra.
Você também vai precisar de três dados do mesmo Odoo: o endereço do Odoo (o endereço em que você abre o Odoo, por exemplo `https://suaempresa.odoo.com`), o nome do banco de dados (aparece na tela de login do Odoo) e o login desse usuário (o e-mail com que ele entra).
Passo 2 — Conecte o Odoo ao Passtastic
1. No seu painel do Passtastic, abra Configurações e depois Integrações (em Negócio).
2. Encontre Odoo POS e clique em Conectar.
3. Preencha o endereço do Odoo, o nome do banco de dados, o login do usuário da integração e a chave de API, e clique em Conectar Odoo.
O Passtastic confere os dados no seu Odoo e traz a lista dos seus caixas.
A acumulação começa a partir de agora, não do mês passado. As vendas que já estão no seu Odoo não são creditadas retroativamente. Tudo que for registrado a partir deste momento acumula.
Passo 3 — Ligue seus caixas às suas localizações
A página mostra uma linha para cada caixa do seu Odoo. Para cada um, escolha a localização do Passtastic em que ele fica e ative Acumula fidelidade nos caixas que devem contar.
- Os caixas que conseguimos identificar pelo nome já vêm preenchidos. O que não conseguimos identificar começa em Não usar.
- Ainda não tem uma localização para ele? Use + Nova localização… na mesma lista para criar sem sair da página.
- Um caixa marcado como Precisa de atenção não estava na última lista enviada pelo seu Odoo. Ele continua acumulando e continua ocupando um ponto de leitura, então confira se ainda quer que ele conte.
Um caixa que acumula ocupa um ponto de leitura. Os pontos de leitura são a mesma cota que os apps de leitura da sua equipe usam — três no Single Location, nove no Multi-Location, trinta no Groups & Brands. O rodapé deste passo mostra quantos você já usou. Cada localização com um caixa acumulando inclui um leitor para a equipe de graça, então desligar um caixa nem sempre faz esse número cair.
Passo 4 — Quais programas acumulam?
Em seguida você vê seus programas de fidelidade. Ative os que devem acumular com as vendas do Odoo e decida para cada um:
- Acumular em — todas as vendas, ou só as vendas que tenham um item das categorias de produto do Odoo que você escolher.
- Carimbos, em um cartão de carimbos — um por venda, ou um por item que conte, até o limite que você definir.
- Recompensas no caixa — se uma recompensa deste programa pode ser dada direto do caixa.
Nos cartões de pontos e de níveis, confira se há uma regra de pontos vinculada. Sem ela o cartão não acumula nada, por mais vendas que passem.
Passo 5 — Diga ao Odoo em quais produtos uma recompensa pode ser usada
Quando você ativa um cartão, criamos no seu Odoo uma etiqueta chamada Passtastic: <nome da sua recompensa>. Uma recompensa que dá algo de graça — um croissant grátis, um café grátis — só pode ser descontada de um produto que tenha essa etiqueta, então nunca dá desconto na conta inteira por engano.
Coloque a etiqueta nos produtos que você aceita dar de graça: no Odoo abra o produto e adicione em Product Tags. Um produto já basta; adicione mais se o cliente puder escolher.
Até você fazer isso, a recompensa aparece na tela do caixa e não desconta nada. Recompensas que são uma porcentagem da conta inteira não precisam de etiqueta.
Passo 6 — Deixe instantâneo (opcional)
O Passtastic pede ao seu Odoo que nos avise no momento em que a venda é paga — por isso as vendas normalmente chegam em segundos. Se o usuário que você criou não tiver permissão para configurar isso, o Passtastic mostra cinco passos curtos e o endereço para você mesmo colar no Odoo.
De um jeito ou de outro nada se perde: também consultamos seu Odoo a cada minuto, então uma venda chega dentro de um minuto mesmo que você nunca faça este passo.
Passo 7 — Atualize cada caixa uma vez para as recompensas aparecerem
Um caixa guarda a própria cópia dos seus produtos e programas de fidelidade, então um caixa já aberto ainda não conhece uma recompensa que você acabou de ativar. Em cada caixa, abra o menu (☰ no canto superior direito), escolha Reload Data e depois Limited. Faça isso depois de conectar e sempre que ativar outro cartão ou mudar uma recompensa. Finalize antes uma venda em andamento: ao recarregar, um cupom aberto é perdido.
O que sua equipe faz no balcão
O único hábito: colocar o cliente na venda. Sua equipe busca o cliente pelo nome no Odoo e o adiciona à venda antes de receber — o mesmo passo de colocar um cliente em qualquer venda. É isso que gera o carimbo ou os pontos. Uma venda sem ninguém vinculado não acumula nada.
Se você tiver um leitor de código de barras no caixa, a equipe pode ler o cartão da carteira do cliente em vez de digitar o nome; vem o mesmo cliente.
Dar uma recompensa. Com o cliente na venda, as recompensas que ele conquistou aparecem ali no caixa. A equipe escolhe uma e ela sai do valor — nada para digitar, nada para lembrar. Se o cliente preferir guardar, ninguém escolhe nada e ela continua no cartão dele.
As ofertas de campanha continuam no app de leitura. Um café de aniversário ou um mimo de "volte logo" é confirmado lendo o cartão do cliente no app Passtastic Scanner e entregue no balcão como sempre.
Seus membros nos seus contatos do Odoo
Seus membros aparecem no Odoo sozinhos. Quando alguém entra no seu programa, o Passtastic o adiciona aos seus contatos do Odoo com nome, e-mail e telefone, para a equipe achar a pessoa no balcão com uma busca só. Os membros que entraram antes da conexão são preenchidos ao longo dos dias seguintes. Quem o Odoo já tem com o mesmo e-mail ou telefone é vinculado, não duplicado.
Uma exceção: um membro que não deixou nem e-mail nem telefone não entra nos seus contatos — não há com o que casar nem o que buscar. Esses clientes você atende como sempre: leia o cartão deles com o app Passtastic Scanner.
Os membros são adicionados automaticamente — não há um botão para desligar isso. Os contatos já criados continuam no Odoo, e remover um membro no Passtastic nunca apaga o contato dele no Odoo.
Devoluções
Ao estornar uma venda no Odoo, o Passtastic retira o que aquela venda tinha gerado, proporcional ao que foi devolvido: devolveu metade da venda, saem metade dos pontos. Um cartão nunca fica negativo — se o cliente já gastou aqueles pontos, para no zero. Você pode desligar isso com Retirar pontos nas devoluções na página do Odoo dentro do Passtastic.
Perguntas frequentes
Preciso cadastrar meus clientes no Odoo por conta própria?
O que exatamente vocês escrevem no meu Odoo?
As devoluções retiram carimbos e pontos?
A equipe ainda pode ler o cartão com o app do Passtastic — isso não dá pontos duas vezes?
E se o cliente não estiver na venda?
Colocamos o cliente errado em uma venda. Dá para transferir?
Devolvemos uma venda em que o cliente usou uma recompensa. O que acontece com a recompensa?
E se um membro novo não for encontrado no caixa?
Resolução de problemas
"O Odoo não aceitou essa chave." A chave, o login, ou os dois não batem. A chave precisa pertencer ao login que você digitou, então confira se copiou a chave inteira e se o login é o e-mail com que aquele usuário entra. Na dúvida, crie uma chave nova no Odoo em Account Security e cole essa.
"Não conseguimos acessar seu Odoo nesse endereço." Use o endereço em que você abre o Odoo, incluindo `https://` e sem nada depois do domínio. Se o seu Odoo está em servidor próprio, confira se ele está no ar e acessível pela internet.
"Não vemos nenhum caixa no seu Odoo." Ou ainda não há caixa configurado no Odoo, ou o usuário que você criou não enxerga o caixa. Dê a esse usuário a permissão Point of Sale: User e tente de novo.
"Este Odoo já está conectado ao Passtastic." Esse banco de dados está conectado a outro negócio no Passtastic. Desconecte lá primeiro e depois conecte aqui.
"Reconhecemos este banco de dados do Odoo, mas ele responde em outro endereço." Seu Odoo mudou de lugar — domínio novo, ou do Odoo Online para servidor próprio. Desconecte a conexão antiga primeiro e depois conecte no endereço novo. Se isso for uma cópia do seu Odoo rodando ao lado do de verdade, conecte o de verdade.
Um aviso diz que este usuário do Odoo não pode criar contatos. A acumulação continua funcionando, mas os membros novos não vão aparecer nos seus contatos do Odoo. Dê ao usuário a permissão Contacts no Odoo e conecte de novo na página do Odoo; a partir daí os membros são preenchidos.
Os pontos ou carimbos não chegaram. Na maioria das vezes o cliente não estava na venda. Também pode ser questão de tempo: dê um minuto. Se mesmo assim não chegar, confira na página do Odoo se o caixa está ligado para acumular e apontado para a localização certa, e se o programa está ativo.
A recompensa não aparece no caixa. Feche aquele caixa e abra de novo uma vez — o Odoo só pega as recompensas na abertura de um caixa. Se continuar faltando, confira se Recompensas no caixa está ativo para esse programa e se o cliente realmente conquistou a recompensa.
Para gerenciar a fidelidade sem um POS, ou conectar outras ferramentas, veja Sistemas POS e integrações. Há uma visão geral do que o Odoo e o Passtastic fazem juntos na página da integração com o Odoo.