Desenvolvimento Millen-21792 – Integração gateway de frete DHL - Conferência de Transferência de Estoque
Release 102
Versão 5
Autor André Mota
Processo: Logística
Nome do Processo: Conferência de Transferência de Estoque
Motivação
Este novo recurso visa integrar o operador logístico e seu clientes ― usuários e-Millennium, para conferência de transferência de estoque. Para isso, foi desenvolvida API para recebimento de conferência de transferência no e-Millennium, a ser realizada no sistema utilizado pelo operador logístico.
Também foi criada API no gateway de frete da DHL a ser utilizado para receber dados da conferência da transferência recebida pelo CD do operador logístico. Vale citar que, de acordo com a quantidade conferida, serão tomadas ações diferentes no sistema. Este desenvolvimento atende o modelo CAT31.
Para controle no e-Millennium, o usuário cadastrará uma filial para o operador logístico e realizará uma transferência, que ficará com o status de Conferência pendente. Ao receber a mercadoria em seu CD, o operador logístico realizará a conferência e enviará um retorno via API, informando que a conferência foi realizada.
1. Caso a transferência esteja sem divergência, o e-Millennium alterará seu status para Conferido e finalizará o processo.
2. Caso seja encontrada uma divergência a menos (quantidade recebida menor que a contida na movimentação), o ERP deverá, automaticamente, emitir uma nota fiscal de devolução/retorno à empresa e concluir a transferência.
3. Caso seja encontrada uma divergência a mais (quantidade recebida maior que a contida na movimentação), a API deverá retornar uma mensagem de erro.
Parâmetros
- Instale o módulo millenium!gw_dhl (DHL), acessando a tela Monitoramento dos Módulos (Novo) pelo caminho Utilitários > Administrador > Monitoramento os Módulos (Novo).
- Cadastre um evento de transferência do tipo Devolução, pelo caminho Utilitários > Administrador > Eventos. Para isso, em um evento de movimentação de transferência de estoque com conferência , na guia Geral, campo Tipo de Evento, selecione a opção Transferência. No campo Tipo de Transferência, selecione a opção Devolução. Veja abaixo:
Observação: para que a devolução gerada, a partir da divergência na transferência conferida, grave a referência ao movimento de origem que está sendo conferido, é necessário que o campo Movimentação Entrada/Saída esteja configurado com uma opção diferente de Não acessa.
- Configure os dados do operador logístico, acessando o caminho Utilitários > Empresa > Filiais. Para isso, selecione a filial. Na guia Integração DHL, ligue a flag Habilita Integração DHL. No campo Modelo Fiscal, selecione a opção CAT 31. Será habilitado o campo Evento para Devolução de Estoque com Divergência. Selecione a opção DHL DHL - Devolução. Informe os dados necessários.
- Ainda em Filiais (Utilitários > Empresa > Filiais ), cadastre uma filial para representar o operador logístico DHL.
Entradas
Lançando uma transferência
Para lançar uma transferência com possibilidade de conferência, siga os passos abaixo:
1. Acesse o evento de transferência de estoque com possibilidade de conferência pelo caminho Logística > Expedição > Movimentações;
2. Na tela da movimentação, realize a transferência (com conferência) preenchendo os campos obrigatórios;
3. Clique em Efetivar. Será emitida a Nota Fiscal Eletrônica;
4. O operador logístico receberá as informações do produto e validará as quantidades, tomando as seguintes ações, de acordo com a divergência:
5. Sem divergência: o e-Millennium conclui a transferência e a altera status para Conferida;
6. Divergência Negativa (itens a menos): o e-Millennium conclui a transferência e emite nota fiscal de devolução do operador logístico para a filial (esta devolução deverá ser realizada conforme configuração do próprio evento configurado no cadastro da filial que fez a transferência);
7. Divergência Positiva (itens a mais): o e-Millennium retorna mensagem na API e não permite a conferência (a empresa irá realizar nova chamada com a quantidade exata e tratar a quantidade excedente fora do processo).
Validações e Saídas
Abaixo, vemos as APIs de integração com o ERP e-Millennium, no gateway de frete da DHL, com os dados da conferência da transferência recebidos pelo CD do operador logístico. De acordo com a quantidade conferida, serão tomadas ações diferentes no sistema.
As mercadorias que constam nas notas enviadas ao CD, mas que não foram transportadas fisicamente, deverão retornar fiscalmente. Já em caso de divergência a mais, será apresentada mensagem de erro e as mercadorias serão devolvidas.
Envio de item(ns) com divergência na quantidade para mais (produto 216)
Envio de item(ns) com divergência na quantidade para menos (produto 217)
