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
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",
    "detalhe": "Pessoa responsável por analistar e implementar soluções tecnológicas para resolução dos problemas[email protected]",
    "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 apenas o atributo codigoErp for codigoCracha seja 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 e caso 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
titleResponse
collapsetrue
{     
    "codigoEmpresa": "1",
    "codigoProntuarioSocial": "91000",
    "codigoCracha": "91000",
    "nome": "FUNCIONÁRIO 91000",
    "apelido": "NOME 91000",
    "dataAdmissao": "2025-08-01T00:00:00",
    "dataDemissao": null,
    "tipoMaoObra": "I",
    "quantidadePessoas": 1,
    "atividadePrincipal": "M",
    "idQualificacao": null,
    "controlaMaoObraPeloSistema": "1",
    "idSubCentroCusto": null,
    "codigoChipCartao": "CHIP123456",
    "id": "13741" }

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 nenhum funcionário for encontrado a inclusão será realizada, e caso seja encontrada uma encontrado um ou mais qualificações já utilizando este codigoErp 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)

...