Digital DevDECISIONES CON FUNDAMENTOHablemos de tu empresa
Volver al diarioDIARIO DIGITAL DEV
IntegraciónCómo se hace

Sincronización incremental: cómo recuperarla tras una interrupción

Una conexión restablecida puede dejar datos pendientes. Acuerda cómo se retoma el recorrido, cuándo se confirma el avance y qué sucede si el origen obliga a reconstruir la copia.

Del recorrido al avance confirmadoEsquema explicativo: Recorrido propuesto para la aceptación: leer las páginas necesarias, comprobar los cambios aplicados y confirmar el avance recuperable del ciclo. Páginas → Cambios: Aplicar. Cambios → Avance: Confirmar.AplicarConfirmarPáginasCambiosAvance

Recorrido propuesto para la aceptación: leer las páginas necesarias, comprobar los cambios aplicados y confirmar el avance recuperable del ciclo.

Ver el recorrido del esquema
  1. Páginas CambiosAplicar
  2. Cambios AvanceConfirmar

RESPUESTA CORTA

La integración debe conservar un avance comprobable, recorrer todas las páginas y confirmar que aplicó sus cambios antes de cerrar el ciclo. Si el origen invalida el punto de continuación, necesita una reconstrucción controlada de la copia, con protección de los datos propios y evidencia de lo que quedó pendiente.

Para quién
  • Gerencia general
  • Liderazgo de TI
  • Responsables de integración
En este artículo

LAS IDEAS CLAVE

  • 01

    Un recorrido termina cuando se completaron sus páginas y se confirmó la aplicación correspondiente.

  • 02

    El avance guardado debe permitir recuperarse sin saltar trabajo ni repetir efectos indebidamente.

  • 03

    Reconstruir una copia exige separar los datos sincronizados de la información propia del negocio.

El problema aparece después de volver a conectar

Imagina un catálogo ficticio cuya copia alimenta un portal empresarial. Mientras la conexión está caída, el origen agrega productos, modifica otros y retira algunos. Recuperar la conexión permite volver a solicitar información, pero todavía hay que explicar qué cambios llegaron y cuáles faltan. Aceptar la integración requiere comprobar el conjunto que usa el portal, además de la disponibilidad técnica del servicio.

Esta guía desarrolla la continuidad de una sincronización recurrente. La elección del mecanismo está en la guía de integración por API y webhooks; el traslado inicial se aborda en la guía de migración de datos. Aquí proponemos pasos y pruebas para contratar una recuperación verificable. Las referencias de Microsoft Graph y Google Calendar son contratos concretos, no capacidades garantizadas de cualquier ERP o CRM.

Delimita la copia que debe mantenerse al día

Documenta qué conjunto se copia: sistema de origen, organización, tipo de registro, filtros y campos necesarios. Identifica la clave que relaciona cada registro con su copia y qué sistema decide sus valores. Separa esos campos de anotaciones o decisiones que nacen en el destino. Así podrás revisar una reconstrucción sin tratar todo el portal como información reemplazable.

Pide al proveedor una ficha de alcance que acompañe el avance guardado. Una marca de continuación solo tiene sentido para el recorrido al que pertenece. Si cambia el conjunto o la consulta, solicita comprobar qué permite el contrato antes de reutilizarla. Incluye quién autoriza esos cambios y cómo se detecta una ejecución con configuración distinta de la prevista.

COMPARA ANTES DE DECIDIR

Qué debe demostrar cada situación

Qué debe demostrar cada situación
SituaciónConducta acordadaEvidencia de aceptación
Página pendienteConservar la continuación del mismo recorrido.Todas las páginas previstas quedaron procesadas.
Caída al guardarRecuperar o repetir el tramo con comprobación.No hay registros omitidos ni efectos duplicados.
Punto invalidadoReconstruir la copia delimitada.Resultado contrastado y datos propios preservados.
Ciclo terminadoConfirmar avance y alcance.Datos contrastados y diferencias resueltas en el alcance aceptado.

En pantallas pequeñas, desliza la tabla para comparar.

Distingue continuar una página de terminar el ciclo

Una respuesta puede ser solamente una parte del trabajo. Microsoft Graph diferencia nextLink, que lleva a páginas pendientes, de deltaLink, que permite consultar cambios en un ciclo posterior. Incluso una página vacía puede tener continuación. La documentación pide reutilizar los enlaces devueltos y trata sus tokens como opacos. Microsoft: seguimiento de cambios con delta query.

