APIX 002

Envía datos de Pix bajo demanda al BACEN (Documento 1202) manteniendo 12 meses de dimensiones transaccionales con el 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:

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	[e-mail]
Contenido del documento	[e-mail]

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.