Inclusão de Funcionário
POST/funcionarios
Envie um objeto JSON na raiz do body, sem envelope data. POST indica inclusão, PUT alteração e DELETE exclusão. A query opcional operacao=N indica operação não definida. Envie os dados em JSON. No PUT, subcontratos existentes que não constarem da lista enviada serão excluídos. O resultado de cada subcontrato é informado separadamente.
Request
Query Parameters
- application/json
- Body
- exemplo
Body
required
Array [
]
subcontratos
object[]
nullable
POST inclui; PUT compara com contratos existentes e exclui os que não estiverem na lista enviada. A resposta principal não agrega o sucesso dos subcontratos.
Exemplo de requisição
{
"codEmpresa": "EMP01",
"matricula": 1001,
"nomeFuncionario": "João da Silva",
"nomeReduzido": "João Silva",
"sexo": "M",
"dataNascimento": "1990-01-15",
"dataAdmissao": "2023-03-01",
"cpf": 12345678901,
"nroPis": 12345678901,
"email": "[email protected]",
"codTipoCalculo": 1,
"tipoSalario": "M",
"controlaPonto": "S",
"compensacao": "N",
"temporario": "N",
"tipoPessoa": 1,
"codHorarioTrabalho": 100,
"subcontratos": []
}
Responses
- 200
- 400
Resultado do funcionário e de seus subcontratos. Verifique success no resultado principal e em cada subcontrato.
- application/json
- Schema
- Example (from schema)
- sucesso
- naoCadastrado
- subcontratoFalhou
Schema
- FuncionarioResponse
- ParametroInvalidoResponse
Array [
]
anyOf
subcontratos
object[]
errors
object
required
{}
Exemplo de resultado
{
"success": true,
"seqRegistro": 128027,
"observacao": null
}
Exemplo de resultado
{
"success": false,
"seqRegistro": null,
"observacao": "FUNCIONARIO NAO CADASTRADO"
}
Exemplo de resultado
{
"success": true,
"seqRegistro": 128027,
"observacao": null,
"subcontratos": [
{
"success": false,
"seqRegistro": null,
"observacao": "Mensagem de erro retornada pelo processamento."
}
]
}
Empresa ausente ou inválida quando a integração por empresa da folha estiver habilitada.
- application/json
- Schema
- Example (from schema)
- empresaAusente
Schema
{
"message": "string"
}
Exemplo de resultado
{
"message": "Operação Negada. Parâmetro codEmpresa ausente na requisição."
}