Guia de uso das APIs

Seja bem-vindo! A partir de agora, você pode explorar este ambiente que permite seu acesso às
informações do Sistema Integrado de Recursos Humanos da Metadados.

Implementação

Nesta etapa, o cliente deverá entrar em contato com a Metadados para execução do processo de instalação da API do Sistema. Em seguida, o cliente precisará publicar o Banco de Dados do Sistema para uma lista específica de IPs que será enviado pela nossa equipe por e-mail.

Após a publicação do banco de dados para os IPs listados, é necessário que o cliente forneça as seguintes informações para a equipe Metadados:

  • Tipo de Base (SQL Server ou Oracle)
  • Host (IP externo para acesso ao banco - não pode ser o DNS)
  • Porta (Porta de acesso externo)
  • Instância (Onde se encontra o banco de dados - caso houver)
  • Database (Nome do banco de dados)
  • Usuário (Usuário para acesso ao banco)
  • Senha (Senha do usuário)

Após fornecer esses dados, a equipe irá criar um acesso exclusivo para o cliente na plataforma de API e, então, enviará para o cliente o token para ser utilizado nas consultas dos recursos da API.

Observações:

Caso deseje utilizar os recursos do PortalRH, é necessária a realização de uma configuração à parte, conforme descrita no link: https://www.metadados.com.br/documentacaoAPIPortalRH

Clientes SaaS não precisam realizar a publicação do banco de dados, pois a mesma é efetuada pela TI da Metadados.

Após a entrega do token para o cliente, é de responsabilidade do mesmo a distribuição e utilização deste. É importante lembrar que a API possui recursos que retornam dados sensíveis como salários, CPFs, entre outros.

 

Autenticação

A autenticação das APIs é realizada com a informação de token no cabeçalho (header) das requisições. Esse token é gerado a partir da criptografia em Base 64 de [Client ID]:[Client Secret]. Sua geração ocorre no momento da criação da APP pela Metadados.

 

Status Codes

Código Erro Descrição
200 OK

Sucesso.

400 Bad Request

A requisição possui parametro(s) inválido(s).

401 Unauthorized

O token de acesso não foi informado ou não possui acesso as APIs.

404 Not Found

O recurso informado no request não foi encontrado.

413 Request is to Large

A requisição está ultrapassando o limite permitido para o perfil do seu token de acesso.

422 Unprocessable Entity

A requisição possui erros de negócio.

429 Too Many Requests

O consumidor estourou o limite de requisições por tempo.

500 Internal Server Error

Erro não esperado, algo está quebrado na API.

Número Máximo de Registros

A API hoje retorna até 100 registros por chamadas, retornando um objeto vazio {} em chamadas que ultrapassassem esse limite. Portanto, para um melhor desempenho, recomendamos a utilização dos parâmetros offset e limit nos recursos onde estes estão disponíveis.

 

1. Colaboradores

1.1 /contratos

Campos retornados no recurso contratos.

Campo Formato Tamanho Descrição
empresa character 4 Código da Empresa, ref. /empresas
descricaoempresa character 20 Descrição da Empresa
pessoa numérico 8 Código da Pessoa
nome character 40 Nome da Pessoa
sexo character 1

Sexo:

  • M - Masculino
  • F - Feminino
cpf character 11 CPF da Pessoa
emailcorporativo character 80 E-mail Corporativo da Pessoa
unidade character 4 Código da Unidade, ref. /unidades
estabelecimento character 4 Código do Estabelecimento, ref. /estabelecimentos
razaosocialestabelecimento character 40 Razão Social do Estabelecimento
descricaodoestabelecimento character 20 Descrição do Estabelecimento
contrato numérico 8 Código do Contrato
cracha character 12 Crachá do Contrato
dataadmissao datetime 8 Data de Admissão do Contrato
datarescisao datetime 8 Data de Rescisão do Contrato
terminocontrato datetime 8 Data de Término do Contrato
situacao character 1

Situação do Contrato:

  • 1 - Ativo
  • 2 - Afastado
  • 3 - Rescindido no mês
  • 4 - Rescindido em meses anteriores
dataultimoafastamento character 30 Data do Último Afastamento do Contrato
causaafastamento character 1

Causa do Afastamento:

  • 1 - Acidente de Trabalho
  • 2 - Doença
  • 3 - Licença-gestante
  • 4 - Licença-prêmio
  • 5 - Serviço Militar
  • 6 - Licença sem remuneração
  • 9 - Outras causas
dataultimoretorno datetime 8 Data do Último Retorno do Contrato
dataultimatransferencia datetime 8 Data da Última Transferência do Contrato
dataultimaalteracaocontrato datetime 8 Data da Última Alteração no Contrato
tiposalario character 1

Tipo Salário:

  • 1 - Mensal
  • 2 - Por Quinzena
  • 3 - Por Semana
  • 4 - Por Dia
  • 5 - Por Hora
  • 6 - Por Tarefa
  • 7 - Outros
salariocontratual decimal 11,2 Salário Contratual do Contrato
horascontratuais decimal 5,2 Horas Contratuais do Contrato
cargo character 8 Código do Cargo, ref. /cargos
descricaocargo character 40 Descrição do Cargo
funcao character 8 Código da Função, ref. /funcoes
descricaofuncao character 40 Descrição da Função
escala character 4 Código da Escala de Horários, ref. /escalas
descricaoescala character 40 Descrição da Escala de Horários
centrocusto1 character 8 Código do Centro de Custo Nível 1, ref. /centrosCusto
descricaocentrocusto1 character 40 Descrição do Centro de Custo Nível 1
centrocusto2 character 8 Código do Centro de Custo Nível 2, ref. /centrosCusto2
descricaocentrocusto2 character 40 Descrição do Centro de Custo Nível 2
centrocusto3 character 8 Código do Centro de Custo Nível 3, ref. /centrosCusto3
descricaocentrocusto3 character 40 Descrição do Centro de Custo Nível 3
centrocusto4 character 8 Código do Centro de Custo Nível 4, ref. /centrosCusto4
descricaocentrocusto4 character 40 Descrição do Centro de Custo Nível 4
postotrabalho character 8 Código do Posto de Trabalho
descricaopostotrabalho character 40 Descrição do Posto de Trabalho
setor character 8 Código do Setor, ref. /setores
descricaosetor character 40 Descrição do Setor
classificacaocontabil character 8 Código da Classificação Contábil
descclassificacaocontabil character 40 Descrição da Classificação Contábil
classificacaogerencial character 8 Código da Classificação Gerencial
descclassificacaogerencial character 40 Descrição da Classificação Gerencial
unidadeclassificacaogerencial character 4 Unidade da Classificação Gerencial
contratoclassificacaogerencial numérico 8 Contrato da Classificação Gerencial

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/contratos?offset=0&limit=10&unidade=0001&contrato=14&email=suporte@metadados.com.br&cpf=48380046187&dataAlteracao=2020-08-01


Query Params:

unidade
contrato
email
cpf
dataRescisao (Obtém os rescindidos a partir da data enviada)
ativo (true: retorna somente contratos ativos; false: retorna somente contratos rescindidos e/ou afastados)
situacao
dataAlteracao (Obtém os contratos alterados a partir da data enviada)
offset
limit

Operação: GET

Formato Retorno: JSON

1.2 /dadosPessoais

Campos retornados no recurso dadosPessoais.

Campo Formato Tamanho Descrição
empresa character 4 Código da Empresa, ref. /empresas
pessoa numérico 8 Código da Pessoa, ref. /contratos
nome character 40 Nome da Pessoa
pai character 40 Nome do Pai da Pessoa
mae character 40 Nome da Mãe da Pessoa
nascimento datetime 8 Data de Nascimento da Pessoa
localnascimento character 20 Cidade de Nascimento da Pessoa
ufnascimento character 2 UF de Nascimento da Pessoa
sexo character 1

Sexo:

  • M - Masculino
  • F - Feminino
racacor character 1

Raça/Cor:

  • 1 - Indígena
  • 2 - Branca
  • 4 - Preta
  • 6 - Amarela
  • 8 - Parda
  • 9 - Não Informada
