Alteração Status recurso

Este manual orienta o uso dos endpoints da API para processos de Alteração Status recurso, com ênfase nos novos requisitos e exemplos de JSON.

../../_images/Image01.png

Este recurso da API permite que o usuário altere o status de um recurso produtivo. A seguir estão descritos os comportamentos, validações e mensagens retornadas pelo sistema.

Regras para Seleção de Recursos

  • Apenas recursos que não estejam em uso na produção poderão ter o status alterado.

  • Esta restrição evita alterações indevidas e garante que não haja interrupções no processo produtivo.

Regras para Seleção de Status

O sistema permitirá a alteração somente para status cadastrados em categorias válidas:

  • Fora de turno

  • Parada não planejada

  • Parada planejada I

  • Parada planejada II

Validações Antes da Alteração

  1. Validação de recurso não informado - Caso o usuário não informe o recurso (codigoRecurso), a API retornará:

    BR One :: informe um valor para o campo "codigoRecurso".
    
  2. Validação de status não informado - Caso o usuário não informe o status (codigoStatus), a API retornará:

    BR One :: informe um valor para o campo "codigoStatus".
    
  3. Validação de uso do recurso - Caso o recurso esteja em uso, a alteração não será permitida. - A API retornará:

    BR One :: O recurso selecionado está em uso na produção e não pode ser alterado. Por favor, selecione um recurso disponível.
    
  4. Validação de status inválido - Se o codigoStatus informado não pertencer a uma das categorias válidas, a API retornará:

    BR One :: O status selecionado não é válido para o recurso. Serão permitidos apenas os status que pertençam a alguma destas categorias: 'Fora de turno', 'Parada não planejada', 'Parada planejada I' ou 'Parada planejada II'.
    

Exemplo de Requisição

{
  "codigoRecurso": "Ferramenta03",
  "codigoStatus": "FDT",
  "observacao" : "retorno previsto as 12:00 PM"
}

Mensagem de Sucesso

Quando todos os dados forem informados corretamente e o recurso estiver disponível, a API confirmará a operação:

BR One :: Operação completada com sucesso.