Integração com o Gestão da Mão de Obra no Armazém

O intuito das integrações junto ao WMS Alcis é permitir que os clientes que adquirirem esta ferramenta e possuam o Gestão da Mão de Obra no Armazém possam ter visibilidade e métricas para aferir e analisar a mão de obra dos separadores/operadores nos processos de expedição dos pedidos do Armazém/Depósito.

Para maiores informações sobre as funcionalidades do Gestão da Mão de Obra no Armazém, acesse o manual do usuário do produto.

As integrações ocorrem via API, observe abaixo os processos que fazem parte da integração:

Ativando a Integração com o Gestão da Mão de Obra no Armazém no WMS Alcis

Para ativar a integração com o Gestão de Mão de Obra no Armazém, acesse Configurações de URL de Notificação (SD314) e, ao realizar uma pesquisa com o valor LMS pela coluna Código Integração, veremos todas as integrações relacionadas e na coluna Status, quando estiver com o parâmetro 00 está Ativo e se estiver com 90 está Inativo. Caso seja necessário alterar algum parâmetro, basta em seguida clicar no botão Salvar.

É importante que os campos de configuração das APIs estejam configurados conforme as informações de ativação de cada projeto.

Cadastros

Unidade Logística, Armazém ou Site

O primeiro passo é ter o cadastro da unidade logística que, no caso do WMS Alcis, é a informação de SITE. É necessário ter dois métodos para envio:

1. Automático: sempre que um novo site for criado no ambiente pela tela SD201-Criação de Site, deverá haver o disparo das informações contidas nesta API (ver na tela SY700 as integrações LMS_SITE_S, LMS_SITE_I, LMS_DEP_S, LMS_DEP_S, LMS_OPER_S e LMS_OPER_I), para que esta nova unidade logística (site) seja cadastrada no Gestão da Mão de Obra no Armazém. Observe o exemplo:

   

2. Manual: utilizado para enviar informações sobre unidade logística (site) em casos onde o Gestão da Mão de Obra no Armazém possa ser integrado a unidades logísticas (sites) cadastradas no WMS Alcis.
   • Endpoint: /wms_data/entities/unidadeLogistica

     Método GET

     Layout JSON:

     {

     "nome": "Nome da unidade logística",

     "code": "número de identificação",

     "ativo": "status do armazém, se está ativo (em funcionamento) ou desativado."

     }

     Exemplo

     {

     "nome": "Armazem Logistico Coffee",

     "code": "ALC",

     "ativo": "Ativo"

     }

Depositante ou Proprietário de Estoque

O segundo passo é ter o cadastro do depositante, que no caso do WMS Alcis também é conhecido como Depositante. É necessário ter dois métodos para envio:

1. Automático: sempre que um novo depositante for criado no ambiente na tela SD310-Depositante, deverá haver o disparo das informações contidas nesta API (verifique na tela SY700 as integrações LMS_DEP_S e LMS_DEP_I), para que este novo depositante (proprietário de estoque) seja cadastrado no Gestão da Mão de Obra no Armazém.

   

2. Manual: utilizado para enviar informações sobre depositante (proprietário de estoque) em casos onde o Gestão da Mão de Obra no Armazém possa ser integrado a depositantes (proprietários de estoque) já previamente cadastrados no WMS Alcis.
   • Endpoint: /wms_data/entities/depositante

     Método: GET

     Layout JSON:

     }

     "nome": "Nome do armazém depositante",

     "code": "número de identificação",

     "ativo": "status do armazém, se está ativo (em funcionamento) ou desativado."

     }

     Exemplo

     {

     "nome": "5 YEARS COFFEE",

     "code": "5YC",

     "ativo": "Ativo"

     }

Operador, Separador ou Operador de Equipamento

O terceiro passo é ter o cadastro do operador, que no caso do WMS Alcis, é o usuário que exerce uma atividade de separação, ou Usuário Operacional, seja ela de picking ou onda. É necessário ter dois métodos de envio:

1. Automático: nesse primeiro caso,sempre que um novo usuário (proprietário do estoque) for criado no ambiente na tela SD953 e realizando associação ao site na tela SD955 deverá haver o disparo das informações contidas nesta API (verifique na tela SY700 as integrações LMS_OPER_I e LMS_OPER_S), para que este novo usuário (operador) seja cadastrado no Gestão da Mão de Obra no Armazém. Também deverá ser enviada em casos onde o usuário tenha alteração de status (ativo ou inativo).

   

