ERP · Gestão Escolar Somente leitura Dados sensíveis

Saúde

Atendimentos da enfermaria, ocorrências de saúde e as medicações administradas pela escola. Útil para apps das famílias, prontuários de clínicas parceiras e indicadores de saúde escolar.

São dados pessoais sensíveis (LGPD, art. 11). Use apenas para a finalidade acordada com a escola, restrinja o acesso no seu sistema e não armazene além do necessário.

O modelo atendimento

id uuid

Identificador do atendimento.

student / classroom / professional object

Aluno, turma e profissional que atendeu.

occurred_at datetime

Data e hora do atendimento.

reason / status string

Motivo e desfecho do atendimento.

symptoms / procedures string|null

Sintomas e procedimentos.

temperature / blood_pressure / oxygen_saturation mixed

Sinais vitais aferidos.

guardian_contacted boolean

Se o responsável foi contatado.

O modelo atendimento
{
  "id": "019f57dd-b696-72e1-b1da-7376dd7fe38e",
  "student": {
    "id": "019e6e4b-6bba-734d-be16-c6826c795d9d",
    "name": "Ana Beatriz Costa"
  },
  "classroom": {
    "id": "019e6e4b-50b0-719c-8bd6-f1b30e763489",
    "name": "5º Ano A"
  },
  "professional": {
    "id": "019e6e4b-3235-727f-b423-89694ac61dea",
    "name": "Alana Salgado"
  },
  "occurred_at": "2026-10-01T10:30:00-03:00",
  "reason": "FEBRE",
  "reason_label": "Febre",
  "status": "LIBERADO",
  "status_label": "Liberado",
  "symptoms": "Temperatura de 38,1 °C.",
  "procedures": "Compressa fria e hidratação.",
  "temperature": 38.1,
  "blood_pressure": null,
  "oxygen_saturation": 98,
  "medications_administered": "Dipirona 500mg (autorizada pelo responsável).",
  "referral": null,
  "guardian_contacted": true,
  "observations": "Responsável buscou às 11h15.",
  "created_at": "2026-10-01T10:31:00-03:00",
  "updated_at": "2026-10-01T11:20:00-03:00"
}
GET /v1/partners/school/{cnpj}/health/visits/all

Listar atendimentos

Atendimentos da enfermaria, do mais recente para o mais antigo. Paginado (25 por página).

Parâmetros de rota

cnpj string obrigatório

CNPJ da escola (14 dígitos, sem formatação).

Filtros (query string)

enrollment_number string opcional

Número de matrícula do aluno.

from date opcional

A partir de (AAAA-MM-DD).

to date opcional

Até (AAAA-MM-DD).

status string opcional

EM_ATENDIMENTO, LIBERADO, ENCAMINHADO_HOSPITAL ou AGUARDANDO_RESPONSAVEL.

reason string opcional

Motivo (ex.: FEBRE, DOR_CABECA, DOR_BARRIGA, MAL_ESTAR, OUTRO).

Códigos de resposta

200

Sucesso.

401

Credenciais inválidas (X-Partner, X-Client ou X-Authorization).

403

Cliente fora do plano Gestão Escolar (ERP_REQUIRED) ou módulo exclusivo de escolas privadas (PRIVATE_CLIENT_REQUIRED).

404

Escola ou recurso não encontrado.

422

Parâmetros inválidos — veja errors.

Requisição GET
GET /v1/partners/school/{cnpj}/health/visits/all
curl https://toakiescola.com.br/api/v1/partners/school/{cnpj}/health/visits/all \
  -H "X-Authorization: {api_token}" \
  -H "X-Partner: {partner_token}" \
  -H "X-Client: {client_slug}"
Resposta 
{
  "data": [
    {
      "id": "019f57dd-b696-72e1-b1da-7376dd7fe38e",
      "student": {
        "id": "019e6e4b-6bba-734d-be16-c6826c795d9d",
        "name": "Ana Beatriz Costa"
      },
      "classroom": {
        "id": "019e6e4b-50b0-719c-8bd6-f1b30e763489",
        "name": "5º Ano A"
      },
      "professional": {
        "id": "019e6e4b-3235-727f-b423-89694ac61dea",
        "name": "Alana Salgado"
      },
      "occurred_at": "2026-10-01T10:30:00-03:00",
      "reason": "FEBRE",
      "reason_label": "Febre",
      "status": "LIBERADO",
      "status_label": "Liberado",
      "symptoms": "Temperatura de 38,1 °C.",
      "procedures": "Compressa fria e hidratação.",
      "temperature": 38.1,
      "blood_pressure": null,
      "oxygen_saturation": 98,
      "medications_administered": "Dipirona 500mg (autorizada pelo responsável).",
      "referral": null,
      "guardian_contacted": true,
      "observations": "Responsável buscou às 11h15.",
      "created_at": "2026-10-01T10:31:00-03:00",
      "updated_at": "2026-10-01T11:20:00-03:00"
    }
  ],
  "links": { /* first, prev, next */ },
  "meta": { "current_page": 1, "per_page": 25 }
}
GET /v1/partners/school/{cnpj}/health/visit/{id}

