Pular para o conteúdo principal

Changelog da API

Acompanhe os lançamentos de novos endpoints, evoluções de contrato, melhorias de infraestrutura e correções na API do Clínica nas Nuvens.

09 de Novembro de 2026​

🚀 Novo Portal para Desenvolvedores​

  • Referência Interativa de Endpoints: Nova documentação dinâmica com testes de requisição diretamente no navegador, busca instantânea e snippets de chamada em várias linguagens via Referência de Endpoints.
  • Guias Práticos Passo a Passo: Reformulação completa dos Guias de Integração cobrindo fluxos essenciais de Agenda, Pacientes, Orçamentos e Cadastros Gerais.
  • Coleções Oficiais para Download: Arquivos pré-configurados prontos para importação direta no Postman e Insomnia.

🔔 Novos Endpoints​

  • Novo Módulo da Nova Disponibilidade: Nova suíte de endpoints em /disponibilidade para canais de autoatendimento, robôs de WhatsApp e portais de agendamento:
    • GET /disponibilidade: consulta horários disponíveis organizados por dia e recurso, com suporte a busca por profissional específico ou por especialidade e convênio.
    • GET /disponibilidade/proximo-horario: consulta rápida que retorna diretamente a primeira data e horário livre para atendimento.
    • GET /disponibilidade/recursos: listagem de recursos ativos da clínica (profissionais, salas e equipamentos) disponíveis para agendamento.
    • Requisito: O uso destes endpoints requer que a clínica esteja com o módulo da Nova Disponibilidade habilitado e ativo no Clínica nas Nuvens.
    • Consulte os Guias de Disponibilidade.
  • Novo Agendamento com Recursos: Suporte à inclusão de salas e equipamentos na criação e retorno de agendamentos (/agenda).
  • Evolução de Contrato Consolidação do Próximo Horário: A consulta de próxima data de atendimento anteriormente em /executor-agenda/{id}/proxima-disponibilidade foi unificada no novo endpoint GET /disponibilidade/proximo-horario.
  • Novo Módulo de Checkout (Autoatendimento): Nova suíte de endpoints em /v1/checkout voltada para canais de autoatendimento (totens físicos, terminais TEF, WhatsApp e portais de pacientes):
    • GET /v1/checkout/formas-pagamento: consulta formas de pagamento ativas e elegíveis para recebimento (RECEBER ou AMBOS).
    • GET /v1/checkout/pacientes/{idPaciente}/em-aberto: consulta consolidada de agendamentos particulares e faturas em aberto, com paginação e flag de alerta debitosEmAtraso.
    • POST /v1/checkout/agendas/{idAgenda}/baixar: liquidação de consultas com faturamento e baixa financeira imediata a partir de pagamentos aprovados externamente.
    • POST /v1/checkout/faturas/{idFatura}/baixar: baixa financeira direta de faturas e títulos particulares em aberto.
    • Consulte os Guias de Checkout.
  • Novo Painel de Chamadas & Totens: Listagem de áreas configuradas (GET /painel-chamada/area/lista) e emissão de senhas sequenciais de atendimento (POST /painel-chamada/senha/gerar). Consulte o Guia do Painel de Chamadas.
  • Novo Pacientes Aniversariantes: Consulta de pacientes por intervalo de dia e mês (GET /paciente/aniversariantes), facilitando réguas de comunicação e marketing. Consulte o Guia de Aniversariantes.
  • Novo Identificação de Pacientes por Telefone: Novo parâmetro telefone no endpoint GET /paciente/lista, permitindo buscar pacientes por celular, fixo, comercial ou recados (com ou sem máscara, exigindo DDD). Ideal para robôs de atendimento e canais conversacionais identificarem o paciente sem exigir CPF logo no início da conversa.
  • Novo Observações de Agendamento do Profissional: Novo campo observacoesAgendamento no retorno detalhado de GET /executor-agenda/{id}, retornando orientações prévias e instruções de atendimento cadastradas para o profissional na clínica.

🛡️ Segurança & Padronização​

  • Melhoria Otimização do Rate Limiter: Aperfeiçoamento do algoritmo de controle de taxa de requisições por minuto, garantindo maior precisão na contabilização e estabilidade para integrações de alto volume.
  • Melhoria Padronização de Erros: Respostas de erro nos códigos 400, 401, 403, e 429 unificadas com mensagens descritivas e padronizadas.

08 de Outubro de 2026​

  • Correção Cadastro de Pacientes Estrangeiros via API: Corrigida a validação de CPF obrigatório, permitindo o cadastro de pacientes estrangeiros sem CPF quando essa configuração estiver prevista no sistema.

01 de Outubro de 2026​

  • Melhoria Contabilização do Limite de Requisições da API: Ajustado o controle de consumo das APIs para garantir uma contabilização mais precisa dos limites contratados, especialmente em ambientes com múltiplas instâncias da aplicação.

25 de Setembro de 2026​

  • Novo Inativação e Ativação de Pacientes via API: Disponibilização do campo de ativação cadastral do paciente na integração via API (PATCH /paciente/{id}/status).

09 de Setembro de 2026​

  • Novo Consulta da Próxima Disponibilidade do Profissional via API: Disponibilização de novo endpoint para consultar diretamente a próxima data disponível de um profissional (GET /agenda/executor/proxima-data-disponivel), simplificando integrações de agendamento.