2. Manual: esse segundo caso será utilizado para enviar informações sobre usuário em casos onde o Gestão da Mão de Obra no Armazém possa ser integrado a um ambiente que já possua usuários cadastrados no WMS.
   • Endpoint: /wms_data/entities/operador

     Método: GET

     Layout JSON:

     {

     "nomeUsuario": "nome de usuário cadastrado no sistema e no coletor",

     "nome": "nome do colaborador",

     "cracha": "número do crachá do colaborador",

     "ativo": "status do colaborador",

     "deleted": "campo para informar se o operador foi deletado",

     "code": "id do usuário"

     }

     Exemplo

     {

     "nomeUsuario": "alanrezende@5ycoffee.com.br",

     "nome": "Alan T Rezende",

     "cracha": "12345",

     "ativo": "ativo",

     "deleted": null,

     "code": "ALANT1"

     }

Operações

Histórico de Tarefa

A API de histórico de tarefa é responsável por enviar ao Gestão da Mão de Obra no Armazém a previsão e a efetiva execução das tarefas de separação. É necessário ter um método de envio que será utilizado na criação, cancelamento e execução das tarefas de separação (picking e/ou onda).

• Automático: haverá a princípio apenas a possibilidade da integração da tarefa de maneira automática, porém essa mesma API será disparada em pontos distintos do processo, para manter o Gestão da Mão de Obra no Armazém atualizado.

  Endpoint: /wms_data/actions/integrarTaref

  Método: POST

  Layout JSON:

  {

  "identificador": "número identificador da tarefa",

  "numeroIdentificacaoUnidadeLogistica": "código de identificação da unidade logística",

  "numeroIdentificacaoDepositante": "código de identificação do depositante",

  "numeroIdentificacaoOperador": "código do operador",

  "descricao": "descrição da tarefa",

  "dataCriacao": "data e hora em que a tarefa foi criada",

  "dataSLA": "data e hora do SLA definido",

  "dataMovimentacao": "data e hora em que a tarefa sofreu movimentação",

  "quantidade": "quantidade",

  "peso": "peso (em gramas)",

  "volume": "volume (em mm³)",

  "linhasExpedidas": "linhas da nota fiscal",

  "quantidadeMovimentada": "quantidade de itens movimentados",

  "pesoMovimentado": "peso dos itens movimentados",

  "volumeMovimentado": "volume dos itens movimentados",

  "linhasExpedidasMovimentadas": "linhas da nota fiscal que foram movimentadas",

  "situacao": "situação da tarefa (PENDENTE, EM_ANDAMENTO, CONCLUIDA, CANCELADA)",

  "tipo": "tipo da tarefa (FILA, TRANSITO, TRABALHO, PAUSA, TERMINO)",

  "rotulos": "informações extras para uma tarefa, separador por um pipe \"|\""

  }

  Primeiro Disparo

  Reserva do Pedido: no ato da reserva do pedido, o Senior WMS Alcis Web deverá enviar a API de Histórico de Tarefa, para que haja a criação da tarefa no Gestão da Mão de Obra no Armazém. Nem todas as informações serão enviadas neste primeiro momento, abaixo está o exemplo das informações que deverão ser enviadas neste primeiro disparo.

  {

  "identificador": "1143210",

  "numeroIdentificacaoUnidadeLogistica": "ALC",

  "numeroIdentificacaoDepositante": "5YC",

  "numeroIdentificacaoOperador": null,

  "descricao": "separação",

  "dataCriacao": "2023-10-09T14:15:22Z", enviar a data e hora da reserva

  "dataSLA": "2023-10-09T14:15:22Z",

  "dataMovimentacao": "2023-10-09T14:15:22Z ", enviar a data e hora da reserva

  "quantidade": null,

  "peso": null,

  "volume": null,

  "linhasExpedidas": null,

  "quantidadeMovimentada": null,

  "pesoMovimentado": null,

  "volumeMovimentado": null,

  "linhasExpedidasMovimentadas": null,

  "situacao": "PENDENTE",

  "tipo": null,

  "rotulos": null"

  }

  

  Segundo Disparo

  Realização da Separação: na conclusão da separação de um dos itens/lotes de separação (parcial ou total) do pedido na tela AK400, deverá ser feito um novo disparo para atualizar o Gestão da Mão de Obra no Armazém. A seguir temos um exemplo do segundo disparo: 

  {

  "identificador": "1143211",

  "numeroIdentificacaoUnidadeLogistica": "ALC",

  "numeroIdentificacaoDepositante": "5YC",

  "numeroIdentificacaoOperador": "ALANT1",

  "descricao": "separação",

  "dataCriacao": "2023-10-09T14:15:22Z", "enviar a data e hora da separação"

  "dataSLA": "2023-10-09T14:15:22Z",

  "dataMovimentacao": "2023-10-09T14:15:22Z", "enviar a data e hora da separação"

  "quantidade": 19, "enviar a quantidade separada (em unidade menor)"

  "peso": 0.12, "enviar o peso da unidade menor"

  "volume": 0.00021, "enviar o volume da unidade menor"

  "linhasExpedidas": null,

  "quantidadeMovimentada": 19, "enviar a quantidade separada (em unidade menor)"

  "pesoMovimentado": 2.28, "enviar o peso total separado (unidades x peso unitário)"

  "volumeMovimentado": 0.00399, "enviar o volume total separado (unidades x volume unitário)"

  "linhasExpedidasMovimentadas": null,

  "situacao": "EM ANDAMENTO", "caso seja a última separação (enviar “CONCLUIDA”)"

  "tipo": null,

  "rotulos": "PF – PICKING FIXO | PICKING", "enviar área e descrição (concatenadas) e após uma separação por | “pipe” enviar se a separação foi “PICKING” Ou “ONDA”."

  }

  

  Terceiro Disparo

  Cancelamento de reserva: para o caso de um eventual cancelamento de reserva do pedido, deverá ser também enviada a API para atualização do Gestão da Mão de Obra no Armazém. Caso o pedido seja novamente reservado após o eventual cancelamento da reserva, a integração deverá ser enviada novamente, conforme descrito no 1º Momento de Disparo. Logo abaixo temos um exemplo das informações enviadas no momento do terceiro disparo.

  {

  "identificador": "1143211",

  "numeroIdentificacaoUnidadeLogistica": "ALC",

  "numeroIdentificacaoDepositante": "5YC",

  "numeroIdentificacaoOperador": null,

  "descricao": "separação",

  "dataCriacao": "2023-10-09T14:15:22Z", "enviar a data e hora do cancelamento da reserva"

  "dataSLA": "2023-10-09T14:15:22Z",

  "dataMovimentacao": "2023-10-09T14:15:22Z", "enviar a data e hora do cancelamento da reserva"

  "quantidade": null,

  "peso": null,

  "volume": null,

  "linhasExpedidas": null,

  "quantidadeMovimentada": null,

  "pesoMovimentado": null,

  "volumeMovimentado": null,

  "linhasExpedidasMovimentadas": null,

  "situacao": "CANCELADA",

  "tipo": null,

  "rotulos": null

  }

  

