Gerar senha de atendimento

Gera uma nova senha de atendimento na clínica, permitindo a entrada de pacientes no fluxo de espera e a emissão de tickets em totens, terminais de autoatendimento ou portais integrados. O endpoint recebe a identificação da área de chamada, o nome do paciente (opcional) e o grau de prioridade do atendimento, criando o cartão de chamada na fila correspondente.

Como gerar uma senha

Envie uma requisição POST com os dados da área e da prioridade desejada:

curl -X POST "https://api.clinicanasnuvens.com.br/painel-chamada/senha/gerar" \
  -H "Authorization: Basic <CREDENCIAIS_EM_BASE64>" \
  -H "clinicaNasNuvens-cid: <TOKEN_DA_CLINICA>" \
  -H "Content-Type: application/json" \
  -d '{
    "idAreaChamada": 468,
    "nomePaciente": "João da Silva",
    "prioridade": "IDOSO_SESSENTA"
  }'

Campos da requisição

Campo	Tipo	Obrigatório	Descrição
idAreaChamada	Integer	Sim	Identificador da área de chamada onde o paciente vai aguardar
nomePaciente	String	Não	Nome do paciente que solicitou a senha
prioridade	String	Sim	Grau de prioridade do atendimento (consulte os valores permitidos abaixo)

Valores aceitos para o campo prioridade

A requisição aceita estritamente os seguintes valores de prioridade:

Valor	Descrição
NORMAL	Atendimento sem prioridade (fila convencional)
IDOSO_SESSENTA	Idoso 60+ (prioridade por idade)
IDOSO_OITENTA	Idoso 80+ (prioridade especial por idade)
PCD	Pessoa com deficiência e/ou acompanhante
GESTANTE	Gestante
LACTANTE	Lactante
CRIANCA_DE_COLO	Criança de colo
TEA	Transtorno do Espectro Autista e/ou acompanhante
DOADOR_SANGUE	Doador de sangue
DOADOR_MEDULA	Doador de medula óssea
INDICACAO	Indicação

Regras e comportamentos

• Validação de Área: O sistema valida se o idAreaChamada informado existe, pertence a uma área com status ativo e configurada para permitir a emissão de senhas. Caso o identificador não exista, a área esteja inativa ou não permita a geração de senhas, retorna HTTP 400.
• Tipagem Prioritária Estrita: O valor enviado no campo prioridade deve corresponder a uma das opções válidas listadas acima. Caso contrário, retorna HTTP 400.
• Delegação de Contagem: O cálculo da numeração da senha gerada respeita as regras internas configuradas para a área ou clínica (contagem diária ou contínua, individual ou compartilhada entre áreas).
• Formatação da Senha: O campo senha devolvido na resposta já contém a formatação final de exibição e impressão (incluindo o prefixo da área, por exemplo REC-021).
• Inserção na Fila: O cartão de chamada é registrado diretamente na fila de atendimento da área especificada, ficando pronto para ser chamado nos monitores vinculados.

Resposta (HTTP 201 Created)

{
  "idCard": 9982,
  "senha": "REC-021",
  "nomePaciente": "João da Silva",
  "prioridade": "IDOSO_SESSENTA",
  "dataHoraEmissao": "2026-10-05T16:30:00Z"
}

Campos do retorno

Campo	Tipo	Descrição
idCard	Integer	Identificador único do cartão gerado na fila de atendimento
senha	String	Senha de atendimento formatada para exibição e impressão
nomePaciente	String	Nome do paciente informado na emissão da senha (se enviado)
prioridade	String	Prioridade atribuída à senha emitida
dataHoraEmissao	String	Data e hora em que a senha foi emitida no padrão ISO 8601 (UTC)

Veja na Referência

Os detalhes de cada operação e esquema estão em Referência › Painel de chamadas › Gerar senha de atendimento.