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.
  • 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.

En esta sección documentamos exclusivamente el modelo de datos — qué tablas existen, qué columnas tienen, qué tipos y qué relaciones. Las particularidades de cada canal de entrega (export batch, conectores específicos, ventanas de actualización, etc.) se documentarán por separado cuando esa capa esté lista, sin que el esquema descrito acá necesite cambiar.

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​