App do médico › Plantões e vagas
Meus plantões
GET/api/v1/me/shiftsPede sessãoComo 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) oumanual(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"
}
]
}