Skip to main content
O objeto employment simboliza a relação empregatícia entre um cliente e uma empresa. É nesta entidade que os elementos vitais do vínculo empregatício são preservados, tais como:
  • Salário bruto
  • Salário líquido
  • Data de início do contrato de trabalho
  • Margem consignável
  • Situação atual do empregado
  • Valor de indenização por rescisão
O objeto employment é imutável. Isso implica que para atualizar qualquer dado, será necessário adicionar um novo employment. Este histórico é mantido para análise da progressão salarial de um cliente e para guardar o registro do vínculo empregatício vigente quando um empréstimo foi requisitado ou concedido. É possível verificar todos os dados submetidos através do endpoint Listar todos os vínculos empregatícios. É permitido filtrar por meio do documento ou ID externo. Ademais, é possível examinar apenas o último registro válido usando o parâmetro ?last=true, para mais informações consulte Visualizar histórico consolidado

​
Status do vínculo

📘 Demissão de funcionários Não é necessário fazer a exclusão do vínculo empregatício quando o contrato de trabalho do funcionário é encerrado. Insira um vínculo com o status terminated e consulte a documentação de Cobrança para entender o processo de quitação antecipada.

​
Validade da informação

O registro de vínculo empregatício é fundamental para o gerenciamento de empréstimos consignados. Para gerenciar a validade do vínculo, o campo expiredAt será preenchido baseando-se na configuração do período de validade através do campo settings.employment.expireInDays. Veja mais em Atualizar as configurações. Exemplo: Se a validade estiver definida para 15 dias e o RH importar os dados em 01 de janeiro:
  • Até 15 de janeiro, o campo employment.expiredAt permanecerá vazio (null);
  • A partir de 15 de janeiro, o employment.expiredAt será preenchido com a data 15 de janeiro.
Mesmo após expirado, é possível alterar a configuração para outro número de dias para modificar todos os registros de forma retroativa.
⚠️ Importante! Se os dados expiram, eles precisam ser reenviados de forma recorrente antes da expiração. Caso a sua configuração seja ilimitada (settings.employment.expireInDays = -1), certifique-se de informar os outros status, principalmente o “demitido” para garantir que o cliente não faça uma solicitação de empréstimo com uma informação desatualizada.

​
Visualizar histórico consolidado

Todo employment deve conter pelo menos o documento do funcionário, status do vínculo e a empresa. Com o passar do tempo, o status e os salários podem sofrer mudanças. Para assegurar uma visão atualizada do cliente, você pode agrupar todos esses vínculos por documento e empresa usando o filtro ?last=true. Se a configuração da sua conta demanda o envio do employment antes do período de expiração, você pode ter múltiplos objetos com os mesmos valores para cada mês ou semana. Este filtro também consolida essas informações e retorna apenas a mais recente, mesmo que já tenha expirado. Se um funcionário possui vínculo com mais de uma empresa, a resposta incluirá a última informação de cada empresa. Exemplo: Após várias inserções feitas nos últimos meses, o banco de dados ficaria com registros parecidos com esses: Ao fazer a requisição com o filtro ?last=true, a resposta retorna apenas do último item independentemente se a informacão expirou.
📘 Importante! Não é possível atualizar os registros de funcionários. É necessário inserir um novo registro.