Manual SRCC - Consulta de Condição da Operação
1. Consulta de condição da operação
Verifica se um CPF tem registro no SRCC em uma data. Esse registro pode ter vindo de uma liquidação antecipada, de uma portabilidade ou de um refinanciamento com redução da parcela.
Use essa consulta antes de decidir sobre a comissão do correspondente: quando o tomador quitou um contrato antes do prazo, uma nova operação feita em menos de 90 dias depois não gera comissão.
A resposta vem na hora, na própria requisição.
O endpoint é liberado por integração. Peça a liberação ao seu contato na QI Tech.
Request
Exemplo
GET /srcc/operation/operation_condition?issuer_document_number=96969879003&payroll_type=social_security&benefit_number=1234567890&reference_date=2026-08-31
Query Params Details
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| issuer_document_number | string | Sim | CPF do tomador, com 11 dígitos e sem pontuação |
| payroll_type | string | Sim | Tipo de empregador: social_security, public ou private |
| benefit_number | string | Só quando payroll_type é social_security | Número do benefício do INSS, apenas dígitos, no máximo 10 |
| reference_date | string | Não | Data usada na consulta, no formato YYYY-MM-DD. Se não for enviada, usamos a data de hoje |
O benefit_number só existe para social_security, e é pedido só nesse caso. Quando o tipo de empregador é public ou private, não envie o campo.
Response
Payload
{
"issuer_document_number": "96969879003",
"payroll_type": "social_security",
"benefit_number": "1234567890",
"reference_date": "2026-08-31",
"has_restriction": true
}
Response Body Details
| Campo | Tipo | Descrição |
|---|---|---|
| issuer_document_number | string | CPF consultado |
| payroll_type | string | Tipo de empregador usado na consulta |
| benefit_number | string | Número do benefício enviado ao SRCC, completado com zeros à esquerda até 10 dígitos. Vem null quando o tipo de empregador não é social_security |
| reference_date | string | Data usada na consulta |
| has_restriction | boolean | true quando o CPF tem registro no SRCC nessa data |
2. Como ler o resultado
| Valor | Significado |
|---|---|
has_restriction: true | O CPF tem registro no SRCC nessa data, e a operação não gera comissão. |
has_restriction: false | O CPF não tem registro no SRCC nessa data. |
O true não diz qual evento gerou o registro. Pode ter sido liquidação antecipada, portabilidade ou refinanciamento com redução da parcela. A consulta também não devolve a data do evento, e o prazo de 90 dias é aplicado pelo próprio SRCC em relação à data que você enviou.
Para conferir uma data passada, como a data em que uma operação já contratada foi feita, envie essa data em reference_date. A consulta sempre olha para a data enviada, não para a data de hoje.
3. Erros
| Código HTTP | Código QI | O que aconteceu |
|---|---|---|
| 400 | SRCC00007 | Faltou um parâmetro obrigatório |
| 400 | SRCC00008 | Um parâmetro foi enviado com valor ou formato inválido |
| 401/403 | (padrão) | Headers de autenticação ausentes ou inválidos |
| 502 | SRCC00009 | O SRCC não aceitou a consulta ou respondeu de forma inesperada |
Nos dois erros de 400, o campo translation diz qual parâmetro está com problema e o que fazer para corrigir.
3.1. SRCC00007 — faltou um parâmetro
| O que faltou | O que vem em translation |
|---|---|
issuer_document_number | O parametro 'issuer_document_number' nao foi enviado. Ele deve conter o CPF do tomador, com 11 digitos e sem pontuacao. |
payroll_type | O parametro 'payroll_type' nao foi enviado. Os valores aceitos sao 'social_security' para INSS, 'public' para servidor publico e 'private' para trabalhador de empresa privada. |
benefit_number, com payroll_type=social_security | O parametro 'benefit_number' nao foi enviado. Ele e obrigatorio quando 'payroll_type' e 'social_security' e deve conter o numero do beneficio do INSS. |
Exemplo
Consulta de INSS sem o número do benefício:
GET /srcc/operation/operation_condition?issuer_document_number=96969879003&payroll_type=social_security
{
"code": "SRCC00007",
"title": "Bad Request",
"description": "Query param 'benefit_number' was not sent. It is required when 'payroll_type' is 'social_security' and must contain the INSS benefit number.",
"translation": "O parametro 'benefit_number' nao foi enviado. Ele e obrigatorio quando 'payroll_type' e 'social_security' e deve conter o numero do beneficio do INSS."
}
3.2. SRCC00008 — parâmetro com valor inválido
| O que você enviou | O que vem em translation |
|---|---|
issuer_document_number=969.698.790-03 | O parametro 'issuer_document_number' deve ser um CPF com exatamente 11 digitos e sem pontuacao. |
payroll_type=other | O parametro 'payroll_type' recebeu um valor que nao existe. Os valores aceitos sao 'social_security' para INSS, 'public' para servidor publico e 'private' para trabalhador de empresa privada. |
benefit_number=123.456.789-0 | O parametro 'benefit_number' deve conter apenas digitos, no maximo 10. |
reference_date=31/08/2026 | O parametro 'reference_date' deve ser uma data no formato 'YYYY-MM-DD'. |
Exemplo
Consulta com o CPF formatado:
GET /srcc/operation/operation_condition?issuer_document_number=969.698.790-03&payroll_type=private
{
"code": "SRCC00008",
"title": "Bad Request",
"description": "Query param 'issuer_document_number' must be a CPF with exactly 11 digits and no punctuation.",
"translation": "O parametro 'issuer_document_number' deve ser um CPF com exatamente 11 digitos e sem pontuacao."
}
3.3. SRCC00009 — problema no SRCC
Nesse caso não há nada errado na sua requisição: o problema está no SRCC ou na comunicação com ele. Tente de novo em alguns minutos e, se continuar, abra um ticket com a QI Tech.
Exemplo
{
"code": "SRCC00009",
"title": "Bad Gateway",
"description": "SRCC did not accept the consult or answered in an unexpected format, so the result could not be read. Nothing is wrong with your request. Retry in a few minutes and open a ticket with QI Tech if it keeps happening.",
"translation": "O SRCC nao aceitou a consulta ou respondeu em um formato inesperado, e nao foi possivel ler o resultado. Nao ha nada errado na sua requisicao. Tente novamente em alguns minutos e abra um ticket com a QI Tech se continuar acontecendo."
}
As mensagens em translation são enviadas sem acento. Não é erro de digitação, é o formato padrão das nossas respostas de erro.
Não use dados pessoais reais, como CPF e número de benefício, no ambiente de sandbox.