A solução integrada entre o WMS Alcis e o Gestão da Mão de Obra no Armazém permite, através de um painel de gestão, monitorar as atividades realizadas pelos colaboradores (Usuários Operacionais) e seus níveis de produtividade. Apresenta visibilidade total da operação, tanto individual quanto coletiva, relacionada às metas de separação de mercadorias. Além de acompanhar os indicadores em tempo real ou consolidados periodicamente, as informações ficam disponíveis por até 60 dias.

Para acessar o Gestão da Mão de Obra no Armazém, insira as informações de usuário e senha na URL de acesso. Dentro do Senior X, através do menu Gestão Logística > Gestão de Mão de Obra > Separação, ou digite Separação na caixa de pesquisa do menu. Para ter acesso aos dados basta utilizar os Filtros seguindo os seguintes critérios:

• Unidade logística: campo obrigatório para preenchimento é a unidade de logística, o Site do armazém;
• Depositante: campo opcional para preenchimento que representa as configurações do responsável legal pelas mercadorias, podendo ser colaborador com regime filial ou a empresa do armazém geral;
• Forma de cálculo: campo opcional para preenchimento de algum acondicionamento, seja peça, peso, cubagem/volumetria, quantidade de tarefas e linhas;
• Rótulo: campo opcional para preenchimento onde o rótulo representa o número do Pedido.