deficientefisico character 1

Deficiente Físico:

  • 0 - Não Deficiente
  • 1 - Deficiente Físico
  • 2 - Deficiente Auditivo
  • 3 - Deficiente Visual
  • 4 - Deficiente Mental (Intelectual)
  • 5 - Deficiente Múltiplo
estudando character 1 Estudando:
  • S - Sim
  • N - Não
ddd character 4 DDD da Pessoa
telefone character 15 Telefone da Pessoa
ramal character 4 Ramal da Pessoa
dddcelular character 4 DDD Celular da Pessoa
telefonecelular character 15 Telefone Celular da Pessoa
email character 80 E-mail da Pessoa
nrocarttrab character 10 Número da CTPS da Pessoa
seriecarttrab character 5 Série da CTPS da Pessoa
datacarttrab datetime Data da CTPS da Pessoa 
ufcarttrab  character  2 UF da CTPS da Pessoa 
pis character 11  Número do PIS da Pessoa
datapis datetime 8 Data do PIS da Pessoa
cpf character 11 CPF da Pessoa
tipoidentidade character 2

Tipo da Identidade:

  • RE
  • RG
identidade character 15 Identidade da Pessoa
dataidentidade datetime 8 Data da Identidade da Pessoa
orgaoemissoridentidade character 8 Orgão Emissor da Identidade da Pessoa
tituloeleitoral character 15 Título Eleitoral da Pessoa
zonaeleitoral character 4 Zona Eleitoral da Pessoa
secaoeleitoral character 4 Seção Eleitoral da Pessoa
tiposanguineo character 3

Tipo Sanguineo:

  • A+
  • A-
  • AB+
  • AB-
  • B+
  • B-
  • O+
  • O-
estadocivil character 2

Estado Civil:

  • 01 - Solteiro
  • 02 - Casado
  • 03 - Viúvo
  • 04 - Separado
  • 05 - Divorciado
  • 06 - União Estável Solteiro
  • 07 - União Estável Divorciado
  • 08 - União Estável Viúvo
grauinstrucao character 2

Grau de Instrução:

  • 01 - Analfabeto
  • 02 - Até o 5º Ano Incompleto do Ensino Fundamental
  • 03 - 5º Ano Completo do Ensino Fundamental
  • 04 - Do 6º ao 9º Ano do Ensino Fundamental
  • 05 - Ensino Fundamental Completo
  • 06 - Ensino Médio Incompleto
  • 07 - Ensino Médio Completo
  • 08 - Técnico
  • 09 - Educação Superior Incompleta
  • 10 - Educação Superior Completa
  • 11 - Pós-Graduação
  • 12 - Mestrado
  • 13 - Doutorado
nacionalidade character 2 Código da Nacionalidade da Pessoa
sindicato character 4 Código Sindicato da Pessoa, ref. /sindicatos
emailcorporativo character 80 E-mail Corporativo da Pessoa
reservista character 20 Certificado de Reservista da Pessoa
registrohabilitacao character 15 Registro da Habilitação da Pessoa
validadehabilitacao datetime 8 Data de Validade da Habilitação da Pessoa
categoriahabilitacao character 3 Categoria da Habilitação da Pessoa
dataultimaalteracaopessoa datetime 8 Data da Última Alteração na Pessoa

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/dadosPessoais?empresa=0001&pessoa=298&offset=0&limit=100&dataAlteracao=2020-08-01


Query Params:

empresa
pessoa
dataAlteracao (Obtém as pessoas alteradas a partir da data enviada)
offset
limit

Operação: GET

Formato Retorno: JSON

 

1.3 /enderecos

Campos retornados no recurso endereços.

Campo Formato Tamanho Descrição
complemento character 20 Complemento (endereço)
contrato character 8 Código do Contrato, ref. /contratos
empresa character 4 Código da Empresa, ref. /empresas
cep character 10 CEP
pessoa numérico 8 Código da Pessoa, ref. /contratos
nrorua character 8 Número (endereço)
uf character 2 UF
bairro character 20 Bairro
cpf character 11 CPF
nome character 40 Nome da Pessoa
cidade character 20 Cidade
unidade character 4 Código da Unidade, ref. /unidades
rua character 40 Rua (endereço)

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/enderecos?offset=0&limit=10&empresa=0001&pessoa=10020007&unidade=1003&contrato=16&email=suporte@metadados.com.br&cpf=48380046187


Query Params:

empresa
pessoa
unidade
contrato
email
cpf
offset
limit

Operação: GET

Formato Retorno: JSON

 

1.4 /dadosComplementaresContrato

Campos retornados no recurso dados complementares do contrato.

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato numérico 8 Código do Contrato, ref. /contratos
variavel character 4 Código da Variável
variaveldescricao character 40 Descrição da Variável
valor indefinido * Valor da Variável


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/dadosComplementaresContrato?unidade=0001&contrato=298&variavel=OP12&descricao=Cor do Olho&valor=A&offset=0&limit=100


Query Params:

unidade
contrato
variavel
descricao
valor
offset
limit

Operação: GET

Formato Retorno: JSON

 

2. Empresas

2.1 /empresas

Campos retornados no recurso empresas:

Campo Formato Tamanho Descrição
empresa character 4 Código da Empresa
razaoempresa character 40 Razão Social da Empresa
descricaoempresa character 20 Descrição da Empresa


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/empresas?empresa=0001


Query Params:

empresa
offset
limit

 

Operação: GET

Formato Retorno: JSON

 

2.2 /unidades

Campos retornados no recurso unidades:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade
descricao character 40 Descrição da Unidade
ativa character 1 Ativa/Desativada
empresa character 4 Código da Empresa
razaoempresa character 40 Razão Social da Empresa
descricaoempresa character 20 Descrição da Empresa


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/unidades?unidade=0001


Query Params:

unidade
offset
limit

Operação: GET

Formato Retorno: JSON

 

2.3 /estabelecimentos

Campos retornados no recurso estabelecimentos:

Campo Formato Tamanho Descrição
estabelecimento character 4 Código do Estabelecimento
razaosocial character 40 Razão Social do Estabelecimento
descricao character 20 Descrição do Estabelecimento
tipoinscricao character 1

Tipo de Inscrição:

  • 1 - CNPJ
  • 2 - CEI
  • 3 - CPF
  • 4 - CAEPF
  • 5 - CNO
inscricao character 16 Inscrição do Estabelecimento
tipologradouro character 4 Código do Tipo de Logradouro
rua character 40 Rua
nrorua character 8 Número da Rua
bairro character 20 Bairro
complemento character 20 Complemento
cep character 10 CEP
cidade character 20 Cidade
codigoibge character 8 Código do Município para o IBGE
uf character 2 Estado (UF)
ddd character 4 DDD
telefone character 15 Telefone
ramal character 4 Ramal
dddfax character 4 DDD do Fax
telefonefax character 15 Telefone do Fax
ramalfax character 4 Ramal do Fax
email character 80 E-mail
ativadesativada character 1

Ativo:

  • 1 - Ativa
  • 2 - Desativada
cpfresponsavel character 11 CPF do Responsável
cargoresponsavel character 40 Descrição do Cargo do Responsável
desccalendario character 40 Descrição do Calendário
cnae character 7 CNAE
graurisco character 1 Grau 1, 2, 3 ou 4
empresa character 4 Empresa a qual o estabelecimento faz parte
sindicato character 4 Sindicato vinculado ao estabelecimento
razaoempresa character 40 Razão Social da Empresa
descricaoempresa character 20 Descrição da Empresa

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/estabelecimentos?estabelecimento=0001&cnpj=81039999/0001-85


Query Params:

estabelecimento
cnpj
offset
limit

Operação: GET

Formato Retorno: JSON

 

3. Cadastros

3.1 /bancos

Campos retornados no recurso bancos:

Campo Formato Tamanho Descrição
banco character 4 Código do Banco
descricao character 40 Descrição do Banco
formapagto character 1