Obter atendimento

Um atendimento da enfermaria.

Parâmetros de rota

cnpj string obrigatório

CNPJ da escola (14 dígitos, sem formatação).

id uuid obrigatório

UUID do atendimento.

Códigos de resposta

200

Sucesso.

401

Credenciais inválidas (X-Partner, X-Client ou X-Authorization).

403

Cliente fora do plano Gestão Escolar (ERP_REQUIRED) ou módulo exclusivo de escolas privadas (PRIVATE_CLIENT_REQUIRED).

404

Escola ou recurso não encontrado.

Requisição GET
GET /v1/partners/school/{cnpj}/health/visit/{id}
curl https://toakiescola.com.br/api/v1/partners/school/{cnpj}/health/visit/{id} \
  -H "X-Authorization: {api_token}" \
  -H "X-Partner: {partner_token}" \
  -H "X-Client: {client_slug}"
Resposta 
{
  "data": {
    "id": "019f57dd-b696-72e1-b1da-7376dd7fe38e",
    "student": {
      "id": "019e6e4b-6bba-734d-be16-c6826c795d9d",
      "name": "Ana Beatriz Costa"
    },
    "classroom": {
      "id": "019e6e4b-50b0-719c-8bd6-f1b30e763489",
      "name": "5º Ano A"
    },
    "professional": {
      "id": "019e6e4b-3235-727f-b423-89694ac61dea",
      "name": "Alana Salgado"
    },
    "occurred_at": "2026-10-01T10:30:00-03:00",
    "reason": "FEBRE",
    "reason_label": "Febre",
    "status": "LIBERADO",
    "status_label": "Liberado",
    "symptoms": "Temperatura de 38,1 °C.",
    "procedures": "Compressa fria e hidratação.",
    "temperature": 38.1,
    "blood_pressure": null,
    "oxygen_saturation": 98,
    "medications_administered": "Dipirona 500mg (autorizada pelo responsável).",
    "referral": null,
    "guardian_contacted": true,
    "observations": "Responsável buscou às 11h15.",
    "created_at": "2026-10-01T10:31:00-03:00",
    "updated_at": "2026-10-01T11:20:00-03:00"
  }
}
GET /v1/partners/school/{cnpj}/health/occurrences/all

Listar ocorrências de saúde

Ocorrências e acidentes registrados, do mais recente para o mais antigo. Paginado.

Parâmetros de rota

cnpj string obrigatório

CNPJ da escola (14 dígitos, sem formatação).

Filtros (query string)

enrollment_number string opcional

Número de matrícula do aluno.

from date opcional

A partir de (AAAA-MM-DD).

to date opcional

Até (AAAA-MM-DD).

category string opcional

Categoria (ex.: QUEDA, CORTE, TRAUMA, REACAO_ALERGICA, CRISE_ASMATICA, CONVULSAO, FEBRE, MAL_ESTAR, OUTRO).

Códigos de resposta

200

Sucesso.

401

Credenciais inválidas (X-Partner, X-Client ou X-Authorization).

403

Cliente fora do plano Gestão Escolar (ERP_REQUIRED) ou módulo exclusivo de escolas privadas (PRIVATE_CLIENT_REQUIRED).

404

Escola ou recurso não encontrado.

422

Parâmetros inválidos — veja errors.

Requisição GET
GET /v1/partners/school/{cnpj}/health/occurrences/all
curl https://toakiescola.com.br/api/v1/partners/school/{cnpj}/health/occurrences/all \
  -H "X-Authorization: {api_token}" \
  -H "X-Partner: {partner_token}" \
  -H "X-Client: {client_slug}"
