Reclassificar Solicitação

Altera o Tipo Solicitação de uma solicitação, da mesma forma que a opção Reclassificar do módulo Resolução.

Ao reclassificar, o CUBE aplica as regras do novo Tipo Solicitação: órgão, seções (navegação), prazo (SLA), criticidade, categorias e fluxo BPM. A solicitação recebe um histórico com o status RECLASSIFICADA. Caso o usuário da API não pertença ao órgão do novo tipo, a solicitação volta para o status ABERTA e sem usuário de tratamento.

A API segue as mesmas regras da opção Reclassificar do módulo Resolução:

caution

• O novo Tipo Solicitação deve estar ativo.
• Se o tipo atual possuir Lista de reclassificar, o novo tipo deve fazer parte dela. Consulte em Consultar Tipos Reclassificáveis.
• Quando a data limite de tratamento da solicitação foi atingida e há restrição por data limite, a reclassificação é bloqueada, exceto para usuários com a permissão resolucao:gestao:indicadores:permite-editar-com-bloqueio.
• Solicitações relacionadas à solicitação também são reclassificadas para o novo tipo, sem registro de formulário.

Fluxo recomendado

1. Consulte Tipos Reclassificáveis e escolha o id do novo tipo.
2. Se o tipo escolhido tiver idFormulario, consulte Modelo de registro desse formulário e preencha o exemploBody.
3. Envie a reclassificação com o idTipoSolicitacao e, quando houver formulário, o registroFormulario.

Endpoints

Método	URL
POST	https://{{url}}/cube/api/v3/solicitacoes/{{idSolicitacao}}/reclassificar

Exemplo de Corpo JSON

Tipo Solicitação sem formulário

{
	"idTipoSolicitacao": 913
}

Tipo Solicitação com formulário

O registroFormulario segue o mesmo formato do body de Criar registro de formulário: as chaves são as chave dos campos do modelo de registro e os valores seguem o formato de cada campo.

{
	"idTipoSolicitacao": 912,
	"registroFormulario": {
		"ip_nome": "Maria da Silva",
		"dt_visita": "2026-10-20T14:30",
		"sl_tipo": "Residencial",
		"cb_aceite": 1
	}
}

Chave	Descrição
idTipoSolicitacao*	Numérico - ID do novo Tipo Solicitação.
registroFormulario	Objeto - Valores do formulário do novo Tipo Solicitação. Obrigatório para preencher os campos obrigatórios quando o tipo possui formulário. Não deve ser enviado quando o tipo não possui formulário.

tip

• Os campos marcados com * são obrigatórios.
• Quando o novo tipo possui formulário, o CUBE cria um novo registro desse formulário para a solicitação com os valores enviados. O registro anterior fica guardado no histórico de reclassificação.
• Chaves que não pertencem ao formulário do novo tipo são ignoradas.
• Quando o novo tipo não possui formulário, o registro de formulário atual da solicitação é desvinculado.

Respostas

Exemplo de corpo da resposta

{
	"idSolicitacao": 1411,
	"idTipoSolicitacaoAnterior": 738,
	"idTipoSolicitacao": 912,
	"idFormulario": 123,
	"idRegistroFormulario": 4567
}

Exemplo de corpo da resposta em caso de erro

{
	"errors": [
		{
			"attribute": "preenchimento.obrigatorio",
			"message": "ip_nome, dt_visita"
		}
	]
}

O attribute traz a chave do erro e o message traz o detalhe (campos, ID ou status envolvidos).

Dicionário dos dados retornados na API

Chave	Descrição
idSolicitacao	Numérico - ID da solicitação reclassificada.
idTipoSolicitacaoAnterior	Numérico - ID do Tipo Solicitação antes da reclassificação.
idTipoSolicitacao	Numérico - ID do novo Tipo Solicitação.
idFormulario	Numérico - ID do formulário do novo tipo. null quando o tipo não possui formulário.
idRegistroFormulario	Numérico - ID do registro de formulário vinculado à solicitação após a reclassificação. null quando não houver.

Erros de validação

attribute	Quando ocorre
preenchimento.obrigatorio	idTipoSolicitacao não informado, ou campos obrigatórios do formulário do novo tipo não preenchidos (o message lista as chaves).
solicitacao.bloqueada.data.limite	A data limite de tratamento da solicitação foi atingida e o usuário não possui a permissão resolucao:gestao:indicadores:permite-editar-com-bloqueio.
tipo.solicitacao.nao.reclassificavel	O tipo atual possui Lista de reclassificar e o novo tipo não faz parte dela.
tipo.solicitacao.inexistente	O novo Tipo Solicitação não existe.
tipo.solicitacao.inativo	O novo Tipo Solicitação está inativo, em rascunho ou excluído.
tipo.solicitacao.sem.formulario	registroFormulario enviado para um tipo que não possui formulário.
formulario.inexistente	O formulário vinculado ao novo tipo não foi encontrado.
permissao.negada	Usuário sem a permissão resolucao:solicitacoes:recategorizar (status 403).
erro.reclassificar.solicitacao	O CUBE não concluiu a reclassificação (status 500). Verifique se os valores do formulário atendem às regras configuradas no formulário.

Status da resposta

Status	Descrição
200	OK - Solicitação reclassificada com sucesso.
400	Requisição inválida - ver tabela de erros de validação.
401	Credenciais de acesso inválidas ou não informadas.
403	Usuário sem a permissão resolucao:solicitacoes:recategorizar.
404	Solicitação não encontrada.
500	A reclassificação não foi concluída pelo CUBE.

Permissões necessárias

Permissão	Descrição
resolucao:solicitacoes:recategorizar	Permite reclassificar solicitações via API.
resolucao:gestao:indicadores:permite-editar-com-bloqueio	Opcional. Permite reclassificar solicitações bloqueadas por data limite.