Encuentra el síntoma, confirma la causa, verifica y corrige. Si persiste, abre un ticket (Soporte) con el origen, la hora y el mensaje exacto.
Antes que nada: la prueba de conexión#
En ETL/ELT → Conexiones, usa "Probar conexión" con la credencial del origen y confirma que el descubrimiento lista las tablas esperadas. Es la verificación más rápida.
Catálogo#
| Síntoma | Causa probable | Cómo verificar | Solución | Prevención |
|---|---|---|---|---|
| "Probar conexión" falla de inmediato | credencial inválida/vencida | revisa usuario/token en el conector | actualiza la credencial y prueba de nuevo | rota las credenciales antes del vencimiento |
| El conector OAuth deja de funcionar después de unos días | refresh token no persistido en Bling/Conta Azul/HubSpot | error de auth después de un tiempo | vuelve a conectar el origen (nuevo OAuth) | reconexión periódica por ahora |
| El descubrimiento no lista las tablas esperadas | alcance/permiso de la credencial insuficiente | revisa los alcances concedidos en el proveedor | concede el alcance de lectura necesario | documenta los alcances mínimos por origen |
| ERP/sistema fiscal de Brasil rechaza (Omie/Bling/Tiny/NF-e) | App Key/Secret/token/certificado incorrectos | valida las credenciales en el panel del ERP | corrige la credencial; para NF-e revisa el .pfx | guarda los secretos como variables de entorno, nunca en el código |
| Meta Ads / Google Ads no autoriza | App Review / developer token pendiente | conector en acceso limitado | espera la aprobación; úsalo dentro del alcance soportado | sigue el estado en Conectores |
| Azure Blob no retoma desde donde se quedó | la reanudación es por nombre de blob | el blob ≤ último procesado se omite | reordena/renombra según la política de reanudación | nombra los blobs de forma monótona |
| El error parece exponer un token | — | nunca debería: los secretos se ocultan | si un token apareció en un log/URL, rótalo | trata la filtración como incidente Crítico |
| "Amazon S3 / traer bucket GCS del cliente" no disponible | el recurso es Roadmap (no implementado) | consulta Estado | usa un conector disponible | no planifiques una integración crítica sobre el Roadmap |
La "carga incremental" es por watermark, no CDC
La ingesta incremental usa watermark (marca de agua por columna). El CDC
verdadero (captura de cambios) es Roadmap — consulta
Ingesta incremental.
Seguridad al reportar#
- Elimina los secretos del ejemplo antes de abrir un ticket. Si un secreto se filtró en un log/URL, revócalo/rótalo primero — consulta Credenciales y rotación.
Relacionados#
Última revisión: 2026-09-08. CDC (captura de cambios) está planificado.