Skip to content

Pacientes ​

Cadastro de pacientes por empresa. Toda rota exige um token de usuário da empresa (Authorization: Bearer <token>); os registros são sempre escopados pela empresa atual (companyId do token), nunca por parâmetro.

MétodoRotaAuthDescrição
GET/api/patientsBearerlista pacientes da empresa (filtros + paginação)
GET/api/patients/conveniosBearerconvênios disponíveis (para filtro e formulário)
GET/api/patients/:idBearerdetalhe de um paciente
POST/api/patientsBearercadastra um paciente
PATCH/api/patients/:idBeareratualiza o cadastro (campos parciais)

Listar pacientes ​

Aceita filtros por busca livre (q — nome, CPF, carteirinha ou prontuário), convenio (nome exato) e uf, além de paginação (page ≥ 1, perPage 1–100, padrão 9).

bash
curl "$BASE/api/patients?q=maria&convenio=Unimed&page=1&perPage=9" \
  -H "authorization: Bearer <token>"

A resposta é um envelope paginado com um resumo da empresa (independente dos filtros):

json
{
  "items": [ { "id": "…", "prontuario": "10003", "nome": "Maria Silva", "cpf": "12345678901", "convenio": "Unimed", "celular": "61988887777" } ],
  "total": 42,
  "page": 1,
  "perPage": 9,
  "summary": { "total": 42, "novos": 3, "aniversariantes": 1 }
}

Cadastrar paciente ​

bash
curl -X POST $BASE/api/patients -H "authorization: Bearer <token>" -H 'content-type: application/json' \
  -d '{
    "nome": "Maria Silva",
    "cpf": "123.456.789-01",
    "sexo": "F",
    "nascimento": "1990-05-12",
    "convenio": "Unimed",
    "celular": "(61) 98888-7777"
  }'

DTO & validação ​

CampoObrigatórioRegra
nomesimstring, 2–120 caracteres
cpfsimCPF válido (dígitos verificadores); formatação é removida e armazenada como dígitos crus
sexosimF ou M
nascimentosimdata YYYY-MM-DD
conveniosimstring (nome do convênio; Particular zera a carteirinha)
celularsimapenas dígitos, 10 ou 11 (formatação removida na entrada)
carteirinhanãostring ou null
cidadenãostring
estadonãostring (UF)
telefonenãoapenas dígitos, 10 ou 11, ou null
emailnãoe-mail válido

CPF e telefones são normalizados para dígitos crus na entrada: 123.456.789-01 → 12345678901, (61) 98888-7777 → 61988887777. O CPF passa por validação dos dígitos verificadores. O número do prontuário é gerado pelo backend; não é enviado no cadastro.

PATCH /api/patients/:id aceita os mesmos campos, todos opcionais — apenas os enviados são alterados.