API Prontuário Verde - Integração (1.0.0)

O recurso de Integração do Prontuário Verde foi projetado para ser o elo central de toda a sua gestão de informações de saúde e registros de pacientes, promovendo a unificação automática de dados em uma base de dados centralizada. Essa funcionalidade é ideal para criar conexões fluídas e diretas entre o Prontuário Verde e uma ampla gama de fontes de dados clínicos e administrativos.

Autenticação

Obter token de acesso.

Endpoint para autenticação. Utilize Basic Auth com usuário e senha fornecidos. Retorna um token Bearer válido por 1 hora.

Authorizations:
BasicAuth
Request Body schema: application/x-www-form-urlencoded
required
grant_type
string
Default: "client_credentials"

Responses

Response samples

Content type
application/json
{
  • "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI...",
  • "token_type": "bearer",
  • "expires_in": 3600
}

Agenda

Retorna agendamentos.

Esta requisição tem por objetivo retornar os horários disponíveis para agendamento, permitindo a filtragem parametrizada por unidade, especialidade, convênio, profissional, e intervalo de datas (data de início e data de fim).

Authorizations:
BearerAuth
query Parameters
data_inicio
string
Example: data_inicio=2025-09-01 08:00

Data de início do agendamento.

data_termino
string
Example: data_termino=2025-09-02 18:00

Data de término do agendamento.

id_convenio
number
Example: id_convenio=98761

Número de identificação do convênio.

id_especialidade
number
Example: id_especialidade=59734

Número de identificação da especialidade.

id_profissional
number
Example: id_profissional=24671

Número de identificação do profissional.

id_unidade
number
Example: id_unidade=47280

Número de identificação da unidade.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Atualiza os detalhes de um agendamento específico.

Permite alterar a situação de um agendamento. Existem as seguintes situações: Agendado(AGE), Confirmado(CON), Presente(PRE), Falta(FAL), Atendido(ATE), Cancelado pela clinica(CAN) e Cancelado pelo paciente (CPA).

Authorizations:
BearerAuth
path Parameters
id_agendamento
required
number^[^/]+$
Example: 74832

Número de identificação do agendamento.

Request Body schema: application/json
required
situacao
required
string

Situação do agendamento.

Responses

Request samples

Content type
application/json
{
  • "situacao": "FAL"
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_agendamento": 74832
}

Lista os agendamentos associados aos pacientes.

Esta requisição tem por objetivo recuperar a listagem integral de todos os agendamentos registrados para a totalidade dos pacientes cadastrados na clínica.

Authorizations:
BearerAuth
query Parameters
data_inicio
string
Example: data_inicio=2025-10-09 09:30

Data de início das agendas.

telefone
required
string
Example: telefone=555136897321

Telefones dos pacientes.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Adiciona um novo horário de bloqueio na agenda do profissional.

Este endpoint é utilizado para inserir um novo bloqueio de horário (indisponibilidade) na agenda do profissional especificado pelo {id_profissional}.

Authorizations:
BearerAuth
path Parameters
id_profissional
required
number^[^/]+$
Example: 12456

Número de identificação do profissional.

Request Body schema: application/json
required
data_inicio
required
string

Data de início do bloqueio.

horario_inicio
required
string

Horário de início do bloqueio.

data_termino
required
string

Data de término do bloqueio.

horario_termino
required
string

Horário de término do bloqueio.

motivo
required
string

Motivo do bloqueio.

Responses

Request samples

Content type
application/json
{
  • "data_inicio": "2025-10-10",
  • "horario_inicio": "08:00:00",
  • "data_termino": "2025-10-11",
  • "horario_termino": "09:00:00",
  • "motivo": "Viagem bate e volta."
}

Response samples

Content type
application/json
{
  • "sucesso": true
}

Cria um novo compromisso na agenda do profissional.

Este endpoint tem por objetivo inserir um novo compromisso na agenda do profissional especificado pelo identificador {id_profissional}.

Authorizations:
BearerAuth
path Parameters
id_profissional
required
number^[^/]+$
Example: 19372

Número de identificação do profissional

Request Body schema: application/json
required
data_inicio
required
string

Data de início do compromisso.

horario_inicio
required
string

Horário de início do compromisso.

data_termino
required
string

Data de término do compromisso.

horario_termino
required
string

Horário de término do compromisso.

descricao
required
string

Descrição do compromisso.

Responses

Request samples