Forma de Pagamento:

  • 1 - Em Espécie
  • 2 - Em Cheque
  • 3 - Documento de Compensação (DOC)
  • 4 - Depósito em CC
  • 5 - Depósito em Poupança
  • 6 - Depósito para Saque com Cartão
nrobanco character 4 Número do Banco
agencia character 20 Nome da Agência
nroagencia character 4 Número da Agência
digitoagencia character  1 Dígito da Agência
contacorrenteestpag character  15 Conta do Estabelecimento Pagador
estabelecimento character  4 Código do Estabelecimento, ref. /estabelecimentos
bancpagador character Banco Pagador:
  • S - Sim
  • N - Não

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/bancos?banco=0001&offset=0&limit=100


Query Params:

banco
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.2 /cargos

Campos retornados no recurso cargos:

Campo Formato Tamanho Descrição
cargo character 4 Código do Banco
descricao character 40 Descrição do Banco
cbo character 5 Código do CBO Antigo
cbonovo character 6 Código do CBO Novo


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/cargos?cargo=0101&offset=0&limit=100


Query Params:

cargo
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.3 /centrosCusto

Campos retornados no recurso de centros de custo 1:

Campo Formato Tamanho Descrição
centrocusto1 character 4 Código do Centro de Custo 1
descricao character 40 Descrição do Centro de Custo 1


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/centrosCusto?centrocusto=0001&ativo=true&offset=0&limit=100


Query Params:

centrocusto
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.4 /centrosCusto2

Campos retornados no recurso de centros de custo 2:

Campo Formato Tamanho Descrição
centrocusto2 character 4 Código do Centro de Custo 2
descricao character 40 Descrição do Centro de Custo 2


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/centrosCusto2?centrocusto=0001&ativo=true&offset=0&limit=100


Query Params:

centrocusto
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.5 /centrosCusto3

Campos retornados no recurso de centros de custo 3:

Campo Formato Tamanho Descrição
centrocusto3 character 4 Código do Centro de Custo 3
descricao character 40 Descrição do Centro de Custo 3


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/centrosCusto3?centrocusto=0001&ativo=true&offset=0&limit=100


Query Params:

centrocusto
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.6 /centrosCusto4

Campos retornados no recurso de centros de custo 4:

Campo Formato Tamanho Descrição
centrocusto4 character 4 Código do Centro de Custo 4
descricao character 40 Descrição do Centro de Custo 4


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/centrosCusto4?centrocusto=0001&ativo=true&offset=0&limit=100


Query Params:

centrocusto
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.7 /escalas

Campos retornados no recurso escalas:

Campo Formato Tamanho Descrição
escala character 4 Código da Escala
descricao character 40 Descrição da Escala
tipoescala character 1

Tipo Escala:

  • S - Simples
  • R - Revezamento
horassemana character 5 Horas Semanais
horasrepouso character 5 Horas de Repouso
iniciovalidade datetime 8 Data de Início da Validade
terminovalidade datetime 8 Data de Término da Validade
ultalteracao datetime 8 Data da Última Alteração


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/escalas?escala=0001&offset=0&limit=100


Query Params:

escala
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.8 /escalasSemanais

Campos retornados no recurso de escalas semanais:

Campo Formato Tamanho Descrição
escala character 4 Código da Escala
descricao character 60 Descrição da Escala
diasemana character 1

Dia da Semana:

  • 1 - Segunda
  • 2 - Terça
  • 3 - Quarta
  • 4 - Quinta
  • 5 - Sexta
  • 6 - Sábado
  • 7 - Domingo
tipodiaescala character 1

Tipo de Dia Escala:

  • C - Compensado
  • D - Dispensado
  • P - Parcialmente Compensado
  • R - Repouso
  • T - Trabalhado
horario character 4 Código do Horário
descricao40 character 40 Descrição do Horário
horarioalternativo character 2 Código do Horário Alternativo
nroordem inteiro inteiro Ordem das Marcações
classemarcacao character 2

Classe da Marcação:

  • 01 - Início Jornada
  • 03 - Início Refeição
  • 04 - Término Refeição
  • 05 - Início Lanche
  • 06 - Término Lanche
  • 07 - Início Descanso
  • 08 - Término Descanso
  • 99 - Término Jornada
tipomarcacao character 1

Tipo de Marcação

  • 1 - Fixa
  • 2 - Móvel
horamarcacao character 5 Hora de Marcação
ativadesativada character 1

Ativo:

  • 1 - Ativa
  • 2 - Desativada


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/escalasSemanais?ativo=true&offset=0&limit=100


Query Params:

ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.9 /horariosMarcacoes

Campos retornados no recurso de horários marcações:

Campo Formato Tamanho Descrição
horario character 4 Código do Horário
nroordem inteiro inteiro Ordem das Marcações
classemarcacao character 2

Classe da Marcação:

  • 01 - Início da Jornada
  • 03 - Início da Refeição
  • 04 - Término da Refeição
  • 05 - Início do Lanche
  • 06 - Término do Lanche
  • 07 - Início do Descanso
  • 08 - Término do Descanso
  • 99 - Término da Jornada
tipomarcacao character 1

Tipo de Dia Escala:

  • 1 - Fixa
  • 2 - Móvel
horamarcacao character 5 Hora de Marcação
toleranciaantes character 5 Hora de Tolerância Antes
toleranciadepois character 5 Hora de Tolerância Após


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/horariosMarcacoes?horario=0001&offset=0&limit=100


Query Params:

horario 
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.10 /funcoes

Campos retornados no recurso funções:

Campo Formato Tamanho Descrição
funcao character 4 Código da Função
descricao character 40 Descrição da Função
cbo character 6 Código do CBO Antigo
cbonovo character 6 Código do CBO Novo


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/funcoes?funcao=0001&offset=0&limit=100


Query Params:

funcao
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.11 /setores

Campos retornados no recurso setores:

Campo Formato Tamanho Descrição
setor character 4 Código do Setor
descricao40 character 40 Descrição do Setor


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/setores?setor=0001&ativo=true&offset=0&limit=100


Query Params:

setor
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.12 /classificacoesGerenciais

Campos retornados no recurso de classificações gerenciais:

Campo Formato Tamanho Descrição
classificacaogerencial character 8 Código da Classificação Gerencial
descricao character 40 Descrição da Classificação Gerencial
unidade character 4 Unidade do Gestor, ref. /unidades
contrato numérico 8 Contrato do Gestor, ref. /contratos


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/classificacoesGerenciais?classificacaoGerencial=0001&ativo=true&offset=0&limit=100


Query Params:

classificacaoGerencial
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.13 /classificacoesContabeis

Campos retornados no recurso de classificações contábeis:

Campo Formato Tamanho Descrição
classificacaocontabil character 8 Código da Classificação Contábil
descricao character 40 Descrição da Classificação Contábil


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/classificacoesGerenciais?classificacaoContabil=0001&ativo=true&offset=0&limit=100


Query Params:

classificacaoContabil
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.14 /sindicatos

Campos retornados no recurso sindicatos:

Campo Formato Tamanho Descrição
sindicato character 4 Código do Sindicato
descricao character 60 Descrição do Sindicato
codigoentidade character 16 Código da Entidade
inscricao character 16 Inscrição do Sindicato
rua character 40 Rua
nrorua character 8 Número da Rua
complemento character 20 Complemento
bairro character 20 Bairro
cidade character 20 Cidade
cep character 10 CEP
uf character 2 UF
mesdissidio character 2 Mês do Dissídio
contato character 40 Contato
ddd character 4 DDD
telefone character 15 Telefone
ramal character 4 Ramal
dddfax character 4 DDD do Fax
telefonefax character 15 Fax
ramalfax character 4 Ramal do Fax
email character 80 E-mail


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/sindicatos?sindicato=0001&offset=0&limit=100


Query Params:

sindicato
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.15 /vinculosEmpregaticios

Campos retornados no recurso vínculos empregatícios:

Campo Formato Tamanho Descrição
vinculoempregaticio character 4 Código do Vínculo Empregatício
descricao character 40 Descrição do Vínculo Empregatício
vinculoempregaticiorais character 2 Vínculo Empregatício para RAIS
categoriasefip character 2 Categoria SEFIP
opcaoprevidencia character 1

