Histórico da Página
...
Atributos | Descrição | Tamanho | Tipo | Chave Primária | Requerido | Valor Default | Valores Válidos | Observação |
id | Id único para rastreamento do registro de ponta a ponta | 12 | NUMBER | S | N | - | - | Gerado automaticamente quando o registro é inserido na tabela. |
codigoEmpresa | Código da empresa | 2 | NUMBER | N | N | - | Empresa cadastrada | Caso não informada será atribuído o código da empresa padrão configurado em default-company-ind. |
codigoEmpresaERP | Código da empresa no ERP | 5 | STRING | N | N | - | - | - |
codigoProntuarioSocial | Código do prontuário social | 10 | STRING | N | S | - | - | - |
codigoCracha | Código do crachá | 12 | STRING | N | N | - | - | - |
nome | Nome do funcionário | 40 | STRING | N | S | - | - | - |
apelido | Apelido do funcionário | 10 | STRING | N | N | - | - | - |
dataAdmissao | Data de admissão | 10 | DATE | N | S | - | - | - |
dataDemissao | Data de demissão | 10 | DATE | N | N | - | - | - |
tipoMaoObra | Tipo de mão de obra | 1 | STRING | N | N | "I" | I = Interna E = Externa | - |
quantidadePessoas | Quantidade de pessoas | 4 | NUMBER | N | N | "1" | - | Acatado somente quando tipoMaoObra = "E" |
atividadePrincipal | Atividade principal | 1 | STRING | N | N | "M" | M = Manutenção O = Operação | - |
idQualificacao | Id da qualificação do funcionário | 10 | NUMBER | N | N | - | Qualificação cadastrada | - |
controlaMaoObraPeloSistema | Controla mão de obra pelo sistema | 1 | STRING | N | N | "1" | 1 = Sim 0 = Não | - |
numeroCelular | Número do celular | 15 | STRING | N | N | - | - | - |
50 | STRING | N | N | - | - | - | ||
idSubCentroCusto | Id do sub-centro de custo | 12 | NUMBER | N | N | - | Sub-Centro de Custo cadastrado para a empresa informada | - |
codigoChipCartao | Código do chip de cartão de ponto | 20 | STRING | N | N | - | - | - |
senhaAcesso | Senha de acesso | 60 | STRING | N | N | - | - | - |
...
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
{
"hasNext": truefalse,
"items": [
{
"codigoEmpresa": 1,
"id": 213745,
"codigoProntuarioSocial": "91000",
"codigoCracha": "91000",
"codigoErpnome": null"FUNCIONÁRIO 91000",
"descricaoapelido": "AJUSTADOR MECANICONOME 91000",
"dataAdmissao": "2025-08-01T00:00:00",
"detalhedataDemissao": null,
"utilizadoIndustriatipoMaoObra": "NI",
} "quantidadePessoas": 1,
{ "atividadePrincipal": "M",
"ididQualificacao": 3null,
"codigoErpcontrolaMaoObraPeloSistema": null"1",
"descricaonumeroCelular": null,
"ALMOXARIFEemail": null,
"detalheidSubCentroCusto": null,
"utilizadoIndustriacodigoChipCartao": "N""CHIP123456",
"senhaAcesso": null
}
]
} |
Parâmetros
- page: Número da página.
- pagesize: Quantidade máxima de registros por página.
...
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"codigoErpcodigoProntuarioSocial": "CARGO-000391000",
"descricaoemail": "ANALISTA DE SISTEMAS SR. III",
"detalhe": "Pessoa responsável por analistar e implementar soluções tecnológicas para resolução dos problemas[email protected]"
} |
Estrutura de dados retorno:
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"codigoErpcodigoProntuarioSocial": "CARGO-000391000",
"descricaoemail": "ANALISTA DE SISTEMAS SR. III[email protected]",
"detalhe": "Pessoa responsável por analistar e implementar soluções tecnológicas para resolução dos problemas",
"id": "1002813745"
} |
Observações
- Quando PATCH poderão ser informados apenas os atributos que necessitam de atualização.
- No caso de PUT deverão ser informados os atributos necessários bem como os obrigatórios.
- Deverá ser informado ao menos um dos atributos para localização da Qualificação do Funcionário (id ou codigoErp codigoProntuarioSocial).
- Caso os dois atributos id e codigoErp codigoProntuarioSocial forem informados, será considerado apenas o atributo id para localização da qualificaçãodo funcionário. Será realizada uma busca por outras qualificações outros funcionários com IDs diferentes que utilizem o codigoErp codigoProntuarioSocial informado e caso nenhuma qualificação nenhum funcionário seja encontrada encontrado o valor informado será alterado, e caso seja encontrada uma encontrado um ou mais qualificações funcionários com IDs diferentes já utilizando este codigoErp codigoProntuarioSocial uma mensagem será exibida e a alteração não será realizada.
- Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado.
- Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
- Caso o atributo codigoCracha seja apenas o atributo codigoErp for informado, será realizada uma busca pelas qualificações por outros funcionários que utilizem esse código e caso sejam encontradas duas ou mais qualificações utilizando este codigoErp nenhum funcionário for encontrado a alteração será realizada, e caso seja encontrado um ou mais funcionários utilizando esse codigoCracha uma mensagem será exibida e a alteração não será realizada.
- Caso o atributo descricao for codigoChipCartao seja informado, será realizada uma busca por outras qualificações com IDs diferentes outros funcionários que utilizem a descricao informada e caso nenhuma qualificação seja encontrada o valor informado será alteradoesse código e caso nenhum funcionário for encontrado a alteração será realizada, e caso seja encontrada uma encontrado um ou mais qualificações com IDs diferentes já utilizando essa descricao funcionários utilizando esse codigoChipCartao uma mensagem será exibida e a alteração não será realizada.
- Caso o atributo dataDemissao seja informado ele não poderá ser menor que o atributo dataAdmissao.
- Caso o atributo tipoMaoObra seja informado com valor "E" (mão de obra externa), o atributo quantidadePessoas não poderá ser menor ou igual a zero.
POST (Insere Funcionário)
...
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"codigoEmpresa": null,
"codigoEmpresaERP": 1,
"codigoProntuarioSocial": "91000",
"codigoCracha": "91000",
"nome": "Funcionário 91000",
"apelido": "NOME 91000",
"codigoErpdataAdmissao": "CARGO-0003"2025-08-01T00:00:00",
"dataDemissao": null,
"descricaotipoMaoObra": "ANALIST. DE SIST. SR. III"null,
"quantidadePessoas": null,
"atividadePrincipal": null,
"idQualificacao": null,
"controlaMaoObraPeloSistema": null,
"detalheidSubCentroCusto": null,
"sem detalhescodigoChipCartao": "CHIP123456"
} |
Estrutura de dados retorno:
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"codigoEmpresa": "1",
"codigoProntuarioSocial": "91000",
"codigoCracha": "91000",
"nome": "FUNCIONÁRIO 91000",
"codigoErpapelido": "NOME 91000",
"dataAdmissao": "CARGO-0003"2025-08-01T00:00:00",
"dataDemissao": null,
"tipoMaoObra": "I",
"quantidadePessoas": 1,
"descricaoatividadePrincipal": "ANALIST. DE SIST. SR. III"M",
"idQualificacao": null,
"detalhecontrolaMaoObraPeloSistema": "sem detalhes"1",
"idSubCentroCusto": null,
"utilizadoIndustriacodigoChipCartao": "NCHIP123456",
"id": "1002813741"
} |
Observações
- Caso os atributos codigoEmpresa e codigoEmpresaERP não forem informados, será utilizado como default o valor definido no parâmetro default-company-ind.
- Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado.
- Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
- O atributo id será gerado automaticamente e atribuído à nova qualificaçãoao novo funcionário, e caso seja informado será desconsiderado.
- O atributo codigoProntuarioSocial deverá ser informado. Será realizada uma busca por outros funcionários que utilizem esse código e caso nenhum funcionário for encontrado a inclusão será realizada, e caso seja encontrado um ou mais funcionários utilizando esse codigoProntuarioSocial uma mensagem será exibida e a inclusão não será realizada.
- Caso o atributo codigoCracha seja Caso o atributo codigoErp for informado, será realizada uma busca por outras qualificações outros funcionários que utilizem esse código e caso seja encontrada uma ou mais qualificações já utilizando este codigoErp nenhum funcionário for encontrado a inclusão será realizada, e caso seja encontrado um ou mais funcionários utilizando esse codigoCracha uma mensagem será exibida e a inclusão não será realizada.O
- atributo descricao deverá ser informado. Será Caso o atributo codigoChipCartao seja informado, será realizada uma busca por outras qualificações outros funcionários que utilizem essa descrição esse código e caso nenhuma qualificação seja encontrada nenhum funcionário for encontrado a inclusão será realizada, e caso seja encontrada uma encontrado um ou mais qualificações já utilizando essa descricao funcionários utilizando esse codigoChipCartao uma mensagem será exibida e a inclusão não será realizada.
- Caso o atributo dataDemissao seja informado ele não poderá ser menor que o atributo dataAdmissao.
- Caso o atributo tipoMaoObra seja informado com valor "E" (mão de obra externa), o atributo quantidadePessoas não poderá ser menor ou igual a zero.
DELETE (Exclui Funcionário)
...
- Deverá ser informado ao menos um dos atributos para localização da Qualificação do Funcionário (id ou codigoErp).Caso seja informado apenas o atributo codigoErp, será realizada uma busca pelas qualificações que utilizem esse código e caso sejam encontradas duas ou mais qualificações utilizando este codigoErp uma mensagem será exibida e a deleção não será realizada codigoProntuarioSocial).
- Caso os dois atributos id e codigoErp codigoProntuarioSocial forem informados, será considerado apenas o atributo id para localização e exclusão da qualificação do funcionário e o codigoErp codigoProntuarioSocial será desconsiderado.
- Caso o registro da qualificação do funcionário esteja sendo utilizado por registros de outras tabelas relacionadas a exclusão não será realizada e uma mensagem será exibida.
...