Painel da empresa › Escalas
Criar posto
POST/api/v1/schedule/postsPede sessãoComo funciona
Cria uma escala: a regra que gera os plantões. Ela diz onde (setor, endereço e as coordenadas com o raio do ponto), o quê (especialidade, tipo de plantão, horário), quando (dias da semana e vigência), por quanto (valor da hora ou total, ou o modelo de contrato) e quem participa (doctorIds).
- Escala fixa tem
diasSemana(0 = domingo a 6 = sábado) e vigência emvalidoDeevalidoAte(AAAA-MM-DD), de no máximo 1 ano. Sem dias, a escala não é fixa e os plantões são criados um a um. - Sem latitude, longitude e raio, o ponto do médico não tem onde ser conferido.
- Setor, especialidade e tipo de plantão vão pelo id das opções (
sectorId,specialtyId,shiftTypeId).
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
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
201 · id da escala criada.
idstring · Identificador do registro.naoAplicadosstring[] · Só no modomanual: datas (AAAA-MM-DD) deescolhasque não puderam ser aplicadas.
Corpo de exemplo
{
"id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
"naoAplicados": [
"texto"
]
}