Plantonizei

App do médico › Plantões e vagas

Meus plantões

GET/api/v1/me/shiftsPede sessão

Como funciona

A agenda do médico na empresa da sessão: os plantões dele no período, com escala, setor, especialidade, início, fim, duração, valor, a situação de cada um e o ponto já batido (entrada, saída e minutos de atraso). O período padrão é o mês corrente; mude com period (today, week) ou com from e to (AAAA-MM-DD).

É a tela inicial do app. Só a sessão de médico usa (403 para as outras).

Parâmetros

  • periodQuery · stringAtalho de período: `today` (hoje), `week` (últimos 7 dias) ou `period` (datas de `from` e `to`). Sem ele, vale o mês corrente.
  • fromQuery · stringInício do período (`AAAA-MM-DD`).
  • toQuery · stringFim do período (`AAAA-MM-DD`).

Respostas

200 · Os plantões do médico no período.

  • shiftsobject[] · Os plantões.
  • shifts[].checkInstring · Horário da entrada.
  • shifts[].checkInIdstring · Identificador do registro de ponto; ausente quando não há ponto.
  • shifts[].checkOutstring · Horário da saída.
  • shifts[].checkinDeadlinestring · Até quando o check-in vale sem pedir liberação; é o início do plantão mais a tolerância da empresa.
  • shifts[].punchReleaseobject · O último pedido de liberação do ponto ainda não usado, com a situação e quem respondeu.
  • shifts[].punchRejectedboolean · A última decisão da coordenação sobre a batida foi recusar.
  • shifts[].punchRejectReasonstring · O motivo da recusa, quando a coordenação escreveu.
  • shifts[].checkinInformedboolean · A entrada foi informada depois (lançada à mão), não batida no local. Recusado o ponto, só o horário informado deixa de valer.
  • shifts[].checkoutInformedboolean · A saída foi informada depois (lançada à mão), não batida no local.
  • shifts[].justificationstring · A justificativa do lançamento manual.
  • shifts[].evidenceKeystring · A chave do comprovante do lançamento manual.
  • shifts[].postedBystring · Quem lançou o horário à mão.
  • shifts[].companyConfirmedAtstring · Quando a empresa escalou o médico neste plantão.
  • shifts[].doctorConfirmedAtstring · Quando o médico confirmou pelo aplicativo; ausente enquanto não confirmou.
  • shifts[].swapUntilstring · Até quando o médico pode pedir troca — o início menos o prazo mínimo de troca das Configurações.
  • shifts[].punchPendingValidationboolean · O ponto espera a validação da coordenação (horário esquecido informado pelo médico, lançamento sem atestado).
  • shifts[].pointExemptboolean · Escala ou médico isento de ponto nas Configurações; o plantão é apurado pelo planejado e o aplicativo não pede batida.
  • shifts[].coordinatorstring · Coordenador responsável pela jornada.
  • shifts[].datestring · Data.
  • shifts[].doctorNamestring · Nome do médico.
  • shifts[].durationHoursnumber · Duração, em horas.
  • shifts[].endsAtstring · Fim.
  • shifts[].idstring · Identificador do registro.
  • shifts[].lateMinutesinteger · Minutos de atraso na entrada.
  • shifts[].origemstring · Origem do plantão: rule (da escala fixa) ou manual (avulso).
  • shifts[].pendingReleaseboolean · Há pedido de liberação da vaga aguardando a coordenação.
  • shifts[].releasedBystring · Quem da coordenação liberou a batida fora da regra, quando houve pedido aprovado.
  • shifts[].punchLatnumber · Latitude de onde o médico bateu o ponto.
  • shifts[].punchLngnumber · Longitude de onde o médico bateu o ponto.
  • shifts[].punchOriginstring · Como o ponto entrou: batido pelo médico ou lançado pela coordenação.
  • shifts[].scaleNamestring · Nome da escala.
  • shifts[].sectorstring · Setor.
  • shifts[].shiftstring · Turno.
  • shifts[].specialtystring · Especialidade.
  • shifts[].startsAtstring · Início.
  • shifts[].statusstring · Situação.
  • shifts[].validatedAtstring · Quando foi validado.
  • shifts[].validatedBystring · Quem validou; ausente enquanto ninguém validou.
  • shifts[].valueCentsinteger · Valor, em centavos.
  • shifts[].windowstring · Janela do plantão (início e fim), em texto.

Corpo de exemplo

{
  "shifts": [
    {
      "checkIn": "texto",
      "checkInId": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
      "checkOut": "texto",
      "checkinDeadline": "texto",
      "punchRelease": {},
      "punchRejected": true,
      "punchRejectReason": "texto",
      "checkinInformed": true,
      "checkoutInformed": true,
      "justification": "texto",
      "evidenceKey": "texto",
      "postedBy": "texto",
      "companyConfirmedAt": "2026-10-20T09:30:00-03:00",
      "doctorConfirmedAt": "2026-10-20T09:30:00-03:00",
      "swapUntil": "2026-10-20T09:30:00-03:00",
      "punchPendingValidation": true,
      "pointExempt": true,
      "coordinator": "texto",
      "date": "texto",
      "doctorName": "texto",
      "durationHours": 1,
      "endsAt": "texto",
      "id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
      "lateMinutes": 1,
      "origem": "texto",
      "pendingRelease": true,
      "releasedBy": "texto",
      "punchLat": 1,
      "punchLng": 1,
      "punchOrigin": "texto",
      "scaleName": "texto",
      "sector": "texto",
      "shift": "texto",
      "specialty": "texto",
      "startsAt": "texto",
      "status": "texto",
      "validatedAt": "texto",
      "validatedBy": "texto",
      "valueCents": 150000,
      "window": "texto"
    }
  ]
}