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":

  1. Caso o valor declarado ultrapasse o Valor Máximo, o e-Millennium enviará o valor informado no campo "Valor Máximo Declarado".
  2. 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!

  1. Este recurso não será implementado no millenium_sigep.
  2. 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:

Tipo do Serviço com Valor Declarado (opcional)
Valor Mínimo Declarado

Percentual Declarado
Valor Máximo Declarado
Em Logística\TMS\Cadastros\Transportadoras, selecione a transportadora Correios API:

Ligar o parâmetro Gateway Frete
No campo Módulo, preencher com a opção Correios API
Preencher a Tabela do SIGEP

Preencher as informações de integração com a API dos Correios

Venda com valor mínimo, valor máximo e percentual declarados

  1. 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.
  2. 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:


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.