> ## 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.
# APIX 002
> Envío de datos de Pix bajo demanda al BACEN (Documento 1202) — 12 meses de dimensiones transaccionales mantenidas disponibles, con formato definido por solicitud.
Los participantes de Pix deben entregar datos transaccionales detallados al BACEN siempre que el regulador los solicite. Reporter te ayuda a mantener esos datos estructurados y listos para extracción ad-hoc.
Esta guía cubre el reporte **APIX 002** (Documento 1202) — qué almacenar, cómo organizarlo y cómo responder cuando BACEN envía una solicitud.
A diferencia del APIX 001, el APIX 002 no tiene un formato XML fijo ni esquema XSD. Cada solicitud define su propio formato, dimensiones y plazo. La institución sigue siendo responsable de extraer datos precisos y cumplir con el plazo establecido por el regulador.
## ¿Qué es APIX 002?
***
El **APIX 002** es un envío regulatorio bajo demanda al Banco Central de Brasil, definido por la Instrucción Normativa BCB nº 32/2020. A diferencia del APIX 001 mensual, se envía solo cuando BACEN lo solicita explícitamente, con el formato especificado por solicitud.
### APIX 001 vs APIX 002
| Aspecto | APIX 001 | APIX 002 |
| ------------------------ | ------------------------------- | ---------------------- |
| **Frecuencia** | Mensual (obligatorio) | Bajo demanda |
| **Plazo** | 15º día hábil del mes siguiente | Definido por solicitud |
| **Formato** | XML (XSD fijo) | Definido por solicitud |
| **Layout / XSD** | Disponible (versión 2.5) | No aplicable |
| **Validación** | Pre + post envío | Solo post-envío |
| **Código del documento** | 1201 | 1202 |
### Quién debe reportar
| Tipo de participante | ¿Debe reportar? |
| -------------------------------------------------------- | -------------------------------------------- |
| Participante directo (proveedor de cuenta transaccional) | Sí |
| Liquidador especial | Sí |
| Participante indirecto (liquidado vía BTG, Itaú u otros) | No — consolidado por el participante directo |
Los participantes indirectos no reportan el APIX 002 directamente. El participante directo consolida los datos en su nombre. Sin embargo, los participantes indirectos deben *mantener los datos subyacentes disponibles* para que el participante directo los agregue cuando BACEN realice una solicitud.
### Atributos del envío
| Campo | Valor |
| --------------------- | ------------------------------------------------------------------- |
| Nombre del documento | Datos del participante de Pix bajo demanda |
| Código del documento | 1202 |
| Código STA | APIX002 |
| Frecuencia | No periódica (bajo demanda) |
| Formato | Definido por solicitud |
| Validación | Post-envío |
| Transacción Autran | SPIXP001 |
| Ventana de referencia | Datos mensuales que cubren hasta 12 meses anteriores a la solicitud |
## Por qué APIX 002 no tiene formato fijo
***
La normativa define explícitamente el formato del envío como *"a definir por demanda"* ("Formato para Remessa: a definir para cada demanda"). Esto tiene cuatro implicaciones directas:
1. **No se publica XSD estándar** para APIX 002 — no puedes pre-construir una sola plantilla.
2. **BACEN define el formato** en el momento de la solicitud, incluyendo dimensiones, granularidad y estructura del archivo.
3. **La institución extrae los datos** que coincidan con las dimensiones especificadas.
4. **El plazo se establece por solicitud**, sin un tiempo de respuesta estándar.
Para mantenerte listo, tu almacén de datos necesita soportar consultas flexibles a través de todas las dimensiones que BACEN pueda solicitar.
## Dimensiones de datos a almacenar
***
Los participantes deben mantener los datos descritos en el **Anexo II de la IN 32/2020** durante al menos 12 meses. Los datos están organizados en tres grupos: transacciones liquidadas internamente, todas las transacciones (internas e interbancarias) y combinaciones cruzadas de dimensiones.
### Transacciones liquidadas internamente
Estas dimensiones aplican a transacciones donde tanto pagador como receptor pertenecen a la misma institución.
| Campo | Descripción | Valores |
| ------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| **Programada** | Si la transacción fue programada | Sí / No |
| **Sospecha de fraude** | Transacciones analizadas más allá del límite de tiempo de detección de fraude | Sí / No |
| **No liquidada a tiempo** | Transacciones que excedieron 40 segundos | Sí / No |
| **Rechazada** | Si la transacción fue rechazada | Sí / No |
| **Motivo del rechazo** | Según arts. 38 y 39 de la Resolución BCB nº 1/2020 | Códigos específicos |
| **Procedimiento de iniciación** | Cómo se inició la transacción | 1) Manual; 2) Valores pre-almacenados |
| **Mecanismo de iniciación** | Mecanismo usado para iniciar la transacción | 1) Llave Pix; 2) QR dinámico; 3) QR estático; 4) Iniciador de pago |
| **Naturaleza del pagador** | Tipo de persona | 1) Persona natural; 2) Persona jurídica |
| **Naturaleza del receptor** | Tipo de persona | 1) Persona natural; 2) Persona jurídica |
| **Iniciador** | ISPB del iniciador de pago | Código ISPB (8 dígitos) |
### Todas las transacciones (internas e interbancarias)
Estas dimensiones aplican al conjunto completo de transacciones, incluyendo liquidaciones interbancarias vía SPI.
| Campo | Descripción | Ejemplo |
| --------------------------- | ---------------------------- | ---------------------------------------------------------------- |
| **Año** | Año de referencia | 2026 |
| **Período** | Mes de referencia | 01–12 |
| **Conteo de transacciones** | Conteo total | 1.250.000 |
| **Monto financiero** | Suma de valores | R\$ 985.000.000,00 |
| **Canal de iniciación** | Donde comenzó la transacción | 1) App; 2) Internet banking; 3) Call center; 4) ATM; 5) Sucursal |
### Consultas cruzadas de dimensiones
BACEN puede solicitar combinaciones de múltiples dimensiones. Ejemplos:
* Conteo de transacciones que son **programadas** Y **con sospecha de fraude**
* Valor de transacciones **rechazadas** por **motivo específico** Y **persona jurídica**
* Transacciones por **canal de iniciación** Y **mecanismo de iniciación**
Estructura tu almacenamiento para que cualquier combinación de estas dimensiones pueda ser agregada eficientemente. Una tabla amplia y desnormalizada o un almacén columnar funciona mejor que modelos altamente normalizados para este tipo de consulta regulatoria.
## Proceso de envío
***
### Sistema y transacción
| Ítem | Valor |
| ------------------- | ------------------------------------------ |
| Sistema | STA (Sistema de Transferência de Arquivos) |
| Código de archivo | APIX002 |
| Transacción Autran | SPIXP001 |
| Número de documento | 1202 |
### Flujo de seis pasos
1. **Espera la solicitud de BACEN** — no hay envío proactivo.
2. **Revisa el formato y plazo** especificados por el regulador.
3. **Extrae los datos** que coincidan con las dimensiones solicitadas.
4. **Genera el archivo** en el formato especificado.
5. **Envía a través del STA** usando el código de archivo `APIX002`.
6. **BACEN ejecuta validación post-envío** sobre los datos recibidos.
No hay validación pre-envío para APIX 002. BACEN valida los datos solo después de enviarlos. Asegúrate de que tu extracción sea precisa antes de enviarla.
## Recomendaciones de implementación
***
### Modelo de datos
Una tabla plana, rica en dimensiones, simplifica la extracción bajo demanda. El esquema mínimo recomendado:
```sql theme={null}
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()
);
```
La columna `settlement_type` distingue las transacciones liquidadas internamente (ambas partes en la misma institución) de las transacciones interbancarias liquidadas vía SPI. Esta distinción importa porque algunas dimensiones aplican solo a liquidaciones internas.
### Capacidades requeridas
* [ ] Almacenar datos transaccionales durante al menos 12 meses anteriores a cualquier solicitud
* [ ] Consultar por cualquier dimensión individual o combinación de dimensiones
* [ ] Agregar conteo y monto financiero sobre períodos arbitrarios
* [ ] Exportar a múltiples formatos (CSV, XML, JSON) ya que BACEN puede especificar cualquiera
* [ ] Generar reportes cruzados de dimensiones de manera eficiente
## Referencias regulatorias
***
### Normativas
| Documento | Descripción |
| ------------------------ | ----------------------------------------------------- |
| IN BCB nº 32/2020 | Normativa principal que establece APIX 001 y APIX 002 |
| IN BCB nº 174/2021 | Actualizaciones a los Anexos I y III de la IN 32 |
| IN BCB nº 126/2021 | Actualizaciones anteriores a la IN 32 |
| IN BCB nº 383/2023 | Actualizaciones vigentes desde 2024-02-01 |
| Resolución BCB nº 1/2020 | Regulación de Pix (arts. 38, 39 y 99) |
### Documentos de apoyo
| Documento | Descripción |
| ---------------------------- | ----------------------------------------------------------------- |
| Instrucciones APIX 002 (PDF) | Orientación sobre preparación y envío de solicitudes bajo demanda |
| Manual de Tiempos de Pix | Referencia para los límites de tiempo de Pix |
| Portal de envío de BACEN | Instrucciones y XSD para APIX 001 |
| Sistema STA | Acceso al Sistema de Transferência de Arquivos |
| Instrucciones del STA | Cómo usar el sistema |
| Sisbacen / Autran | Consulta de transacciones |
### Contactos de BACEN
| Tema | Email |
| ----------------------- | ----------------------------------------------------------------- |
| Entrega del envío | [suporte.ti@bcb.gov.br](mailto:suporte.ti@bcb.gov.br) |
| Contenido del documento | [estatisticas.spb@bcb.gov.br](mailto:estatisticas.spb@bcb.gov.br) |
Esta página se basa en la regulación vigente a enero de 2026. Verifica siempre las publicaciones más recientes de BACEN para los requisitos actuales.
A diferencia del APIX 001, que puede ser totalmente automatizado con una plantilla de Reporter, el APIX 002 requiere intervención manual — debes esperar la solicitud específica de BACEN, comprender el formato que define y construir la extracción en consecuencia. Reporter puede ayudar a generar el archivo de salida, pero la plantilla debe crearse por solicitud.