Opção Previdência:

  • 0 - Nenhuma
  • 1 - INSS
  • 2 - Outra Previdência
vinculoprevidencia character 1

Vínculo Previdência:

  • 0 - Não Recolhe
  • 1 - Empregado
  • 2 - Empregador
  • 3 - Autônomo
  • 4 - Freteiro
  • 5 - Médico Residente
  • 6 - Empregado Doméstico
  • 7 - Facultativo
  • 8 - Estagiário
  • I - Inativo
  • P - Pensionista
recolhefgts character 1 Recolhe FGTS:
  • S - Sim
  • N - Não
vinclosindicato character 1 Vínculo Sindicato:
  • S - Sim
  • N - Não
recebeferias character 1 Recebe Férias:
  • S - Sim
  • N - Não


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/vinculosEmpregaticios?vinculoEmpregaticio=0001&offset=0&limit=100


Query Params:

vinculoEmpregaticio
offset
limit

Operação: GET

Formato Retorno: JSON

 

3.16 /preAdmissao

A documentação deste recurso, sua formatação e exemplos podem ser acessados através do seguinte link: http://www.metadados.com.br/documentacaoAPIPreAdmissao


URL de chamada:

https://metadados.linkapi.com.br/v2/sirh/preAdmissao

Operação: POST

Formato Retorno: JSON

 

4. Frequência

4.1 /marcacoes

Campos retornados no recurso marcações:

Campo Formato Tamanho Descrição
data datetime 8 Data da Marcação no formato “DD-MM-YYYY”
hora character 5 Horário da Marcação no formato “HH:mm”
origem character 10 Origem da marcação
numeroMarcacao character 8 Número da marcação no dia

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/marcacoes?unidade=0001&contrato=296&dataInicio=2019-07-01&dataFim=2019-07-22&offset=0&limit=100


Query Params:

unidade *
contrato *
dataInicio *
dataFim *
offset
limit
* campos obrigatórios

Operação: GET

Formato Retorno: JSON

 

4.2 /eventosPonto

Campos retornados no recurso eventos ponto:

Campo Formato Tamanho Descrição
eventoponto numérico 8 Código do Evento do Ponto
descricao character 40 Descrição do Evento do Ponto
tipoinfoevento character 1

Tipo de Informação do Evento:       

  • H - Horas
  • Q - Quantidade
  • V - Valor
avisaocorrencia character 1 Avisa Ocorrência:
  • S - Sim
  • N - Não
aceitaacerto character 1 Aceita Acerto:
  • S - Sim
  • N - Não
aceitaconfirmacao character 1 Aceita Confirmação:
  • S - Sim
  • N - Não
aceitalancamentos character 1 Aceita Lançamentos:
  • S - Sim
  • N - Não


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/eventosPonto?eventoPonto=1&tipoInfoEvento=H&ativo=true&offset=0&limit=100


Query Params:

eventoPonto
tipoInfoEvento
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

4.2 /lancamentosEventosPonto

Campos retornados no recurso lançamentos eventos ponto:

Campo Formato Tamanho Descrição
dataapuracao datetime 8 Data da Apuração
unidade character 4 Código da Unidade, ref. /unidades
contrato numérico 8 Código do Contrato, ref. /contratos
eventoponto numérico 8 Código do Evento do Ponto, ref. /eventosPonto
descricao character 40 Descrição do Evento do Ponto
numeroordem numérico 8 Número da Ordem
minutosdiurnos numérico 10 Minutos Diurnos
minutosnoturnos numérico 10 Minutos Noturnos
minutostotal numérico 10 Minutos Totais
quantidadeapurada decimal 18,6 Quantidade Apurada
valorapurado decimal 11,2 Valor Apurado
origemlanctoevento character 1

Origem de Lançamento do Evento:

  • G - Gerado
  • D - Digitado
origemcalculoponto character 1

Origem de Cálculo no Ponto:

  • B - Banco Horas   
  • D - Digitado
  • G - Gorjetas
  • M - Marcações Diversas 
  • P - Ponto
  • R - Refeitório
  • S - Simulação BH


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/lancamentosEventosPonto?eventoPonto=1&unidade=0001&contrato=296&dataInicio=2020-08-01&dataFim=2020-08-31&offset=0&limit=100


Query Params:

eventoPonto
unidade
contrato
dataInicio (YYYY-MM-DD) *
dataFim (YYYY-MM-DD) *
offset
limit
* campos obrigatórios

Operação: GET

Formato Retorno: JSON

 

5. Folha de Pagamento

 

5.1 /vdbs

Campos retornados no recurso VDBs:

Campo Formato Tamanho Descrição
vdb numérico 8 Código do VDB
descricao character 40 Descrição do VDB
tipovdb character 1

Tipo de VDB:

  • V - Vencimento
  • D - Desconto
  • B - Base
aceitaprestacao character 1 Aceita Prestação:
  • S - Sim
  • N - Não
usaponto character 1 Utiliza Ponto:
  • S - Sim
  • N - Não
usafolha character 1 Utiliza Folha:
  • S - Sim
  • N - Não
impressofolha character 1

Impressão Folha:

  • N - Não Imprimir
  • Q - Imprimir Horas/Qtde 
  • S - Imprimir Valor
  • T - Imprimir Horas/Qtde e Valor
impressorecibo character 1 Impressão Recibo:
  • N - Não Imprimir
  • Q - Imprimir Horas/Qtde 
  • S - Imprimir Valor
  • T - Imprimir Horas/Qtde e Valor
impressotermo character 1 Impressão Termo:
  • N - Não Imprimir
  • Q - Imprimir Horas/Qtde 
  • S - Imprimir Valor
  • T - Imprimir Horas/Qtde e Valor
avisaafastferias character 1

Avisa Afastamento Férias: 

  • S - Sim
  • N - Não
incidenciafolha character 1 Incidência Folha:
  • - (Subtraindo)
  • + (Somando)
  • 0 (Não Incide)
classificacaofolha character 2

Classificação Folha:

  • 00 - Outros
  • AB - Abono de Férias
  • AD - Adicionais
  • DT - 13º Salário
  • EN - Encargos
  • FE - Férias
  • FT - Faltas
  • HE - Horas Extras
  • HN - Horas Noturnas
  • IN - Indenizações
  • PC - Prêmios e Comissões
  • RP - Rendimentos do PIS/PASEP
  • SL - Salários e Ordenados 
incidenciarais character 1 Incidência RAIS:
  • - (Subtraindo)
  • + (Somando)
  • 0 (Não Incide)
classificacaorais character 2

Classificação RAIS:

  • 00 - Outros
  • AI - Aviso Prévio Indenizado
  • DT - 13º Salário RF- Remuneração Fixa
  • RV - Remuneração Variável
  • VB - Valor Total do Saldo do Banco de Horas
incidenciainss character 1 Incidência INSS:
  • - (Subtraindo)
  • + (Somando)
  • 0 (Não Incide)
classificacaoinss character 2

Classificação INSS:

  • 00 - Outros
  • DT - 13º Salário
  • FE - Férias
  • PF - Provisão INSS s/Férias
  • PL - Pró-Labore e Honorários
  • RA - Remuneração de Autônomo
  • RO - Sal. Contrib. Outros Empregos
  • SE - Salário Educação
  • SF - Salário Família
  • SL - Salários e Ordenados
  • SM - Salário Maternidade
incidenciafgts character 1 Incidência FGTS:
  • - (Subtraindo)
  • + (Somando)
  • 0 (Não Incide)
classificacaofgts character 2

Classificação FGTS:

  • 00 - Outros
  • DT - 13º Salário
  • FE - Férias
  • SL - Salários e Ordenados
incidenciairf character 1

Incidência IRF:

  • - (Subtraindo)
  • + (Somando)
  • 0 (Não Incide)
classificacaoirf character 2

