DocumentaciónDocumentación
Talk2Sync Documentation
Manual de Usuario
APIs de Conexiones
  • English
  • Español
Talk2Sync Documentation
Manual de Usuario
APIs de Conexiones
  • English
  • Español
  • Portal de Guía de Usuario y Documentación de API
  • User-documentation

    • Manual de Usuario
    • Guide

      • Guía del Usuario: Introducción
      • Conceptos Fundamentales
    • Talk2sync

      • Botones de Conexión
      • Sistema de Códigos de Color
      • Alertas o errores de validación
      • Filtros de comandos
      • La información eliminada todavía aparece: cómo eliminarla
      • Eliminación de datos
    • Conexiones

      • Configuraciones de la conexión
    • Campos

      • Sincronización basada en tiempos
      • Gobierno de datos
      • Campos especiales y adicionales
    • Productos

      • Campos de productos
      • Equivalencias
      • Búsqueda de productos
      • Vincular / Desvincular Productos
    • Ventas

      • Campos
      • Equivalencias de órdenes
      • Búsqueda de órdenes de venta
      • Sin SKU (SKU faltante)
    • Reports

      • Exportación de Productos
      • Reporte de Ventas
    • Faq

      • Amazon

        • Requisitos de Código de Barras en Amazon
        • Discrepancias con el Catálogo de Amazon y Errores de ASIN
        • Requisitos del Fabricante en Amazon
        • Errores de Creación de Nuevos ASIN y Valores de Atributos Inválidos
        • Talk2sync, SKUs e Identificadores de Productos
        • Plantillas de Variación en Amazon
      • Mercadolibre

        • Tiendas Oficiales en Mercado Libre
        • Ubicaciones y Atributos Geográficos en Mercado Libre
        • Recogida en Tienda en Mercado Libre
        • Atributos Adicionales en Mercado Libre
        • Procesamiento de Imágenes y Sincronización en Mercado Libre
        • Error de Vendedor Inhabilitado para Publicar en Mercado Libre
      • Linio

        • Error de Marca No Registrada en Linio
        • Requisitos de Dimensiones Físicas y Peso en Linio
  • APIs para Conexiones

    • APIs de Conexiones
    • Quick-start

      • Introducción y Requisitos
      • Agregar Conexión
      • Configurar Conexión
      • Generar Claves
      • Prueba tu Integración
    • Webhooks

      • API de Webhooks
      • Catalog

        • Webhooks: Listar Productos
        • Webhooks: Listar Producto por ID
        • Webhooks: Agregar/Actualizar Producto
      • Sales

        • Webhooks: Listar Órdenes
        • Listar orden por ID
        • Agregar/Actualizar orden
    • Reverse-connections

      • Reverse Connections
      • Implementation-states

        • Implementación
        • Implementación de consulta: productos y órdenes
        • Implementación de almacenamiento: productos y órdenes
        • Sleep y timeouts
      • Protocol

        • Protocolo
        • Descripción general
        • Carga de productos
        • Carga de órdenes
        • Descarga de productos
        • Descarga de órdenes
      • Rest-calls

        • Llamadas REST
        • Fetching-changes

          • Llamadas REST para obtención de cambios
          • Consultar si está obteniendo cambios
          • Catalog

            • Enviar página de productos
            • Finalizar envíos de productos
          • Sales

            • Enviar página de órdenes
            • Finalizar envíos de órdenes
            • Finalizar todos los envíos
        • Pulling-changes

          • Llamadas REST para descarga de cambios
          • Consultar si está descargando cambios
          • Catalog

            • Obtener el siguiente producto
            • Obtener página de productos
            • Notificar almacenamiento exitoso del producto
            • Notificar error en el almacenamiento del producto
            • Finalizar descarga de productos
          • Sales

            • Obtener la siguiente orden
            • Obtener página de órdenes
            • Notificar almacenamiento exitoso de una orden
            • Notificar error en el almacenamiento de una orden
            • Finalizar descarga de órdenes
            • Finalizar transacción de descarga

Alertas o errores de validación

Cuando Talk2sync encuentra problemas al actualizar o insertar datos, aparecen alertas, advertencias y avisos para cada equivalencia de producto o pedido. Comprender estos mensajes te ayuda a identificar y resolver rápidamente los problemas de sincronización.

Tipos de alertas

Alertas

Las alertas son problemas críticos que impiden la sincronización de datos. Cuando aparece una alerta, la operación no puede continuar hasta que se resuelva el problema.

Situaciones comunes que generan alertas:

  • Errores de validación de la plataforma externa
  • Campos obligatorios faltantes
  • Fallos de autenticación
  • Errores de conexión con la API
  • Incompatibilidades en el formato de los datos

Advertencias

Las advertencias indican problemas no críticos que pueden afectar la sincronización o la calidad de los datos, pero que no necesariamente impiden realizar la operación.

Situaciones comunes que generan advertencias:

  • Campos opcionales faltantes
  • Inconsistencias en el formato de los datos
  • Limitaciones específicas de la plataforma
  • Problemas relacionados con el rendimiento

Avisos

Los avisos son mensajes informativos que no bloquean las operaciones, pero proporcionan información útil sobre el proceso.

Situaciones comunes que generan avisos:

  • Operación completada con observaciones
  • Respuestas específicas de la plataforma
  • Actualizaciones parciales completadas
  • Información adicional sobre la operación

Burbujas de problemas

Cada equivalencia de producto o pedido puede mostrar burbujas de información que contienen:

Qué muestran las burbujas de problemas

  • Mensajes de error - Descripciones específicas de lo que salió mal
  • Problemas de validación - Campos que no superaron la validación
  • Mensajes de la plataforma - Mensajes enviados directamente por la plataforma externa
  • Motivos del fallo - Por qué no se está realizando la actualización o inserción
  • Acciones sugeridas - Cómo resolver el problema

Cómo leer los mensajes de problemas

Los mensajes de problemas normalmente incluyen:

  1. Tipo de error - Qué tipo de problema ocurrió
  2. Campo afectado - Qué campo de datos presenta el problema
  3. Descripción del error - Cuál es el problema específico
  4. Respuesta de la plataforma - Comentarios de la plataforma externa (si están disponibles)
  5. Acción necesaria - Qué debes hacer para solucionarlo

Ejemplos de mensajes de problemas

Error de validación:

Error: La validación del precio falló
Campo: Precio del producto
Mensaje: El precio debe ser mayor que 0
Acción: Actualiza el precio del producto a un importe válido

Campo obligatorio faltante:

Advertencia: Falta un campo obligatorio
Campo: Categoría del producto
Mensaje: La categoría es obligatoria para esta plataforma
Acción: Añade una categoría al producto

Error de autenticación:

Alerta: La autenticación falló
Campo: Credenciales de la API
Mensaje: La clave de API no es válida o las credenciales han expirado
Acción: Vuelve a autenticarte en Configuración

Menú emergente de notificaciones

Acceso a las notificaciones

En la barra de navegación principal del panel de Talk2sync, hay un botón de Notificaciones (normalmente representado por un icono de campana) que abre un menú emergente.

Qué muestra el menú de Notificaciones

  • Lista de problemas recientes - Todas las alertas, advertencias y avisos
  • Cantidad de problemas - Número total de problemas activos
  • Agrupados por tipo - Organizados según el nivel de alerta
  • Marcas de tiempo - Cuándo ocurrió cada problema
  • Acciones rápidas - Enlaces directos a los registros afectados

Botón Solucionar problemas

Dentro del menú emergente de Notificaciones hay un botón Solucionar problemas que realiza un análisis automatizado.


Análisis para solucionar problemas

Qué hace Solucionar problemas

El botón Solucionar problemas inicia un análisis completo de todos los problemas de tu cuenta:

  1. Analiza todas las conexiones - Revisa todas las plataformas conectadas
  2. Identifica todos los problemas - Encuentra cada alerta, advertencia y aviso
  3. Analiza patrones - Busca temas o problemas recurrentes
  4. Detecta problemas a escala - Identifica cuándo el mismo error ocurre muchas veces
  5. Genera un informe - Proporciona un informe de análisis estructurado

Detección de patrones

Cuando existen muchos problemas similares, el análisis de Solucionar problemas:

  • Agrupa errores similares - Combina el mismo tipo de error entre varios registros
  • Identifica la causa raíz - Encuentra el problema subyacente común
  • Muestra el impacto - Indica cuántos registros están afectados
  • Sugiere soluciones - Recomienda soluciones para el patrón identificado

Ejemplo de análisis de patrones

Situación: 150 productos no se pueden sincronizar

Sin detección de patrones: Ves 150 mensajes de error individuales (lo cual puede resultar abrumador).

Con el análisis de Solucionar problemas:

