Documentation Index
Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
Use this file to discover all available pages before exploring further.
Os participantes do Pix devem entregar dados transacionais detalhados ao BACEN sempre que o regulador solicitar. O Reporter ajuda você a manter esses dados estruturados e prontos para extração ad-hoc.
Este guia cobre o relatório APIX 002 (Documento 1202) — o que armazenar, como organizar e como responder quando o BACEN envia uma solicitação.
Diferente do APIX 001, o APIX 002 não tem formato XML fixo nem schema XSD. Cada solicitação define seu próprio formato, dimensões e prazo. A instituição permanece responsável por extrair dados precisos e cumprir o prazo definido pelo regulador.
O que é o APIX 002?
O APIX 002 é um envio regulatório sob demanda ao Banco Central do Brasil, definido pela Instrução Normativa BCB nº 32/2020. Diferente do APIX 001 mensal, é enviado apenas quando o BACEN o solicita explicitamente, com o formato especificado por solicitação.
APIX 001 vs APIX 002
| Aspecto | APIX 001 | APIX 002 |
|---|
| Frequência | Mensal (obrigatório) | Sob demanda |
| Prazo | 15º dia útil do mês seguinte | Definido por solicitação |
| Formato | XML (XSD fixo) | Definido por solicitação |
| Layout / XSD | Disponível (versão 2.5) | Não aplicável |
| Validação | Pré + pós envio | Apenas pós-envio |
| Código do documento | 1201 | 1202 |
Quem deve reportar
| Tipo de participante | Deve reportar? |
|---|
| Participante direto (provedor de conta transacional) | Sim |
| Liquidante especial | Sim |
| Participante indireto (liquidado via BTG, Itaú ou outros) | Não — consolidado pelo participante direto |
Os participantes indiretos não reportam o APIX 002 diretamente. O participante direto consolida os dados em seu nome. No entanto, os participantes indiretos ainda devem manter os dados subjacentes disponíveis para que o participante direto os agregue quando o BACEN fizer uma solicitação.
Atributos do envio
| Campo | Valor |
|---|
| Nome do documento | Dados do participante de Pix sob demanda |
| Código do documento | 1202 |
| Código STA | APIX002 |
| Frequência | Não periódica (sob demanda) |
| Formato | Definido por solicitação |
| Validação | Pós-envio |
| Transação Autran | SPIXP001 |
| Janela de referência | Dados mensais cobrindo até 12 meses anteriores à solicitação |
A normativa define explicitamente o formato do envio como “a definir por demanda” (“Formato para Remessa: a definir para cada demanda”). Isso tem quatro implicações diretas:
- Nenhum XSD padrão é publicado para o APIX 002 — você não pode pré-construir um único template.
- O BACEN define o formato no momento da solicitação, incluindo dimensões, granularidade e estrutura do arquivo.
- A instituição extrai os dados que correspondem às dimensões especificadas.
- O prazo é definido por solicitação, sem tempo de resposta padrão.
Para se manter pronto, seu repositório de dados precisa suportar consultas flexíveis em todas as dimensões que o BACEN possa solicitar.
Dimensões de dados a armazenar
Os participantes devem manter os dados descritos no Anexo II da IN 32/2020 por pelo menos 12 meses. Os dados são organizados em três grupos: transações liquidadas internamente, todas as transações (internas e interbancárias) e combinações cruzadas de dimensões.
Transações liquidadas internamente
Essas dimensões aplicam-se a transações em que tanto pagador quanto recebedor pertencem à mesma instituição.
| Campo | Descrição | Valores |
|---|
| Agendada | Se a transação foi agendada | Sim / Não |
| Suspeita de fraude | Transações analisadas além do limite de tempo de detecção de fraude | Sim / Não |
| Não liquidada a tempo | Transações que excederam 40 segundos | Sim / Não |
| Rejeitada | Se a transação foi rejeitada | Sim / Não |
| Motivo da rejeição | Conforme arts. 38 e 39 da Resolução BCB nº 1/2020 | Códigos específicos |
| Procedimento de iniciação | Como a transação foi iniciada | 1) Manual; 2) Valores pré-armazenados |
| Mecanismo de iniciação | Mecanismo usado para iniciar a transação | 1) Chave Pix; 2) QR dinâmico; 3) QR estático; 4) Iniciador de pagamento |
| Natureza do pagador | Tipo de pessoa | 1) Pessoa natural; 2) Pessoa jurídica |
| Natureza do recebedor | Tipo de pessoa | 1) Pessoa natural; 2) Pessoa jurídica |
| Iniciador | ISPB do iniciador de pagamento | Código ISPB (8 dígitos) |
Todas as transações (internas e interbancárias)
Essas dimensões aplicam-se ao conjunto completo de transações, incluindo liquidações interbancárias via SPI.
| Campo | Descrição | Exemplo |
|---|
| Ano | Ano de referência | 2026 |
| Período | Mês de referência | 01–12 |
| Contagem de transações | Contagem total | 1.250.000 |
| Valor financeiro | Soma dos valores | R$ 985.000.000,00 |
| Canal de iniciação | Onde a transação começou | 1) App; 2) Internet banking; 3) Call center; 4) ATM; 5) Agência |
Consultas cruzadas de dimensões
O BACEN pode solicitar combinações de múltiplas dimensões. Exemplos:
- Contagem de transações que são agendadas E com suspeita de fraude
- Valor de transações rejeitadas por motivo específico E pessoa jurídica
- Transações por canal de iniciação E mecanismo de iniciação
Estruture seu armazenamento para que qualquer combinação dessas dimensões possa ser agregada de forma eficiente. Uma tabela ampla e desnormalizada ou um armazenamento colunar funciona melhor do que modelos altamente normalizados para esse tipo de consulta regulatória.
Processo de envio
Sistema e transação
| Item | Valor |
|---|
| Sistema | STA (Sistema de Transferência de Arquivos) |
| Código do arquivo | APIX002 |
| Transação Autran | SPIXP001 |
| Número do documento | 1202 |
Fluxo de seis passos
- Aguarde a solicitação do BACEN — não há envio proativo.
- Revise o formato e o prazo especificados pelo regulador.
- Extraia os dados que correspondem às dimensões solicitadas.
- Gere o arquivo no formato especificado.
- Envie pelo STA usando o código de arquivo
APIX002.
- O BACEN executa validação pós-envio sobre os dados recebidos.
Não há validação pré-envio para o APIX 002. O BACEN valida os dados apenas após o envio. Garanta que sua extração esteja precisa antes de enviar.
Recomendações de implementação
Modelo de dados
Uma tabela plana e rica em dimensões facilita a extração sob demanda. O schema mínimo recomendado:
CREATE TABLE pix_transactions (
id UUID PRIMARY KEY,
occurred_at TIMESTAMP NOT NULL,
year SMALLINT NOT NULL,
month SMALLINT NOT NULL,
amount NUMERIC(18, 2) NOT NULL,
settlement_type VARCHAR(16) NOT NULL, -- INTERNAL / SPI
scheduled BOOLEAN NOT NULL DEFAULT FALSE,
suspected_fraud BOOLEAN NOT NULL DEFAULT FALSE,
not_settled_in_time BOOLEAN NOT NULL DEFAULT FALSE,
rejected BOOLEAN NOT NULL DEFAULT FALSE,
rejection_reason VARCHAR(8),
initiation_procedure SMALLINT NOT NULL, -- 1=Manual, 2=Pre-stored
initiation_mechanism SMALLINT NOT NULL, -- 1=Key, 2=Dynamic QR, 3=Static QR, 4=Initiator
payer_nature SMALLINT NOT NULL, -- 1=Natural, 2=Legal
receiver_nature SMALLINT NOT NULL, -- 1=Natural, 2=Legal
initiation_channel SMALLINT NOT NULL, -- 1=App, 2=Web, 3=Call, 4=ATM, 5=Branch
initiator_ispb VARCHAR(8),
created_at TIMESTAMP NOT NULL DEFAULT NOW()
);
A coluna settlement_type distingue as transações liquidadas internamente (ambas as partes na mesma instituição) das transações interbancárias liquidadas via SPI. Essa distinção importa porque algumas dimensões aplicam-se apenas a liquidações internas.
Capacidades necessárias
Referências regulatórias
Normativas
| Documento | Descrição |
|---|
| IN BCB nº 32/2020 | Normativa principal que estabelece o APIX 001 e o APIX 002 |
| IN BCB nº 174/2021 | Atualizações dos Anexos I e III da IN 32 |
| IN BCB nº 126/2021 | Atualizações anteriores à IN 32 |
| IN BCB nº 383/2023 | Atualizações vigentes a partir de 2024-02-01 |
| Resolução BCB nº 1/2020 | Regulamentação do Pix (arts. 38, 39 e 99) |
Documentos de apoio
| Documento | Descrição |
|---|
| Instruções do APIX 002 (PDF) | Orientação para preparar e enviar solicitações sob demanda |
| Manual de Tempos do Pix | Referência para os limites de tempo do Pix |
| Portal de envio do BACEN | Instruções e XSD para o APIX 001 |
| Sistema STA | Acesso ao Sistema de Transferência de Arquivos |
| Instruções do STA | Como usar o sistema |
| Sisbacen / Autran | Consulta de transações |
Contatos do BACEN
| Tópico | Email |
|---|
| Entrega do envio | suporte.ti@bcb.gov.br |
| Conteúdo do documento | estatisticas.spb@bcb.gov.br |
Esta página é baseada na regulamentação em vigor em janeiro de 2026. Verifique sempre as publicações mais recentes do BACEN para os requisitos atuais.
Diferente do APIX 001, que pode ser totalmente automatizado com um template do Reporter, o APIX 002 exige intervenção manual — você deve aguardar a solicitação específica do BACEN, entender o formato definido e construir a extração de acordo. O Reporter pode ajudar a gerar o arquivo de saída, mas o template deve ser criado por solicitação.
