Manual de Instalação — PlataformaPgto Receiver (ShellBox)

De Merito Wiki
Revisão de 11h54min de 16 de julho de 2026 por Merito (discussão | contribs)
Ir para: navegação, pesquisa

Este manual é destinado à equipe de Suporte e descreve o passo a passo para a instalação e configuração do serviço PlataformaPgto Receiver diretamente no servidor (Linux) dos postos clientes.

1. Visão Geral

O PlataformaPgto Receiver é o serviço que conecta o posto ao servidor central da Mérito. Ele escuta uma fila de mensageria (RabbitMQ) e, quando há uma transação via ShellBox, ele baixa os dados e grava no banco PostgreSQL local do posto.

2. Pré-requisitos (Rede do Posto)

Antes de iniciar a instalação, certifique-se de que a rede do posto possui a seguinte liberação de saída no firewall/roteador:

  • Regra: Permitir Saída (Outbound)
  • Protocolo: TCP
  • Porta de Destino: 5555
  • IP de Destino: 85.31.63.86 (hub.merito-es.com.br)

CAUTION

Sem essa liberação, o serviço não conseguirá conectar ao servidor da Mérito.

3. Passo a Passo da Instalação (Terminal do Posto)

Acesse o terminal do servidor do posto e execute os comandos abaixo.

3.1 Configurar o repositório da Mérito

3.2 Instalar o serviço

(Este comando serve tanto para a primeira instalação quanto para atualizar o sistema em postos que já o possuem).

WARNING

Solução de Problemas (Erro 404 ao instalar): Se o comando acima der 404 Not Found ao tentar baixar o .deb, significa que o índice do repositório está dessincronizado. Para contornar, baixe o arquivo físico e instale manualmente substituindo a versão abaixo pela que o apt tentou baixar (ex: b58):

4. Configuração Obrigatória no Posto

Após a instalação, é necessário configurar dois arquivos em /opt/plataforma-pgto-receiver/bin/.

Arquivo 1: application-prod.properties

Este arquivo guarda a configuração do banco e a fila do RabbitMQ.

Edite as variáveis para que fiquem exatamente neste padrão:

Arquivo 2: loginbasico.cfg

Crie ou edite o arquivo com os dados de login interno do sistema Mérito:

WARNING

As senhas (local.senha_bd e senha) precisam OBRIGATORIAMENTE ser geradas usando merito-integra --ofuscar-senha <senha> no terminal. Não coloque senhas em texto puro neste arquivo.

Exemplo de preenchimento:

5. Iniciar e Validar o Serviço

Após preencher e salvar os dois arquivos, reinicie os serviços:

5.1 Como saber se funcionou?

Verifique os logs do serviço em tempo real:

O serviço está rodando corretamente se o log não apresentar erros de conexão ("SocketTimeoutException") e exibir mensagens informando que a rotina de vínculo de abastecidas está sendo executada.

5.2 (Opcional) Consultar Fila no RabbitMQ

Para garantir que as mensagens estão chegando e sendo consumidas, a equipe de Suporte pode acessar o painel do RabbitMQ:

  • URL: https://rabbitmqm.merito-es.com.br
  • Usuário: merito_admin
  • Senha: Merito#010306

Aba Queues > Pesquise pela fila do posto (ex: shellbox-93489243001007). O campo Consumers deve estar 1 ou maior, indicando que o posto está conectado.

6. Parametrização no Sistema MÉRITO Redes (ERP)

A instalação no Linux está concluída, mas o processo ainda não acabou! É obrigatório realizar o mapeamento lógico da plataforma (vínculo de bicos, formas de pagamento, combustíveis) diretamente no sistema MÉRITO Redes. Isso garante que o sistema interno entenda os códigos que vêm do aplicativo.

Para realizar essas parametrizações, siga o manual oficial na Wiki: 👉 Manual de Configuração de Plataformas de Pagamento

Disponível em “https://wiki.merito-es.com.br/index.php?title=Manual_de_Instalação_—_PlataformaPgto_Receiver_(ShellBox)&oldid=2387”