Janeiro

Comunicado realizado em 17/01/2025

Revisão de acessos e garantia de segurança aos sistemas

Prezado(a) cliente,

Gostaríamos de informá-lo que, em decorrência das recentes eleições municipais, pode haver alterações no quadro de colaboradores em alguns municípios, o que pode impactar também os usuários dos sistemas.

Com o objetivo de evitar acessos indevidos e garantir a segurança das informações a partir do próximo ano, recomendamos que a gestão dos acessos seja revisada.

Pedimos que verifiquem se as permissões de acesso permanecem adequadas e se os responsáveis pelos sistemas (administradores) estão devidamente atualizados.

Esse controle é realizado por meio do menu Utilitários > Gerenciador de acessos.

Esta medida preventiva visa assegurar a integridade e a confidencialidade dos dados, evitando acessos não autorizados.

Agradecemos pela atenção e permanecemos à disposição para quaisquer dúvidas.

Melhorias entregues até 09/01/2025

Aprimoradas as funcionalidades Entrada e Saída de bens

Comunicamos que o sistema Almoxarifado (Cloud) agora reconhece Entradas e Saídas de itens do tipo Parcial, exibindo a situação na listagem inicial.

A Entrada/Saída será parcial quando, pelo menos, um Item da listagem possuir um tipo de inconsistência, como, por exemplo, ausência de saldo. Nessas situações, os itens que não possuem inconsistências serão finalizados normalmente, mas os demais não serão finalizados, o que poderá ser realizado posteriormente, quando sanada a inconsistência.

Além disso, a tela Listando itens (menu Executando > Movimentos de bens > Entradas > Outras opções (ícone de engrenagem) > Itens) agora exibe a Situação de cada material, ou seja, se quando da finalização da Entrada, ele foi finalizado com sucesso ou com Erro.

Ao passar o mouse sobre o ícone de Erro será exibido o motivo da situação, cadastrado quando da finalização.

Vale ressaltar que, os Itens que foram finalizados com Erro são passíveis de edição (ícone de lápis), possibilitando, assim, o seu ajuste ou exclusão. Após a edição, se ainda houver algum item com erro, basta enviar novamente para finalização. Mas, se todos os itens estiverem devidamente finalizados, a Entrada é atualizada automaticamente para a situação Finalizada.

A entrada também pode exibir o status Erro ao finalizar, que ocorre quando a entrada é enviada para finalização, mas nenhum dos itens é finalizado com sucesso. Nesses casos também é possível realizar a edição (ícone de lápis) do procedimento, ajustando ou excluindo os itens com erro e enviando novamente para finalização.

O mesmo procedimento foi aplicado às Saídas de bens (menu Executando > Movimentos de bens > Saídas).

[Técnicos] Alterações no processo de migração de Entradas, Itens e Finalizações do Almoxarifado

Atenção usuários técnicos!

Informamos que foram realizadas alterações na forma de recebimento dos Itens de Entradas, Saídas e Finalizações do sistema Almoxarifado (Cloud). Agora deve-se seguir os seguintes passos:

1. Enviar Entradas e Saídas;
2. Enviar Itens de Entradas e Saídas;
   • Alteramos o JSON de envio, bem como os campos obrigatórios de preenchimento sendo:
   • Itens da Entrada: O envio de valores dos movimentos passa a ser opcional (precoMedio, saldoFisico e saldoFinanceiro), sendo obrigatório apenas a informação dos campo quantidadeItem e valorUnitario:

• Itens da Saída: campo de valor obrigatório agora é apenas quantidadeItem.

3. Finalizar Entradas e Saídas;

   • Poderá ser utilizado o novo serviço (movimentos-finalizacao) ou os serviços anteriores (saidas-finalizacao e entradas-finalizacao). No novo serviço, caso os movimentos não sejam enviados, estes serão gravados com os valores zerados, sendo necessário executar o recálculo dos movimentos após o término de todas as finalizações;
   • O recálculo deve ser realizado antes da criação de Inventários, caso contrário, não seria possível executá-lo;
   • Caso os valores dos movimentos sejam enviados junto com o movimento, como é feito atualmente nas migrações, o sistema continuará utilizando os valores recebidos na migração, podendo também ser recalculado os movimentos caso haja necessidade.

