Lista de APIs privadas
Rotas privadas de consulta com método, endpoint e exemplo de resposta
Lista de APIs privadas
Esta é a lista completa das APIs privadas de consulta publicadas hoje.
As operações privadas de escrita ficaram documentadas separadamente para manter a navegação humana organizada:
Cadastros CRM · criar e atualizarAtividades e follow-ups · criar e agirReuniões · criar e agirConsultório · criar e agir
Como acessar
Use o token privado da empresa no cabeçalho:
Onde encontrar:
- no Simplifica, abra o menu do usuário;
- acesse
Token API; - copie o token privado da sua empresa.
O que esta página entrega
Para cada endpoint publicado abaixo, esta página mostra:
- o método HTTP;
- a rota base;
- o que o endpoint retorna;
- um exemplo de chamada limpa;
- um exemplo de JSON de resposta.
Regra desta fase
Nesta primeira fase das integrações privadas, os endpoints publicados aqui são de leitura (GET).
Convenções gerais
- autenticação por token privado no header
Authorization: Bearer; - paginação operacional de
100registros por página; - resposta com
items,count,limit,offset,hasMoreelinks; - relacionamentos por ID devem ser resolvidos no lado consumidor;
- quando aparecer um exemplo de
links, ohrefilustrado abaixo acompanha o próprio endpoint mostrado.
CRM
Listar Leads via Integração
Método: GET
Endpoint: /simplificav2/lead
Retorna as levantadas de mão recebidas pela integração de leads.
Conceito importante:
- cada linha deste endpoint representa um evento recebido pela integração;
- a mesma pessoa pode aparecer mais de uma vez;
- isso pode acontecer com origens diferentes ou até com a mesma origem;
- para contar entradas da integração, conte os registros retornados;
- para identificar a pessoa única no CRM, use
pessoa_id.
Campos de leitura mais úteis:
id: identificador do evento recebido;pessoa_id: pessoa vinculada no CRM, quando houver;novo_na_empresa: indica se o evento criou um lead novo (S) ou se foi associado a alguém já existente (N);origem_textoeconsultor_texto: texto recebido ou resolvido no processamento;utm_json: objeto JSON completo das UTMs recebidas;custom_json: objeto JSON com os campos customizados enviados na integração.
Observação:
- os campos
utm_*não são duplicados no topo da resposta; - o detalhamento das UTMs fica centralizado dentro de
utm_json.
Exemplo de chamada:
Exemplo de resposta:
Listar atividades
Método: GET
Endpoint: /simplificav2/atividade
Retorna a lista de atividades da empresa cadastradas no Simplifica.
Exemplo de chamada:
Exemplo de resposta:
Listar follow-ups de atividade
Método: GET
Endpoint: /simplificav2/atividade_follow_up
Retorna a lista de follow-ups de atividades da empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar motivos de atividade
Método: GET
Endpoint: /simplificav2/atividade_motivo
Retorna os motivos de atividade da empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar motivos padrão de atividade
Método: GET
Endpoint: /simplificav2/atividade_motivo_padrao
Retorna os motivos internos usados pelo sistema em fluxos operacionais de atividade.
Leitura prática:
- use o campo
ativopara saber se o motivo ainda está válido para uso interno; - esta rota não possui criação nem atualização por API.
Exemplo de chamada:
Exemplo de resposta:
Listar categorias CRM
Método: GET
Endpoint: /simplificav2/categoria
Retorna a lista de categorias da empresa cadastradas no Simplifica.
Exemplo de chamada:
Exemplo de resposta:
Listar consultores
Método: GET
Endpoint: /simplificav2/consultor
Retorna os consultores cadastrados na empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar endereços
Método: GET
Endpoint: /simplificav2/endereco
Lista os endereços cadastrados para as pessoas, com dados completos de localização.
Exemplo de chamada:
Exemplo de resposta:
Listar pessoas
Método: GET
Endpoint: /simplificav2/pessoa
Retorna a lista de pessoas da empresa cadastradas no Simplifica.
Como separar leads e clientes:
- leads: filtre por
tipo_pessoa_cliente = "L"; - clientes: filtre por
tipo_pessoa_cliente = "C".
Exemplos úteis:
Exemplo de chamada:
Exemplo de resposta:
Listar motivos de inativação de pessoa
Método: GET
Endpoint: /simplificav2/pessoa_motivo_inativacao
Retorna a lista de motivos de inativação de pessoa da empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar origens de pessoa
Método: GET
Endpoint: /simplificav2/pessoa_origem
Lista as origens disponíveis para classificar pessoas no CRM.
Exemplo de chamada:
Exemplo de resposta:
Listar segmentos
Método: GET
Endpoint: /simplificav2/segmento
Retorna a lista de segmentos da empresa cadastrados no Simplifica.
Exemplo de chamada:
Exemplo de resposta:
Listar tags
Método: GET
Endpoint: /simplificav2/tag
Retorna as tags publicadas no módulo de leitura.
Exemplo de chamada:
Exemplo de resposta:
Reuniões
Listar reuniões
Método: GET
Endpoint: /simplificav2/reuniao
Retorna a lista de todas as reuniões da empresa cadastradas no Simplifica.
Exemplo de chamada:
Exemplo de resposta:
Listar motivos de reunião
Método: GET
Endpoint: /simplificav2/reuniao_motivo
Retorna a lista de todos os motivos de reunião da empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar motivos de cancelamento de reunião
Método: GET
Endpoint: /simplificav2/reuniao_motivo_cancelamento
Retorna a lista de todos os motivos de cancelamento de reunião da empresa.
Exemplo de chamada:
Exemplo de resposta:
Comercial
Listar categorias de produto
Método: GET
Endpoint: /simplificav2/categoria_produto
Retorna a lista de categorias de produto ou serviço da empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar etapas de negociação
Método: GET
Endpoint: /simplificav2/etapa_negociacao
Retorna a lista de todas as etapas de negociação da empresa.
Exemplo de chamada:
Exemplo de resposta:
Listar motivos de cancelamento comercial
Método: GET
Endpoint: /simplificav2/motivo_cancelamento
Lista os motivos de cancelamento comercial disponíveis para oportunidade, venda ou ambos.
Exemplo de chamada:
Exemplo de resposta:
Listar oportunidades
Método: GET
Endpoint: /simplificav2/oportunidade
Lista oportunidades da empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar itens de oportunidade
Método: GET
Endpoint: /simplificav2/oportunidade_item
Retorna os itens de produtos, serviços ou kits vinculados às oportunidades.
Exemplo de chamada:
Exemplo de resposta:
Listar origens comerciais
Método: GET
Endpoint: /simplificav2/origem_comercial
Lista as origens comerciais disponíveis para classificar entradas e resultados do funil.
Exemplo de chamada:
Exemplo de resposta:
Listar produtos
Método: GET
Endpoint: /simplificav2/produto
Retorna somente produtos da empresa.
Observações:
- use essa rota quando precisar de itens com atributos de estoque;
movimenta_estoqueretornaSouN;un_medidapode trazer códigos comoUN(unidade),LT(litro) ePC(peça).
Exemplo de chamada:
Listar serviços
Método: GET
Endpoint: /simplificav2/servico
Retorna somente serviços da empresa que não estão marcados como procedimento.
Observações:
- não movimenta estoque.
Exemplo de chamada:
Listar procedimentos
Método: GET
Endpoint: /simplificav2/procedimento
Retorna somente procedimentos da empresa.
Observações:
- procedimento é um serviço marcado internamente como procedimento;
- essa rota ajuda a separar o catálogo clínico dos demais serviços.
- não movimenta estoque.
Exemplo de chamada:
Listar kits
Método: GET
Endpoint: /simplificav2/kit
Retorna somente kits comerciais da empresa.
Observações:
- a resposta inclui
itens, com a composição atual do kit; - o kit não tem configuração própria de movimentação de estoque;
- se um item do kit movimenta estoque, esse movimento acontece a partir dos itens associados;
- cada item do kit traz o produto ou serviço vinculado, quantidade e valor unitário.
Exemplo de chamada:
Exemplo de resposta:
Listar estoque
Método: GET
Endpoint: /simplificav2/estoque
Retorna somente produtos da empresa com saldo de estoque diferente de zero.
Observações:
- a rota considera apenas produtos com
movimenta_estoque = "S"; - produtos com saldo zerado não aparecem;
- saldo negativo também pode aparecer e deve ser interpretado como estoque atual abaixo de zero.
Exemplo de chamada:
Listar movimentação de estoque
Método: GET
Endpoint: /simplificav2/estoque/{id}/movimentacao
Retorna o histórico de movimentações de estoque de um produto específico.
Observações:
- a rota sempre exige o
iddo produto; - não existe uma rota geral de movimentações sem informar o produto;
- a resposta traz entradas, saídas e ajustes, com saldo acumulado após cada movimento.
Exemplo de chamada:
Listar catálogo completo de produtos e serviços
Método: GET
Endpoint: /simplificav2/produto_servico
Retorna o catálogo completo da empresa com produtos, serviços, procedimentos e kits.
Observações:
tipoidentifica quando o item é produto, serviço ou kit;procedimento = "S"indica que o item é um procedimento dentro do grupo de serviços;- para integrações novas, prefira as rotas específicas
produto,servico,procedimentoekit.
Exemplo de chamada:
Exemplo de resposta:
Listar vendas
Método: GET
Endpoint: /simplificav2/venda
Retorna as vendas cadastradas no sistema.
Exemplo de chamada:
Exemplo de resposta:
Listar itens de venda
Método: GET
Endpoint: /simplificav2/venda_item
Retorna os itens das vendas cadastradas no sistema.
Exemplo de chamada:
Exemplo de resposta:
Consultório
Listar motivos de consulta
Método: GET
Endpoint: /simplificav2/motivo_consulta
Retorna os motivos de consulta cadastrados para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar motivos de cancelamento de consulta
Método: GET
Endpoint: /simplificav2/consulta_motivo_cancelamento
Retorna os motivos de cancelamento de consulta da empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar bloqueios de agenda
Método: GET
Endpoint: /simplificav2/bloqueio_agenda
Retorna os bloqueios de agenda do consultório com os profissionais vinculados.
Exemplo de chamada:
Exemplo de resposta:
Listar preços por profissional
Método: GET
Endpoint: /simplificav2/preco_profissional
Retorna a tabela de preço por profissional da empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar consultas
Método: GET
Endpoint: /simplificav2/consulta
Retorna as consultas do consultório da empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar itens de consulta
Método: GET
Endpoint: /simplificav2/consulta_item
Retorna os procedimentos vinculados às consultas da empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar materiais de consulta
Método: GET
Endpoint: /simplificav2/consulta_material
Retorna os materiais consumidos por procedimento nas consultas da empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Financeiro
Listar categorias financeiras
Método: GET
Endpoint: /simplificav2/categoria_financeira
Retorna as categorias financeiras publicadas no módulo de leitura.
Exemplo de chamada:
Exemplo de resposta:
Listar centros de custo
Método: GET
Endpoint: /simplificav2/centro_custo
Retorna os centros de custo publicados no módulo financeiro.
Exemplo de chamada:
Exemplo de resposta:
Listar contas bancárias
Método: GET
Endpoint: /simplificav2/conta_bancaria
Retorna as contas bancárias publicadas no módulo financeiro.
Exemplo de chamada:
Exemplo de resposta:
Listar despesas
Método: GET
Endpoint: /simplificav2/despesa
Retorna as despesas cadastradas para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar despesas parceladas
Método: GET
Endpoint: /simplificav2/despesa_parcelada
Retorna as despesas parceladas cadastradas para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar despesas recorrentes
Método: GET
Endpoint: /simplificav2/despesa_recorrente
Retorna as despesas recorrentes cadastradas para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar receitas
Método: GET
Endpoint: /simplificav2/receita
Retorna as receitas cadastradas para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar receitas parceladas
Método: GET
Endpoint: /simplificav2/receita_parcelada
Retorna as receitas parceladas cadastradas para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar receitas recorrentes
Método: GET
Endpoint: /simplificav2/receita_recorrente
Retorna as receitas recorrentes cadastradas para a empresa autenticada.
Exemplo de chamada:
Exemplo de resposta:
Listar tipos de pagamento
Método: GET
Endpoint: /simplificav2/tipo_pagamento
Retorna os tipos de pagamento publicados no módulo financeiro.
Exemplo de chamada:
Exemplo de resposta:
Projeções
Listar assinatura_oportunidade
Método: GET
Endpoint: /simplificav2/assinatura_oportunidade
Lista oportunidades ganhas com informações relacionadas a assinaturas e recorrência.
Exemplo de chamada:
Exemplo de resposta: