Como obter a porta do srvmegapetro.exe pelo Mega Connection Manager

Manual da API de Pedido de Vendas

01. Guia de implantação  |  02. Pré-requisitos  |  03. Porta do srvmegapetro.exe  |  04. Autenticação e autorização  |  05. Padrão de requisições

Objetivo

Este artigo explica como identificar a porta HTTP em que o srvmegapetro.exe está publicado. Essa porta é necessária para montar a URL base da API de Pedido de Vendas e acessar o Swagger da versão instalada.

Endpoint do Mega Connection Manager

A porta do srvmegapetro.exe deve ser consultada no Mega Connection Manager pelo endpoint abaixo:

GET http://<host-connection-manager>:<porta-connection-manager>/api/ConnectionManager/Connection/srvmegapetro.exe

Exemplo:

GET http://nb-andreoliv:9099/api/ConnectionManager/Connection/srvmegapetro.exe

Exemplo em cURL

curl -X GET \
  'http://nb-andreoliv:9099/api/ConnectionManager/Connection/srvmegapetro.exe' \
  -H 'accept: text/plain'

Exemplo de resposta

{
  "host": "",
  "httpPort": 9194,
  "tcpPort": 9394
}

Como interpretar a resposta

Campo	Descrição	Uso na API
host	Host informado pelo Connection Manager para o serviço.	Quando vier vazio, use o host pelo qual o serviço deve ser acessado no ambiente, como localhost em acesso local ou o nome/IP do servidor em acesso remoto.
httpPort	Porta HTTP do srvmegapetro.exe.	Deve ser usada para montar a URL base da API REST e o endereço do Swagger.
tcpPort	Porta TCP do serviço.	Não é usada para chamadas REST da API de Pedido de Vendas.

Montagem da URL base e do Swagger

Com o valor de httpPort, monte os endereços abaixo:

Finalidade	Formato
URL base da API	http://<host>:<httpPort>/api/v1
Swagger	http://<host>:<httpPort>/swagger

Considerando a resposta com httpPort igual a 9194, em um acesso local os endereços ficam assim:

API:     http://localhost:9194/api/v1
Swagger: http://localhost:9194/swagger

Configuração de porta fixa no MegaConfig.xml

Quando o cliente desejar trabalhar com uma porta fixa para o srvmegapetro.exe, a configuração deve ser feita no arquivo MegaConfig.xml, na seção <PORTAFIXA>.

Exemplo de configuração:

<!-- Configuração dos servers que devem usar portas fixas -->
<PORTAFIXA>
  <SRVMEGAPETRO>8110</SRVMEGAPETRO>
</PORTAFIXA>

Atenção: A alteração de porta fixa deve ser realizada por responsável técnico do ambiente. Antes de alterar o arquivo, faça backup do MegaConfig.xml e valide impactos de firewall, serviços e integrações existentes.

Validação após configurar porta fixa

1. Salvar a alteração no MegaConfig.xml.
2. Reiniciar os serviços necessários do ambiente Mega, conforme procedimento interno.
3. Consultar novamente o endpoint do Mega Connection Manager.
4. Confirmar se o campo httpPort retornou a porta fixa configurada.
5. Acessar o Swagger pela porta validada.
6. Executar o teste de conectividade da API.

Problemas comuns

Situação	Possível causa	Ação recomendada
Endpoint do Connection Manager não responde	Mega Connection Manager indisponível, porta bloqueada ou host incorreto.	Validar se o serviço está em execução e se a porta do Connection Manager está liberada.
srvmegapetro.exe não é encontrado	Serviço não iniciado ou nome consultado incorreto.	Validar se o processo está ativo e se o nome usado no endpoint é srvmegapetro.exe.
Swagger não abre	Porta HTTP incorreta, serviço inativo ou bloqueio de rede.	Consultar novamente o httpPort e validar firewall.
Porta fixa não foi aplicada	Configuração não salva, XML inválido ou serviço não reiniciado.	Revisar o MegaConfig.xml, reiniciar os serviços e consultar novamente o Connection Manager.