Incluir/atualizar registro

POST 
/gestorFuncionario

Realiza a inclusão/atualização de um ou mais registros na tabela GESTORES_FUNCIONARIOS, considerando a chave para atualização codEmpresa e matricula. Sempre que forem enviados dados do(s) Gestor(es) de um Funcionário, os dados anteriores deste mesmo funcionário serão substituídos pelos novos enviados.

Identificadores são requisitos operacionais para localizar os vínculos; o serviço pode processar pendências de cadastro antes de salvar. dataInicial é obrigatória no domínio, dataFinal é opcional. A chamada substitui os gestores anteriores dos funcionários enviados.

Request

application/json

Body

Body

required

Corpo JSON; os campos não são parâmetros de URL.

data

object[]

required

Lista de registros. Envie ao menos um registro para executar a operação.

Array [

]

minimo

Payload mínimo ilustrativo

{
  "data": [
    {
      "codEmpresa": "1000",
      "matricula": 900001,
      "codEmpresaGestor": "1000",
      "matriculaGestor": 900002,
      "dataInicial": "2026-01-15"
    }
  ]
}

completo

Payload completo ilustrativo

{
  "data": [
    {
      "codEmpresa": "1000",
      "matricula": 900001,
      "codEmpresaGestor": "1000",
      "matriculaGestor": 900002,
      "dataInicial": "2026-01-15",
      "dataFinal": "2026-12-31"
    }
  ]
}

Responses

200

Sucesso

application/json

Schema

Schema

success booleanrequired
message stringnullable
data object[]nullable

Example (from schema)

{
  "success": true,
  "message": "string",
  "total": 0,
  "data": [
    {}
  ]
}

sucesso

Sucesso ilustrativo

{
  "success": true,
  "message": null,
  "total": 1,
  "data": null
}

400

O serviço retornou success false. PUT sem IDs existentes, dependentes sem sucesso, ou falha tratada na consulta de ocorrências. Não representa todas as falhas de validação.

application/json

Schema

Schema

success booleanrequired
message stringnullable
data object[]nullable

Example (from schema)

{
  "success": true,
  "message": "string",
  "total": 0,
  "data": [
    {}
  ]
}

semProcessamento

Resultado negativo do serviço, ilustrativo

{
  "success": false,
  "message": null,
  "total": 0,
  "data": null
}

401

Nao autorizado

application/json

Schema

Schema

property name* any

Example (from schema)

{}

ilustrativo

Exemplo legado, dependente do serviço de autenticação

{
  "success": false,
  "message": "Authorization expirado ou inexistente."
}

500

Exceção no binding, validação ou processamento. Pode ocorrer ao faltar campo obrigatório. Mensagem/cause dependem da exceção.

application/json

Schema

Schema

message stringnullablerequired

Example (from schema)

{
  "success": false,
  "message": "string"
}

excecao

Exceção ilustrativa; mensagem depende do erro

{
  "success": false,
  "message": "Falha ao processar a requisição."
}

Loading...