Profissional de Saúde no CNES

Onde o profissional de saúde trabalha segundo o Cadastro Nacional de Estabelecimentos de Saúde: estabelecimento, ocupação (CBO), carga horária e tipo de vínculo na competência atual. Consulta-se pelo CPF ou pelo CNS; o histórico de vínculos e o relatório oficial em PDF saem sob pedido.

POST/v1/cnes-profissional/consultas

Órgão
Cadastro Nacional de Estabelecimentos de Saúde (DATASUS/Ministério da Saúde)
Prazo máximo
60 s
PDF
Sob pedido

Campos do corpo

  • cpfum destes: cpf ou nome ou historico

    CPF, com ou sem máscara

    CPF da pessoa consultada.

  • nomeum destes: cpf ou nome ou historico

    Texto, até 150

    Nome completo. Confere quem o documento achou — se não bater, a consulta volta dados_divergentes e não é cobrada.

  • historicoum destes: cpf ou nome ou historico

    true ou false

    true traz também os vínculos encerrados, cada um com o período em que apareceu.

  • cnsopcional

    15 dígitos

    Cartão Nacional de Saúde, 15 dígitos. Use no lugar do CPF; com os dois, vale o CNS.

  • incluirPdfopcional

    true ou false

    true devolve o PDF em detalhe.certidao.pdfBase64, quando o órgão fornece o arquivo.

  • referenciaopcional

    Texto, até 80

    Seu identificador. Volta na resposta, no webhook e no histórico.

  • filtroopcional

    Objeto

    Devolve só os itens de detalhe.itens que batem: {"campo": valor}.

  • ordenaropcional

    Nome de um campo do item

    - na frente para a ordem decrescente.

  • limiteopcional

    Inteiro de 1 a 1000

    Quantos itens devolver.

Resultados possíveis

dadossem_registros

Decida pelo campo codigo. Consulta que o órgão não respondeu volta como sem_retorno ou em_processamento e não é cobrada.

Observações

  • Os vínculos da competência atual vêm em detalhe.itens; com historico: true, os encerrados vêm depois, com o título começando por "Histórico:".
  • Profissional cadastrado sem vínculo na competência atual volta dados com o texto "Profissional sem vínculo ativo no CNES" — a consulta foi feita e é cobrada.
  • O CNES não traz o número no conselho de classe (CRM, COREN): para isso, use crm ou conselhos-de-classe.
  • Com incluirPdf: true, o relatório oficial do CNES vem em detalhe.certidao.pdfBase64.