3s-cnes-client

Cliente Python assíncrono para consultar estabelecimentos, leitos e profissionais nos serviços SOAP públicos do CNES (Cadastro Nacional de Estabelecimentos de Saúde).

O pacote é exclusivamente assíncrono e usa zeep[async] para consumir os serviços SOAP.

Instalação

pip install 3s-cnes-client

Uso

import asyncio

from cnes_client import CNESClient


async def main():
    async with CNESClient() as client:
        estabelecimento = await client.estabelecimento("7869231")
        leitos = await client.leitos("4013484")
        profissionais = await client.profissionais("4013484")

        print(estabelecimento)
        print(leitos)
        print(profissionais)


asyncio.run(main())

Se preferir fechar o cliente manualmente:

from cnes_client import CNESClient

client = CNESClient()

try:
    leitos = await client.leitos("4013484")
finally:
    await client.close()

Métodos disponíveis

estabelecimento(cnes: str) -> dict

Consulta os dados completos de um estabelecimento pelo código CNES informado.

Retorno: um dicionário com o resultado completo do serviço consultarEstabelecimentoSaude, incluindo dados do estabelecimento, profissionais, leitos, habilitações, equipamentos, SAMU e sumário quando presentes no retorno do CNES.

{
  "EstabelecimentoSaude": {
    "CodigoCNES": {
      "codigo": "7869231"
    },
    "CodigoUnidade": {
      "codigo": "5105307869231"
    },
    "nomeFantasia": {
      "Nome": "CENTRAL DE REGULACAO"
    },
    "nomeEmpresarial": {
      "Nome": "PREFEITURA MUNICIPAL DE LUCIARA"
    },
    "dataAtualizacao": "2026-06-24",
    "fluxoClientela": "ATENDIMENTO DE DEMANDA REFERENCIADA"
  },
  "profissional": [],
  "leito": [],
  "habilitacao": [],
  "equipamento": [],
  "samu": [],
  "sumario": {
    "quantidadeProfissionaisSaude": 3,
    "quantidadeLeitos": 0
  }
}

leitos(cnes: str) -> list[dict]

Consulta os perfis de leitos vinculados ao código CNES informado.

Retorno: uma lista de dicionários contendo as informações de cada perfil de leito.

[
  {
    "codigo": "96",
    "descricao": "SUPORTE VENTILATORIO PULMONAR",
    "dataAtualizacao": "2026-05-18T00:00:00",
    "quantidadeLeito": 4,
    "quantidadeLeitoSUS": 4
  },
  {
    "codigo": "02",
    "descricao": "CARDIOLOGIA",
    "dataAtualizacao": "2026-05-18T00:00:00",
    "quantidadeLeito": 6,
    "quantidadeLeitoSUS": 0
  }
]

profissionais(cnes: str) -> list[dict]

Consulta os profissionais vinculados ao código CNES informado.

Retorno: uma lista de dicionários contendo o CPF e o CNS de cada profissional ligado ao CNES.

[
  {
    "CNS": "709809023050097",
    "CPF": "413******00"
  },
  {
    "CNS": "708408234337161",
    "CPF": "050******35"
  },
  {
    "CNS": "704102842163350",
    "CPF": "085******52"
  },
  {
    "CNS": "700509551692756",
    "CPF": "116******74"
  }
]

Desenvolvimento

python -m pip install -e ".[dev]"
ruff check .
mypy src
pytest
python -m build