Classificação IRF:

  • 00 - Outros
  • BM - Bolsa de Estudo Médico Residente
  • CP - Contribuições Previdenciárias
  • DA - Diárias e Ajudas de Custo
  • DM - Despesas Médico-Hospitalares
  • DT - 13º Salário
  • E1 - Fundo Prev. Serv. Público sobre 13º Salário
  • EP - Fundo Prev. Serv. Público (Patrocinador)
  • F1 - Fundo Aposent. Prog. Individual sobre 13º Salário (FAPI)
  • FA - Fundo Aposent. Prog. Individual (FAPI)
  • FC - Frete de Cargas
  • FE - Férias
  • FP - Frete de Passageiros
  • LD - Lucros Distribuídos
  • LS - Lucros e Dividendos pagos ao Sócio de SCP
  • LU - Lucros e Dividendos pagos por PJ
  • P1 - Previdência Privada sobre 13º Salário
  • PA - Proventos de Aposentadoria/Pensão
  • PD - Pensão Judicial sobre 13º Salário
  • PF - Pensão Judicial sobre Férias
  • PJ - Pensão Judicial sobre Salários
  • PL - Pensão Judicial sobre Lucros Distribuídos
  • PM - Pensão/Aposentadoria por Moléstia Grave
  • PP - Previdência Privada
  • RE - Residente Exterior c/ Rend Brasil
  • RN - Outros Rendimentos não Tributáveis
  • RT - Outros Rendimentos Tributáveis
  • S1 - Fundo Previdência Servidor Público sobre 13º Salário
  • SP - Fundo Previdência Servidor Público
  • VC - Rend. não Trib. Voluntário da Copa
verbarescisoria numérico  10 Verba Rescisória
incidenciaverba character 1 Incidência Verba:
  • - (Subtraindo)
  • + (Somando)
  • 0 (Não Incide)


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/vdbs?vdb=1&tipoVdb=V&ativo=true&offset=0&limit=100


Query Params:

vdb
tipoVdb
ativo (true: retorna somente os registros ativos; false: retorna somente os registros inativos)
offset
limit

Operação: GET

Formato Retorno: JSON

 

5.2 /folhaPagamento

Campos retornados no recurso folha pagamento:

Campo Formato Tamanho Descrição
datafolha datetime 8 Data da Folha
codigofolha character 2

Código da Folha:

  • 11 - Mensal
  • 21 - Quinzenal - 1a. Quinzena
  • 22 - Quinzenal - 2a. Quinzena
  • 31 - Semanal - 1a. Semana
  • 32 - Semanal - Semanas intermediárias
  • 33 - Semanal - Última Semana
  • 41 - Adiantamento Semanal/Quinzenal
  • 51 - 13o. Salário - Antecipação
  • 52 - 13o. Salário - Complementação
  • 61 - Suplementar
  • 71 - Avulsa
  • 81 - Férias
  • 82 - Férias - 2o. Recibo do Dia
  • 83 - Férias - 3o. Recibo do Dia
  • 91 - Rescisão Principal
  • 92 - 1ª Rescisão Complementar
  • 93 - 2ª Rescisão Complementar
  • 95 - Rescisão Parcial
unidade character 4 Código da Unidade, ref. /unidades
contrato numérico 8 Código do Contrato, ref. /contratos
vdb numérico 8 Código do VDB, ref. /vdbs
tipoinfofolha character 1

Tipo de Informação Folha:

  • 0 - Só o Valor
  • 1 - Horas e Valor
  • 2 - Dias e Valor
  • 3 - Quantidade de Tarefas e Valor
horasquantidade decimal 11,2 Horas/Quantidade
valor decimal 15,2 Valor


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/folhaPagamento?vdb=1&unidade=0001&contrato=296&dataFolha=08-2020&consolidada=true&offset=0&limit=100


Query Params:

vdb
unidade
contrato
dataFolha (MM-YYYY) *
consolidada (true: retorna somente registros consolidados na folha; false: retorna somente registros não consolidados na folha)
offset
limit
* campos obrigatórios

Operação: GET

Formato Retorno: JSON

 

5.3 /lancamentos

Campos retornados no recurso lançamentos:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato numérico 8 Código do Contrato, ref. /contratos
vdb numérico 8 Código do VDB, ref. /vdbs
tipolancamento character 1

Tipo de Lançamento:

  • 1 - Para Folha Mensal
  • 2 - Para Folha Quinzenal
  • 3 - Para Folha Semanal
  • 4 - Para Adiantamento
  • 5 - Para 13o. Salário
  • 6 - Para Folha Suplementar
  • 7 - Para Folha Avulsa/RPA
  • 8 - Para Folha de Férias
  • 9 - Para Folha de Rescisão
datavencimento datetime Data de Vencimento
datalancamento datetime Data do Lançamento 
origemlancamento character 1

Origem do Lançamento:

  • A - Vale Alimentação
  • C - Convênios
  • D - Digitado
  • G - Gerado pelo Sistema
  • I - Importações Diversas
  • P - Ponto Eletrônico
  • T - Vale Transporte
tipoinfolancamento character 

Tipo de Informação do Lançamento:

  • 0 - Valor em R$
  • 1 - Quantidade de Horas
  • 2 - Quantidade de Dias
  • 3 - Quantidade de Tarefas
quantidadevalor decimal 11,2 Quantidade/Valor
lancamentofixo character

Lançamento Fixo:

  • S - Sim
  • N - Não
situacaolancamento character

Situação do Lançamento:

  • C - Consolidado na Folha de Pagamento 
  • null - Não Consolidado na Folha de Pagamento 
operador character Operador do Lançamento
datahoraalteracao datetime Data/Hora da Alteração
numeroprestacao numérico 10 Número de Prestação
numerototalprestacoes numérico 10 Número Total de Prestações
descricao character 250 Descrição


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/lancamentos?vdb=1&tipoLancamento=1&unidade=0001&contrato=296&dataVencimento>=2020-08-01&dataVencimento<=2020-08-31&offset=0&limit=100


Query Params:

vdb
tipoLancamento
unidade
contrato
dataVencimento (YYYY-MM-DD): Podem ser utilizados os operadores >=, <= e =
offset
limit 

Operação: GET

Formato Retorno: JSON

 

5.4 /lancamentos

Campos a serem enviados para o recurso lançamentos:

Campo Obrigatório Formato Tamanho Descrição
unidade S character 4 Código da Unidade, ref. /unidades
contrato S numérico 8 Código do Contrato, ref. /contratos
vdb S numérico 8 Código do VDB, ref. /vdbs
tipolancamento S character 1

Tipo de Lançamento:

  • 1 - Para Folha Mensal
  • 2 - Para Folha Quinzenal
  • 3 - Para Folha Semanal
  • 4 - Para Adiantamento
  • 5 - Para 13o. Salário
  • 6 - Para Folha Suplementar
  • 7 - Para Folha Avulsa/RPA
  • 8 - Para Folha de Férias
  • 9 - Para Folha de Rescisão
datavencimento S datetime Data de Vencimento
datalancamento S datetime Data do Lançamento 
origemlancamento S character 1

Origem do Lançamento:

  • A - Vale Alimentação
  • C - Convênios
  • D - Digitado
  • G - Gerado pelo Sistema
  • I - Importações Diversas
  • P - Ponto Eletrônico
  • T - Vale Transporte
tipoinfolancamento S character 

Tipo de Informação do Lançamento:

  • 0 - Valor em R$
  • 1 - Quantidade de Horas
  • 2 - Quantidade de Dias
  • 3 - Quantidade de Tarefas
quantidadevalor N decimal 11,2 Quantidade/Valor
lancamentofixo S character

Lançamento Fixo:

  • S - Sim
  • N - Não
situacaolancamento N character

 Situação do Lançamento:

  • C - Consolidado na Folha de Pagamento 
  • null - Não Consolidado na Folha de Pagamento
operador S character Operador do Lançamento
datahoraalteracao S datetime Data/Hora da Alteração
numeroprestacao N numérico 10 Número de Prestação
numerototalprestacoes N numérico 10 Número Total de Prestações
descricao N character 250 Descrição


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/lancamentos


Exemplo de Body:

