Integração de API para Lançar, Fechar e Concluir Expedições

Last updated: June 19, 2026

A maioria das anomalias pode ser capturada manualmente através do lançamento de uma nova Expedição no L2L. O L2L permite criar, atualizar e concluir Expedições através da API, de forma a automatizar processos e aumentar a eficiência. Eis alguns casos de utilização em que a automatização da criação e conclusão de Expedições pode ser útil:

  • Lançar uma Expedição para notificar os técnicos quando uma Máquina apresenta uma falha específica
  • Lançar um processo no L2L a partir de outra aplicação, como um QMS
  • Fechar uma Expedição quando uma condição de falha já não está ativa
  • Utilizar dispositivos de hardware para lançar Expedições

Lançar uma Expedição

Objetivo: Automatizar a criação de uma Expedição para melhorar a eficiência e a precisão dos dados da Expedição.
Intervalo sugerido: Sob demanda
Descrição do processo:

  1. (Opcional) Identificar se já foi lançada uma Expedição para a Máquina afetada com o mesmo Tipo de Expedição. Isto pode ser utilizado para evitar a duplicação de dados. Se for encontrada uma Expedição com a mesma Máquina e o mesmo Tipo de Expedição, poderá não ser necessária uma nova Expedição. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&machinecode=[machine code]&dispatchtypecode=[dispatch type code]&open=T&order_by=-reported&limit=1
  2. Criar uma nova Expedição. Existem dois métodos para criar uma Expedição:
    1. Adicionar. Isto cria uma Expedição concluída e fechada. Este método é utilizado quando pretende simplesmente registar uma ocorrência ou um período de inatividade sem necessidade de qualquer interação humana. 
      POST https://[customer].leading2lean.com/api/1.0/dispatches/add/?auth=[api key]
      1. Parâmetros POST: site=[site id]&dispatchtypecode=[dispatch type code]&description=[description]&machinecode=[machine code]&tradecode=[trade code]
      2. Consulte a documentação oficial da API para obter a lista completa dos parâmetros POST.
    2. Abrir. Isto é utilizado para lançar uma Expedição aberta. É semelhante ao lançamento de uma Expedição utilizando o formulário Nova Expedição na interface do utilizador.
    3. POST https://[customer].leading2lean.com/api/1.0/dispatches/open/?auth=[api key]
      1. Parâmetros POST: site=[site id]&dispatchtypecode=[dispatch type code]&description=[description]&machinecode=[machine code]&tradecode=[trade code]
      2. Consulte a documentação oficial da API para obter a lista completa dos parâmetros POST.

Fechar uma Expedição

Objetivo: Fechar uma Expedição de forma programática
Intervalo sugerido: Sob demanda
Descrição do processo:

  1. Procure a Expedição para encontrar o ID da Expedição. Este passo pode ser ignorado se o ID da Expedição já for conhecido. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&dispatchnumber=[dispatch number]
  2. Feche a Expedição 
    POST https://[customer].leading2lean.com/api/1.0/dispatches/close/[dispatch id]/?auth=[api key]

Concluir uma Expedição

Objetivo: Concluir uma Expedição de forma programática
Intervalo sugerido: A pedido
Esquema do processo:

  1. Procure a Expedição para encontrar o ID da Expedição. Este passo pode ser ignorado se o ID da Expedição já for conhecido. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&dispatchnumber=[dispatch number]
  2. Conclua a Expedição 
    POST https://[customer].leading2lean.com/api/1.0/dispatches/complete/[dispatch id]/?auth=[api key]