En Google Calendar, el nuevo nextSyncToken aparece al final del recorrido. Si una sincronización incremental entrega más páginas, se conserva el syncToken de esa consulta y se añade el pageToken correspondiente. Google: sincronización incremental de Calendar. Para contratar, pide una explicación equivalente de tu API: cómo reconoce páginas pendientes, qué indica finalización y qué dato debe guardar. No reemplaces una marca opaca por una fecha calculada localmente.

Confirma el avance junto con los datos aplicados

Como criterio de diseño, exige que el proveedor explique la relación entre aplicar cambios y guardar el avance. Si registra que avanzó antes de conservar los datos correspondientes, podría saltarse trabajo después de una caída. Si guarda los datos y se interrumpe antes de confirmar el avance, deberá poder revisar o repetir ese tramo de manera segura. La solución concreta depende de los sistemas involucrados.

Pide demostrar ambas interrupciones con registros ficticios. El informe debe mostrar desde dónde retomó, qué registros volvió a evaluar y cómo comprobó el resultado. No basta con enseñar el último token recibido: hace falta distinguir recepción, aplicación y cierre confirmado. Si la réplica activa otras operaciones, delimita esos efectos y consulta la guía de reintentos sin duplicar pedidos. Releer datos no debería convertirse inadvertidamente en repetir una acción comercial.

Acuerda cómo se representan cambios y eliminaciones

Microsoft advierte que una entidad puede aparecer varias veces y que no debe suponerse un orden específico en las respuestas delta. También define representaciones para elementos retirados. Microsoft: representación de los cambios. La posición en una página no basta para interpretar el estado del negocio; revisa la documentación del recurso concreto y la forma de combinar sus resultados.

Prepara casos separados para un registro creado, uno modificado y otro retirado. En cada caso, especifica qué debe verse en el destino y qué información propia debe conservarse. Una ausencia en una página parcial no demuestra eliminación. Tampoco debe transformarse una señal de retiro en autorización para borrar historia comercial. Si llegan avisos con estados contradictorios, la guía de eventos fuera de orden desarrolla la precedencia; aquí la aceptación comprueba que el recorrido incluye y procesa las bajas previstas.

Prepara la pérdida del punto de continuación

Calendar documenta respuestas 410 cuando se invalida un token, por ejemplo por expiración o cambios en permisos relacionados. Su procedimiento requiere limpiar el almacén de eventos del cliente y hacer una sincronización completa. Google: sincronización completa requerida por el servidor. Ese almacén es la copia sincronizada del ejemplo; no es una instrucción para borrar registros comerciales propios de una aplicación integrada.

Antes de contratar, exige delimitar qué copia puede reconstruirse, qué datos deben preservarse y cómo se verificará el reemplazo. Una alternativa a evaluar es preparar y revisar una nueva copia antes de habilitarla, si la arquitectura lo permite. Debe quedar visible si la información disponible sigue siendo la anterior o si el recorrido está suspendido. Acuerda qué operaciones del negocio pueden continuar en cada estado.

Pide identificar la respuesta de invalidez del proveedor real y separarla de errores de autorización, límites de consumo o fallas transitorias. No toda falla significa perder el avance. La propuesta debe indicar cuándo reanudar, cuándo solicitar intervención y cuándo reconstruir. Un reintento indefinido del mismo punto inválido no resuelve esa decisión.

Ejecuta un ensayo de recuperación con resultado esperado

Usa un ambiente autorizado y datos ficticios; simula los destinos externos que pudieran enviar mensajes o modificar operaciones reales. Define primero un conjunto esperado con identificadores y campos relevantes. Distribuye cambios entre varias páginas, interrumpe el proceso y comprueba el resultado tras retomarlo. Incluye una página vacía con continuación cuando el contrato la admita, además de modificaciones y bajas.

Ensaya por separado la invalidez del punto guardado. Verifica que se activa el procedimiento acordado y que los datos propios permanecen protegidos. Compara registros, relaciones y campos; un conteo coincidente puede ocultar un faltante y un duplicado. Registra las diferencias y su resolución antes de aceptar. El ensayo acredita esas condiciones probadas, no una garantía de ausencia de pérdida en cualquier escenario.

Entrega la operación con estados comprensibles