{
     "unidade": "0001",
     "contrato": "1",
     "vdb": 1,
     "tipoLancamento": "1",
     "dataVencimento": "2020-07-01",
     "dataLancamento": "2020-07-01",
     "origemLancamento": "D",
     "tipoInfoLancamento": "0",
     "quantidadeValor": 2436.46,
     "lancamentoFixo": "N",
     "situacaoLancamento": null,
     "operador": "TESTE",
     "dataHoraAlteracao": "2020-07-02 12:05:02",
     "numeroPrestacao": null,
     "numeroTotalPrestacoes": null,
     "descricao": null
}

Operação: POST

Formato Retorno: JSON

 

5.5 /contratosFolha

Campos retornados no recurso contratos folha:

Campo Formato Tamanho Descrição
datafolha datetime 8 Data da Folha
codigofolha character 2

Código da Folha:

  • 11 - Mensal
  • 21 - Quinzenal - 1a. Quinzena
  • 22 - Quinzenal - 2a. Quinzena
  • 31 - Semanal - 1a. Semana
  • 32 - Semanal - Semanas intermediárias
  • 33 - Semanal - Última Semana
  • 41 - Adiantamento Semanal/Quinzenal
  • 51 - 13o. Salário - Antecipação
  • 52 - 13o. Salário - Complementação
  • 61 - Suplementar
  • 71 - Avulsa
  • 81 - Férias
  • 82 - Férias - 2o. Recibo do Dia
  • 83 - Férias - 3o. Recibo do Dia
  • 91 - Rescisão Principal
  • 92 - 1ª Rescisão Complementar
  • 93 - 2ª Rescisão Complementar
  • 95 - Rescisão Parcial
empresa character 4 Código da Empresa, ref. /empresas
pessoa numérico 8 Código da Pessoa, ref. /dadosPessoais
unidade character 4 Código da Unidade, ref. /unidades
estabelecimento character 4 Código do Estabelecimento, ref. /estabelecimentos
contrato numérico 8 Código do Contrato, ref. /contratos
situacao character 1

Situação do Contrato:

  • 1 - Ativo
  • 2 - Afastado
  • 3 - Rescindido no mês
  • 4 - Rescindido em meses anteriores
dataadmissao datetime 8 Data de Admissão
dataultimoafastamento datetime 8 Data do Último Afastamento
datarescisao datetime 8 Data de Rescisão
cargo character 8 Código do Cargo, ref. /cargos
funcao character 8 Código da Função, ref. /funcoes
setor character 8 Código do Setor, ref. /setores
escala character 4 Código da Escala, ref. /escalas
centrocusto1 character 8 Código do Centro de Custo 1, ref. /centrosCusto
centrocusto2 character 8 Código do Centro de Custo 2, ref. /centrosCusto1
centrocusto3 character 8 Código do Centro de Custo 3, ref. /centrosCusto2
centrocusto4 character 8 Código do Centro de Custo 4, ref. /centrosCusto3
classificacaogerencial character 8 Código da Classificação Gerencial, ref. /classificacoesGerenciais
classificacaocontabil character 8 Código da Classificação Contábil, ref. /classificacoesContabeis
vinculoempregaticio character 2 Código do Vínculo Empregatício, ref. /vinculosEmpregaticios
salariocontratual decimal 11,2 Salário Contratual
salariomes decimal 11,2 Salário Mês
salariohora decimal 11,4 Salário Hora
horascontratuais decimal 5,2 Horas Contratuais
horasmes decimal 5,2 Horas Mês
horasdia decimal 7,4 Horas Dia


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/contratosFolha?unidade=0001&contrato=296&dataFolha=08-2020&offset=0&limit=100


Query Params:

unidade
contrato
dataFolha (MM-YYYY) *
offset
limit
* campos obrigatórios

Operação: GET

Formato Retorno: JSON

 

6. Treinamento e Desenvolvimento

 

6.1 /cursos

Campos retornados no recurso cursos:

Campo Formato Tamanho Descrição
curso character 15 Código do Curso
descricao character 50 Descrição do Curso
datacriacao datetime 8 Data de Criação do Curso
datadesativacao datetime 8 Data de Desativação do Curso
cargahoraria decimal 7,2 Carga Horária do Curso


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/cursos?curso=0001&offset=0&limit=100


Query Params:

curso
offset
limit

Operação: GET

Formato Retorno: JSON

 

6.2 /pessoasCursos

Campos retornados no recurso pessoas cursos:

Campo Formato Tamanho Descrição
empresa character 4 Código da Empresa, ref. /empresas
unidade character 4 Código da Unidade, ref. /unidades
pessoa numérico 8 Código da Pessoa, ref. /contratos
curso character 15 Código do Curso, ref. /cursos
datainicio datetime 8 Data de Início do Curso
dataencerramento datetime 8 Data de Encerramento do Curso
status character 1

Impressão Folha:

  • A - Aprovado
  • C - Cancelado
  • P - Programado
  • R - Reprovado
nota character 15 Nota do Curso
cargahoraria decimal 7,2 Carga Horária do Curso
cargo character 4 Código do Cargo, ref. /cargos
setor character 4 Código do Setor, ref. /setores
evento character 4 Código do Evento
centrocusto1 character 4 Código do Centro de Custo 1, ref. /centrosCusto
centrocusto2 character 4 Código do Centro de Custo 2, ref. /centrosCusto2
centrocusto3 character 4 Código do Centro de Custo 3, ref. /centrosCusto3
centrocusto4 character 4 Código do Centro de Custo 4, ref. /centrosCusto4


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/pessoasCursos?curso=Ambientacao&empresa=0001&pessoa=298&dataInicio=2020-08-01&dataEncerramento=2020-08-31&offset=0&limit=100


Query Params:

curso
empresa
pessoa
dataInicio (YYYY-MM-DD)
dataEncerramento (YYYY-MM-DD) 
offset
limit

Operação: GET

Formato Retorno: JSON

 

6.3 /eventos

Campos retornados no recurso eventos:

Campo Formato Tamanho Descrição
evento character 7 Código do Evento
datainicio datetime 8 Data de Início do Evento
dataencerramento datetime 8 Data de Encerramento do Evento
observacoes texto 2³¹ Observações do Evento
situacaoevento character 1

Situação do Evento:

  • C - Cancelado
  • F - Finalizado
  • L - Planejado
  • P - Programado


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/eventos?evento=0001&situacaoEvento=F&offset=0&limit=100


Query Params:

evento
situacaoEvento 
offset
limit

Operação: GET

Formato Retorno: JSON

 

6.4 /eventoHoras

Campos retornados no recurso evento horas:

Campo Formato Tamanho Descrição
evento character 7 Código do Evento
dataevento datetime 8 Mês/Ano do Evento
cargahoraria decimal 7,2 Carga Horária do Evento


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/sirh/eventoHoras?evento=0001&dataEvento>=2020-08-01&dataEvento<=2020-08-31&offset=0&limit=100


Query Params:

evento
dataEvento (YYYY-MM-DD): Podem ser utilizados os operadores >=, <= e =
offset
limit

Operação: GET

Formato Retorno: JSON

 

7. Financeiro

 

7.1 /contasAPagar

Campos retornados no recurso contas a pagar:

Campo Formato Tamanho Descrição
numerosequencial numérico 10 Número Sequencial
numerodocumento character 10 Número do Documento
datainicio datetime 8 Data de Início
datatermino datetime 8 Data de Término
statusregistro character 2

Status Registro:

  • 01 - Incluído
  • 02 - Liberado para o Sistema de Contas a Pagar
  • 03 - Aceito pelo Sistema de Contas a Pagar
  • 04 - Solicitando Autorização para a Exclusão
  • 05 - Excluído pelo Sistema de Contas a Pagar
  • 06 - Autorização negada para a Exclusão
  • 07 - Excluído pela Folha
  • 08 - Rejeitado pelo Sistema de Contas a Pagar
  • 09 - Solicitando Provisão p/Conta a Pagar
  • 10 - Provisionado pelo Contas a Pagar
