v1

latestOpenAPI 3.0.02026-07-264636241.7 MB

Assistência

Listar assistências

🔒 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)

Retorna todas as assistências disponíveis para o usuário autenticado, considerando permissões, filtros internos e parametrizações do módulo.

Finalidade funcional:

Exibir ao cliente ou equipe técnica uma visão consolidada de todos os chamados, permitindo acompanhamento completo do ciclo de atendimento.

Principais usos:

Tela inicial de Assistências no app
Painéis operacionais internos
Filtros por status, data, situação ou prioridade

Retorno típico:

Dados resumidos (status atual, descrição principal, solicitante)
Indicadores de progresso
Última atualização
Situação operacional (aberta, em análise, concluída etc.)

get/v1/relacionamento/assistencias

Query parameters

offsetinteger

registro inicial

limitinteger

quantidade de registros (caso não passe retorna todos)

Headers

emailstring required

Example:email@email.com

tokenstring required

Example:79d965e5027b7423423f2471824e799949c75f9ce

Response

Assistências Técnicas

totalinteger

offsetinteger

limitinteger

Example response

{
  "total": 1,
  "limit": 30,
  "assistencias": [
    {
      "referencia": "193 ou 193_30",
      "referencia_data": "2023-01-15 15:26:15",
      "ativo": "S",
      "idassistencia": 11,
      "idcliente": 345,
      "documento_cliente": "12345678900",
      "cliente": "Joao da silva",
      "cep_cliente": "49010020",
      "idsindico": 345,
      "sindico": "João",
      "idempreendimento": 3,
      "codigointerno_empreendimento": "222",
      "empreendimento": "Varandas",
      "etapa": "Unica",
      "bloco": "Bloco B",
      "unidade": "103",
      "parecer_tecnico": "Parecer dado pelo técnico",
      "data_cad": "2021-01-08 14:10:44",
      "idsituacao": 3,
      "situacao": "Inicial",
      "unidade_manual": "103",
      "bloco_manual": "Bloco manual",
      "empreendimento_manual": "Empreendimento",
      "data_prevista_termino": "2027-01-01",
      "data_conclusao": "2027-01-01",
      "recorrente": "S",
      "total_horas": 1070,
      "custo_previsto": 343334.33,
      "idatendimento": 22,
      "empreendimento_localidade": "Localudade",
      "unidade_area": "unidade_area",
      "idlocalidade": 3,
      "localidade": "Localidade",
      "descricao_localidade": "Descrição localidade",
      "idarea": 1,
      "area": "Externa",
      "descricao_area": "Sem descrição",
      "prioridade": "N",
      "motivo_cancelamento": "Aberto por engano",
      "descricao_motivo_cancelamento": "O cliente se enganou",
      "ultima_atualizacao_situacao": "2021-02-05 17:00:10",
      "data_modificacao": "2021-05-27 10:47:40"
    }
  ]
}