Skip to main content

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 realizadofinalizado 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:

  1. Acesse o menu PARÂMETROS (Configuração da Garagem)

    parametros.jpg

  2. Localize e altere o parâmetro:

    • Chave: COMPROVANTE.ROTATIVO.CODE_TYPE
    • De: "qrcode"
    • Para: "ean13"
    • Clique em SALVAR

      qrcode.jpg


  3. Localize o parâmetro COMPROVANTE.ROTATIVO.ESTADIA:

    • Procure a primeira ocorrência da chave {{localizador_externo}}

      barcode1.jpg

    • Onde encontrar "qrcode", altere para "barcode"
    • Clique em SALVAR

      barcode2.jpg


  4. Teste a configuração:

    • Retire um ticket no terminal de entrada
    • Verifique se o código de barras EAN13 está sendo impresso corretamente

      image.png

⚠️ 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.PDV.

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:

  1. Acesse o menu TERMINAIS

  2. Clique em ADICIONAR

  3. Preencha os campos:

    • Ativo: ATIVADO
    • Identificação: Nome descritivo do PDV (ex.: "PDV SUPERMERCADO")
    • Tipo: ADM
    • IP: Este campo é apenas para identificação. Você pode usar:
      • O endereço IP do servidor do PDV, ou
      • Um IP aleatório para referência (ex.: 127.0.0.1d)10)

  4. Configurações JSON:

    • Não é necessário alterar as configurações do JSON

  5. Clique em SALVAR

    terminal.jpg


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:

  1. Acesse o menu MODALIDADES DE PAGAMENTO

  2. Clique em ADICIONAR

  3. Preencha os campos:

    • Identificação: Nome do estabelecimento (ex.: "ROLDÃO ATACADISTA")
    • Tipo: LOCAL
    • Calcula Troco: NÃO
    • Caixa - Acumulador: SIM
    • Caixa - Valor Inicial: 0
    • Pagamento PIX: NÃO
    • Gerar Documento Fiscal: DESATIVADO
    • Permitida nos Terminais: Vincule o terminal criado no Passo 2

  4. Clique em SALVAR

    modalidade.jpg


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:

  1. Acesse o menu PREÇOS DAS ESTADIAS

  2. Clique em ADICIONAR

  3. Preencha os campos:

    Identificação:

    • Use nomenclatura clara que identifique a faixa de valor
    • Exemplo: "COMPRA ACIMA DE $30 1H"
    • Isso facilita a visualização na parametrização

    Vigência:

    • Início: Data de início da vigência
    • Fim: Se permanente ou indeterminado, use data futura (ex.: 01/01/2100 23:59:59)
    • Ativação: TODOS

    Horários:

    • Se funcionar durante todo o período do estabelecimento:
      • Dia de Início: DOMINGO (dia 1 da semana)
      • Horário de Início: 00:00:00
      • Dia de Término: SÁBADO (dia 7 da semana)
      • Horário de Término: 23:59:59

    Períodos:

    • Clique em ADICIONAR PERÍODO
    • Período: Tempo em minutos (ex.: 60 para 1 hora)
    • Tolerância: 0
    • Valor Cliente: 0 (para isentar o ticket)
    • Valor Parceiro: 0
    • Próximo Período: DEIXE VAZIO (importante para retornar à tabela padrão após o término)

  4. Clique em SALVAR

    tabelapreco.jpg


  5. Repita o processo para todas as outras faixas de valores:

    • COMPRA ACIMA DE $50 2H (120 minutos)
    • COMPRA ACIMA DE $100 3H (180 minutos)
    • COMPRA ACIMA DE $150 12H (720 minutos)

      tabelas.jpg

⚠️ 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:

  1. Acesse o menu PARCEIROS

  2. Clique em ADICIONAR

  3. Preencha os campos:

    • Identificação: Use o mesmo nome da tabela de preços correspondente

      • Exemplo: "COMPRA ACIMA DE $30 1H"

    • Tipo: LOCAL

    • Padrão: DESATIVADO

    • Padrão Pagamento Web: DESATIVADO

    • Tempo para Pagamento Após Cálculo: 240 segundos

    • Qtd. Máx. de Pagamentos Diários: 9999

    • Voucher Obrigatório: DESATIVADO

    • Permitido nos Terminais: Vincule o terminal criado no Passo 2

    • Valor Máximo: 9999

    • Revalida?: SIM

  4. Configuração de Tabelas de Preços e Horários:

    • Clique em ADICIONAR
    • Pátio: Selecione o pátio principal
    • Tabela de Preços: Vincule a tabela correspondente (ex.: "COMPRA ACIMA DE $30 1H")
    • Se houver outros pátios (ex.: pátio de moto), adicione-os também com a mesma tabela

  5. Clique em SALVAR

  6. Repita o processo para todas as outras faixas de valores:

    • COMPRA ACIMA DE $50 2H
    • COMPRA ACIMA DE $100 3H
    • COMPRA ACIMA DE $150 12H

💡 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:

  1. Acesse o menu SISTEMAS EXTERNOS

  2. Clique em ADICIONAR

  3. Preencha os campos:

    • Identificação: Nome descritivo (ex.: "PDV ZANTHUS")

    • Tipo: ZANTHUS

    • Terminal: Vincule o terminal criado no Passo 2

    • PORT: Porta de comunicação socket

      • Padrão usado na homologação: 4005
      • ⚠️ Importante: Esta porta deve ser a mesma configurada no PDV terceiro
      • Pode ser alterada, desde que o TI da unidade seja comunicado para ajustar também no PDV

    • Faturar com Tempo Excedido: ATIVADO

  4. Configuração de Regra de Utilização de Parceiros:

    • Clique em ADICIONAR para cada faixa de valor
    • Valor Mínimo: Defina o valor mínimo da compra
    • Parceiro: Vincule o parceiro correspondente

    Exemplo de configuração:

    Valor Mínimo Parceiro Vinculado
    30 COMPRA ACIMA DE $30 1H
    50 COMPRA ACIMA DE $50 2H
    100 COMPRA ACIMA DE $100 3H
    150 COMPRA ACIMA DE $150 12H

  5. Clique em SALVAR

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:

  1. Retire um ticket no terminal de entrada

    • Verifique se está imprimindo com código de barras EAN13

  2. 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

  3. 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:

  1. Verifique se todos os passos do checklist foram concluídos
  2. Confirme se a porta TCP está configurada corretamente em ambos os lados
  3. Consulte os logs do sistema para identificar possíveis erros
  4. 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

Back to top