ERP MEGA - API - Como consumir APIs SOAP que dependem do Mega Integrador em ambiente Mega Cloud
Dúvida
Como utilizar APIs SOAP do Mega em ambiente Mega Cloud?
Solução
As APIs projetadas no padrão Simple Object Access Protocol, mais conhecido como SOAP, recebem requisições através dos protocolos HTTP e SMTP e utilizam mensagens em formato XML para a troca de informações.
Para configurar APIs SOAP é necessário seguir os passos abaixo na seguinte ordem, para isso, realize os passos a seguir:
Passo 1: Identificar a URL necessária para realizar a request no end-point:
É necessário a criação de um ticket para que seja disponibilizado a URL para utilização da API SOAP.
Passo 2: Configurar o Serviço do Mega Integrador necessário para a request:
Atenção! Caso a empresa já utilize o Mega Integrador, não é necessário realizar o passo 2.
As APIs SOAP utilizam os serviços do Mega Integrador e para clientes Cloud Mega, a configuração do Serviço será realizado junto com o ticket criado para liberação da URL, basta informar o Código de Serviço que será utilizado.
Passo 3: Elaborar o XML para utilização na request:
O XML para utilização na request é o mesmo utilizado nas chamadas do Mega Integrador, onde cada serviço possui seus campos.
Toda a documentação dos campos necessários assim como exemplos de XML, se encontram nos links abaixo:
Passo 4: Realizar a request com o XML:
Após realizar todos os passos de configuração e elaboração do XML, utilize os dados abaixo para realizar a request:
- Endereço do End-Point: Utilize a URL obtida no passo 1.
- Header: Inserir o Content-Type application/xml.
- Body: No Body, insira o XML abaixo como padrão nas request, alterando as tags conforme a necessidade:
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/">
308
1
INSERIR AQUI O XML DO SERVICO 308
]]>
- TAG : Nessa TAG será preenchida com o código do Serviço do Mega Integrador de acordo com o passo 3.
- TAG Nessa TAG será preenchida com o código do usuário no Mega ERP que irá realizar esse insert, em casos de insert de Movimentações é necessário que esse usuário possua as devidas permissões dentro do ERP.
- TAG : Nessa data, em inserir o XML elaborado no passo 3 de acordo com o serviço selecionado.
Exemplo de request:
Segue um exemplo da request realizada pelo Postman, onde utilizamos o Serviço 205 para inserção de usuário, e a URL é o IP e Porta interna:
curl --location '192.168.0.5:8118/Integrador?wsdl%20=null' \
--header 'Content-Type: application/xml' \
--data 'xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/">
205
1
123
MegaTeste
Mega Teste
SENHA
2
]]>
'
Atenção! Essa configuração é focada nas APIs SOAP que dependem do Mega Integrador, para APIs SOAP que dependem dos Portais Web, e APIs REST temos a documentação Abaixo: