Painel da empresa › Escalas
Criar plantão
POST/api/v1/schedule/shiftsPede sessãoComo funciona
Cria um plantão avulso numa escala (postId), fora da regra ou para completar o dia. Mande a data (date, AAAA-MM-DD), o início e o fim (startsAt e endsAt, RFC 3339), a duração e o valor; com doctorLinkId, o plantão já nasce com o médico, e sem ele nasce como vaga aberta.
Regras:
- Plantão em data passada é permitido, mas exige
justification. Sem ela a resposta é 422 comneedsJustification: true, e a tela abre o campo. - O mesmo médico não pode ter dois plantões na mesma escala, dia e horário (409).
- Escala inativa não recebe plantão (409).
- O médico precisa ser desta empresa.
Quem criou e o papel dele saem da sessão e ficam gravados no plantão. Fica na trilha de auditoria.
Parâmetros
dateCorpo · stringData do plantão (`AAAA-MM-DD`).doctorIdCorpo · stringIdentificador do médico nesta empresa (o vínculo).durationHoursCorpo · numberDuração, em horas.endsAtCorpo · stringFim (RFC 3339, com fuso).evidenceKeyCorpo · stringChave do comprovante. Obrigatória para o escalista, junto da justificativa.justificationCorpo · stringJustificativa. Obrigatória quando a data já passou.paymentTermCorpo · stringPrazo de pagamento: à vista ou a prazo. Vazio segue o contrato da escala.postIdCorpo · stringIdentificador da escala (jornada) do plantão.startsAtCorpo · stringInício (RFC 3339, com fuso).valueCentsCorpo · integerValor, em centavos.
Respostas
201 · id do plantão criado.
idstring · Identificador do registro.
Corpo de exemplo
{
"id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e"
}