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.
Qué debe demostrar cada situación
| Situación | Conducta acordada | Evidencia de aceptación |
|---|---|---|
| Página pendiente | Conservar la continuación del mismo recorrido. | Todas las páginas previstas quedaron procesadas. |
| Caída al guardar | Recuperar o repetir el tramo con comprobación. | No hay registros omitidos ni efectos duplicados. |
| Punto invalidado | Reconstruir la copia delimitada. | Resultado contrastado y datos propios preservados. |
| Ciclo terminado | Confirmar 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.
Antes de aceptar la recuperación de una sincronización
Marca lo que ya revisaste. Las marcas quedan solo en esta página.
Errores comunes
Cerrar el ciclo porque llegó una respuesta vacía, sin revisar si quedan páginas.
Guardar avance sin comprobar qué cambios quedaron aplicados.
Borrar datos propios al reconstruir una copia sincronizada.
Presentar la conexión disponible como evidencia de información completa.
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
CON TEXTO Y CONTEXTO
Fuentes y referencias
- Use delta query to track changes in Microsoft Graph dataMicrosoft
- 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.
