Como configurar integração com PDV Zanthus?
O que é o PDV Zanthus?
O PDV Zanthus é um sistema de ponto de venda comumente utilizado em grandes redes de supermercados, lojas e autocenters (ex.: Roldão Atacadista). Através desta integração, é possível realizar a validação do ticket do estacionamento no momento do pagamento das compras do cliente.
Como funciona:
- No momento do pagamento, o PDV envia uma comunicação via socket para o servidor Link
- O sistema Fokus recebe o pacote de mensagem através de uma porta TCP
- A mensagem contém o número do ticket e o valor da compra
- Através das regras configuradas, são aplicados descontos diferenciados de acordo com o valor total da compra
⚠️ Importante:
- As regras de validação, valores e períodos devem ser definidos pelo cliente
- A Link não possui responsabilidade pela operação do estacionamento
- Este documento segue a referência da documentação da Zanthus e o procedimento de homologação realizado em 24/10/2025
Passo 1: Configurar Padrão de Código dos Tickets
Por que esta configuração é necessária?
O Fokus utiliza por padrão o código QRCODE, porém o PDV Zanthus aceita apenas leitura de BARCODE EAN13. Por isso, é necessário alterar o padrão de impressão dos tickets.
Como configurar:
⚠️ ATENÇÃO:
Importante alterar esse parâmetro ANTES da abertura do estabelecimento, sem clientes no pátio!
Se houver clientes com tickets antigos (QRCode), eles não conseguirão validá-los no PDV após a mudança.
Passo 2: Criar Terminal de Identificação do PDV
Para que serve?
Este terminal será utilizado para identificar todas as transações provenientes do PDV parceiro dentro do sistema Fokus.
Como configurar:
Passo 3: Criar Modalidade de Pagamento Local
Para que serve?
Esta modalidade será utilizada para registrar e identificar todas as validações realizadas através do PDV no sistema.
Como configurar:
Passo 4: Configurar Tabelas de Preços (Períodos de Isenção)
Para que serve?
Cada tabela de preços representa um período de isenção diferente, baseado no valor da compra do cliente. É fundamental criar uma tabela para cada regra de validação.
Exemplo de estrutura de regras:
| Valor da Compra | Período de Isenção |
|---|---|
| Acima de R$ 30 | 1 hora (60 min) |
| Acima de R$ 50 | 2 horas (120 min) |
| Acima de R$ 100 | 3 horas (180 min) |
| Acima de R$ 150 | 12 horas (720 min) |
Como configurar cada tabela:
⚠️ Lembre-se:
Sempre deixe o campo PRÓXIMO PERÍODO vazio em todas as tabelas!
Passo 5: Criar Parceiros (Convênios)
Para que serve?
Cada parceiro representa uma regra de validação específica, vinculada a uma tabela de preços correspondente.
Como configurar cada parceiro:
💡 Dica Adicional:
Para que esses parceiros também possam ser usados no CAIXA ASSISTIDO (para validações manuais em terminal Link), vincule também o terminal do caixa (ex.: "CAIXA01") na configuração de cada parceiro.
Passo 6: Configurar a Integração com o PDV (Sistemas Externos)
Este é o passo final que estabelece a comunicação entre o Fokus e o PDV Zanthus.
Como configurar:
Checklist Final de Configuração
Antes de colocar em operação, verifique se todos os passos foram concluídos:
- [ ] Passo 1: Alterado padrão de código para EAN13 (QRCODE → BARCODE)
- [ ] Passo 2: Terminal de identificação do PDV criado
- [ ] Passo 3: Modalidade de pagamento local criada
- [ ] Passo 4: Tabelas de preços criadas para cada período de isenção
- [ ] Passo 5: Parceiros criados e vinculados às tabelas de preços
- [ ] Passo 6: Sistema externo Zanthus configurado com regras de utilização
- [ ] Porta TCP configurada corretamente (mesma no Fokus e no PDV)
- [ ] PDV terceiro configurado corretamente
- [ ] Teste realizado com ticket de entrada
Testando a Integração
Como testar:
-
Retire um ticket no terminal de entrada
- Verifique se está imprimindo com código de barras EAN13
-
Simule uma compra no PDV
- Faça uma compra com valor que se enquadre em uma das regras
- Valide o ticket no PDV durante o pagamento
-
Verifique no sistema Fokus:
- Acesse o menu HISTÓRICO ou FATURAMENTO
- Confirme se a validação foi registrada corretamente
- Verifique se o período de isenção foi aplicado conforme a regra
Perguntas Frequentes
1. O que acontece se um cliente tiver um ticket antigo (QRCode) após a mudança para EAN13?
O ticket antigo não poderá ser lido pelo PDV Zanthus. Por isso é fundamental fazer a mudança antes da abertura do estabelecimento, sem clientes no pátio.
2. Posso usar validações manuais no caixa além da integração automática?
Sim! Basta vincular também o terminal do caixa (ex.: CAIXA01) na configuração dos parceiros (Passo 5). Assim, os operadores poderão realizar validações manuais quando necessário.
3. Posso alterar os valores e períodos de isenção depois?
Sim, você pode criar novas tabelas de preços e parceiros, ou editar os existentes. Lembre-se de ajustar também as regras em Sistemas Externos.
4. Como alterar a porta TCP de comunicação?
A porta pode ser alterada em Sistemas Externos, mas é fundamental comunicar o TI da unidade para que a mesma porta seja configurada no PDV Zanthus. Ambos os lados devem usar a mesma porta.
5. O que significa "Próximo Período" vazio?
Ao deixar o campo "Próximo Período" vazio, o sistema retorna automaticamente à tabela de preços padrão do parceiro após o término do período de isenção. Isso evita que o cliente fique com desconto indefinido.
6. Como funciona o campo "Revalida"?
Com "Revalida" ativado, se o cliente validar o ticket novamente no PDV com uma nova compra, o sistema aplicará novamente a regra de desconto, somando ou renovando o período de isenção.
7. Preciso criar um parceiro para cada faixa de valor?
Sim! Cada faixa de valor precisa ter seu próprio parceiro, vinculado à sua respectiva tabela de preços. Isso garante que o sistema aplique corretamente cada regra.
8. Como sei se a integração está funcionando corretamente?
Você pode verificar nos logs do sistema, no histórico de movimentações e nos relatórios de faturamento. Todas as validações via PDV ficarão registradas com a modalidade de pagamento criada.
Suporte Técnico
Se encontrar dificuldades na configuração ou se a integração não estiver funcionando corretamente:
- Verifique se todos os passos do checklist foram concluídos
- Confirme se a porta TCP está configurada corretamente em ambos os lados
- Consulte os logs do sistema para identificar possíveis erros
- Entre em contato com o suporte técnico da Link Tecnologia
Observações Finais
- A responsabilidade pela operação do estacionamento é do cliente
- As regras de validação devem ser definidas pelo estabelecimento
- Esta documentação segue os padrões da homologação realizada em 24/10/2025
- Mantenha sempre backups das configurações antes de realizar alterações
Documento criado em: 28/10/2025
Versão: 1.0
Sistema: Fokus + PDV Zanthus
Homologação: 24/10/2025