Exportación de datos Banamex desde Bancanet Empresarial

Los datos bancarios valen cuando llegan a los sistemas donde la empresa realmente opera. Bancanet Empresarial exporta movimientos, saldos y catálogos a los formatos que SAP, Oracle, Contpaqi, Aspel y las herramientas de BI internas consumen sin transformación adicional.

Además de archivos, el portal publica una API REST con OAuth 2.0 y webhooks por eventos para automatizar el traspaso en lugar de depender de descargas manuales.

Resumen técnico · Exportación de datos

  • Formatos: CSV, XLSX, TXT posicional, XML CFDI 4.0, MT940, BAI2, JSON.
  • Conectores nativos: SAP (IDoc), Oracle (FBDI), Contpaqi, Aspel SAE/COI.
  • API REST con OAuth 2.0, rate limit 600 req/min, paginación 10,000 registros.
  • Webhooks por evento con firma HMAC SHA-256 y política de reintentos.

Formatos de exportación

El menú de exportación parte del mismo catálogo de reportes disponible en reportes financieros y reportes personalizados. Cada reporte elige su formato de salida: CSV para ingesta simple, XLSX para revisión humana, TXT posicional para sistemas legados, XML para CFDI y cumplimiento regulatorio, MT940 o BAI2 para ERP internacionales.

Para los estados de cuenta, la exportación incluye el PDF legal y el XML CFDI 4.0 timbrado. Para movimientos detallados, el CSV entrega una fila por transacción con fecha, fecha valor, referencia, beneficiario, concepto, cargo, abono, saldo y UUID asociado cuando existe.

Formatos y campos disponibles

FormatoUso típicoEncodingTamaño máximo
CSVIngesta a BI / hojas de cálculoUTF-8 BOM500,000 filas
XLSXRevisión y análisis humanoUTF-8500,000 filas
TXT posicionalSistemas legados / mainframeASCII / ISO-8859-11,000,000 líneas
XML CFDI 4.0SAT, CFDI timbradoISO-8859-1Sin límite práctico
MT940ERP internacional (SAP)ASCIIPor cuenta-día
BAI2ERP internacional (Oracle)ASCIIPor cuenta-día
JSONAPI REST / webhooksUTF-810,000 registros/página

Integraciones ERP nativas

Los conectores para ERP mexicanos (Contpaqi y Aspel SAE/COI) siguen el layout estándar del fabricante, con campos mapeados a movimientos bancarios, comisiones, tipo de cambio e UUID CFDI. La importación en el ERP se realiza sin transformación intermedia, reduciendo el esfuerzo de conciliación a una revisión visual por excepciones.

Para SAP, la exportación genera IDocs FINSTA con la estructura de estado de cuenta electrónico que SAP espera en el módulo Bank Accounting (FI-BL). Para Oracle EBS y Fusion, el formato es Oracle Cash Management FBDI compatible con la carga automática de bank statements. El catálogo de beneficiarios y operadores se alinea por RFC para mantener integridad referencial.

API REST y automatización

La API REST expone endpoints de consulta y ejecución. El flujo de autenticación es OAuth 2.0 client_credentials con token de acceso válido por 3,600 segundos. Los endpoints cubren saldos, movimientos, ejecución de pagos autorizados bajo mancomunidad previa, descarga de reportes y administración del catálogo de beneficiarios.

El rate limit estándar es 600 solicitudes por minuto por client_id. Las llamadas incluyen el header Idempotency-Key para evitar duplicidad en reintentos. La paginación entrega bloques de hasta 10,000 registros con cursores `next_page_token` para recorrer conjuntos grandes sin perder consistencia transaccional.

Webhooks por eventos

Los webhooks publican eventos en tiempo real a una URL configurada: transferencia SPEI completada, dispersión de nómina procesada, estado de cuenta disponible, reporte generado, intento de acceso fallido. El payload es JSON firmado con HMAC SHA-256 usando un secret compartido entre Banamex y la empresa.

La política de reintentos es backoff exponencial: 30 segundos, 2 minutos, 10 minutos, 1 hora, 6 horas. Si la URL no responde tras cinco intentos el evento queda en cola manual para reinyección desde el panel de administración de usuarios por parte del administrador maestro. Todo queda auditado ante la CNBV.

Preguntas frecuentes sobre exportación de datos

¿Bancanet Empresarial expone una API REST?
Sí. El portal cuenta con API REST autenticada por OAuth 2.0 y token de acceso rotativo. Los endpoints cubren consulta de saldos, movimientos, ejecución de pagos autorizados bajo mancomunidad y descarga de reportes en JSON o XML para integraciones continuas.
¿Cuál es el tamaño máximo de archivo exportable?
Los archivos CSV y XLSX soportan hasta 500,000 registros por descarga. Para volúmenes mayores el portal pagina automáticamente y la API REST entrega bloques de 10,000 registros por llamada con cursor next_page_token.
¿En qué encoding se generan los archivos?
El encoding predeterminado es UTF-8 con BOM para compatibilidad con Excel en Windows. CSV admite separador configurable (coma, punto y coma, pipe) y los XML siguen ISO-8859-1 requerida por el SAT para complementos CFDI.
¿Qué política de reintentos aplica la API REST?
La API devuelve códigos HTTP estándar. Los 429 recomiendan backoff exponencial desde 1 hasta 60 segundos. Los 5xx transitorios admiten hasta cinco reintentos automáticos. Las respuestas son idempotentes mediante el header Idempotency-Key.
¿Los webhooks están disponibles?
Sí. El portal publica webhooks por eventos con firma HMAC SHA-256 para validar autenticidad. La URL y el secret se configuran desde el panel del administrador maestro y la bitácora guarda cada intento de entrega.

Servicios relacionados