1️⃣7️⃣ #49331 - API para Manutenção do Agendamento da GMUD
📜 Descrição
A partir desta melhoria, foi disponibilizada uma nova requisição de API para permitir a manutenção das informações de agendamento de uma GMUD. Com isso, integrações externas poderão atualizar a data e hora de início e fim da mudança enquanto a GMUD ainda estiver aguardando aprovação.
A nova requisição permite alterar os campos de Data de Agendamento, Data de Agendamento Fim, Hora de Agendamento e Hora de Agendamento Fim, utilizando como referência a chave da GMUD. O recurso é voltado para cenários em que a operação já possui processos integrados via API e precisa ajustar automaticamente a janela planejada da mudança antes da aprovação.
A manutenção será permitida apenas para GMUDs que ainda não passaram pelo processo de aprovação. Caso a GMUD já esteja Aprovada, Reprovada ou Finalizada, a API bloqueará a atualização e retornará uma mensagem de erro informando que a GMUD já passou pelo processo de aprovação. Todas as alterações realizadas por essa manutenção ficam registradas no Log, garantindo rastreabilidade da ação.
✍ Notas
- Nova Requisição de API
Foi adicionada uma nova rota para manutenção do agendamento de GMUDs: PUT /GMUDs/manutencao. - Atualização de Data e Hora
A API permite atualizar data e hora de início e fim da mudança, mantendo o agendamento da GMUD alinhado ao processo operacional - Bloqueio Após Aprovação
GMUDs Aprovadas, Reprovadas ou Finalizadas não poderão ter o agendamento alterado por essa requisição. - Registro em Log
As alterações realizadas pela API ficam registradas no Log da GMUD, incluindo as informações modificadas e o operador utilizado na requisição. - Apoio a Integrações
O recurso permite que clientes automatizem a manutenção de janelas de mudança por meio de sistemas externos ou processos integrados.
💡 Caso de uso
- Integrações com Sistemas Externos
Empresas que controlam mudanças em ferramentas externas podem atualizar o agendamento da GMUD automaticamente na Desk Manager. - Ajuste de Janela Antes da Aprovação
Caso a data ou horário planejado da mudança precise ser alterado antes da aprovação, a integração pode realizar o ajuste sem ação manual no portal. - Governança de Mudanças
A limitação para GMUDs ainda não aprovadas ajuda a preservar o controle do processo, evitando alterações indevidas após aprovação, reprovação ou finalização. - Rastreabilidade Operacional
Como as alterações ficam registradas em Log, administradores podem auditar mudanças no agendamento e identificar quando e por qual operador a atualização foi realizada.
📦 Plano
Disponível para todos os planos.
🎞️ Vídeo
Segue o link para o vídeo explicativo da nova funcionalidade.
💲 Valores
Não haverá adição de valores.
🔢 Código do Recurso
#49331