Content type
application/json
{
  • "data_inicio": "2025-09-26",
  • "horario_inicio": "07:00:00",
  • "data_termino": "2025-09-26",
  • "horario_termino": "08:00:00",
  • "descricao": "Consulta Oftalmo"
}

Response samples

Content type
application/json
{
  • "sucesso": true
}

Lista todos os agendamentos de um profissional específico.

Esta requisição tem por objetivo recuperar e listar a programação integral de todas as agendas e horários vinculados ao profissional em questão.

Authorizations:
BearerAuth
path Parameters
id_profissional
required
number^[^/]+$
Example: 12847

Número de identificação do profissional.

query Parameters
data_inicio
string
Example: data_inicio=2025-10-15

Data limite inferior (início) utilizada para filtrar os agendamentos por intervalo de tempo.

data_termino
string
Example: data_termino=2025-10-16

Data limite superior (fim) utilizada para filtrar os agendamentos por intervalo de tempo.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Cria um novo agendamento na agenda do profissional.

Este endpoint é utilizado para inserir um novo registro de agendamento diretamente na agenda do profissional especificado pelo identificador {id_profissional}.

Authorizations:
BearerAuth
path Parameters
id_profissional
required
number^[^/]+$
Example: 32731

Número de identificação do profissional.

Request Body schema: application/json
required
id_unidade
required
number

Número de identificação da unidade.

id_paciente
required
number

Número de identificação do paciente.

nome_paciente
required
string

Nome do paciente.

data_inicio
required
string

Data de início do agendamento.

horario_inicio
required
string

Horário de início do agendamento.

horario_termino
required
string

Horário de término do agendamento.

observacoes
string

Observações do agendamento.

Responses

Request samples

Content type
application/json
{
  • "id_unidade": 10923,
  • "id_paciente": 1422800,
  • "nome_paciente": null,
  • "data_inicio": "2025-10-15",
  • "horario_inicio": "10:00",
  • "horario_termino": "11:00",
  • "observacoes": "Encaixe"
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_agendamento": 5028400
}

Cancela um agendamento específico para um profissional.

Este endpoint (PUT) é utilizado para atualizar o status de um agendamento específico, referenciado pelo {id_agenda}, definindo-o como 'Cancelado' na agenda do profissional {id_profissional}.

Authorizations:
BearerAuth
path Parameters
id_agenda
required
number^[^/]+$
Example: 15555

Número de identificação da agenda.

id_profissional
required
number^[^/]+$
Example: 13726

Número de identificação do profissional.

Request Body schema: application/json
required
nome_paciente
required
string

Nome do paciente.

notificar_paciente
required
string

Indicador se é necessário ou não notificar o paciente.

Responses

Request samples

Content type
application/json
{
  • "nome_paciente": "Mariana da Silva Silveira",
  • "notificar_paciente": "Não"
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_agendamento": 52536
}

Convênio

Lista todos os convênios cadastrados.

O endpoint confere acesso à base de dados para listar o inventário completo dos convênios vigentes, entregando todos os registros pertinentes ao sistema.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Despesa

Lista todas as categorias de despesa.

Esta operação é designada para coletar e retornar o inventário completo de todas as categorias de despesa utilizadas para a classificação dos registros financeiros da clínica.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista todas as despesas.

Esta requisição tem por objetivo recuperar a listagem de todas as despesas registradas que se enquadram no intervalo temporal definido pelos parâmetros de data.

Authorizations:
BearerAuth
query Parameters
data_inicio
string
Example: data_inicio=2025-10-01

Data de início do intervalo de listagem das despesas.

data_termino
string
Example: data_termino=2025-10-26

Data de término do intervalo de listagem das despesas.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Especialidade

Lista todas as especialidades.

A operação efetua a apresentação integral do catálogo de especialidades oferecidas pela clínica, fornecendo a lista completa dos serviços disponíveis.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Estoque

Lista todos os itens.

A requisição realiza a listagem integral dos itens de despesa que compõem o registro financeiro em questão.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista todos os fornecedores.

O endpoint permite acessar e coletar o registro integral de todos os fornecedores cadastrados à clínica, fornecendo a base necessária para a correta classificação das despesas.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Orçamento

Lista todos os orçamentos.

Esta requisição tem por objetivo recuperar e listar todos os orçamentos que atendam simultaneamente aos critérios de situação definida e ao intervalo temporal (datas de início e término) especificados nos parâmetros de consulta.

