v1

latestOpenAPI 3.0.02026-07-264636241.7 MB

Assistência

Consultar detalhes completos da 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)

Retorna todas as informações de uma assistência específica, incluindo:

Dados gerais do chamado
Itens associados
Histórico de mensagens
Visitas agendadas
Situação atual
Anexos enviados
Dados de diagnóstico (quando aplicável)

Uso:

Tela de detalhes completa no aplicativo, proporcionando transparência total ao usuário final e suporte interno.

get/v1/relacionamento/assistencias/{idAssistencia}

Path parameters

idAssistenciainteger required

id da assistência

Headers

emailstring required

Example:email@email.com

tokenstring required

Example:79d965e5027b7423423f2471824e799949c75f9ce

Response

Dados da Assistência Técnica

idassistenciainteger

idatendimentointeger

data_cadastrostring

data_cancelamentostring nullable

Data em que a assistência foi cancelada (presente apenas quando a situação atual for cancelada)

data_finalizacaostring nullable

Data de finalização da assistência (presente apenas quando a situação atual for a situação de fim)

protocolo_atendimentostring

descricaostring nullable

Descrição da área comum ou localidade da assistência

parecer_tecnicostring nullable

Parecer técnico / observação da assistência

sla_assistencia_vencidoboolean

Example response

{
  "idassistencia": 120,
  "idatendimento": 120,
  "data_cadastro": "2020-08-04 17:08:57",
  "data_cancelamento": "2020-09-05 14:32:00",
  "data_finalizacao": "2020-09-10",
  "protocolo_atendimento": "2008040535",
  "descricao": "Perto da piscina",
  "parecer_tecnico": "Infiltração na parede do banheiro",
  "sla_assistencia_vencido": true,
  "situacao": {
    "nome": "Novo",
    "situacao_cor_bg": "#25b33c",
    "situacao_cor_nome": "#ffffff"
  },
  "cliente": {
    "idpessoa": 2,
    "nome": "Maria Silva",
    "email": "email@email.com.br",
    "documento": "1234567890",
    "telefone": "(79) 3333-4444",
    "celular": "(79) 99999-8888",
    "data_nascimento": "1990-05-20",
    "estado_civil": "Solteiro",
    "codigointerno": "CLI-0042",
    "endereco": {
      "nome": "Avendida rotary",
      "cep": "49037550",
      "numero": "3432",
      "bairro": "Atalaia",
      "complemento": "Casa",
      "logradouro": {
        "idlogradouro": 2,
        "nome": "Avenida"
      },
      "estado": {
        "idestado": 26,
        "nome": "Sergipe"
      },
      "cidade": {
        "idestado": 4733,
        "nome": "Aracaju"
      }
    }
  },
  "sindico": {
    "idsindico": 19,
    "nome": "Síndico Teste",
    "celular": "(99) 99999-9999",
    "email": "sindico@cvcrm.com.br",
    "documento_tipo": "cpf",
    "data_cad": "2022-05-17 16:54:02"
  },
  "unidade": {
    "unidades": [
      {
        "idunidade": 140,
        "nome": "504"
      }
    ],
    "perfil": {
      "nome": "Titular da Reserva",
      "sigla": "TR"
    },
    "previsao_entrega": "2021-02-01",
    "porcentagem_total_estagio_obra_unidade": 22.27,
    "grupo_especial": 1,
    "etapa": {
      "idetapa": 4,
      "nome": "Única"
    },
    "bloco": {
      "idbloco": 2216,
      "nome": "Várias unidades"
    },
    "empreendimento": {
      "idempreendimento": 3,
      "nome": "9201 - Varándãs Do Garcia 9",
      "porcentagem_total_estagio_obra": 50,
      "permitir_criar_atendimento": true,
      "foto": {
        "nome": "construtor.jpg",
        "tipo": "image/jpeg",
        "dispositivo_exibicao": "desktop",
        "tamanho": 2672,
        "url": "https://relacionar.cvcrm.com.br/api/get/imagens/painel_cliente_logo/[[LARGURA]]/[[ALTURA]]/20210111152544_5ffc98284c62c.jpg"
      }
    },
    "andar": "1º Andar",
    "coluna": "3"
  },
  "bloco": {
    "idbloco": 495,
    "nome": "Bloco A",
    "codigointerno": "BL-A"
  },
  "empreendimento": {
    "idempreendimento": 2,
    "nome": "Empreendimento Qualidade 111",
    "data_entrega": "2024-12-31",
    "referencia_externa": "REF-001",
    "codigointerno": "EMP-001",
    "endereco": "Rua das Flores, 100",
    "estado": "SE",
    "cidade": "Aracaju"
  },
  "etapa": {
    "idetapa": 3,
    "nome": "Pós-obra"
  },
  "area_comum": {
    "idarea": 455,
    "nome": "07"
  },
  "itens": [
    {
      "idassistencia_item": 123,
      "iditem": 2,
      "item": "Piso",
      "data_conclusao": "2020-08-04 17:08:57",
      "horas_servico": "2",
      "coberto": "S",
      "data_previsao": "2020-08-04 17:08:57",
      "descricao": "LAGA TINGA1",
      "situacao": {
        "nome": "Novo",
        "situacao_cor_bg": "#25b33c",
        "situacao_cor_nome": "#ffffff"
      },
      "ambiente": {
        "idambiente": 1,
        "nome": "Sala"
      },
      "patologia": {
        "idpatologia": 1,
        "nome": "Rachadura"
      },
      "problema": {
        "idproblema": 1,
        "nome": "Rachadura vertical"
      },
      "subitens": [
        {
          "iditem": 1,
          "idsubItem": 10,
          "dataCad": "2026-04-16 10:30:00",
          "ativoPainel": true,
          "nome": "Sub A",
          "patologia": {
            "idpatologia": 1,
            "nome": "Rachadura"
          },
          "problema": {
            "idproblema": 1,
            "nome": "Rachadura vertical"
          }
        }
      ]
    }
  ],
  "visitas": [
    {
      "idvisita": 2,
      "equipe": "Maria Silva",
      "periodo_data_de": "2020-08-04 17:08:57",
      "periodo_data_ate": "2020-08-04 17:08:57",
      "situacao": {
        "nome": "Novo",
        "situacao_cor_bg": "#25b33c",
        "situacao_cor_nome": "#ffffff"
      },
      "itens": [
        {
          "idassistencia_item": 123,
          "iditem": 4,
          "nome": "Piso"
        }
      ],
      "usuarios": [
        {
          "idusuario": 27,
          "nome": "Piso"
        }
      ]
    }
  ],
  "mensagens": [
    {
      "idmensagem": 2,
      "idusuario": 2,
      "nome": "Maria Silva",
      "data_cadastro": "2020-08-04 17:08:57",
      "mensagem": "teste"
    }
  ],
  "contratos": [
    {
      "idcontrato": 1662,
      "titulo": "Associado",
      "tipo": "Distrato",
      "criado": "2020-02-17 13:40:36",
      "unidade": {
        "unidades": [
          {
            "idunidade": 140,
            "nome": "504"
          }
        ],
        "perfil": {
          "nome": "Titular da Reserva",
          "sigla": "TR"
        },
        "previsao_entrega": "2021-02-01",
        "porcentagem_total_estagio_obra_unidade": 22.27,
        "grupo_especial": 1,
        "etapa": {
          "idetapa": 4,
          "nome": "Única"
        },
        "bloco": {
          "idbloco": 2216,
          "nome": "Várias unidades"
        },
        "empreendimento": {
          "idempreendimento": 3,
          "nome": "9201 - Varándãs Do Garcia 9",
          "porcentagem_total_estagio_obra": 50,
          "permitir_criar_atendimento": true,
          "foto": {
            "nome": "construtor.jpg",
            "tipo": "image/jpeg",
            "dispositivo_exibicao": "desktop",
            "tamanho": 2672,
            "url": "https://relacionar.cvcrm.com.br/api/get/imagens/painel_cliente_logo/[[LARGURA]]/[[ALTURA]]/20210111152544_5ffc98284c62c.jpg"
          }
        },
        "andar": "1º Andar",
        "coluna": "3"
      },
      "arquivo": {
        "nome": "ATO - Boleto _ 24_02_2019 - 3.pdf",
        "tipo": "application/pdf",
        "tamanho": "16298",
        "url": "http://dev.cvcrm.com.br/api/get/download/reservas_contratos|2020|01|3867/20200514091903_5ebd373739148.pdf"
      }
    }
  ],
  "documentos": {
    "arquivos": [
      {
        "nome": "ATO - Boleto _ 24_02_2019 - 3.pdf",
        "tipo": "application/pdf",
        "tamanho": "16298",
        "url": "http://dev.cvcrm.com.br/api/get/download/reservas_contratos|2020|01|3867/20200514091903_5ebd373739148.pdf"
      }
    ],
    "arquivos_mensagens": [
      {
        "idarquivo": 21,
        "idassistencia": 120,
        "idmensagem": 65,
        "nome": "232478_1_1531483244.pdf",
        "tipo": "application/pdf",
        "tamanho": 433433,
        "url": "http://construtordevendas.localhost/api/get/download/ass_assistencias_arquivos/20180723161136_5b5628681ea40.pdf"
      }
    ]
  },
  "campos_adicionais": [
    {
      "total": 1,
      "campos_adicionais": [
        {
          "idcampo": 718,
          "nome": "Ponto de Referência",
          "obrigatorio": "N",
          "tipo": "select",
          "ativo": "S",
          "ordem_exibicao": 1,
          "nome_referencia": "ponto_referencia",
          "padrao": [
            "Referência 1",
            "Referência 2"
          ],
          "exibir_portal_cliente": "S"
        }
      ]
    }
  ]
}