4. Recalcular os valores dos movimentos.

   É possível realizar o recálculo de duas formas:

   • Recalcular todos os materiais de um Estoque com base na Data e Hora (ao consultar os lotes de migração, estes serão retornados na consulta de Lotes, retornando, também, um hash de processamento, que possibilitará a consulta do andamento em outro endpoint).

• Para consultar o andamento do processamento com base no hash disponibilizado, deverá ser utilizado o endpoint na URL: GET .../estoque-services/api/processamentos/<hash_processamento>;
• Também foram criados endpoints para realizar o recálculo via Service Layer por meio da URL: POST .../estoque-services/api/exercicios/<ano_exercicio>/almoxarifados/<id_estoque>/movimentos/recalcular-movimentos-estoque*

• Recalcular os valores dos movimentos a partir da Data e Hora informada (o processamento será sincronizado com o lote de migração, não retornando o hash de processamento).

• Também foram criados endpoints para realizar o recálculo via Service Layer por meio da URL: POST .../estoque-services/api/exercicios/<ano_exercicio>/almoxarifados/<id_estoque>/movimentos/recalcular-movimentos-material

O procedimento de migração também foi alterado, devendo-se seguir os passos abaixo:

1. Migrar Entradas (não houve alteração);

2. Migrar Itens das Entradas, neste é possível escolher uma das duas opções abaixo:

   • Opção 1: Migrar os Itens com os valores e saldos (opção atual);
   • Opção 2: Migrar os Itens sem o envio dos valores (obrigatório para entrada apenas a quantidade e o valor unitário)

3. Finalizar Entradas (após finalizar, caso os valores dos movimentos não tenham sido enviados, o sistema irá gravar os valores zerados, incluindo saldos físicos e financeiros);

4. Migrar Saídas (sem alteração do que temos hoje);

5. Migrar Itens das Saídas (aqui temos 2 opções):

   • Opção 1: Migrar os Itens com os valores e saldos (opção feita atualmente);
   • Opção 2: Migrar os Itens sem o envio dos valores (obrigatório para saída apenas a quantidade);

6. Finalizar Saídas (após finalizar, caso os valores dos movimentos não tenham sido enviados, o sistema gravará os valores zerados, incluindo saldos físicos e financeiros).

Após todas as finalizações, disponibilizamos um serviço que irá recalcular o valor dos movimentos do estoque, o qual poderá ser utilizado tanto para o recálculo dos movimentos com especificação de apenas um estoque, quanto dos movimentos a partir da data e hora informadas. O recálculo será realizado com base nos movimentos existentes de Entradas e Saídas finalizadas.

Caso os movimentos tenham sido enviados com valores errados, o saldo do mesmo ficará negativo (sem qualquer validação em relação a isso). Nessa hipótese, o responsável pela migração deverá analisar e ajustar as Entradas e Saídas de modo a deixar todos os dados consistentes e, se necessário, basta realizar o recálculo novamente.

Esse serviço receberá uma data inicial e irá calcular todos os valores até a data do último movimento existente, portanto, há alguns casos em que não é possível a execução do serviço, tais como:

• Quando houver um Inventário que possui a especificação com Data igual ou maior que a Data informada para o serviço, nos casos de utilização do serviço para recalcular os valores de apenas uma especificação;
• Quando houver um Inventário com Data igual ou maior que a Data fornecida para o serviço, nos casos de utilização do serviço para recalcular todas as especificações.

Após isso, as migrações dos demais dados poderão seguir normalmente.

Nestas situações de recálculo de todos os materiais, o lote enviado ficará com Situação igual a Processando até que todos cálculos de todos materiais sejam concluídos, ou seja, dependendo da quantidade de movimentos e materiais pode ser que o processo demore um pouco.

Lembre-se!

Após a criação de um Inventário não será possível recalcular os movimentos.

Desenvolvido novo serviço de lote para recalcular os valores dos movimentos

• Serviço de lote 1 - Recalcular todos os materiais de um estoque com base na data e hora

URL: POST .../estoque-services/api/conversoes/lotes/recalcular-movimentos-estoque

Payload exemplo: (recalcula os valores dos movimentos a partir da data e hora informada de todos os materiais)

• Serviço de lote 2 - Recalcular com base em uma especificação e data e hora

URL: POST .../estoque-services/api/conversoes/lotes/recalcular-movimentos-material

Payload exemplo: (recalcula os valores dos movimentos de 1 especificação a partir da data e hora informada)

Neste caso, o processamento é síncrono com o lote de migração, ou seja, não retorna um hash de processamento.

