Primeiro envio
Vamos configurar um fluxo completo e enviar a primeira mensagem. O exemplo usa uma aplicação MES recebendo dados de pallets.
Criar a Aplicação
Em Aplicações (/applications), crie uma aplicação com a sigla MES. A sigla aparece nas URLs
e nos relatórios, então use algo curto e estável.
Criar a Interface
Em Interfaces (/interfaces), crie a interface MES_PALLET para a aplicação MES. Escolha a ordem
de processamento:
- Sequencial quando a ordem das mensagens importa (movimentações de estoque, por exemplo).
- Paralela quando o volume importa mais que a ordem.
Criar a Definição de Entrega
Em Definições (/definitions), crie AnyToMES_PalletData apontando para a interface
MES_PALLET. Configure:
- Tipo de entrega:
HTTP_POST - Destino: a URL do sistema MES
- Timeout e tentativas conforme o SLA do destino
- Transformador: opcional nesta primeira volta
Gerar um API Token
Em API Tokens (/api-tokens), gere um token para a aplicação MES. Ele vai no header
x-api-token de cada requisição.
O token só é exibido no momento da criação. Toda cópia posterior fica registrada no histórico de cópias do token.
Enviar a mensagem
JSON
curl -X POST http://localhost:3000/api/MES_PALLET/AnyToMES_PalletData \
-H "Content-Type: application/json" \
-H "x-api-token: SEU_TOKEN_AQUI" \
-d '{"pallet":"PAL001","weight":120.5,"line":"LINE-A"}'Resposta de sucesso:
{
"id_message": "uuid-da-mensagem",
"message_type": "ASYNC",
"return_message": "Message received and queued",
"hasError": false
}Acompanhar
Abra Mensagens (/messages) e busque pelo id_message retornado. A tela de detalhe
(/messages/:id) mostra o payload completo e o histórico de tentativas de entrega — inclusive a
resposta do destino em cada uma.
E via SOAP?
Toda Definição com “Expor Web Service” ativada ganha automaticamente um endpoint SOAP:
GET /api/ws/MES_PALLET/AnyToMES_PalletData?wsdl ← WSDL gerado dinamicamente
POST /api/ws/MES_PALLET/AnyToMES_PalletData ← envelope SOAPA autenticação pode ser feita por WS-Security UsernameToken dentro do envelope, em vez do
header x-api-token.
Próximos passos
- Aplicar um Transformador para adaptar o payload ao formato do destino.
- Cadastrar Erros de Negócio para classificar respostas de falha.
- Configurar Alertas para ser avisado quando algo parar.