Pular para o conteúdo
TAI TAI Desenvolvedores

Pedir as minhas férias (autoatendimento)

POST
/solicitacao-ferias/minha

O colaborador logado pede as próprias férias: {dataInicio (AAAA-MM-DD), quantidadeDias OU dataFim, diasAbono? (vender até 1/3 do direito), justificativa?}. O servidor confere as regras da CLT na hora (saldo do período aquisitivo, 30 dias de antecedência, início fora dos 2 dias antes de feriado ou do descanso semanal, abono, conflito com férias e pedidos já existentes) e recusa com o motivo. O pedido nasce SOLICITADO e o gestor é avisado; a aprovação é de quem tem acesso ao cadastro de colaboradores.

Autorização
Módulo contratado: PESSOAS
Permissão: qualquer usuário autenticado da empresa

Authorizations

Seção intitulada “Authorizations ”

Request Body required

Seção intitulada “Request Body required ”
object
dataInicio

Primeiro dia das férias (AAAA-MM-DD)

string format: date
dataFim

Último dia das férias (AAAA-MM-DD); opcional se informar quantidadeDias

string format: date
quantidadeDias

Dias corridos de férias

integer format: int32
diasAbono

Dias vendidos (abono pecuniário, até 1/3 do direito); 0 ou vazio = não vende

integer format: int32
justificativa

Observação para quem aprova

string

Responses

Seção intitulada “ Responses ”

200

Seção intitulada “200 ”

OK

Partial entity data with ID (only non-null fields will be updated)

