Painel da empresa › Escalas
Editar posto
PATCH/api/v1/schedule/posts/{id}Pede sessãoComo funciona
Edita a regra da escala. O corpo é o mesmo da criação.
Tirar dias da regra ou encurtar a vigência não apaga plantão que já tem médico escalado. Quando a mudança deixaria plantões assim fora da regra, a rota responde 409 com requiresConfirmation: true e a lista em affectedShifts. Para salvar mesmo assim, repita com confirm=true na query: esses plantões ficam no calendário como avulsos.
Fica na trilha de auditoria. Pede a permissão de criar e editar escalas.
Quando a escala da empresa está travada para o fechamento, só o administrador altera; os demais perfis recebem 403 até alguém destravar.
Parâmetros
idCaminho · string · obrigatórioIdentificador do registro, como vem na listagem.confirmQuery · stringCom `true`, salva mesmo deixando plantões com médico fora da regra.cepCorpo · stringCEP, só dígitos.cityCorpo · stringCidade.complementCorpo · stringComplemento.coordinatorCorpo · stringCoordenador responsável pela jornada.districtCorpo · stringBairro.hourlyRateCentsCorpo · integerValor da hora, em centavos.numberCorpo · stringNúmero.scaleNameCorpo · stringNome da escala.sectorCorpo · stringSetor.shiftCorpo · stringTurno.specialtyCorpo · stringEspecialidade.stateCorpo · stringEstado.statusCorpo · stringSituação.streetCorpo · stringLogradouro.swapPolicyCorpo · stringPolítica de troca da escala.totalCentsCorpo · integerValor total, em centavos.windowCorpo · stringJanela do plantão (início e fim), em texto.attendanceTypeCorpo · stringTipo de atendimento.contractTemplateIdCorpo · stringIdentificador do modelo de contrato que define o valor do plantão.diasSemanaCorpo · integer[]Dias da semana da escala fixa: 0 é domingo e 6 é sábado. Vazio quando a escala não é fixa.distribuicaoCorpo · string: auto | vazio | manualComo os médicos entram nos plantões: `auto`, `vazio` ou `manual`. Vazio no PATCH mantém o modo gravado.escolhasCorpo · objectSó no modo `manual`: data `AAAA-MM-DD` → vínculo do médico; `""` deixa o dia vazio. Dia que já passou também vale (lança quem cobriu). Não se aplica a dia sem plantão, a médico já escalado no mesmo horário em outra escala, a plantão que o médico já confirmou nem a plantão com ponto batido; essas datas voltam em `naoAplicados` na resposta.doctorIdsCorpo · string[]Identificadores dos médicos nesta empresa (os vínculos).escalistaCorpo · stringEscalista responsável pela jornada.geofenceRadiusMetersCorpo · integerRaio, em metros, dentro do qual o ponto vale.latitudeCorpo · numberLatitude do local da escala. Sem coordenadas e raio, o ponto não tem onde ser conferido.longitudeCorpo · numberLongitude.medicosPropriosCorpo · booleanA jornada tem time próprio, em vez de usar o da escala.scheduleIdCorpo · stringIdentificador da escala.scheduleNameCorpo · stringNome da escala.sectorIdCorpo · stringIdentificador do setor.shiftTypeIdCorpo · stringIdentificador do tipo de plantão.specialtyIdCorpo · stringIdentificador da especialidade.validoAteCorpo · stringFim da vigência (`AAAA-MM-DD`). A escala vale no máximo 1 ano.validoDeCorpo · stringInício da vigência (`AAAA-MM-DD`). Obrigatório na escala fixa.
Respostas
200 · Escala salva no modo manual, com as datas de escolhas que não puderam ser aplicadas.
naoAplicadosstring[] · Só no modomanual: datas (AAAA-MM-DD) deescolhasque não puderam ser aplicadas.
Corpo de exemplo
{
"naoAplicados": [
"texto"
]
}