Linha Microsiga Protheus

Árvore de páginas


01. DADOS GERAIS


Produto:

TOTVS Agro Comercialização

Linha de Produto:

Linha Protheus

Segmento:

Agroindústria

Módulo:AGRODISTRIBUIDOR ( SIGAAGD)
Função:AGDA090.PRW
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :

DAGRODIST-1727


02. SITUAÇÃO/REQUISITO

Implementar o processo de finalização da configuração das features do módulo TCO (Total Cost Ownership), através da API POST /api/agd/v1/tco/finalizar-configuracao.

A nova API é responsável por registrar a configuração final do módulo AgroDistribuidor, consolidando o status das features e garantindo a rastreabilidade da finalização.

A mesma deve:

  1. Receber a requisição HTTP POST para registrar a configuração final do módulo, sem necessidade de body.

  2. Verificar pendências de incompatibilidades antes de concluir a finalização:

    • O backend deve consultar a tabela NE1 e verificar se todas as features configuráveis não possuem pendências de compatibilidade, conforme o retorno do método getIncompatibilidadeFeatures().

    • Caso existam pendências (por exemplo, conflitos de compartilhamento de tabelas ou parâmetros incorretos), a requisição deve ser rejeitada, retornando uma mensagem estruturada informando os motivos da falha.

  3. Em caso de sucesso na validação:

    • Identificar o registro da feature TCO na tabela NE1.

    • Atualizar o campo NE1_STATUS para 3 (Finalizado).

    • Preencher os campos NE1_DT_FINAL (data) e NE1_HRFINA (hora) com a data e hora atuais do servidor.

  4. Retornar uma resposta estruturada (JSON) indicando o resultado do processamento, incluindo o status individual de cada feature (success, error, ignored) e mensagens de detalhe.


03. SOLUÇÃO

Foi implementada a API POST /api/agd/v1/tco/finalizar-configuracao, responsável por:

  1. Percorrer automaticamente todas as features ativas (NE1_ATIVO = 1) do módulo TCO.

  2. Validar incompatibilidades de tabelas e parâmetros através dos DTOs (ex.: agdTCOBarterDTO, agdTCOReceituarioDTO, agdTCOOriginacaoProtheusDTO).

  3. Atualizar o status da feature (NE1_STATUS) para 3 – “Finalizado”, quando não houver erros.

  4. Registrar a data (NE1_DT_FINAL) e hora (NE1_HRFINA) de finalização com base no momento da execução.

  5. Retornar um JSON consolidado, exibindo o resultado individual de cada feature:

    • success → finalizada com sucesso

    • error → foram encontradas incompatibilidades

    • ignored → já finalizada ou não atualizável

04. DEMAIS INFORMAÇÕES


05. ASSUNTOS RELACIONADOS

        Não se aplica