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.
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
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".
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".
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.
Validação de status inválido - Se o
codigoStatusinformado 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.