Authorizations:
BearerAuth
query Parameters
data_final
required
string
Example: data_final=2025-10-13

Parâmetro de data que define o limite final do período de busca para os orçamentos.

data_inicial
required
string
Example: data_inicial=2025-10-01

Parâmetro de data que define o limite inicial do período de busca para os orçamentos.

situacao
string
Example: situacao=QUITADO

Parâmetro utilizado para filtrar os orçamentos com base em seu status ou situação atual.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Procedimento

Lista todos os procedimentos.

Essa operação realiza a listagem completa do catálogo de procedimentos disponíveis na clínica.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Programa Fidelidade

Lista todos os Programas Fidelidade.

Este endpoint é responsável por coletar e disponibilizar o catálogo completo de todos os programas de fidelidade que estão atualmente cadastrados no sistema.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Profissional

Lista todos os profissionais.

Este endpoint tem por objetivo recuperar a listagem completa de todos os profissionais de saúde cadastrados na clínica.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista os pacientes associados a um profissional.

Este endpoint tem por objetivo recuperar a listagem completa de todos os pacientes que se encontram vinculados ao profissional especificado pelo identificador {id_profissional}.

Authorizations:
BearerAuth
path Parameters
id_profissional
required
number^[^/]+$
Example: 18472

Número de identificação do profissional.

query Parameters
nome_paciente
string
Example: nome_paciente=GUILHERME SANTANA

Nome do paciente.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista as unidades de um profissional específico.

Esta requisição tem por objetivo recuperar a listagem de todas as unidades de atendimento que estão vinculadas ao profissional especificado pelo identificador {id_profissional}.

Authorizations:
BearerAuth
path Parameters
id_profissional
required
number^[^/]+$
Example: 15159

Número de identificação do profissional

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Paciente

Lista todas as origens de pacientes.

Esta requisição é designada para coletar e disponibilizar o conjunto de todas as fontes de captação (origens) utilizadas para classificar a procedência dos pacientes da clínica.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista todos os pacientes.

Esta operação é designada para coletar e apresentar o inventário completo de todos os pacientes registrados na base de dados da organização. Ao ser acionada, a requisição garante o retorno da lista integral de clientes. Deve receber pelo menos um parâmetro, sendo ele nome, CPF ou telefone.

Authorizations:
BearerAuth
query Parameters
telefone
string
Example: telefone=5551999954897

Telefone do paciente.

nome
string
Example: nome=Fabiana Hadassa Ferreira

Nome do paciente.

cpf
string
Example: cpf=95074719011

CPF do paciente.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Cria um novo paciente.

O endpoint possibilita a criação de uma nova entidade de paciente, estabelecendo um registro inicial na base da organização.

Authorizations:
BearerAuth
Request Body schema: application/json
required
nome_registro
required
string

Nome completo oficial da pessoa (registro civil).

nome_social
string

Nome social da pessoa, se houver.

dt_nascimento
string

Data de nascimento da pessoa.

sexo
string

Sexo biológico ou gênero da pessoa.

rg
string

Número do Registro Geral (RG).

cpf
string

Número do Cadastro de Pessoas Físicas (CPF).

uf
string

Unidade Federativa (Estado) de residência.

cidade
string

Nome da cidade de residência.

bairro
string

Nome do bairro de residência.

logradouro
string

Nome da rua, avenida, praça, etc.

numero_logradouro
number

Número do endereço residencial.

complemento_logradouro
string

Complemento do endereço.

cep
string

Código de Endereçamento Postal (CEP).

telefone_residencial
string

Número de telefone fixo residencial.

telefone_comercial
string

Número de telefone comercial.

telefone_celular
string

Número de telefone celular.

email
string

Endereço de e-mail.

cns
string

Número do Cartão Nacional de Saúde (CNS).

responsavel
string

Nome completo do responsável legal (se aplicável).

responsavel_cpf
string

CPF do responsável legal.

observacoes
string

Campo para observações e informações adicionais.

id_origem
number

Identificador da origem do cadastro/registro.

id_fidelidade
number

Identificador ou número do programa de fidelidade.

vigencia_fim_fidelidade
string

Data de término da vigência do programa de fidelidade.

nacionalidade
string

Nacionalidade da pessoa.

estado_civil
string

Estado civil da pessoa.

profissao
string

Profissão ou ocupação principal.

