3s-cnes-client 0.2.1

Cliente Python assíncrono para o serviço SOAP oficial do CNES.

3s-cnes-client

Cliente Python assíncrono para consultar 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:
        leitos = await client.leitos("4013484")
        profissionais = await client.profissionais("4013484")

        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

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