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 finalizado 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)
   

   

2. Localize e altere o parâmetro:

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

     

     
     

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

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

     

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

     

     
     

4. Teste a configuração:

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

     

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.

---

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.10)

4. Configurações JSON:

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

5. Clique em SALVAR
   

   

   
   

---

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
   

   

   
   

---

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
   

   

   
   

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)
     

     

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 (PERMITIDO NOS TERMINAIS).

---

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

---

Criação de rota estática (caso necessário)

Identificar TODAS as interfaces

Observe:

• IP atribuído

• Rede associada

• Status UP

---

Identificar qual interface alcança o gateway da integração

Exemplo:

• Gateway GPA: 192.168.0.1

Descubra por qual interface ele é acessado:
ip route get 192.168.0.1

Saída esperada:
via 192.168.0.1 dev enp3s0

➡ Essa é a interface correta, mesmo que não seja a default.

---

Criar a rota usando a interface certa