Manual Consignado Privado - Leilão Interno

1. Início de Leilão

Após as configurações dos filtros de pedidos de empréstimo, o parceiro irá começar a receber webhooks notificando estas solicitações.

{
    "status": "ongoing",
    "event_datetime": "2025-03-20T14:47:43Z",
    "key": "88b0203d-31ad-48c6-a795-b6d45ab4898a",
    "webhook_type": "laas.private_payroll_auction.new_issuer_proposal_request",
    "data": {
        "issuer_proposal_request_key": "88b0203d-31ad-48c6-a795-b6d45ab4898a",
        "status": "ongoing",
        "expiration_datetime": "2025-03-21T11:47:12Z",
        "inclusion_limit_datetime": "2025-03-20T11:49:43Z",
        "issuer_proposal_request_data": {
            "issuer_registration_number": "TESTE123",
            "birth_date": "1973-03-14",
            "disbursed_issue_amount": 2100,
            "admission_date": "2020-03-10",
            "consigned_credit_balance": 10000,
            "eligible": true,
            "employer_document_type": "cnpj",
            "document_number": "00737823780",
            "employer_document_number": "29113956000181",
            "number_of_installments": 10,
            "political_exposition": "not_exposed",
            "name": "VALENTINA SANTOS"
        },
    }
}

Cada pedido de empréstimo passa por duas etapas, o leilão interno e o leilão no app da CTPS. O leilão interno se inicia assim que o webhook é recebido e se encerra no timestamp indicado no campo inclusion_limit_datetime, durante este período as propostas de todos os parceiros são recebidas e ranqueadas com base na taxa, assim que o leilão interno se encerra a proposta com as melhores condições é enviada à CTPS do tomador onde as propostas de todas as IFs são apresentadas. Caso nenhuma proposta seja enviada até o fim do leilão interno, a primeira proposta enviada depois do inclusion_limit_datetime ganhará automaticamente e será enviada à CTPS.

2. Proposta de Crédito

Request

ENDPOINT

- /private_payroll_auction/issuer_proposal_request/{issuer_proposal_request_key}/auction_proposal

MÉTODO

- POST

Request Body: Incluindo uma AuctionProposal no leilão

{
    "request_control_key" : "111e7ed3-4080-4cae-a853-8e12812817ea",
    "disbursed_issue_amount": 15000,
    "installment_face_value": 400.00,
    "number_of_installments": 48,
    "purchaser_document_number": "01272247000120",
    "days_to_expiration": 10,
    "rebates": [
        {
            "fee_type": "spread",
            "amount_type": "percentage",
            "amount": 4.17
        }
    ]
}

Response

STATUS

- 202 (Accepted)

Response Body: Proposta criada

{
  "auction_proposal_key": "814e7ed3-4080-4cae-a853-8e12812817ea",
  "issuer_proposal_request_key" : "100e7ed3-4080-4cae-a853-8e12812817ea",
  "request_control_key" : "111e7ed3-4080-4cae-a853-8e12812817ea",
  "status": "bid",
  "proposal_score" : 0.4,
  "inclusion_date" : "2025-03-18T14:52:07.123456",
  "rank_position" : null,
  "proposal_data": {
        "simulation": {
            "total_iof": 15.46,
            "annual_cet": 0.0603,
            "monthly_cet": 0.0049,
            "issue_amount": 1015.46,
            "annual_interest_rate": 0.0180272568,
            "monthly_interest_rate": 0.00149,
            "disbursed_issue_amount": 1000.0,
            "installment_face_value": 102.25,
            "number_of_installments" : 48
        },
        "monthly_interest_rate": null,
        "disbursed_issue_amount": 15000,
        "installment_face_value": 102.25,
        "number_of_installments": 48
  },
}

3. Encerramento do Leilão

Quando o leilão interno se encerra, um webhook é enviado atualizando o parceiro se o mesmo venceu ou perdeu o leilão, no caso de vitória, a operação de crédito é criada e o link de formalização do QI Sign é enviado ao app da CTPS do tomador, a partir deste momento o acompanhamento da operação deve ser realizado através da chave credit_operation_key.

WEBHOOK_TYPE

laas.private_payroll_auction.end_of_auction

{
    "key": "150cfaa5-99dc-4c80-be3e-2231350cf9a2",
    "data": {
        "auction_proposal_key": "250cfea5-99dc-4c80-be3e-2231350cf9a2",
        "status": "won",
        "type": "auction",
        "rank_position": 1,
        "signature_url": "https://sandbox.sign.qitech.com.br/r/3D1s523",
        "credit_operation_key": "9e06ca79-3610-4794-8312-9663e0343f6b",
        "issuer_proposal_request_key": "262d0584-9827-4652-9b27-6a46c9832f38"
    },
    "status": "won",
    "event_datetime": "2025-03-20T14:48:43Z",
    "webhook_type": "laas.private_payroll_auction.end_of_auction"
}

A chave da operação de crédito será enviada com valor null para as propostas perdedoras.

Atenção

O link de assinatura não será enviado no ambiente de produção, apenas em sandbox para que seja possível simular a assinatura do tomador.

Anexos

Definição do Objeto IssuerProposalRequest

Nome	Tipo	Descrição
issuer_proposal_request_key	string	Identificador único da Solicitação de Proposta
issuer_proposal_request_data	object	Objeto que descreve os dados da Solicitação de Proposta
status	string	Status da Solicitação de Proposta (ongoing, finished, expired)

Definição do Objeto IssuerProposalRequestData

Nome	Tipo	Descrição
name	string	Nome completo do Tomador
document_number	string	CPF do Tomador
birth_date	string	Data de nascimento do Tomador no formato YYYY-MM-DD
disbursed_amount	float	Valor de desembolso solicitado pelo tomador
number_of_installments	integer	Número de parcelas solicitados pelo tomador
consigned_credit_balance	float	Margem consignável disponível de saldo do tomador
admission_date	string	Data de admissão do trabalhador no cargo atual no formato YYYY-MM-DD
issuer_registration_code	string	Matricula eSocial do empregado
employer_document_number	string	CNPJ do empregador
eligible	boolean	True se elegivel, False se não elegivel
employer_document_type	string	CNPJ ou CPF

Detalhamento dos Status da solicitação de proposta

Status	Descrição
ongoing	Solicitação de Proposta em andamento, o leilão continua ativo.
finished	Solicitação de Proposta finalizada, o leilão foi encerrado e uma Proposta enviada foi aceita e incluída.
expired	Solicitação de Proposta expirada, o leilão foi encerrado sem a inclusão de nenhuma Proposta em tempo hábil.

Detalhamento da Requisição de Proposta de Leilão

Campo	Tipo	Descrição	Obrigatório
issuer_proposal_request_key	string	Chave única de identificação da IssuerProposalRequest incluída no formato uuid v4.	Sim
auction_proposal_key	string	Chave única de identificação da AuctionProposal incluída no formato uuid v4.	Sim
disbursed_issue_amount	float	Valor de desembolso pretendido pela Proposta.	Sim
monthly_interest_rate	float	Taxa de juros mensal da Proposta no intervalo de 0 a 1 (0% a 100%, respectivamente).	Não
installment_face_value	float	Valor da parcela pretendida pela Proposta.	Não
number_of_installments	integer	Número de parcelas da proposta.	Sim
days_to_expiration	integer	Número de dias até que a proposta expire. Caso a chave não seja incluida, a validade da proposta será de 7 dias	Não
rebates	list	Lista de rebates da operação de crédito. Utiliza o mesmo padrão da emissão ativa (/debt)	Não