Patrón identificado: Falta el campo Categoría
Registros afectados: 150 productos
Causa raíz: El campo Categoría no está asignado en la configuración de la conexión
Solución: Configura la asignación del campo Categoría en Configuración
Tiempo estimado para solucionar: 5 minutos para configurar, 10 minutos para volver a sincronizar

Uso de la información de los problemas para solucionarlos

Proceso paso a paso

  1. Revisa el menú de Notificaciones - Comprueba qué problemas existen
  2. Haz clic en Solucionar problemas - Ejecuta el análisis de patrones
  3. Revisa el informe de análisis - Comprende los patrones identificados
  4. Identifica la causa raíz - Determina qué está provocando los problemas
  5. Aplica la solución - Realiza los cambios necesarios
  6. Vuelve a sincronizar los datos - Envía nuevamente las actualizaciones
  7. Supervisa los resultados - Verifica que los problemas se hayan resuelto

Patrones de problemas comunes

Patrón 1: Errores de validación

  • Problema: Varios productos no superan la validación del precio
  • Causa: Problema con el formato o el valor del campo de precio
  • Solución: Actualiza el formato del precio o valida los valores

Patrón 2: Campos faltantes

  • Problema: Muchos productos no tienen campos obligatorios
  • Causa: El campo no está asignado en la configuración de la conexión
  • Solución: Configura la asignación de campos

Patrón 3: Problemas de autenticación

  • Problema: Todas las operaciones de sincronización fallan
  • Causa: Las credenciales de la API han expirado o son incorrectas
  • Solución: Vuelve a autenticarte en Configuración

Patrón 4: Incompatibilidad de formato

  • Problema: Un tipo de campo específico falla en varios registros
  • Causa: El formato de los datos no coincide con los requisitos de la plataforma
  • Solución: Ajusta la configuración del campo o la transformación de datos

Gestión de problemas a gran escala

Cuando tienes muchos problemas

Enfoque para problemas a gran escala:

  1. Ejecuta el análisis de Solucionar problemas - Identifica los principales patrones
  2. Encuentra la causa raíz - Normalmente, entre 1 y 3 problemas principales causan la mayoría de los errores
  3. Corrige la causa raíz - Soluciona el problema subyacente
  4. Vuelve a sincronizar todo - Envía todas las actualizaciones de una sola vez
  5. Verifica los resultados - Comprueba si los problemas se resolvieron

Ejemplo: Solución de 1,000 problemas

Situación: 1,000 pedidos no se pueden sincronizar y muestran diferentes mensajes de error.

Paso de análisis:

  • Ejecuta Solucionar problemas
  • Descubre que los 1,000 errores se deben a una única configuración de asignación

Paso de solución:

  • Actualiza esa configuración
  • Vuelve a sincronizar los 1,000 pedidos

Resultado:

  • Los 1,000 pedidos se sincronizan correctamente
  • Se solucionaron 1,000 problemas con un solo cambio

Resolución masiva de problemas

En lugar de solucionar cada problema individualmente:

  1. Identifica el patrón - Determina qué está causando los errores
  2. Soluciona el problema desde el origen - Actualiza la configuración, las asignaciones o los parámetros
  3. Aplica la solución a todos - La solución se aplica a todos los registros afectados
  4. Vuelve a sincronizar por lotes - Envía todos los cambios de una sola vez

Buenas prácticas para la gestión de problemas

✓ Sí debes:

  • Revisar las Notificaciones periódicamente
  • Utilizar Solucionar problemas para encontrar patrones
  • Atacar las causas raíz en lugar de solucionar problemas individuales
  • Probar las soluciones primero con un lote pequeño
  • Documentar los problemas y sus soluciones
  • Mantener un registro de los problemas como referencia
  • Resolver los problemas rápidamente para evitar inconsistencias en los datos

✗ No debes:

  • Ignorar las alertas y advertencias
  • Intentar enviar actualizaciones sin resolver los problemas
  • Solucionar los problemas uno por uno sin buscar patrones
  • Suponer que los errores se resolverán por sí solos
  • Dejar datos problemáticos en el sistema
  • Ignorar los patrones de problemas recurrentes
  • Continuar sin comprender los mensajes de error

Temas relacionados

  • Configuración de conexiones - Cómo configurar las conexiones para evitar problemas
  • Enviar actualizaciones - Cómo aparecen los problemas al enviar actualizaciones
  • Estadísticas y mantenimiento - Herramientas de mantenimiento para prevenir problemas
Actualizado el: 28/08/26, 12:58 a.m.
Prev
Sistema de Códigos de Color
Next
Filtros de comandos