---
title: "Cadastrar um documento na vistoria"
method: POST
path: "/v3/relacionamento/agendamentos/{idAgendamento}/vistorias/{idVistoria}/documentos"
tags: ["Vistoria"]
---

# Cadastrar um documento na vistoria

`POST /v3/relacionamento/agendamentos/{idAgendamento}/vistorias/{idVistoria}/documentos`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v3/relacionamento/agendamentos/{idAgendamento}/vistorias/{idVistoria}/documentos`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Cadastra um documento na vistoria a partir do conteúdo do arquivo em base64. O documento
aparece na tela de gerenciar vistoria do gestor.

- Disponível apenas para o painel **gestor**, com a permissão de anexar arquivos em agendamentos.
- Formatos aceitos: jpg, jpeg, gif, png, bmp e pdf.
- Não é permitido anexar documentos em vistoria com situação Cessão (`CE`) ou Distrato (`DI`).

## Path parameters

- `idAgendamento` integer, required
- `idVistoria` integer, required

## Request body

- CriarDocumentoVistoriaRequest: Documento a ser cadastrado na vistoria
  - `arquivo` string, byte, required: Conteúdo do arquivo em base64, sem o prefixo data URI
  - `nome` string: Nome exibido na tela do gestor. Sem ele, fica o nome gerado no envio. Quando a extensão do nome não é a do arquivo, a extensão do arquivo é acrescentada ao final.

## Response `200`

Documento cadastrado com sucesso

- RetornoDocumentoVistoria: Retorno do cadastro ou da remoção de um documento da vistoria
  - `status` string
  - `code` integer
  - `data` object
    - `idarquivo` integer

## Other responses

- `400`: Arquivo ausente, base64 inválido, formato não permitido ou tamanho acima do limite
- `401`: Request sem token de autorização ou token inválido
- `403`: Sem permissão ou situação da vistoria não permite anexar documentos
- `404`: Agendamento inexistente ou inativo, ou vistoria não pertence ao agendamento informado

---

[API](https://skmtc.dev/cvcrm/apis/agendamento.md) - [All operations](https://skmtc.dev/cvcrm/apis/agendamento/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/agendamento/revisions/da647a17c120?raw)