Skip to Content
Primeiros passosPrimeiro envio

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

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 SOAP

A 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.