> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Não me perturbe

### Não Me Perturbe (Bloqueio de Contato)

**Tipo:** Síncrona

Durante o processo de contratação do empréstimo consignado, é realizada a validação do número de telefone do trabalhador na base do serviço **Não Me Perturbe**.

Caso o telefone esteja cadastrado nesta base, o trabalhador **não poderá prosseguir com a contratação** enquanto o bloqueio estiver ativo.

Para viabilizar a contratação, o trabalhador deverá solicitar a remoção do número diretamente junto à **ABR Telecom**, responsável pela gestão do serviço.

**Prazo de Atualização:**\
A remoção do bloqueio pode levar até **48 horas** para ser refletida nos sistemas.

***

## 1. Validação na jornada do produto

O telefone do trabalhador deve ser obrigatoriamente informado na etapa de criação de vínculo, conforme o endpoint abaixo:

**Endpoint**

```text theme={null}
POST /trabalhador/cadastrar-vinculo
```

**Parâmetros**

* `telefoneFixo1`: Telefone fixo do trabalhador (opcional);
* `telefoneCelular1`: Telefone celular do trabalhador (obrigatório para contato e validações);

Para mais detalhes, consulte a documentação técnica:\
[https://bmpdocs.moneyp.com.br/e-consignado/contratacao-ativa/cadastro-de-empregador-e-trabalhador#exemplo-de-requisicao](https://bmpdocs.moneyp.com.br/e-consignado/contratacao-ativa/cadastro-de-empregador-e-trabalhador#exemplo-de-requisicao)

***

#### Validação e Bloqueio

A validação do telefone ocorre durante o processo de originação da proposta.

Caso seja identificado que o número informado está na base do **Não Me Perturbe**, a operação será automaticamente bloqueada.

***

#### Retorno de Erro

Em caso de bloqueio, o parceiro receberá o seguinte retorno ao tentar originar a proposta:

```text theme={null}
{
  "Erros": [
    "Número de celular informado está na base do Não me perturbe. O número de contato do cliente não pode estar com bloqueio no não me perturbe para permitir a operação."
  ]
}
```

***

#### Considerações Técnicas

* A validação na base **Não Me Perturbe** é obrigatória para continuidade da operação;
* Telefones com bloqueio ativo impedem a contratação do empréstimo consignado;
* A regularização depende exclusivamente da solicitação do trabalhador junto à ABR Telecom;
* Recomenda-se validar previamente o status do telefone para evitar falhas na originação.

***

## 2. Consultas avulsas na base Não me Perturbe

A BMP disponibiliza uma API para que seus parceiros consultem, a qualquer momento, se um telefone consta na base do Não Me Perturbe.

A atualização da base é realizada diariamente, garantindo que as consultas sejam efetuadas utilizando a versão mais recente disponibilizada pela DATAPREV.

***

#### Autenticação

Para consumo da API, é necessário gerar um token JWT no padrão RS256 e posteriormente obter um Bearer Token via OAuth 2.0.

Após a autenticação, o access token retornado deverá ser enviado no header `Authorization` de todas as requisições subsequentes.

```text theme={null}
Authorization: Bearer <AccessToken>
```

#### BASE URL

```text theme={null}
Homologação: https://public-api.partnerhub.scm.moneyp.dev.br
```

```text theme={null}
Produção: https://public-api.partnerhub.scm.moneyp.com.br
```

***

#### Endpoint

```text theme={null}
GET /nao-perturbe/{telefone}
```

***

#### Parâmetros

| Parâmetro | Tipo   | Obrigatório | Descrição                                            |
| :-------- | :----- | :---------- | :--------------------------------------------------- |
| telefone  | string | Sim         | Telefone que será consultado na base Não Me Perturbe |

***

#### Exemplo de Requisição

```text theme={null}
GET /nao-perturbe/11999999999
```

***

#### Exemplo de Respostas

#### Telefone sem bloqueio

#### HTTP 200

```text theme={null}
{
  "telefone": "11999999999",
  "possuiBloqueio": false,
  "telefones": null,
  "dataArquivo": null,
  "empresasBloqueadas": null,
  "origemDescricao": null,
  "statusProcessamento": "Sucesso",
  "codigoProcessamento": 0,
  "descricaoProcessamento": "Sucesso",
  "mensagem": "Telefone não possui bloqueio na base Não Perturbe"
}
```

#### Telefone com bloqueio

#### HTTP 200

```text theme={null}
{
  "telefone": "11999999999",
  "possuiBloqueio": true,
  "telefones": [
    "11999999999",
    "11988888888"
  ],
  "dataArquivo": "2026-04-17",
  "empresasBloqueadas": [
    "TODAS"
  ],
  "origemDescricao": "WEB SITE",
  "statusProcessamento": "Sucesso",
  "codigoProcessamento": 0,
  "descricaoProcessamento": "Sucesso",
  "mensagem": "Telefone possui bloqueio na base Não Perturbe"
}
```

#### HTTP 400

```text theme={null}
{
  "telefone": null,
  "possuiBloqueio": false,
  "mensagem": "Telefone é obrigatório",
  "motivoErro": "TELEFONE_NAO_FORNECIDO"
}
```

#### HTTP 404

```text theme={null}
{
  "telefone": "11999999999",
  "possuiBloqueio": false,
  "mensagem": "Resultado da consulta não encontrado",
  "motivoErro": "DADOS_NAO_ENCONTRADOS"
}
```

***

#### Erro interno

#### HTTP 500

```text theme={null}
{
  "telefone": "11999999999",
  "possuiBloqueio": false,
  "mensagem": "Resposta nula do serviço Bureaus",
  "motivoErro": "ERRO_CONSULTA"
}
```

***

#### Códigos HTTP

| Código | Descrição             | Quando ocorre                                         |
| :----- | :-------------------- | :---------------------------------------------------- |
| 200    | OK                    | Telefone localizado e consulta processada com sucesso |
| 400    | Bad Request           | Telefone não enviado na requisição                    |
| 404    | Not Found             | Telefone não localizado na base consultada            |
| 500    | Internal Server Error | Erro inesperado durante o processamento               |

***

#### Motivos Padronizados

| Motivo                   | Descrição                                  |
| :----------------------- | :----------------------------------------- |
| TELEFONE\_NAO\_FORNECIDO | Telefone não fornecido para consulta       |
| DADOS\_NAO\_ENCONTRADOS  | Telefone não encontrado na base consultada |
| ERRO\_CONSULTA           | Falha inesperada durante a consulta        |
| ERRO\_INTERNO            | Falha inesperada durante a execução        |

***

#### Headers de Resposta

Todas as respostas da API retornam os seguintes headers:

```text theme={null}
Content-Type: application/json
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: Content-Type,Authorization
Access-Control-Allow-Methods: GET,OPTIONS
```

***

#### Considerações Técnicas

* A API utiliza serialização JSON no padrão camelCase;
* O telefone pode ser enviado tanto via path parameter quanto via query string;
* O formato recomendado para integração é `/nao-perturbe/{telefone}`;
* A base de homologação deve ser utilizada para testes integrados;
* A base de produção deve ser utilizada exclusivamente para consumo produtivo;
* A atualização da base Não Me Perturbe ocorre uma vez ao dia.