Ao consultar os lotes de migração, o serviço 1 (reprocessa todos os materiais), retorna também na consulta do lotes, um hash do processamento, onde poderá ser consultado o andamento em um outro endpoint:

O registro de migração será atualizado para Sucesso somente quando o processamento for concluído, então, será possível identificar a finalização do processamento por meio do lote de migração.

Para consultar o andamento do processamento com base no hash disponibilizado, deverá ser utilizado o endpoint na url abaixo:

• URL: GET .../estoque-services/api/processamentos/<hash_processamento>

• Exemplo URL completa: .../estoque-services/api/processamentos/d377cf10-f401-4724-a532-e7650c8fd508

Exemplo retorno:

Também foram criados endpoints para recalcular via service layer (não via serviço de lotes).

• Serviço Service Layer 1 - Recalcular todos os movimentos de um estoque com base na hora informada:

URL: POST .../estoque-services/api/exercicios/<ano_exercicio>/almoxarifados/<id_estoque>/movimentos/recalcular-movimentos-estoque*

Exemplo URL completa: .../estoque-services/api/exercicios/2024/almoxarifados/45/movimentos/recalcular-movimentos-estoque

Exemplo payload:

• Serviço Service Layer 2 - Recalcular movimentos de uma especificação de um estoque com base na hora informada:

URL: POST .../estoque-services/api/exercicios/<ano_exercicio>/almoxarifados/<id_estoque>/movimentos/recalcular-movimentos-material

Exemplo URL completa: .../estoque-services/api/exercicios/2024/almoxarifados/45/movimentos/recalcular-movimentos-material

Exemplo payload:

Todos os serviços que retornam um hash de processamento podem ter seu andamento consultado por meio do serviço de consulta de processamento.

• Procedimentos para migração:
  • Migrar Entradas (sem alteração do que temos hoje);
  • Migrar itens das Entradas:
    • Migrar os itens com os valores e saldos (opção feita atualmente);
    • Migrar os itens sem o envio dos valores (obrigatório para entrada apenas a quantidade e o valor unitário);
  • Finalizar Entradas (após finalizar, caso os valores dos movimentos não tenham sido enviados, o sistema gravará os valores zerados, incluindo saldos físicos e financeiros);
  • Migrar Saídas (sem alteração do que temos hoje);
  • Migrar itens das Saídas:
    • Migrar os itens com os valores e saldos (opção feita atualmente);
    • Migrar os itens sem o envio dos valores (obrigatório para saída apenas a quantidade);
  • Finalizar Saídas (após finalizar, caso os valores dos movimentos não tenham sido enviados, o sistema gravará os valores zerados, incluindo saldos físicos e financeiros).

Com as finalizações realizadas, desenvolvemos um serviço que recalcula o valor dos movimentos de um estoque, o qual pode ser utilizado para recalcular os valores dos movimentos de uma ou mais especificações de um estoque, a partir de uma data que também precisará ser fornecida para o serviço.

Esse recálculo será feito com base nos movimentos existentes, de Saídas e Entradas finalizadas.

Caso os movimentos tenham sido enviados com valores incorretos, como, por exemplo, ter uma saída que deixa um estoque de um material negativo, o saldo do mesmo ficará negativo (sem qualquer validação em relação a isso). Nesse caso, a pessoa responsável pela migração deverá analisar e ajustar as entradas e saídas para que os dados fiquem consistentes e, se necessário, o recálculo dos movimentos poderá ser feito novamente.

Esse serviço receberá uma data inicial, e irá calcular todos os valores até a data do último movimento existente, sendo assim, em alguns casos, não poderá ser executado esse serviço, tais como:

• Se for utilizado o serviço para recalcular os valores de apenas uma especificação - caso exista um Inventário que possui a especificação com data igual ou posterior a data informada para o serviço, não será possível recalcular os valores;
• Se for utilizado o serviço para recalcular todas as especificações - caso exista algum Inventário com data igual ou posterior a data fornecida para o serviço;

Após isso, as migrações dos demais dados poderão seguir normalmente.

Nestas situações de recálculo de todos os materiais, o lote enviado ficará com status igual a Processando até que todos cálculos de todos materiais sejam concluídos, ou seja, dependendo da quantidade de movimentos e materiais pode ser que o processo demore um pouco.

Importante!

Caso seja criado algum Inventário, conforme citado acima, não será possível recalcular os movimentos.