Introdução

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.

curl --request GET \
  --url https://api.base39.io/v1/employments?last=true \
  --user 'bs_sandbox_65592feb50584d6838855f12' \

{
  "id": "emp_64ad4400413ee1e9520ef9cc",
  "status": "working",
  "company": "comp_64ad4400413ee1e9520ef9ca",
  "grossSalary": 5710,
  "customer": {
    "dcument": "12312312300"
  },
  "createdAt": "2023-04-02",
  "expiredAt": null
}

📘 Importante!

Não é possível atualizar os registros de funcionários. É necessário inserir um novo registro.