object
id
integer format: int64
active
boolean
createdAt
string format: date-time
colaborador

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
id
integer format: int64
active
boolean
createdAt
string format: date-time
nome
string
0 <= 255 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
dataNascimento
string format: date-time
genero
string
Allowed values: MASCULINO FEMININO NAO_BINARIO OUTRO PREFIRO_NAO_INFORMAR
nacionalidade
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
cpf
string
/^(\d{11}|\d{3}\.\d{3}\.\d{3}-\d{2})$/
rg
string
0 <= 20 characters /^[\d.\-A-Za-z]+$/
estadoCivil
string
Allowed values: SOLTEIRO CASADO DIVORCIADO VIUVO UNIAO_ESTAVEL
telefone
string
0 <= 20 characters /^[\d\s\-().+]+$/
emailPessoal
string format: email
0 <= 255 characters
emailCorporativo
string format: email
0 <= 255 characters
linkedin
string
0 <= 500 characters /^(https?://)?[\w\-.]+(:\d+)?(/[\w\-./?%&=@#]*)?$/
endereco
string
0 <= 500 characters /^[\p{L}\p{N}\s\-.,;:/°ºª()]+$/
codigoFuncionario
string
0 <= 50 characters /^[a-zA-Z0-9\-_]+$/
codigoPosicao
string
0 <= 50 characters /^[a-zA-Z0-9\-_]+$/
tipoContrato
string
Allowed values: CLT PJ ESTAGIO TEMPORARIO TERCEIRIZADO APRENDIZ INTERMITENTE SOCIO_SERVICO AUTONOMO
dataAdmissao
string format: date-time
nivelHierarquico
string
Allowed values: ESTAGIARIO TREINEE JUNIOR PLENO SENIOR COORDENADOR GERENTE ESPECIALISTA SUPERINTENDENTE DIRETOR VICE_PRESIDENTE C_LEVEL
regimeTrabalho
string
Allowed values: INTEGRAL PARCIAL PRESENCIAL REMOTO HIBRIDO
horarioTrabalho
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
beneficios
string
0 <= 1000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
pis
string
/^\d{11}$/
ctps
string
0 <= 30 characters /^[\d.\-/]+$/
nis
string
0 <= 20 characters /^[a-zA-Z0-9]+$/
informacoesSaude
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
fotoUrl
string
0 <= 500 characters /^(https?://)?[\w\-.]+(:\d+)?(/[\w\-./?%&=@#]*)?$/
idiomas
Array<string>
enviarEmail
boolean
nomeSocial
string
0 <= 255 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
apelido
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
naturalidade
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
estadoNatal
string
0 <= 2 characters /^[A-Z]{2}$/
fumante
boolean
corRaca
string
Allowed values: BRANCA PRETA PARDA AMARELA INDIGENA NAO_INFORMADO
tipoSanguineo
string
Allowed values: A_POSITIVO A_NEGATIVO B_POSITIVO B_NEGATIVO AB_POSITIVO AB_NEGATIVO O_POSITIVO O_NEGATIVO
grauInstrucao
string
Allowed values: ANALFABETO FUNDAMENTAL_ATE_5_ANO_INCOMPLETO FUNDAMENTAL_5_ANO_COMPLETO FUNDAMENTAL_6_AO_9_ANO FUNDAMENTAL_COMPLETO MEDIO_INCOMPLETO MEDIO_COMPLETO SUPERIOR_INCOMPLETO SUPERIOR_COMPLETO POS_GRADUACAO_INCOMPLETA POS_GRADUACAO_COMPLETA MESTRADO_INCOMPLETO MESTRADO_COMPLETO DOUTORADO_INCOMPLETO DOUTORADO_COMPLETO POS_DOUTORADO_INCOMPLETO POS_DOUTORADO_COMPLETO
cep
string
0 <= 9 characters /^(\d{8}|\d{5}-\d{3})$/
logradouro
string
0 <= 255 characters /^[\p{L}\p{N}\s\-.,;:/°ºª()]+$/
enderecoNumero
string
0 <= 20 characters /^[a-zA-Z0-9]+$/
complemento
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
bairro
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
cidade
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
enderecoUf
string
0 <= 2 characters /^[A-Z]{2}$/
pais
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
telefone2
string
0 <= 20 characters /^[\d\s\-().+]+$/
telefone3
string
0 <= 20 characters /^[\d\s\-().+]+$/
ramal
string
0 <= 10 characters /^$|^\d+$/
rgOrgaoEmissor
string
0 <= 20 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
rgUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
rgDataEmissao
string format: date-time
tituloEleitor
string
0 <= 12 characters /^\d{12}$/
tituloEleitorZona
string
0 <= 10 characters /^[a-zA-Z0-9]+$/
tituloEleitorSecao
string
0 <= 10 characters /^[a-zA-Z0-9]+$/
tituloEleitorDataEmissao
string format: date-time
tituloEleitorUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
ctpsSerie
string
0 <= 20 characters /^[\d.\-/]+$/
ctpsDataEmissao
string format: date-time
ctpsUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
ctpsDigital
boolean
cnh
string
0 <= 20 characters /^[a-zA-Z0-9]+$/
cnhCategoria
string
Allowed values: A B C D E AB AC AD AE
cnhDataEmissao
string format: date-time
cnhDataVencimento
string format: date-time
cnhOrgaoEmissor
string
0 <= 20 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
cnhDataPrimeira
string format: date-time
cnhUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
certReservista
string
0 <= 30 characters /^[a-zA-Z0-9]+$/
categoriaMilitar
string
0 <= 30 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
circunscricaoMilitar
string
0 <= 30 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
regiaoMilitar
string
0 <= 30 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
certReservistaDataEmissao
string format: date-time
certReservistaOrgaoExpedicao
string
0 <= 50 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
situacaoMilitar
string
Allowed values: RESERVISTA DISPENSADO ALISTADO NAO_SE_APLICA EXCESSO_CONTINGENTE REFORMADO
matriculaEsocial
string
0 <= 30 characters
codCategoria
string
tipoRegimeTrabalhista
string
tipoRegimePrevidenciario
string
tipoAdmissao
string
indicativoAdmissao
string
naturezaAtividade
string
tipoRegimeJornada
string
defFisica
boolean
defVisual
boolean
defAuditiva
boolean
defMental
boolean
defIntelectual
boolean
reabilitadoReadaptado
boolean
preencheCotaPcd
boolean
observacaoDeficiencia
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
municipioId
integer format: int64
municipioDescricao
string
tipoLogradouro
string
sexoEsocial
string
grauInstrucaoEsocial
string
paisNascimento
string
paisNacionalidade
string
tipoContratoPrazo
string
dataTerminoContrato
string format: date-time
clausulaAssecuratoria
boolean
objetoDeterminante
string
0 <= 255 characters
tipoJornadaEsocial
string
tempoParcial
string
horasSemanais
number
horarioNoturno
boolean
descricaoJornada
string
0 <= 999 characters
dataOpcaoFgts
string format: date-time
esocialReciboAdmissao
string
0 <= 40 characters
tipoRua
string
tipoBairro
string
tipoFuncionarioTotvs
string
fichaRegistroTotvs
string
tipoAdmissaoTotvs
string
motivoAdmissaoTotvs
string
motivoMudancaTotvs
string
tipoRecebimentoTotvs
string
situacaoTotvs
string
jornadaMensalTotvs
string
horarioTotvs
string
letraHorarioTotvs
string
sindicatoTotvs
string
contribuicaoSindicalTotvs
string
ocorrenciaSefipTotvs
string
categoriaSefipTotvs
string
situacaoFgtsTotvs
string
situacaoRaisTotvs
string
calculaInssTotvs
boolean
calculaIrrfTotvs
boolean
percentualAdiantamentoTotvs
number
desligado
boolean
dataDesligamento
string format: date-time
motivoDesligamento
string
Allowed values: DEMISSAO_SEM_JUSTA_CAUSA DEMISSAO_COM_JUSTA_CAUSA PEDIDO_DEMISSAO ACORDO_MUTUO TERMINO_CONTRATO APOSENTADORIA FALECIMENTO TRANSFERENCIA_EMPRESA OUTRO
observacaoDesligamento
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
ferias

Partial entity data with ID (only non-null fields will be updated)

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
id
integer format: int64
active
boolean
createdAt
string format: date-time
dataInicio
string format: date-time
dataFim
string format: date-time
quantidadeDias
integer format: int32
numeroFracao
integer format: int32
totalFracoes
integer format: int32
diasAbonoPecuniario
integer format: int32
valorAbonoPecuniario
number
valorFerias
number
valorTercoConstitucional
number
valorTotal
number
status
string
Allowed values: PENDENTE_SOLICITACAO SOLICITADO APROVADO EM_ANDAMENTO CONCLUIDO CANCELADO VENCIDO
dataSolicitacao
string format: date-time
dataAprovacao
string format: date-time
dataPagamento
string format: date-time
dataRetornoPrevisto
string format: date-time
dataRetornoEfetivo
string format: date-time
pagoEmDobro
boolean
observacoes
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
motivoCancelamento
string
0 <= 1000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
emAndamento
boolean
primeiraFracao
boolean
fracionada
boolean
dataInicioSolicitada
string format: date-time
dataFimSolicitada
string format: date-time
quantidadeDias
integer format: int32
solicitaAbonoPecuniario
boolean
diasAbonoSolicitados
integer format: int32
fracionamento
boolean
numeroFracao
integer format: int32
totalFracoes
integer format: int32
status
string
Allowed values: PENDENTE_SOLICITACAO SOLICITADO APROVADO EM_ANDAMENTO CONCLUIDO CANCELADO VENCIDO
dataSolicitacao
string format: date-time
aprovadoPor

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
id
integer format: int64
active
boolean
createdAt
string format: date-time
nome
string
0 <= 255 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
dataNascimento
string format: date-time
genero
string
Allowed values: MASCULINO FEMININO NAO_BINARIO OUTRO PREFIRO_NAO_INFORMAR
nacionalidade
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
cpf
string
/^(\d{11}|\d{3}\.\d{3}\.\d{3}-\d{2})$/
rg
string
0 <= 20 characters /^[\d.\-A-Za-z]+$/
estadoCivil
string
Allowed values: SOLTEIRO CASADO DIVORCIADO VIUVO UNIAO_ESTAVEL
telefone
string
0 <= 20 characters /^[\d\s\-().+]+$/
emailPessoal
string format: email
0 <= 255 characters
emailCorporativo
string format: email
0 <= 255 characters
linkedin
string
0 <= 500 characters /^(https?://)?[\w\-.]+(:\d+)?(/[\w\-./?%&=@#]*)?$/
endereco
string
0 <= 500 characters /^[\p{L}\p{N}\s\-.,;:/°ºª()]+$/
codigoFuncionario
string
0 <= 50 characters /^[a-zA-Z0-9\-_]+$/
codigoPosicao
string
0 <= 50 characters /^[a-zA-Z0-9\-_]+$/
tipoContrato
string
Allowed values: CLT PJ ESTAGIO TEMPORARIO TERCEIRIZADO APRENDIZ INTERMITENTE SOCIO_SERVICO AUTONOMO
dataAdmissao
string format: date-time
nivelHierarquico
string
Allowed values: ESTAGIARIO TREINEE JUNIOR PLENO SENIOR COORDENADOR GERENTE ESPECIALISTA SUPERINTENDENTE DIRETOR VICE_PRESIDENTE C_LEVEL
regimeTrabalho
string
Allowed values: INTEGRAL PARCIAL PRESENCIAL REMOTO HIBRIDO
horarioTrabalho
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
beneficios
string
0 <= 1000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
pis
string
/^\d{11}$/
ctps
string
0 <= 30 characters /^[\d.\-/]+$/
nis
string
0 <= 20 characters /^[a-zA-Z0-9]+$/
informacoesSaude
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
fotoUrl
string
0 <= 500 characters /^(https?://)?[\w\-.]+(:\d+)?(/[\w\-./?%&=@#]*)?$/
idiomas
Array<string>
enviarEmail
boolean
nomeSocial
string
0 <= 255 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
apelido
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
naturalidade
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
estadoNatal
string
0 <= 2 characters /^[A-Z]{2}$/
fumante
boolean
corRaca
string
Allowed values: BRANCA PRETA PARDA AMARELA INDIGENA NAO_INFORMADO
tipoSanguineo
string
Allowed values: A_POSITIVO A_NEGATIVO B_POSITIVO B_NEGATIVO AB_POSITIVO AB_NEGATIVO O_POSITIVO O_NEGATIVO
grauInstrucao
string
Allowed values: ANALFABETO FUNDAMENTAL_ATE_5_ANO_INCOMPLETO FUNDAMENTAL_5_ANO_COMPLETO FUNDAMENTAL_6_AO_9_ANO FUNDAMENTAL_COMPLETO MEDIO_INCOMPLETO MEDIO_COMPLETO SUPERIOR_INCOMPLETO SUPERIOR_COMPLETO POS_GRADUACAO_INCOMPLETA POS_GRADUACAO_COMPLETA MESTRADO_INCOMPLETO MESTRADO_COMPLETO DOUTORADO_INCOMPLETO DOUTORADO_COMPLETO POS_DOUTORADO_INCOMPLETO POS_DOUTORADO_COMPLETO
cep
string
0 <= 9 characters /^(\d{8}|\d{5}-\d{3})$/
logradouro
string
0 <= 255 characters /^[\p{L}\p{N}\s\-.,;:/°ºª()]+$/
enderecoNumero
string
0 <= 20 characters /^[a-zA-Z0-9]+$/
complemento
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
bairro
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
cidade
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
enderecoUf
string
0 <= 2 characters /^[A-Z]{2}$/
pais
string
0 <= 100 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
telefone2
string
0 <= 20 characters /^[\d\s\-().+]+$/
telefone3
string
0 <= 20 characters /^[\d\s\-().+]+$/
ramal
string
0 <= 10 characters /^$|^\d+$/
rgOrgaoEmissor
string
0 <= 20 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
rgUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
rgDataEmissao
string format: date-time
tituloEleitor
string
0 <= 12 characters /^\d{12}$/
tituloEleitorZona
string
0 <= 10 characters /^[a-zA-Z0-9]+$/
tituloEleitorSecao
string
0 <= 10 characters /^[a-zA-Z0-9]+$/
tituloEleitorDataEmissao
string format: date-time
tituloEleitorUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
ctpsSerie
string
0 <= 20 characters /^[\d.\-/]+$/
ctpsDataEmissao
string format: date-time
ctpsUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
ctpsDigital
boolean
cnh
string
0 <= 20 characters /^[a-zA-Z0-9]+$/
cnhCategoria
string
Allowed values: A B C D E AB AC AD AE
cnhDataEmissao
string format: date-time
cnhDataVencimento
string format: date-time
cnhOrgaoEmissor
string
0 <= 20 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
cnhDataPrimeira
string format: date-time
cnhUfEmissor
string
0 <= 2 characters /^[A-Z]{2}$/
certReservista
string
0 <= 30 characters /^[a-zA-Z0-9]+$/
categoriaMilitar
string
0 <= 30 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
circunscricaoMilitar
string
0 <= 30 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
regiaoMilitar
string
0 <= 30 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
certReservistaDataEmissao
string format: date-time
certReservistaOrgaoExpedicao
string
0 <= 50 characters /^[\p{L}\p{N}\s\-.,()'’]+$/
situacaoMilitar
string
Allowed values: RESERVISTA DISPENSADO ALISTADO NAO_SE_APLICA EXCESSO_CONTINGENTE REFORMADO
matriculaEsocial
string
0 <= 30 characters
codCategoria
string
tipoRegimeTrabalhista
string
tipoRegimePrevidenciario
string
tipoAdmissao
string
indicativoAdmissao
string
naturezaAtividade
string
tipoRegimeJornada
string
defFisica
boolean
defVisual
boolean
defAuditiva
boolean
defMental
boolean
defIntelectual
boolean
reabilitadoReadaptado
boolean
preencheCotaPcd
boolean
observacaoDeficiencia
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
municipioId
integer format: int64
municipioDescricao
string
tipoLogradouro
string
sexoEsocial
string
grauInstrucaoEsocial
string
paisNascimento
string
paisNacionalidade
string
tipoContratoPrazo
string
dataTerminoContrato
string format: date-time
clausulaAssecuratoria
boolean
objetoDeterminante
string
0 <= 255 characters
tipoJornadaEsocial
string
tempoParcial
string
horasSemanais
number
horarioNoturno
boolean
descricaoJornada
string
0 <= 999 characters
dataOpcaoFgts
string format: date-time
esocialReciboAdmissao
string
0 <= 40 characters
tipoRua
string
tipoBairro
string
tipoFuncionarioTotvs
string
fichaRegistroTotvs
string
tipoAdmissaoTotvs
string
motivoAdmissaoTotvs
string
motivoMudancaTotvs
string
tipoRecebimentoTotvs
string
situacaoTotvs
string
jornadaMensalTotvs
string
horarioTotvs
string
letraHorarioTotvs
string
sindicatoTotvs
string
contribuicaoSindicalTotvs
string
ocorrenciaSefipTotvs
string
categoriaSefipTotvs
string
situacaoFgtsTotvs
string
situacaoRaisTotvs
string
calculaInssTotvs
boolean
calculaIrrfTotvs
boolean
percentualAdiantamentoTotvs
number
desligado
boolean
dataDesligamento
string format: date-time
motivoDesligamento
string
Allowed values: DEMISSAO_SEM_JUSTA_CAUSA DEMISSAO_COM_JUSTA_CAUSA PEDIDO_DEMISSAO ACORDO_MUTUO TERMINO_CONTRATO APOSENTADORIA FALECIMENTO TRANSFERENCIA_EMPRESA OUTRO
observacaoDesligamento
string
0 <= 2000 characters /^[\p{L}\p{N}\s\-.,;:!?()\[\]{}'"/\\@#$%&*+=°ºª|~^`´\r\n]+$/
dataAprovacao
string format: date-time
justificativa
string
motivoReprovacao
string
pendente
boolean
aprovada
boolean

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade

© 2026 T AI TECNOLOGIA LTDA