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

# Conceitos

> Entenda como funcionam o registro, a validade, o reenvio e os formatos de resposta do Autorizador SCR.

Esta página reúne as regras comuns aos três endpoints do Autorizador SCR.

## Endpoints

Todas as rotas partem do host `https://api.databox360.com.br/api` e exigem autenticação via [Bearer Token](https://docs.databox360.com.br/api-reference/autenticacao.md).

| Operação | Método | Rota |
| - | - | - |
| [Enviar autorização](https://docs.databox360.com.br/autorizador/enviar-autorizacao) | `POST` | `/autorizacoes` |
| [Consultar autorização](https://docs.databox360.com.br/autorizador/consultar-autorizacao) | `GET` | `/autorizacoes/autorizacao/:documento` |
| [Listar autorizações](https://docs.databox360.com.br/autorizador/listar-autorizacoes) | `GET` | `/autorizacoes/` |

## Reenvio atualiza o registro

Cada documento possui uma autorização. Ao enviar novamente os dados de um documento que já tem autorização, o registro existente é atualizado: o `id` e a `dataCriacao` permanecem, e a `dataAtualizacao` muda.

## Validade

O campo `dataExpiracao` informa até quando a autorização está vigente. Para o prazo de guarda dos registros e as regras de revogação, consulte [Sobre o Autorizador SCR](https://docs.databox360.com.br/autorizador/sobre.md).

## Formatos de data

| Campo | Formato | Exemplo |
| - | - | - |
| `metadata.timestamp` (envio) | ISO 8601 com fuso horário | `2026-01-15T10:00:00-03:00` |
| `dataCriacao`, `dataAtualizacao`, `dataExpiracao`, `data` (resposta) | `DD/MM/YYYY HH:mm:ss` | `15/01/2026 10:00:05` |

## Documento e tipo

* O `documento` pode ser enviado com ou sem pontuação. As respostas devolvem apenas os dígitos.
* Na consulta por documento, informe apenas os dígitos na rota.
* O `tipoDocumento` (`cpf` ou `cnpj`) deve corresponder ao número informado: 11 dígitos para `cpf` e 14 para `cnpj`.

## Formatos de resposta

Cada rota devolve um envelope próprio. Trate cada uma de acordo com a sua estrutura.

| Rota | Indicador de sucesso | Conteúdo | Observações |
| - | - | - | - |
| Enviar | `sucesso: true` | `data` (objeto) | Inclui `message`. |
| Consultar | `status: "sucesso"` | `dados` (objeto) | `data` é a data/hora do processamento. |
| Listar | `sucesso: true` | `data` (lista) | Inclui `total`. |

> [!WARNING]
>
> O campo `data` tem significados diferentes conforme a rota: o conteúdo (envio e listagem) ou a data/hora do processamento (consulta).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.