Conecte o Holded POS

O que isso faz

Conecte sua conta Holded e seu programa de fidelidade passa a acumular direto no seu caixa Holded. Quando sua equipe registra uma venda paga com um cliente vinculado, o Passtastic identifica isso automaticamente — sem necessidade de um dispositivo separado para acumular. Para dar uma recompensa, sua equipe ainda confirma com uma leitura rápida no app Passtastic Scanner, assim como em qualquer outro caixa.

Quais cartões podem acumular com as vendas do Holded

• Cartões de pontos e de níveis acumulam de acordo com suas regras de pontos — a regra de acúmulo vinculada ao cartão define quanto vale uma venda. Se um cartão ainda não tiver uma regra de acúmulo vinculada, ele não vai acumular até você configurar uma.
• Cartões de carimbos acumulam 1 carimbo por venda paga — não precisa de nenhuma regra.
• Cupons, pacotes (carimbos pré-pagos / pontos pré-pagos) e assinaturas não podem acumular com as vendas do Holded. Esses tipos não têm uma forma de acumular a partir de uma transação do PDV, então eles não aparecem na lista de cartões que você pode ativar.

Antes de começar

• Acesso à sua conta Holded com permissão para criar credenciais de API.
• Pelo menos um cartão de fidelidade publicado no Passtastic que possa acumular (um cartão de pontos, de níveis ou de carimbos). Se você ainda não tiver um, crie primeiro em Programs → Create New Program (Programas → Criar novo programa).
• O app Passtastic Scanner gratuito em um celular ou tablet — você ainda vai precisar dele para resgatar recompensas.

Passo 1 — Obtenha sua chave de API do Holded

1. No Holded, abra Configurações.

2. Vá para Desenvolvedores.

3. Abra Credenciais.

4. Clique em Novo Token de API.

5. Selecione exatamente estas permissões:

• Vendas: Leitura
• Contatos: Leitura
• Desenvolvedores: Completo

Passo 2 — Conecte o Holded ao Passtastic

1. No seu painel Passtastic, abra Configurações e depois Integrações, em Negócio.

2. Encontre Holded POS.

3. Cole a chave de API que você copiou e clique em Conectar Holded.

Passo 3 — Escolha quais cartões acumulam

Depois de conectado, você verá Seus cartões de fidelidade — todos os cartões de pontos, níveis e carimbos da sua conta. Ative um cartão para começar a acumular com as vendas do Holded.

• Para cartões de pontos e de níveis, garanta que uma regra de acúmulo esteja vinculada — os cartões só acumulam depois que uma regra de pontos é configurada para eles. Se ainda não houver nenhuma vinculada, use Configure suas regras de pontos na mesma página.
• Cartões de carimbos não precisam de regra — só ativar já é suficiente; eles acumulam 1 carimbo por venda paga.

A página de conexão mostra N de M cartões acumulando, para você ver rapidamente quantos dos seus cartões aptos a acumular estão ativados.

O único hábito que importa: vincular o cliente à venda

Pontos e carimbos só são creditados quando sua equipe vincula o cliente ao ticket no Holded — da mesma forma que ao adicionar um cliente a qualquer venda. Se uma venda for registrada sem cliente vinculado, nada é creditado automaticamente.

Isso não significa necessariamente que a venda está perdida: uma venda feita sem cliente ainda pode ser atribuída a ele mais tarde, no mesmo dia, se o ticket for atualizado com o cliente antes do fechamento do dia. Depois desse período, a venda não pode mais ser correspondida.

Como sua equipe resgata uma recompensa

O Holded não mostra o status de recompensa de um cliente no caixa, então o resgate continua usando uma leitura rápida, assim como em qualquer programa de fidelidade Passtastic:

1. Quando um cliente diz que a recompensa dele está pronta, sua equipe abre o app Passtastic Scanner e escaneia o passe da wallet do cliente. Isso confirma que a recompensa é real e está pronta.

2. Sua equipe aplica a recompensa no pagamento normalmente (desconto, item grátis etc.).

Esse é o único lugar onde você ainda usa o scanner — o acúmulo é automático a partir das vendas do Holded.

Solução de problemas

Minha chave de API não foi aceita. Verifique se você criou um Token de API genuíno do Holded (não uma senha de login nem outro tipo de chave) e se copiou a string inteira. Crie um novo token no Holded → Configurações → Desenvolvedores → Credenciais e cole-o novamente.

Erro "Adicione a permissão Vendas: Leitura / Desenvolvedores: Completo". O token está sem uma das três permissões necessárias. Volte ao Holded, crie um novo Token de API e selecione todas as três: Vendas: Leitura, Contatos: Leitura, Desenvolvedores: Completo — depois cole esse token.

"Não foi possível registrar o webhook de vendas no Holded." O Holded permite apenas um webhook de vendas por conta. Se outra ferramenta já estiver registrada para receber as notificações de vendas do seu Holded, o Holded vai rejeitar um segundo webhook. Desconecte ou reconfigure o webhook da outra ferramenta no Holded e tente conectar o Passtastic novamente.

Minha conexão precisa de uma nova chave depois que regenerei uma no Holded. Regenerar ou revogar uma chave no Holded invalida a que o Passtastic está usando, então a conexão para de funcionar até você reconectar. Crie um novo Token de API no Holded (mesmas permissões acima) e cole-o na página da integração Holded para reconectar — as configurações do seu cartão são mantidas.

Uma venda não está sendo correspondida ao cliente certo. Verifique se a permissão Contatos: Leitura ainda está ativada na sua chave de API — sem ela, o Passtastic não consegue corresponder as vendas aos seus clientes. Se estiver faltando, adicione-a ao seu token existente ou crie um novo com as três permissões.

Para gerenciar a fidelidade sem um PDV, ou conectar outras ferramentas, veja Sistemas POS e integrações.