Desenvolvimento Millen-34067 – Integração correios API - Cálculo do valor declarado
Release 104
Versão 5
Autor Jaciara Silva
Processo: Logística
Nome do Processo: Embarque
Motivação
Desenvolver parâmetro "Percentual Declarado" e "Valor Máximo Declarado" no cadastro de Tipos de Frete (Logística\Estoque\Cadastros\Tipos de Frete), para que seja informado percentual e valor máximo acordado pelos Correios.
Preenchendo os parâmetros Percentual Declarado e Valor Máximo Declarado, ao realizar embarque e enviar PLP aos Correios, o e-Millennium irá multiplicar o valor da nota pelo percentual configurado e validar se o valor declarado não ultrapassou o valor, informado no parâmetro "Valor Máximo Declarado":
- Caso o valor declarado ultrapasse o Valor Máximo, o e-Millennium enviará o valor informado no campo "Valor Máximo Declarado".
- Caso o valor declarado não ultrapasse o Valor Máximo, o e-Millennium enviará o valor obtido após a multiplicação do valor da Nota Fiscal pelo percentual configurado, no parâmetro Percentual Declarado.
IMPORTANTE!
- Este recurso não será implementado no millenium_sigep.
- Os Correios estão em migração de Web Service para API, prevista para março de 2024. Esta customização somente será desenvolvida no novo padrão (API).
Atenção! Este recurso não acompanha a versão do sistema. Para utilizá-lo, solicite aos nossos consultores que forneçam o módulo para instalação. Caso você não consiga fazer a instalação, entre em contato com nosso departamento comercial e solicite a visita de um consultor.
Parâmetros
Instalar o módulo millenium!gf_correios_api.minst. Para informações sobre como fazer a instalação de módulos no e-Millennium acesse o Manual de instalação de módulos no e-Millennium.
Entradas
Configurando tipo de frete
Para ativar o recurso de valor declarado, as configurações devem ser feitas no cadastro dos tipos de fretes a serem utilizados para os Correios.
Em Logística\Estoque\Cadastros\Tipo de Frete:
- Ligar o parâmetro VD – Valor Declarado
- Preencher os campos (habilitados somente quando o parâmetro acima estiver ligado):
Tipo do Serviço com Valor Declarado (opcional)
Valor Mínimo Declarado
- Na guia Correios API, preencha os campos:
Percentual Declarado
Valor Máximo Declarado
Em Logística\TMS\Cadastros\Transportadoras, selecione a transportadora Correios API:
- Na guia Frete e Seguro:
Ligar o parâmetro Gateway Frete
No campo Módulo, preencher com a opção Correios API
Preencher a Tabela do SIGEP
- Na guia Correios API
Preencher as informações de integração com a API dos Correios
Venda com valor mínimo, valor máximo e percentual declarados
- Quando somente o valor mínimo estiver configurado, será verificado se o valor da nota é maior que o valor mínimo e, se for, será automaticamente informado o valor mínimo e desconsiderado o valor da nota fiscal.
- Se estiverem preenchidos os campos de Valor Máximo e Percentual Declarado, será aplicada a seguinte fórmula :
Valor Total * Percentual Declarado = Resultado
O resultado é maior que o valor informado no campo de Valor Máximo? É, então assumimos que o valor máximo é o informado no campo e não o resultado da conta. Caso seja menor, segue o valor do resultado.
Cenário de configuração do tipo de frete:
Valor Declarado Mínimo = 150,00
Percentual Declarado = 25%
Valor Declarado Máximo = 190,00
Após o faturamento da venda e autorização da nota fiscal pela Sefaz, deverá ser incluído o embarque do pedido de venda.
Em Logística\Expedição\Embarque:
- Incluir Embarque
- Selecione a nota fiscal emitida
- Efetivar
- No link Ações\Alterar Status, devem ser feitas as mudanças do status do embarque de acordo com os processos da empresa. Assim que o status estiver como CONCLUÍDO, o sistema enviará os dados do embarque automaticamente para o Correio, via API.
Validações e Saídas
Ao configurar os valores mínimo e máximo, o sistema fará uma validação para garantir que a lógica do processo não seja corrompida. Neste exemplo, o valor máximo configurada está menor que o valor informado como sendo o mínimo e o sistema emitiu mensagem de alerta, para que fosse feita a correção antes de efetivar a parametrização do recurso.
