v1

latestOpenAPI 3.0.02026-07-264636241.7 MB
Assistência

Criar nova assistência

🔒 Autenticação necessária

Esta API utiliza autenticação via e-mail e token nos headers da requisição. Consulte o tutorial completo antes de fazer sua primeira chamada: Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)

Cria um novo chamado de manutenção/atendimento técnico, iniciando o fluxo completo de assistência.

Finalidade funcional:

Permitir que clientes, equipes internas, pós-obra ou SAC iniciem uma solicitação de reparo.

O que normalmente é enviado:

  • Identificação da unidade ou empreendimento
  • Descrição clara do problema
  • Possíveis itens pré-classificados

Dados do solicitante:

  • Informações complementares exigidas pela política interna da empresa

Valor para o negócio:

É o ponto de partida para gerar rastreabilidade de problemas construtivos e atendimento ao cliente.

post/v1/relacionamento/assistencias

Headers

emailstring required
Example:email@email.com
tokenstring required
Example:79d965e5027b7423423f2471824e799949c75f9ce

Request body

campos_adicionaisobject

Example request

{
  "itens": [
    {
      "iditem": 2,
      "descricao": "Descrição do item",
      "uniqid": "602acc93d645a"
    }
  ],
  "unidade": {
    "idunidade": 1847
  },
  "unidade_avulsa": {
    "empreendimento": "HOTEL MODELO CAMPINA GRANDE",
    "bloco": "Bloco 2",
    "unidade": "503"
  },
  "area": {
    "idempreendimento": 12,
    "idarea": 4,
    "descricao": "Perto da piscina"
  },
  "localidade": {
    "idlocalidade": 2,
    "descricao": "Ponto de referência"
  },
  "campos_adicionais": {
    "717": "2025-04-20",
    "725": "Sim"
  }
}

Response

Cadastro de Assistência Realizado com Sucesso

idassistenciainteger

Id da assistência criado

sucessoboolean

Example response

{
  "idassistencia": 90,
  "sucesso": true
}