# QI Tech — Crédito Consignado › SRCC

Documentação da QI Tech em texto corrido, para colar em um LLM.
Fonte: https://docs.qitech.com.br
2 página(s).

Índice:
- Manual SRCC - Consulta de Condição da Operação (/documentation/srcc/consulta_condicao_operacao)
- Manual SRCC - Introdução (/documentation/srcc/introducao)

---

# Manual SRCC - Consulta de Condição da Operação

URL: /documentation/srcc/consulta_condicao_operacao

:::info Antes de começar
- [Introdução ao SRCC](/documentation/srcc/introducao)
:::

---

## 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.

:::info Liberação do endpoint
O endpoint é liberado por integração. Peça a liberação ao seu contato na QI Tech.
:::

### Request

**GET**
/srcc/operation/operation_condition

**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 |

:::caution Número do benefício
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

STATUS
**200** (OK)

**Payload**

```json
{
    "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. |

:::caution
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
```

```json
{
    "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
```

```json
{
    "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**

```json
{
    "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."
}
```

:::info Acentuação
As mensagens em `translation` são enviadas sem acento. Não é erro de digitação, é o formato padrão das nossas respostas de erro.
:::

:::danger Aviso Importante!
Não use dados pessoais reais, como CPF e número de benefício, no ambiente de sandbox.
:::

---

# Manual SRCC - Introdução

URL: /documentation/srcc/introducao

:::info Próximo passo
- [Consulta de Condição da Operação](/documentation/srcc/consulta_condicao_operacao)
:::

---

## 1. O que é o SRCC

O SRCC (Serviço de Registro de Crédito Consignado) é um registro central de operações de crédito consignado, mantido pela [Núclea](https://www.nuclea.com.br/registro-de-credito-consignado/).

Os bancos que aderiram às regras do consignado, criadas em 2021 pela FEBRABAN e pela ABBC, registram ali alguns eventos das operações que fazem. Qualquer um desses bancos pode consultar o registro depois.

## 2. O que fica registrado

| Evento | Quando acontece |
|--------|-----------------|
| Portabilidade | O contrato passa para outro banco. |
| Refinanciamento | O contrato é refinanciado com redução da parcela. |
| Liquidação antecipada | O contrato é quitado antes do prazo. |

Cada registro fica ligado ao CPF do tomador e ao tipo de empregador que desconta as parcelas na folha.

## 3. Para que serve a consulta

Uma das regras do consignado trata da comissão do correspondente bancário: se o tomador quitou um contrato antes do prazo, uma nova operação feita em menos de **90 dias** depois dessa quitação não gera comissão.

A consulta ao SRCC é o que responde essa pergunta. Você envia o CPF, o tipo de empregador e uma data. A resposta diz se aquele CPF tem registro no SRCC naquela data.

:::info
Os eventos registrados e o prazo de 90 dias são definidos pelas regras do consignado e pelos manuais do SRCC publicados pela Núclea. A QI Tech faz a consulta e traduz a resposta, sem mudar o critério.
:::

## 4. Tipos de empregador

O SRCC separa o tomador pelo tipo de empregador, ou seja, por quem desconta as parcelas na folha:

| Valor | Descrição |
|-------|-----------|
| `social_security` | INSS: aposentados e pensionistas. |
| `public` | Servidor público federal, estadual ou municipal. |
| `private` | Trabalhador de empresa privada (CLT). |