---
title: "Realiza o cadastro de uma nova assistência técnica"
method: POST
path: "/assistencia"
tags: ["Assistências Técnicas"]
---

# Realiza o cadastro de uma nova assistência técnica

`POST /assistencia`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cliente`
- URL: `https://integracao.cvcrm.com.br/api/v1/cliente/assistencia`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization, gerado pelo endpoint de autenticação do próprio Portal do Cliente: `POST /api/v1/cliente/autenticacao` (documento e senha do cliente) ou `POST /api/v1/cliente/autenticacao/sindico` (síndicos).
> ⚠️ O token de integração das APIs v2/v3 (`POST /api/v3/auth/token`) **não é válido** para o Portal do Cliente: ele não representa um cliente e as consultas retornarão vazias ou dados incorretos.

Para o cadastro de uma assistência técnica é pelo menos um item da assistência e os valores de um dos atributos de entre 'unidade', 'unidade_avulsa', 'area' e 'localidade'.

## Request body

- CadastroAssistencia
  - `itens` object[], required: Array de itens da assistência técnica
    - `iditem` integer, required
    - `descricao` string
    - `uniqid` string: Id único (13 caracteres) usado no upload dos arquivos do item (POST /assistencia/item/documento/upload-arquivos). Vincula os arquivos enviados a este item.
  - `unidade` object
    - `idunidade` integer, required
  - `unidade_avulsa` object
    - `empreendimento` string, required
    - `bloco` string, required
    - `unidade` string
  - `area` object
    - `idempreendimento` integer, required
    - `idarea` integer, required
    - `descricao` string
  - `localidade` object
    - `idlocalidade` integer, required
    - `descricao` string
  - `campos_adicionais` object

## Response `200`

Retorna a assistência técnica

- object
  - `sucesso` boolean
  - `idassistencia` integer: Id da assistência criada

## Other responses

- `422`: Erro interno ao realizar ação!

---

[API](https://skmtc.dev/cvcrm/apis/portal-do-cliente.md) - [All operations](https://skmtc.dev/cvcrm/apis/portal-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/portal-do-cliente/revisions/7d95f9678127?raw)