Consulta de Margem
info
Descrição
Este endpoint permite consultar a margem disponível para o cliente, utilizando informações como o número do documento do cliente, o CNPJ do empregador e o tipo de serviço da bancarizadora. A resposta fornece detalhes sobre a margem disponível, saldo utilizável e informações pessoais do colaborador, essenciais para a realização de simulações e propostas de empréstimo consignado.
Endpoint
POST /clt-loan/v1/get-margin
Headers
{
"Authorization": "Bearer {TOKEN_DO_LOGIN}",
}
Payload (Body)
{
"document_number": "44961167827",
"employer_document": "98179558000180",
"service_type": "QITECH"
}
info
Observações:
- O campo employer_document é o CNPJ da empresa onde o cliente trabalha.
- O campo service_type pode ser obtido no response dalistagem de bancarizadora.
- Resposta de Sucesso (200 OK)
Exemplo de Resposta :
{
"success": true,
"message": "Margem consultada com sucesso.",
"data": {
"margin_key": "bfa23ba1-be95-40b6-9a65-0696fca3be86",
"document": "06561646541",
"name": "JOÃO SILVA",
"employer": {
"name": "EMPRESA XYZ LTDA",
"document": "89412850",
"cnae": "6201"
},
"available_balance": 500.0,
"utilizable_balance": 400.0,
"base_margin_value": 4500.0,
"total_gross_salary": null,
"birth_date": "1985-07-20",
"gender": {
"code": 1,
"description": "Masculino"
},
"mother_name": "MARIA DA SILVA",
"admission_date": "2020-03-15",
"worker_category_code": "101",
"job_code": {
"code": "2515",
"description": "Analista de Sistemas"
},
"can_continue": true,
"restrictions": [],
"selected_fund_id": 2
}
}