Resposta 
{
  "data": [
    {
      "id": "019f203c-98c9-733f-80ef-704101c14826",
      "student": {
        "id": "019e6e4b-6bba-734d-be16-c6826c795d9d",
        "name": "Ana Beatriz Costa"
      },
      "classroom": {
        "id": "019e6e4b-50b0-719c-8bd6-f1b30e763489",
        "name": "5º Ano A"
      },
      "professional": {
        "id": "019e6e4b-3235-727f-b423-89694ac61dea",
        "name": "Alana Salgado"
      },
      "occurred_at": "2026-09-18T15:10:00-03:00",
      "category": "QUEDA",
      "category_label": "Queda",
      "location": "Pátio",
      "description": "Escorregou durante o recreio e ralou o joelho.",
      "involved": null,
      "witnesses": "Prof. Carlos Almeida",
      "guardian_notified": true,
      "ambulance_required": false,
      "referral": null,
      "notes": null,
      "created_at": "2026-09-18T15:20:00-03:00",
      "updated_at": "2026-09-18T15:20:00-03:00"
    }
  ],
  "links": { /* first, prev, next */ },
  "meta": { "current_page": 1, "per_page": 25 }
}
GET /v1/partners/school/{cnpj}/health/occurrence/{id}

Obter ocorrência de saúde

Uma ocorrência de saúde.

Parâmetros de rota

cnpj string obrigatório

CNPJ da escola (14 dígitos, sem formatação).

id uuid obrigatório

UUID da ocorrência.

Códigos de resposta

200

Sucesso.

401

Credenciais inválidas (X-Partner, X-Client ou X-Authorization).

403

Cliente fora do plano Gestão Escolar (ERP_REQUIRED) ou módulo exclusivo de escolas privadas (PRIVATE_CLIENT_REQUIRED).

404

Escola ou recurso não encontrado.

Requisição GET
GET /v1/partners/school/{cnpj}/health/occurrence/{id}
curl https://toakiescola.com.br/api/v1/partners/school/{cnpj}/health/occurrence/{id} \
  -H "X-Authorization: {api_token}" \
  -H "X-Partner: {partner_token}" \
  -H "X-Client: {client_slug}"
Resposta 
{
  "data": {
    "id": "019f203c-98c9-733f-80ef-704101c14826",
    "student": {
      "id": "019e6e4b-6bba-734d-be16-c6826c795d9d",
      "name": "Ana Beatriz Costa"
    },
    "classroom": {
      "id": "019e6e4b-50b0-719c-8bd6-f1b30e763489",
      "name": "5º Ano A"
    },
    "professional": {
      "id": "019e6e4b-3235-727f-b423-89694ac61dea",
      "name": "Alana Salgado"
    },
    "occurred_at": "2026-09-18T15:10:00-03:00",
    "category": "QUEDA",
    "category_label": "Queda",
    "location": "Pátio",
    "description": "Escorregou durante o recreio e ralou o joelho.",
    "involved": null,
    "witnesses": "Prof. Carlos Almeida",
    "guardian_notified": true,
    "ambulance_required": false,
    "referral": null,
    "notes": null,
    "created_at": "2026-09-18T15:20:00-03:00",
    "updated_at": "2026-09-18T15:20:00-03:00"
  }
}
GET /v1/partners/school/{cnpj}/health/medications/all

Listar medicações

Medicações que a escola administra aos alunos, com posologia, horários e estoque. Paginado.

Parâmetros de rota

cnpj string obrigatório

CNPJ da escola (14 dígitos, sem formatação).

Filtros (query string)

enrollment_number string opcional

Número de matrícula do aluno.

active boolean opcional

1 ativas, 0 encerradas.

Códigos de resposta

200

Sucesso.

401

Credenciais inválidas (X-Partner, X-Client ou X-Authorization).

403

Cliente fora do plano Gestão Escolar (ERP_REQUIRED) ou módulo exclusivo de escolas privadas (PRIVATE_CLIENT_REQUIRED).

404

Escola ou recurso não encontrado.

422

Parâmetros inválidos — veja errors.

Requisição GET
GET /v1/partners/school/{cnpj}/health/medications/all
curl https://toakiescola.com.br/api/v1/partners/school/{cnpj}/health/medications/all \
  -H "X-Authorization: {api_token}" \
  -H "X-Partner: {partner_token}" \
  -H "X-Client: {client_slug}"
Resposta 
{
  "data": [
    {
      "id": "019f57f0-acfa-7379-a41c-141026b10a08",
      "student": {
        "id": "019e6e4b-6bba-734d-be16-c6826c795d9d",
        "name": "Ana Beatriz Costa"
      },
      "name": "Loratadina",
      "dosage": "10mg",
      "dosage_quantity": 1,
      "frequency": "1x ao dia",
      "schedule_times": [
        "12:00"
      ],
      "starts_on": "2026-09-01",
      "ends_on": "2026-12-15",
      "stock_quantity": 18,
      "stock_unit": "comp.",
      "notes": null,
      "active": true
    }
  ],
  "links": { /* first, prev, next */ },
  "meta": { "current_page": 1, "per_page": 25 }
}