Consultar desligamentos (término de vínculo)

GET/v1/vinculos/desligamentos

🔒 Requer Bearer token

Escopo vinculos:read. Lista os empréstimos do parceiro encerrados por término de vínculo (trabalhador desligado) no período. Proxy filtrado por contrato+CPF — só retorna contratos do próprio parceiro. Sem registros retorna { "desligamentos": [] }.

Parâmetros

data_iniciostringqueryopcional

Início da janela de busca (YYYY-MM-DD). Default: janela padrão do backend.

padrão: ^\d{4}-\d{2}-\d{2}$

data_fimstringqueryopcional

Fim da janela de busca (YYYY-MM-DD). Default: hoje.

padrão: ^\d{4}-\d{2}-\d{2}$

Respostas

Corpo da resposta 200

desligamentosarray<object>obrigatório

contratostringobrigatório

cpf_trabalhadorstringobrigatório

matriculastringobrigatório

nome_trabalhadorstringobrigatório

cnpj_empregadorstringobrigatório

nome_empregadorstringobrigatório

data_desligamentostring<date>obrigatório

motivo_desligamentoobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

situacao_emprestimoobjectobrigatório

codigointegerobrigatório

descricaostringobrigatório

total_parcelasintegerobrigatório

valor_parcelanumberobrigatório

valor_emprestimonumberobrigatório

Request

curl -X GET 'https://econsignado-api.socinal.com.br/v1/vinculos/desligamentos?data_inicio=valor&data_fim=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "desligamentos": [
    {
      "contrato": "A100001-001",
      "cpf_trabalhador": "75842274574",
      "matricula": "MAT-8024716378",
      "nome_trabalhador": "João da Silva",
      "cnpj_empregador": "12674953000114",
      "nome_empregador": "Alves Teixeira - EI",
      "data_desligamento": "2025-05-30",
      "motivo_desligamento": {
        "codigo": 2,
        "descricao": "Dispensa sem justa causa"
      },
      "situacao_emprestimo": {
        "codigo": 15,
        "descricao": "Encerrado por término do vínculo"
      },
      "total_parcelas": 24,
      "valor_parcela": 312.45,
      "valor_emprestimo": 6000
    }
  ]
}