nome_pai
string

Nome completo do pai.

nome_mae
string

Nome completo da mãe.

responsavel_nacionalidade
string

Nacionalidade do responsável legal.

responsavel_estado_civil
string

Estado civil do responsável legal.

responsavel_profissao
string

Profissão ou ocupação do responsável legal.

responsavel_rg
string

RG do responsável legal.

id_unidade
number

Identificador da unidade de atendimento ou registro.

cpf_menor_estrangeiro
string

CPF ou número de documento alternativo para menor estrangeiro.

Responses

Request samples

Content type
application/json
{
  • "items": [
    ]
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_paciente": 42726
}

Lista o paciente informado na URL.

Esta requisição tem por objetivo recuperar e retornar os dados do paciente específico, com base no ID ({id_paciente}) fornecido no caminho do endpoint.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number
Example: 12983

Número de identificação do paciente

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Atualiza os dados de um paciente específico.

Este endpoint permite atualizar os dados de um paciente específico. A operação aceita atualização parcial: apenas os campos fornecidos no corpo da requisição (JSON) serão alterados, mantendo-se inalterados os demais dados do registro.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 12001

Número de identificação do paciente

Request Body schema: application/json
required
nome_registro
string

Nome do paciente.

nome_social
string

Nome social do paciente.

dt_nascimento
string

Data de nascimento do paciente.

sexo
string

Sexo biológico do paciente.

rg
string

RG do paciente.

cpf
string

CPF do paciente.

uf
string

Unidade Federativa de residência.

cidade
string

Cidade de residência.

bairro
string

Bairro de residência.

logradouro
string

Nome da rua, avenida ou logradouro.

numero_logradouro
string

Número do logradouro.

complemento_logradouro
string

Complemento do endereço.

cep
string

Código de Endereçamento Postal (CEP).

telefone_residencial
string

Telefone residencial do paciente.

telefone_comercial
string

Telefone comercial do paciente.

telefone_celular
string

Telefone celular do paciente.

email
string

Endereço de e-mail.

cns
string

Cartão Nacional de Saúde.

responsavel
string

Nome do responsável legal, se aplicável.

responsavel_cpf
string

CPF do responsável legal.

observacoes
string

Campo para observações adicionais.

id_origem
number

Número de identificação da origem do registro.

id_fidelidade
number

Número de identificação de fidelidade/programa de benefícios.

vigencia_fim_fidelidade
string

Data de fim da vigência do programa de fidelidade.

nacionalidade
string

Nacionalidade do paciente.

estado_civil
string

Estado civil do paciente.

profissao
string

Profissão do paciente.

nome_pai
string

Nome completo do pai.

nome_mae
string

Nome completo da mãe.

responsavel_nacionalidade
string

Nacionalidade do responsável legal.

responsavel_estado_civil
string

Estado civil do responsável legal.

responsavel_profissao
string

Profissão do responsável legal.

responsavel_rg
string

RG do responsável legal.

id_unidade
number

Número de identificador da unidade de atendimento/registro.

cpf_menor_estrangeiro
string

Indica se o CPF pertence a um menor estrangeiro.

Responses

Request samples

Content type
application/json
{
  • "nome_registro": "Ryan Anderson da Silva",
  • "nome_social": null,
  • "dt_nascimento": "23/01/1980",
  • "sexo": "Masculino",
  • "rg": "329491878",
  • "cpf": "50779257120",
  • "uf": "PB",
  • "cidade": "João Pessoa",
  • "bairro": "Mangabeira",
  • "logradouro": "Rua Josina Lessa Feitosa",
  • "numero_logradouro": "789",
  • "complemento_logradouro": null,
  • "cep": "58055260",
  • "telefone_residencial": "8338774043",
  • "telefone_comercial": null,
  • "telefone_celular": "83988485004",
  • "email": "ryan.anderson.dasilva@negleribeiro.com",
  • "cns": null,
  • "responsavel": "string",
  • "responsavel_cpf": "string",
  • "observacoes": "Paciente diabético",
  • "id_origem": 0,
  • "id_fidelidade": 0,
  • "vigencia_fim_fidelidade": "string",
  • "nacionalidade": "Brasileiro",
  • "estado_civil": "Casado",
  • "profissao": "Empresário",
  • "nome_pai": "Mateus Luís Tomás da Silva",
  • "nome_mae": "Antônia Aparecida Nicole",
  • "responsavel_nacionalidade": null,
  • "responsavel_estado_civil": null,
  • "responsavel_profissao": "string",
  • "responsavel_rg": null,
  • "id_unidade": 1,
  • "cpf_menor_estrangeiro": "S"
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_paciente": 12001
}

