# BC PROTEGE+ - Consulta de Autorização

Consulta de autorização no BC PROTEGE+ para Pessoa Jurídica. Verifica se o CNPJ está autorizado para realizar operações de Abertura de Contas (ACT) e Transferência de Titularidade (ATT) no Banco Central do Brasil.

- **Identificador:** `empresas/bc-protege-consulta-de-autorizacao`
- **Categoria:** PEP, sanções e compliance
- **Audiência:** PJ
- **Endpoint:** `POST /api/v1/{tenant}/empresas/bc-protege-consulta-de-autorizacao`
- **Preço de tabela:** R$ 0,160 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/empresas/bc-protege-consulta-de-autorizacao

## Quando usar

Descrição

O serviço de BC PROTEGE+ - Consulta de Autorização consulta a autorização de Pessoa Jurídica no sistema BC PROTEGE+ do Banco Central do Brasil.

Verifica as permissões para realizar operações de Abertura de Contas (ACT) e Transferência de Titularidade (ATT).

O resultado inclui um relatório detalhado em HTML e PDF com todas as autorizações concedidas ou negadas.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CNPJ da empresa, com ou sem máscara. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `protocolo` | texto |
| `protocolo_resposta` | texto |
| `codigo_estado` | texto |
| `autorizacao.status` | texto |
| `autorizacao.autorizacao.codigo_mensagem` | texto |
| `autorizacao.autorizacao.numero_controle_if` | texto |
| `autorizacao.autorizacao.cnpj_base_ent_respons` | texto |
| `autorizacao.autorizacao.numero_controle_src` | texto |
| `autorizacao.autorizacao.data_hora_bc` | data |
| `autorizacao.autorizacao.data_movimento` | data |
| `autorizacao.autorizacao.permissoes[].tipo_protocolo` | texto |
| `autorizacao.autorizacao.permissoes[].indicador_permissao` | texto |
| `autorizacao.autorizacao.permissoes[].autorizado` | booleano |
| `autorizacao.autorizacao.permissoes[].descricao` | texto |
| `autorizacao.autorizacao.todos_autorizados` | booleano |
| `autorizacao.autorizacao.algum_autorizado` | booleano |
| `autorizacao.autorizacao.status_geral` | texto |
| `resposta.status` | texto |
| `resposta.conteudo` | texto |
| `resposta.conteudo_encoding` | texto |
| `xml_envio` | texto |
| `xml_envio_encoding` | texto |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "BC PROTEGE+ - Consulta de Autorização",
  "query_slug": "bc-protege-consulta-de-autorizacao",
  "data": {
    "protocolo": "texto",
    "protocolo_resposta": "texto",
    "codigo_estado": "texto",
    "autorizacao": {
      "status": "texto",
      "autorizacao": {
        "codigo_mensagem": "texto",
        "numero_controle_if": "texto",
        "cnpj_base_ent_respons": "texto",
        "numero_controle_src": "texto",
        "data_hora_bc": "2026-01-01",
        "data_movimento": "2026-01-01",
        "permissoes": [
          {
            "tipo_protocolo": "texto",
            "indicador_permissao": "texto",
            "autorizado": false,
            "descricao": "texto"
          }
        ],
        "todos_autorizados": false,
        "algum_autorizado": false,
        "status_geral": "texto"
      }
    },
    "resposta": {
      "status": "texto",
      "conteudo": "texto",
      "conteudo_encoding": "texto"
    },
    "xml_envio": "texto",
    "xml_envio_encoding": "texto"
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.160"
}
```
