cancelarVistorias

id: cancelarVistoria

title: Cancelar vistorias

Endpoint utilizado para cancelar uma vistoria.

URL

POST https://gateway.vexsoft.com.br/api/vistoria/v3/vistoria/TOKEN/ID_VISTORIA/cancelamento

(https://gateway.vexsoft.com.br/api/vistoria/v3/vistoria/TOKEN/ID_VISTORIA/cancelamento)

---

Conceituação

TOKEN: Token da sua empresa.

ID_VISTORIA: ID da vistoria que será cancelada.

Este endpoint permite cancelar uma vistoria já realizada. O cancelamento mantém o registro da vistoria para fins de auditoria e rastreabilidade, alterando apenas sua situação para "Cancelada".

---

URL exemplo

https://gateway.vexsoft.com.br/api/vistoria/v3/vistoria/EPO110/12345/cancelamento

---

Request

Campo	tipo	Descrição	Obrigatoriedade
motivoCancelamento	string	Motivo do cancelamento da vistoria	Sim
idUsuario	integer	ID do usuário responsável pelo cancelamento	Sim
dataCancelamento	string	Data e hora do cancelamento no formato YYYY-MM-DD HH:MM	Sim
placa	string	Placa do veículo da vistoria	Sim
idEmpresa	integer	ID da empresa proprietária da vistoria	Sim

---

Request Body exemplo

{
    "motivoCancelamento": "Vistoria realizada no veículo incorreto",
    "idUsuario": 15,
    "dataCancelamento": "2026-03-09 14:30:00",
    "placa": "ABC1D23",
    "idEmpresa": 10
}

---

Aviso

• Somente a última vistoria do veículo pode ser cancelada.
• Não é possível cancelar vistorias quando o módulo de Gestão de Pátio estiver ativo.
• O cancelamento é uma operação irreversível.
• A vistoria cancelada continuará disponível para consulta, porém será identificada como cancelada.
• Após o cancelamento, caso a vistoria cancelada seja a última vistoria do veículo, o sistema atualizará automaticamente a referência para a última vistoria válida anterior.