Lista os convênios de um paciente específico.

A operação retorna um inventário detalhado de todos os convênios ativos no cadastro do paciente cujo ID foi informado.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 18723

Número de identificação do paciente

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Adiciona um novo convênio ao paciente.

A requisição realiza o cadastro (ou inclusão) de um novo convênio, vinculando-o diretamente ao registro do paciente especificado.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 12663

Número de identificação do paciente

Request Body schema: application/json
id_convenio
required
number

Número de identificação do convênio.

numero_convenio
required
number

Número de registro, matrícula ou código do plano/carteirinha do beneficiário.

plano
string

Nome do plano.

empresa
string

Nome da empresa ou instituição responsável pela contratação/fornecimento do convênio.

titular
string

Nome ou identificador do titular principal do convênio/plano (a pessoa responsável pelo contrato).

Responses

Request samples

Content type
application/json
{
  • "id_convenio": 62028,
  • "numero_convenio": 1234,
  • "plano": "FLEX",
  • "empresa": "OVYVA",
  • "titular": "JOANA"
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_paciente": 12001
}

Lista todas as etiquetas.

Esta requisição tem por objetivo recuperar a listagem integral de todas as etiquetas (tags) disponíveis para classificação e atribuição aos pacientes.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista as etiquetas de um paciente específico.

Esta requisição tem por objetivo recuperar a listagem completa de todas as etiquetas (tags de classificação) que se encontram vinculadas ao paciente especificado pelo identificador {id_paciente}.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 12231

Número de identificação do paciente.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Desassocia (remove) uma etiqueta do perfil de um paciente.

A operação realiza a exclusão de uma etiqueta do perfil do paciente, desassociando a classificação.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 1422800

Número de identificação do paciente.

Request Body schema: application/json
required
etiqueta
required
string

Etiqueta do paciente.

Responses

Request samples

Content type
application/json
{
  • "etiqueta": [
    ]
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_paciente": 1422800
}

Atribui uma etiqueta ao perfil do paciente para classificá-lo.

Esta requisição tem por objetivo atribuir ou vincular uma nova etiqueta de classificação ao registro do paciente.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 1422800

Número de identificação do paciente.

Request Body schema: application/json
required
etiqueta
required
string

Etiqueta do paciente.

Responses

Request samples

Content type
application/json
{
  • "etiqueta": [
    ]
}

Response samples

Content type
application/json
{
  • "sucesso": true,
  • "id_paciente": 1422800
}

Lista as agendas (agendamentos) de um paciente específico.

Esta requisição tem por objetivo recuperar a listagem de todos os agendamentos registrados para o paciente cujo identificador ({id_paciente}) foi fornecido.

Authorizations:
BearerAuth
path Parameters
id_paciente
required
number^[^/]+$
Example: 13811

Número de identificação do paciente.

query Parameters
data_inicio
string
Example: data_inicio=2025-10-10 09:30

Data de início do agendamento.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Recebimentos

Lista os recebimentos de pacientes de convênios.

Esta requisição tem por objetivo recuperar a listagem integral de todos os registros de recebimentos provenientes de convênios.

Authorizations:
BearerAuth
query Parameters
data_final
string
Example: data_final=2025-10-17

Parâmetro de data que define o limite final do período de busca para os recebimentos de convênio.

data_inicial
string
Example: data_inicial=2025-10-18

Parâmetro de data que define o limite inicial do período de busca para os recebimentos de convênio.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Lista os recebimentos de pacientes particulares.

Esta requisição tem por objetivo recuperar a listagem integral de todos os registros de recebimentos particulares.

Authorizations:
BearerAuth
query Parameters
data_final
required
string
Example: data_final=2025-10-17

Parâmetro de data que define o limite final do período de busca para os recebimentos de natureza particular.

data_inicial
required
string
Example: data_inicial=2025-10-15

Parâmetro de data que define o limite inicial do período de busca para os recebimentos de natureza particular.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Unidade

Lista todas as unidades.

Esta requisição tem por objetivo recuperar a listagem integral de todas as unidades de atendimento (ou filiais) cadastradas na conta da organização.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}