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.
A conexão com o Odoo faz parte do pacote Conecte seu PDV. Ela fica ativa durante o teste grátis de 14 dias e é cobrada por localização; veja Preços. Se você remover o pacote, a conexão fica em pausa: as vendas deixam de somar carimbos ou pontos sozinhas, sua equipe lê o cartão como antes e nada é apagado. Está em um plano anterior? O seu plano mantém o que incluía; veja Compreender Limites dos Planos e Como Fazer Upgrade.
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.
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: Administrator e a permissão da agenda Contacts. O Administrator é necessário porque o Passtastic cria no seu Odoo os programas de fidelidade, as etiquetas de produto deles e a regra de código de barras dos cartões da wallet, e o Odoo só deixa um administrador de ponto de venda criar isso. Com Point of Sale: User a conexão falha.
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. Você tem 2 por negócio, mais 1 para cada unidade extra, e você pode adicionar mais em Pacotes e extras. 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.
- O que o caixa devolve, em um cartão de carimbos — o que é descontado quando o cartão fica completo: Desconto (um valor fixo ou uma porcentagem), Produto grátis ou A equipe resolve, se a sua equipe dá a recompensa manualmente. Cartões de pontos e de níveis não têm essa escolha aqui: num cartão de pontos, as recompensas no caixa são os itens do catálogo marcados como No caixa em Configurações → Regras de pontos e recompensas; num cartão de níveis, o % de desconto no caixa (opcional) de cada nível, na aba Configuração do programa.
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.
Se você voltar um cartão de carimbos para A equipe resolve e clicar em Salvar aqui, ou em Publicar na aba Configuração do cartão, tiramos a recompensa dele da lista de recompensas do Odoo. Um caixa que já está aberto continua oferecendo a recompensa antiga até você atualizá-lo: menu (☰ no canto superior direito) → Reload Data → Limited, como no passo 7.
Desativar um programa também tira a recompensa dele da lista do Odoo, então a equipe não consegue escolhê-la no caixa. Ative de novo e clique em Salvar para trazê-la de volta. Num caixa que já esteja aberto, faça Reload Data → Limited (passo 7).
Passo 5 — Diga ao Odoo em quais produtos uma recompensa pode ser usada
Quando você clica em Salvar num programa com recompensa — O que o caixa devolve num cartão de carimbos, ou um item do catálogo marcado como No caixa num cartão de pontos —, criamos no seu Odoo uma etiqueta chamada Passtastic: <nome da sua recompensa> (num cartão de carimbos, a linha do programa na página do Odoo mostra o nome exato). Um programa sem recompensa não recebe etiqueta. Cada uma dessas recompensas, tanto um item grátis quanto um desconto, só é descontada de produtos que tenham essa etiqueta, então nunca dá desconto na conta inteira por engano: “10% de desconto” são 10% sobre os produtos etiquetados.
Coloque a etiqueta nos produtos aos quais a recompensa deve se aplicar: no Odoo abra o produto e adicione em Product Tags. Um produto já basta; adicione mais se o cliente puder escolher.
Dê a cada produto só uma etiqueta do Passtastic. Se um produto tiver duas recompensas do Passtastic (por exemplo um Pacote e o café grátis de uma associação), o caixa do Odoo não consegue aplicar nenhuma das duas a ele: ao tocar em Reward, só entram mais itens pagos na venda. Use um produto separado para cada recompensa, por exemplo Café (Pacote) e Café (membro).
Até você fazer isso, a recompensa aparece na tela do caixa e não desconta nada. A única recompensa que não precisa de etiqueta é o % de desconto no caixa de um cartão de níveis: ele é descontado da venda inteira.
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, e-mail ou telefone 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.
Sua equipe lê o cartão da carteira do cliente no caixa do Odoo (com um leitor de código de barras no caixa) e o Odoo coloca o cliente na venda, ou busca pelo nome, e-mail ou telefone. Um limite: o Odoo guarda um só código de barras por cliente, então, se um cliente tem dois dos seus cartões, só o que ele mais usa o traz. Se, ao ler o outro cartão, o Odoo mostrar «Unknown Barcode», peça o outro cartão ou busque pelo nome. Pontos, carimbos e recompensas dos dois cartões funcionam normalmente depois que o cliente está na venda.
Dar uma recompensa. Lance primeiro o item, depois coloque o cliente na venda, toque em Reward e escolha a recompensa. Para um item grátis, o Odoo costuma adicionar um segundo item igual e descontar o valor dele, então a venda mostra dois: um pago e um grátis. Se o cliente quer só o grátis, selecione a linha paga, toque em Qty e digite 1: a linha grátis fica e o total vai a zero. Se o cliente preferir guardar a recompensa, 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.
Pacotes e associações no caixa
Os clientes também podem usar um Pacote ou um benefício de uma associação no caixa do Odoo: um café pré-pago, ou a degustação grátis que vem com a associação.
Ative. Na página do Odoo, em Quais programas acumulam?, encontre o cartão do Pacote ou da associação e ative Resgatar no caixa. Depois, no Odoo, coloque a etiqueta que aparece nessa linha, em Product Tags, nos produtos que o Pacote ou cada benefício dá de graça, como no passo 5. Por fim, atualize cada caixa: menu (☰ no canto superior direito) → Reload Data → Limited, como no passo 7.
No caixa. Sua equipe lança o item, coloca o cliente na venda buscando pelo nome, e-mail ou telefone, toca em Reward e escolhe o Pacote ou o benefício. Como em qualquer item grátis, o Odoo costuma adicionar um segundo item igual e descontar o valor dele; se o cliente quer só o grátis, volte a linha paga para 1 (Qty e depois 1). O uso do Pacote ou o benefício sai da conta, e o passe é atualizado em cerca de um minuto. Cada produto deve ter só uma etiqueta do Passtastic (veja o passo 5), senão o caixa não consegue aplicar nenhuma das recompensas. Também dá para usar um Pacote que o cliente ainda não instalou no celular. Sua equipe deve dar um benefício por cupom; o Odoo não impede um segundo.
Devoluções. Devolva a venda no Odoo e o uso volta para o passe. Só volta um uso que foi realmente descontado.
Se um cliente usa mais do que tem. Isso acontece quando um caixa estava offline ou dois caixas foram usados ao mesmo tempo. A venda nunca é recusada: o cliente fica com o que recebeu, nada é tirado dos outros cartões dele, o uso a mais fica registrado no histórico do cliente e você recebe uma notificação no sino do seu painel.
O crédito pré-pago ainda não pode ser resgatado no caixa do Odoo. Por enquanto, sua equipe o resgata com o app Passtastic Scanner.
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. Se o endereço está certo, confira se o usuário que você criou tem a permissão Point of Sale: Administrator (passo 1): o Odoo recusa um usuário com menos que isso, e por enquanto isso aparece como esta mensagem.
"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: Administrator 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. Atualize aquele caixa: menu (☰ no canto superior direito) → Reload Data → Limited, como no passo 7. Fechar e abrir de novo não basta — um caixa guarda a própria cópia dos seus programas de fidelidade. Se a recompensa continuar faltando, confira se o programa tem uma recompensa definida (O que o caixa devolve num cartão de carimbos, um item do catálogo em No caixa num cartão de pontos, um % de desconto no caixa (opcional) num nível), se depois você clicou em Salvar na página do Odoo e se o cliente realmente conquistou a recompensa.
O programa diz que o Odoo recusou criar a recompensa. O Odoo recusou a recompensa ao salvar, e a mensagem mostra o motivo dado pelo Odoo. Verifique se o Odoo continua conectado e clique em Salvar naquele programa de novo. Se em vez disso disser que a recompensa não está completa, complete O que o caixa devolve naquela linha e salve novamente.
O programa diz: “Não conseguimos remover esta recompensa do Odoo, então a equipe ainda pode escolhê-la no caixa.” Até isso ser resolvido, a equipe ainda pode escolher a recompensa antiga no caixa. Verifique se o Odoo continua conectado e clique em Salvar naquele programa de novo. Depois, atualize qualquer caixa que já esteja aberto: menu (☰ no canto superior direito) → Reload Data → Limited, como no passo 7.
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.