Acuerda una vista operativa que distinga último ciclo terminado, recorrido en curso, interrupción y reconstrucción pendiente. Debe indicar el alcance afectado y quién atiende la excepción. Conserva referencias suficientes para investigar sin exponer tokens, credenciales ni datos privados en paneles compartidos. Si la aplicación muestra una hora de actualización, define qué hecho representa. Microsoft advierte que los cambios pueden tardar en aparecer en delta query; terminar el recorrido no acredita actualización instantánea. Microsoft: demoras de procesamiento.

Lleva a la evaluación de integración de sistemas el conjunto a sincronizar, la documentación disponible y los recorridos que dependen de esa copia. Pide incorporar a la propuesta el ensayo, la evidencia de aceptación y el procedimiento de recuperación. El cierre útil para la empresa es poder explicar qué información está disponible, qué quedó pendiente y cómo volverá a comprobarse.

PARA TU PRÓXIMA CONVERSACIÓN

Antes de aceptar la recuperación de una sincronización

Marca lo que ya revisaste. Las marcas quedan solo en esta página.

Descargar recurso en PDF

Errores comunes

  1. Cerrar el ciclo porque llegó una respuesta vacía, sin revisar si quedan páginas.

  2. Guardar avance sin comprobar qué cambios quedaron aplicados.

  3. Borrar datos propios al reconstruir una copia sincronizada.

  4. Presentar la conexión disponible como evidencia de información completa.

DE LA LECTURA A LA DECISIÓN

Qué hacer esta semana

  1. Define el conjunto sincronizado y separa la información propia del destino.
  2. Pide un ensayo de interrupción y otro de punto invalidado con resultados esperados.
  3. Incluye evidencia de aceptación, responsables y recuperación en la propuesta.

Preguntas frecuentes

¿Basta con guardar la fecha de la última sincronización?

Depende del contrato del origen. Si entrega tokens o enlaces opacos, conserva y utiliza esas referencias según su documentación. Una fecha local no equivale necesariamente al punto de continuación ni demuestra que todas las páginas fueron aplicadas.

¿Una respuesta sin registros significa que terminó el trabajo?

No siempre. Hay que revisar la señal de continuación o finalización del proveedor. Microsoft Graph puede devolver una página vacía que todavía tenga nextLink; el ciclo no termina por el tamaño de esa página.

¿Hay que borrar el destino si deja de servir el token?

No se debe borrar indiscriminadamente. La recuperación debe delimitar la copia que se reconstruye, preservar datos propios y seguir el contrato del proveedor. Antes de habilitarla, comprueba su resultado y deja explícito qué información continúa pendiente.

Guías para evaluar tu proyecto

Si necesitas llevar este tema a tu operación, estos recursos te ayudan a comparar alternativas y preparar el alcance antes de contratar.

Integración por API y webhooks: cómo elegir y comprobar el flujo

Cómo integrar ventas, registro y cobro entre tus sistemas

CON TEXTO Y CONTEXTO

Fuentes y referencias

  1. Use delta query to track changes in Microsoft Graph dataMicrosoft
  2. Synchronize resources efficientlyGoogle for Developers

Contenido elaborado con asistencia de IA a partir de las fuentes enlazadas. Las recomendaciones corresponden al análisis editorial de Digital Dev. Cómo elaboramos y corregimos nuestros artículos.

DE LA LECTURA A TU PROYECTO

¿Tus sistemas obligan a repetir el mismo trabajo?

Identifiquemos qué información debe pasar entre aplicaciones, quién la autoriza y cómo comprobar su llegada. Con las APIs y condiciones de tus proveedores podemos evaluar un primer flujo de integración.

ESTÁS CONSULTANDO DESDE

Sincronización incremental: cómo recuperarla tras una interrupción

No necesitas tener un documento técnico preparado. Cuéntanos el desafío y coordinamos la conversación por correo.

Conoce a las personas detrás de Digital Dev

HABLEMOS DE TU PROYECTO

Solicita una reunión.

Solo nombre y email son obligatorios. Coordinamos por correo.

Usaremos tus datos para responder y el origen detectado para entender cómo llegaste; ese contexto permanece en esta pestaña hasta dos horas. Medimos visitas y solicitudes automáticamente con Google y OpenAI. Nuestra medición de GA4 no incluye lo que escribes; las etiquetas publicitarias pueden usar datos de contacto hasheados según su configuración. Evita información confidencial.

Tu consulta se envía directamente a Digital Dev.