datainclusao datetime 8 Data de Inclusão
operadorinclusao character 6 Operador da Inclusão
dataliberacao datetime 8 Data de Liberação
operadorliberacao character 6 Operador da Liberação
dataaceitacaoliberacao datetime 8 Data de Aceitação da Liberação
datasolicitacaoestorno datetime 8 Data de Solicitação do Estorno
operadorsolicitacaoestorno character 6 Operador da Solicitação do Estorno
dataautorizacaoestorno datetime 8 Data de Autorização do Estorno
datanegacaoestorno datetime 8 Data de Negação do Estorno 
dataestorno datetime 8 Data do Estorno
operadorestorno character 6 Operador do Estorno
datasolicitacaoprovisao datetime 8 Data de Solicitação da Provisão
operadorsolicitacaoprovisao character Operador da Solicitação de Provisão 
dataprovisao datetime Data da Provisão
datavencimento datetime  Data de Vencimento 
descricaoreduzida character 40 Descrição Reduzida
descricao character 250  Descrição 
formaapuracontapagar character

Forma de Apuração:

  • 01 - Empresa
  • 02 - Unidade
  • 03 - Estabelecimento
  • 04 - Setor
  • 05 - Centro Custo Nível 1
  • 06 - Centro Custo Nível 2
  • 07 - Centro Custo Nível 3
  • 08 - Centro Custo Nível 4
  • 09 - Classificação Contábil
  • 10 - Classificação Gerencial
  • 11 - Classificação GPS
  • 12 - Classificação SEFIP
  • 13 - Sindicato
  • 14 - Banco
  • 15 - Banco Pagador
  • 99 - Um único total
codigoapuracao character Código de Apuração 
fornecedor character 4 Código do Fornecedor, ref. /fornecedores
fornecedordescricaoreduzida character 20  Descrição Reduzida do Fornecedor
contadevedora character 20 Conta Devedora
contacredora character  20 Conta Credora 
historicopadrao character 4 Código do Histórico Padrão
valor decimal  15,2  Valor
valororiginal decimal 11,2 Valor Original
tipoitemcontapagar character 2

Tipo do Item:

  • 01 - GPS Empresa Mensal
  • 02 - GPS Empresa 13º Salário
  • 03 - GPS Individual
  • 04 - DARF IRF s/Salários
  • 05 - DARF PIS s/Folha
  • 06 - GFIP (FGTS)
  • 07 - GRCS Patronal
  • 08 - GRCS Empregados
  • 09 - Contrato
  • 10 - DARF IRF s/Autônomos
  • 11 - GPS Produtos Rurais
  • 12 - GPS Fretes (SIMPLES)
  • 13 - GPS Diferença Dissídio
  • 14 - GPS Individual 13º Salário
  • 15 - DARF IRF s/Lucros Distr.
  • 16 - GFIP (FGTS 115)
  • 17 - GFIP (FGTS 150)
  • 18 - GFIP (FGTS 155)
  • 19 - GFIP (FGTS 650)
  • 20 - Emissão de Cheques
  • 21 - DARF IRF s/Residente Exterior
  • 22 - Remessas Bancárias
  • 26 - Pensionistas
  • 40 - Folha Avulsa/RPA
  • 41 - Férias
  • 44 - Rescisão Principal
  • 45 - Rescisão Complementar
  • 99 - Outros
chaveoutrosistema numérico 10 Chave no Sistema Terceiro
chaveoutrosistematitulo numérico 10 Chave do Título no Sistema Terceiro
numerotitulo numérico  10  Número do Título
numerocheque numérico 10 Número do Cheque
seriecheque character 6 Série do Cheque
numeroremessa numérico 10 Número da Remessa
banco character 4 Código do Banco, ref. /bancos
numerobanco character 3 Número do Banco
numeroagencia character 4 Número da Agência
digitoagencia character 1 Dígito da Agência
contacorrente character 15 Número da Conta Corrente
numerodoc numérico 10 Número do DOC
seriedoc character 6 Série do DOC
numeroemissaoseq numérico 10 Número de Emissão Sequência
numerochequeseq numérico 10 Número do Cheque Sequência
formapagamento character 1

Forma de Pagamento:

  • 1 - Em Espécie
  • 2 - Em Cheque
  • 3 - Documento de Compensação - DOC
  • 4 - Depósito em Conta Corrente
  • 5 - Depósito na Poupança
  • 6 - Depósito para Saque por Cartão
formapagamentooriginal character 1

Forma de Pagamento Original:

  • 1 - Em Espécie
  • 2 - Em Cheque
  • 3 - Documento de Compensação - DOC
  • 4 - Depósito em Conta Corrente
  • 5 - Depósito na Poupança
  • 6 - Depósito para Saque por Cartão
itemcontapagar numérico 10 Código do Item
codigoauxiliar character 20 Código Auxiliar do Item
empresa character 4 Código da Empresa, ref. /empresas
estabelecimento character 4 Código do Estabelecimento, ref. /estabelecimentos
estabelecimentocodigoauxiliar character 20 Código Auxiliar do Estabelecimento
sindicato character 4 Código do Sindicato, ref. /sindicatos
classificacaogpssefip character 4 Código da Classificação GPS/SEFIP
anomescompetencia character 7 Ano/Mês de Competência
unidade character 4 Código da Unidade, ref. /unidades
contrato numérico  8 Código do Contrato, ref. /contratos
nome character  40 Nome da Pessoa
datafolha datetime  Data Folha 
codigofolha character  2

Código da Folha:

  • 11 - Mensal
  • 21 - Quinzenal - 1a. Quinzena
  • 22 - Quinzenal - 2a. Quinzena
  • 31 - Semanal - 1a. Semana
  • 32 - Semanal - Semanas intermediárias
  • 33 - Semanal - Última Semana
  • 41 - Adiantamento Semanal/Quinzenal
  • 51 - 13o. Salário - Antecipação
  • 52 - 13o. Salário - Complementação
  • 61 - Suplementar
  • 71 - Avulsa
  • 81 - Férias
  • 82 - Férias - 2o. Recibo do Dia
  • 83 - Férias - 3o. Recibo do Dia
  • 91 - Rescisão Principal
  • 92 - 1ª Rescisão Complementar
  • 93 - 2ª Rescisão Complementar
  • 95 - Rescisão Parcial
necessitaprovisao character 1

Necessita Provisão:

  • S - Sim
  • N - Não
tipolancamento character  1

Tipo de Lançamento:

  • 1 - Para Folha Mensal
  • 2 - Para Folha Quinzenal
  • 3 - Para Folha Semanal
  • 4 - Para Adiantamento
  • 5 - Para 13o. Salário
  • 6 - Para Folha Suplementar
  • 7 - Para Folha Avulsa/RPA
  • 8 - Para Folha de Férias
  • 9 - Para Folha de Rescisão
 
justificativa texto 2³¹ Justificativa
codigoguia character 100 Código Guia
unidadecodigoauxiliar character  20 Código Auxiliar da Unidade
datavencimentocovid19 datetime  Data de Vencimento COVID-19 


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/financeiro/contasAPagar?status=02&dataInclusao>=2020-08-01&dataInclusao<=2020-08-31&offset=0&limit=100


Query Params:

status
fornecedor
unidade
contrato
dataInclusao (YYYY-MM-DD): Podem ser utilizados os operadores >=, <= e =
dataLiberacao (YYYY-MM-DD): Podem ser utilizados os operadores >=, <= e = 
dataVencimento (YYYY-MM-DD): Podem ser utilizados os operadores >=, <= e = 
offset
limit

Operação: GET

Formato Retorno: JSON

 

7.2 /contasAPagarRateio/{numeroSequencial}

Campos retornados no recurso contas a pagar rateio:

Campo Formato Tamanho Descrição
numerosequencial numérico 10 Número Sequencial
tiporateio character 2

Tipo de Rateio:

  • 01 - DARF Folha
  • 02 - DARF Autônomos
  • 03 - DARF PIS
  • 04 - DARF Lucros Distr.
  • 05 - GRCS Empregados
  • 06 - GFIP (FGTS)
  • 07 - GFIP (FGTS 115)
  • 08 - GFIP (FGTS 150)
  • 09 - GFIP (FGTS 155)
  • 10 - GFIP (FGTS 650)
  • 11 - Outros
  • 12 - GPS Empresa Mensal
  • 13 - GPS Empresa 13º Salário
  • 14 - GPS Diferença de Dissídio
  • 15 - DARF Residente Exterior
