# Como migrar o cartãozinho de papel para o app

Fonte: https://docs.barbeiro.app/business-admin/loyalty/migrate-punch-card
Perfil: Administrador
Verificado em: 2026-08-22

Saindo do cartãozinho de papel ("10 selos → próxima grátis") para o programa digital? O botão **Migrar cartão** transfere os selos de cada cliente sem você precisar fazer conta de pontos: você diz **quantos selos o cliente já tem**, e o sistema calcula e lança os pontos certinhos.

## Antes de começar

> **Crie a recompensa do cartão primeiro**
>
> A migração se ancora numa **recompensa** — a que o cartão completo representa (ex.: *corte
> grátis*). Em **Fidelidade → Recompensas**, crie essa recompensa (tipo **Serviço grátis** ou
> **100% de desconto**) antes de migrar. Se você ainda não tem nenhuma recompensa ativa, o botão
> Migrar cartão avisa para criar uma primeiro.

## Passo a passo

1. Em **Fidelidade → Clientes**, busque o cliente, abra o menu da linha e escolha **Migrar
   cartão**. (O botão **Migrar cartão de selos**, no topo da página, faz o mesmo e abre a busca
   antes.)

2. Em **O cartão cheio dava o quê?**, escolha a recompensa que o cartão completo representa.

3. Informe **Selos no cartão** (ex.: 10) e **Já preenchidos** (ex.: 6). A tira de selos no meio da
   janela desenha o cartão — os preenchidos ficam marcados, os que faltam ficam vazios, igual ao
   papel na mão do cliente.

4. Leia a prévia: *"6 de 10 selos · faltam 4 visitas"*, *"+ 30 pts"* e *"O saldo vai de 12 para 42
   pontos"*. Se aqueles pontos já colocam o cliente num nível, a prévia avisa: *"E o cliente vira
   Prata na hora, com 5% de desconto"*.

5. Confirme em **Migrar e recolher o cartão**. Pronto: o cliente fica exatamente onde estava no
   papel — e o papel pode ir para o lixo.

## Como o cálculo funciona

A migração é **proporcional à recompensa**: `pontos = (selos preenchidos ÷ total de selos) × custo da recompensa`. Assim, um cartão **cheio (10 de 10)** equivale **exatamente** à recompensa, não importa a sua taxa de pontos por visita. Exemplo: recompensa de **50 pontos**, cartão de **10 selos** → cada selo vale 5 pontos → **6 selos = 30 pontos**.

## Atenção aos detalhes

> **O cliente precisa ter conta de fidelidade**
>
> A conta é criada automaticamente quando o cliente ganha o primeiro ponto (num atendimento
> concluído). Para um cliente que nunca pontuou no app, conclua uma visita primeiro — aí o botão
> Migrar cartão fica disponível na ficha dele.

> **Cartão completo = próxima visita grátis**
>
> Migrar um cartão **cheio (10/10)** lança os pontos da recompensa inteira — o cliente resgata a
> visita grátis no **próximo atendimento**, igual ao cartão de papel. Não é resgatado
> automaticamente.

> **Só o administrador migra**
>
> O botão Migrar cartão aparece só para o **administrador** (mesma permissão do Ajustar pontos). A
> recepção resgata e aplica recompensas quando o cliente já tem saldo.

> **A migração pode subir o cliente de nível na hora**
>
> Os pontos lançados contam para o total acumulado, então o cliente pode entrar num nível
> imediatamente — a prévia diz isso **antes** de você confirmar, com o nome do nível e o desconto
> que ele passa a ter. É esperado: quem tinha meio cartão de papel já era cliente de casa.

## Perguntas frequentes

**O que acontece se eu digitar selos a mais do que o total?**
O sistema não deixa — os selos preenchidos não podem passar do total do cartão.

**Posso migrar vários cartões diferentes (de tamanhos diferentes)?**
Sim. O **total de selos** é informado a cada migração (padrão 10), então cada cartão pode ter um tamanho diferente.

**A migração conta para os níveis (Bronze/Prata/Ouro)?**
Sim — os pontos lançados também contam para o total acumulado, então o cliente pode subir de nível. É um bônus, não atrapalha o cartão.

## Leia também

- [Como criar uma recompensa de fidelidade](https://docs.barbeiro.app/business-admin/loyalty/create-loyalty-reward)
- [Como configurar o programa de fidelidade](https://docs.barbeiro.app/business-admin/loyalty/configure-loyalty-program)
- [Como aplicar um resgate de fidelidade a um atendimento](https://docs.barbeiro.app/business-admin/loyalty/apply-loyalty-voucher-on-booking)