Saltar al contenido principal

¿Qué es Sincronización y Datos?

Sincronización y Datos es un servicio adicional que expone el modelo de datos canónico de tu cuenta como un conjunto de tablas relacionales, pensadas para análisis, reporting y sincronización hacia un data warehouse.

Las entidades centrales son las mismas que ya aparecen en la API REST y en el dashboard (clientes, pagos, suscripciones, mandatos, gateways, sesiones, eventos…) pero el modelo va más allá de la superficie de la API. Las tablas vienen vinculadas entre sí por claves foráneas, lo que permite cruzar pagos, clientes, métodos de pago, suscripciones, gateways y eventos en una sola consulta SQL, sin necesidad de orquestar múltiples llamadas ni reensamblar respuestas anidadas.

Con el servicio habilitado puedes:

  • Consultar tus datos con SQL directamente sobre el modelo canónico, sin tener que mantener una integración por API para casos analíticos o de reporting.
  • Recibir lotes Parquet en S3 con snapshots periódicos del mismo modelo (ver Entrega Parquet).
  • Sincronizar los datos hacia un data warehouse externo (Snowflake, BigQuery, Redshift, etc.) para combinarlos con tus otras fuentes y alimentar dashboards, modelos analíticos o flujos de billing internos.
Servicio opcional

Sincronización y Datos no viene activado por defecto. Consulta a soporte@debi.pro por este servicio adicional.

Qué cubre esta sección​

Además del modelo en sí, documentamos cómo se entregan los datos cuando el canal es export batch a S3:

TemaPágina
Tablas, columnas y relacionesModelo de datos
IDs, timestamps, soft deletes, cursoresConvenciones
Lotes Parquet, orden FIFO, retención en bucketEntrega Parquet (S3)
Consultas de ejemploRecetas SQL, Dashboard custom

El esquema de tablas es el mismo en SQL directo y en Parquet; solo cambia el mecanismo de entrega. Otros canales (conectores dedicados, SQL embebido en la app) se documentan aparte si aplican a tu contrato.

Convenciones rápidas
  • Todos los id son los IDs públicos con prefijo (CSljikas98, PYa8EJ1DkDnY, SBmQ6j9NWxblNv…) que devuelve la API pública.
  • Los nombres de tablas, columnas, estados (status) y demás enums se mantienen siempre en inglés, igual que en la API.
  • Los timestamps usan RFC3339 con offset (2022-02-11T23:19:22-03:00).
  • Los importes se expresan en la unidad mayor de la moneda (por ejemplo 12.50 ARS, no centavos).
  • Para ingesta incremental hacia un data warehouse, se usa la columna dw_loaded_at como cursor (no updated_at): avanza cada vez que se publica una fila, por lo que el polling no se saltea actualizaciones tardías. Más detalle en Convenciones → dw_loaded_at.

Mapa de esta sección​