empresa character 4 Código da Empresa, ref. /empresas
pessoa numérico 8 Código da Pessoa, ref. /contratos
unidade character 4 Código da Unidade, ref. /unidades
unidadecodigoauxiliar character 20 Código Auxiliar da Unidade
contrato numérico 8 Código do Contrato, ref. /contratos
anomesbase datetime 8 Ano/Mês Base
valor decimal 15,2 Valor
estabelecimento character 4 Código do Estabelecimento, ref. /estabelecimentos
estabelecimentocodigoauxiliar character 20 Código Auxiliar do Estabelecimento
classificacaocontabil character 8 Código da Classificação Contábil
classcontabest character 20 Código Estruturado da Classificação Contábil
setor character 8 Código do Setor, ref. /setores 
postotrabalho character 8 Código do Posto de Trabalho
centrocusto1 character 8 Código do Centro de Custo 1, ref. /centrosCusto
centrocusto1codigoestruturado character 16 Código Estruturado do Centro de Custo 1
centrocusto2 character 8 Código do Centro de Custo 2, ref. /centrosCusto2
centrocusto2codigoestruturado character 16 Código Estruturado do Centro de Custo 2
centrocusto3 character Código do Centro de Custo 3, ref. /centrosCusto3
centrocusto3codigoestruturado character 16 Código Estruturado do Centro de Custo 3
centrocusto4 character 8 Código do Centro de Custo 4, ref. /centrosCusto4
centrocusto4codigoestruturado character 16 Código Estruturado do Centro de Custo 4
classificacaogerencial character Código da Classificação Gerencial
classificacaogps character 4 Código da Classificação GPS
classificacaosefip character 4 Código da Classificação SEFIP


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/financeiro/contasAPagarRateio/2?unidade=0001&contrato=298&offset=0&limit=100

 

Path Params:

numeroSequencial


Query Params:

unidade
contrato
offset
limit

Operação: GET

Formato Retorno: JSON

 

7.3 /contasAPagar/{numeroSequencial}

Campos a serem enviados para o recurso contas a pagar:

Campo Obrigatório Formato Tamanho Descrição
status S character 2

Status Permitidos para Atualização:

  • 03 - Aceito pelo Sistema de Contas a Pagar
  • 05 - Excluído pelo Sistema de Contas a Pagar
  • 06 - Autorização negada para a Exclusão
  • 08 - Rejeitado pelo Sistema de Contas a Pagar
mensagem

Obrigatório caso status = 06 ou status = 08

texto 2³¹ Mensagem de erro para gravação no log
operadorestorno Obrigatório caso status = 05 character 6 Operador do Estorno
dataestorno Obrigatório caso status = 05 datetime Data de Estorno


Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/financeiro/contasAPagar/2

 

Path Params:

numeroSequencial


Exemplos de Body:

{
    "status": "03"
}

{
    "status": "05",
    "dataEstorno": "2020-08-13 10:41:50",
    "operadorEstorno": "TESTE"
}

{
    "status": "06",
    "mensagem": "Não foi possível efetuar a exclusão do título."
}

{
    "status": "08",
    "mensagem": "Erro ao inserir o título."
}

Operação: PATCH

Formato Retorno: JSON

 

8. PortalRH

Os recursos pertencentes à divisão PortalRH na API Metadados, são um redirecionamento para seus correspondentes métodos no WebService do PortalRH.

8.1 /obterSaldoDoBancoDeHoras

Campos retornados no recurso obterSaldoDoBancoDeHoras:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato character 8 Código do Contrato
mensagem character 40 Mensagem
codigoBancoHoras character 4 Código do Banco de Horas
nomeBancoHoras character 40 Nome do Banco de Horas
saldoMinutos numerico 5 Saldo em minutos

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/portalrh/obterSaldoBancoDeHoras?unidade=0001&contrato=296&dataSolicitacao=2019-07-31


Query Params:

unidade *
contrato *
dataSolicitacao *
* campos obrigatórios

Operação: GET

Formato Retorno: XML

8.2 /obterSaldoDeFerias

Campos retornados no recurso obterSaldoDeFerias:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato character 8 Código do Contrato
inicioPerAquisitivo datetime 23 Data de Início do Período Aquisitivo
terminoPerAquisitivo datetime 23 Data de Término do Período Aquisitivo
diasFaltadosPeriodo numerico 4 Número de Dias Faltados no Período
diasPerdidosPeriodo numerico 4 Número de Dias Perdidos no Período
diasCedidosPeriodo numerico 4 Número de Dias Cedidos no Período
diasAbonoPeriodo numerico 4 Número de Dias Abonados no Período
diasPendentesPeriodos numerico 4 Número de Dias Pendentes no Período
dataLimite datetime 23 Date Limite do Período

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/portalrh/obterSaldoDeFerias?unidade=0001&contrato=296


Query Params:

unidade *
contrato *
* campos obrigatórios

Operação: GET

Formato Retorno: XML

8.3 /inserirMarcacoesPonto

Campos a serem enviados para o recurso inserirMarcacoesPonto:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato character 8 Código do Contrato
marcacoes
  • dataHora
  • tipo

character
character

19
1

Data e Hora da Marcação
Tipo da Marcação:
  • D - Digitada
  • E - Eletrônica
  • G - Gerada
  • M - Manutenção
  • P - Presumida

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/portalrh/inserirMarcacoesPonto


Exemplo de Body:

{
 "unidade": "0001",
 "contrato": 296,
 "marcacoes": [
  {
   "DataHora": "2019-08-02 08:10:00",
   "Tipo": "D"
  }
 ]
}

Operação: POST

Exemplo de Resposta:

{
 "d": "[
    {
     "DataHora": "2019-08-02T18:10:00",
     "Tipo": "D",
     "Status": "Marcação incluída com sucesso"
    }
   ]"
}

8.4 /excluirMarcacoesPonto

Campos a serem enviados para o recurso excluirMarcacoesPonto:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato character 8 Código do Contrato
marcacoesParaExcluir
  • dataHora
  • tipo

character
character

19
1

Data e Hora da Marcação
Tipo da Marcação

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/portalrh/excluirMarcacoesPonto


Exemplo de Body:

{
 "unidade": "0001",
 "contrato": 296,
 "marcacoesParaExcluir": [
  {
   "DataHora": "2019-08-02 08:10:00",
   "Tipo": "D"
  }
 ]
}

Operação: POST

Exemplo de Resposta:

{
 "d": "[
    {
     "DataHora": "2019-08-02T18:10:00",
     "Tipo": "D",
     "Status": "Marcação excluída com sucesso"
    }
   ]"
}

8.5 /inserirSolicitacaoFerias

Campos a serem enviados para o recurso inserirSolicitacaoFerias:

Campo Formato Tamanho Descrição
unidade character 4 Código da Unidade, ref. /unidades
contrato character 8 Código do Contrato
solicitacaoFerias
  • inicioFerias
  • diasFerias
  • diasAbono
  • pagamento13Salario

character
numerico
numerico
boolean

10
2
2

Data de Início das Férias
Número de Dias
Número de Dias Abonados
Indicativo de Pagamento de 13° Salário

Exemplo de Requisição:

https://metadados.linkapi.com.br/v2/portalrh/inserirSolicitacaoFerias


Exemplo de Body:

{
 "unidade": "0001",
 "contrato": 296,
 "solicitacaoFerias": {
   "InicioFerias": "2019-10-15",
   "DiasFerias": 15,
   "DiasAbono": 0,
   "Pagamento13Salario": false
 }
}

Operação: POST

Exemplo de Resposta:

{
 "d": "[
    {
     "InicioFerias": "2019-10-15T00:00:00",
     "DiasFerias": 15,
     "DiasAbono": 0,
     "Pagamento13Salario": false,
     "Situaca": 0,
     "NumeroSolicitacao": 30488,
     "Mensagem": "Sucesso"
    }
   ]"
}