Páginas filhas
  • API Funcionários (Manutenção Industrial)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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

-

-

-

email

E-mail

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
languagejava
titleResponse
{
    "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
languagejava
titleBody
collapsetrue
{
    "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
languagejava
titleResponse
collapsetrue
{
    "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
languagejava
titleBody
collapsetrue
{
    "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
languagejava
titleResponse
collapsetrue
{     
    "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.

...