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

Botones de Conexión

Descripción General

Cada conexión de Talk2sync muestra seis botones de acción en su tarjeta de panel. Estos botones controlan todas las operaciones principales que puedes realizar en una conexión. Entender qué hace cada botón es esencial para gestionar efectivamente tu sincronización de datos.


Botón 1: Obtener Actualizaciones (Grab)

Propósito

El botón Obtener Actualizaciones dispara un job que recupera todos los productos y órdenes de venta de tu plataforma conectada.

Qué Hace

Cuando haces clic en este botón:

  1. Inicia Escaneo - Se inicia un nuevo JOB para recuperar todos los PRODUCTOS y ÓRDENES DE VENTA que existen en esa PLATAFORMA para esta CONEXIÓN
  2. Lee Datos - El sistema lee y descarga todos los datos de la plataforma externa
  3. Descarga Activos - Se descargan todas las imágenes y medios asociados
  4. Analiza Cambios - Después del escaneo, el sistema compara los datos recién escaneados con datos previamente reconocidos
  5. Detecta Diferencias - Se identifican diferencias entre datos antiguos y nuevos
  6. Propaga Cambios - Si tienes otras conexiones configuradas para recibir actualizaciones, los cambios se programan para propagación

Consideraciones de Rendimiento

Primera Sincronización (Escaneo Inicial)

La primera vez que sincronizas una conexión, el proceso tarda más porque todo el catálogo debe ser escaneado.

Velocidad de Escaneo

El tiempo promedio de escaneo es:

  • Velocidad Base: ~1 segundo por producto/orden
  • Más Tiempo de Descarga de Imágenes que varía dependiendo de:
    • Número de imágenes por producto
    • Tamaño de cada imagen
    • Velocidad de ancho de banda de la ubicación fuente
    • Conectividad de red

Ejemplos de Tiempos

  • 100 productos (5 imágenes cada uno): ~5-10 minutos
  • 1,000 productos (10 imágenes cada uno): ~30-45 minutos
  • 10,000 productos (3 imágenes cada uno): ~2-4 horas

Fases del Proceso

Fase 1: Escaneo de Datos

  • Se conecta a la plataforma externa
  • Recupera todos los registros de productos y órdenes
  • Descarga medios asociados (imágenes, videos)
  • Almacena datos temporalmente

Fase 2: Post-Análisis y Comparación

  • Compara datos recién escaneados con datos almacenados previamente
  • Identifica registros cambiados (nuevos, modificados o eliminados)
  • Construye un conjunto de cambios

Fase 3: Propagación

  • Si hay conexiones adicionales configuradas para recibir actualizaciones, los cambios se programan
  • Prepara actualizaciones para otras plataformas conectadas
  • Pone en cola los cambios para enviar en la siguiente acción de Enviar Actualizaciones

Mejores Prácticas

✓ Haz:

  • Ejecuta obtener actualizaciones regularmente para mantener datos actuales
  • Monitorea el progreso del job en el panel
  • Programa obtener actualizaciones durante horas de menor actividad para catálogos grandes
  • Permite suficiente tiempo para descarga de imágenes

✗ No hagas:

  • Canceles obtener actualizaciones durante la operación (si es posible)
  • Ejecutes obtener mientras estés haciendo cambios activamente en la plataforma
  • Interrumpas conectividad de red durante escaneo

Botón 2: Enviar Actualizaciones (Pull)

Propósito

El botón Enviar Actualizaciones dispara un job que escribe cambios en tu plataforma conectada. Ejecuta operaciones INSERT y UPDATE para modificar datos en la plataforma externa.

Qué Hace

Cuando haces clic en este botón:

  1. Ejecuta Cambios en Cola - Procesa todas las operaciones INSERT y UPDATE programadas
  2. Modifica Datos Externos - Envía cambios a la plataforma conectada
  3. Borra Cola - Elimina cambios procesados de la cola
  4. Actualiza Estado - Muestra éxito o fallo para cada operación

Indicador de Cambios en Cola

Aparece un distintivo rojo mostrando:

  • Número de cambios pendientes - El conteo de operaciones esperando ser ejecutadas
  • Tipos de cambios - INSERT (registros nuevos) o UPDATE (registros modificados)
  • Destino de plataforma - Qué plataforma recibirá estos cambios

Ejemplo de Distintivo: "35" significa 35 cambios en cola para esta plataforma

Gestión de Cola de Cambios

Qué Crea Cambios en Cola

Los cambios se ponen en cola cuando:

  • Editas un producto u orden en Talk2sync
  • Se obtienen cambios de otra plataforma conectada
  • Creas manualmente nuevos registros
  • Se completan operaciones de importación en lote
  • Se disparan reglas de sincronización automática

Ver Cambios en Cola

  1. Haz clic en el número del distintivo para ver la cola detallada
  2. Ve cambios específicos antes de enviar
  3. Deselecciona cambios individuales si es necesario (en la mayoría de casos)
  4. Envía todos los cambios seleccionados de una vez

Mejores Prácticas

✓ Haz:

  • Revisa cambios en cola antes de enviar
  • Envía actualizaciones durante horas de menor actividad
  • Monitorea el progreso del job
  • Verifica que los cambios fueron exitosos usando Stats

✗ No hagas:

  • Envíes actualizaciones sin entender qué cambiará
  • Envíes actualizaciones conflictivas a múltiples plataformas simultáneamente
  • Ignores operaciones fallidas
  • Borres la cola sin enviar si los cambios son importantes

Botón 3: Sincronizar

Propósito

El botón Sincronizar combina Obtener Actualizaciones y Enviar Actualizaciones en una operación: Obtener Actualizaciones + Enviar Actualizaciones = Sincronizar

Qué Hace

Cuando haces clic en Sincronizar:

  1. Primero Obtiene Actualizaciones - Recupera datos más recientes de la plataforma
  2. Analiza Cambios - Compara con datos almacenados
  3. Luego Envía Actualizaciones - Ejecuta cualquier cambio en cola
  4. Se Completa en Una Acción - Todas las operaciones se ejecutan secuencialmente

Por Qué Usar Sincronizar

Eficiencia

Sincronizar es útil en el uso diario de Talk2sync porque:

  • No necesitas esperar a que Obtener se complete antes de iniciar Enviar
  • Combina dos operaciones en un clic
  • Ahorra tiempo en tu flujo de trabajo
  • Es más eficiente que ejecutar Obtener y Enviar por separado

Secuencia de Sincronización

1. Comienza Obtener Actualizaciones
   ├── Escanea datos de plataforma
   ├── Analiza cambios
   └── Pone en cola actualizaciones para envío

2. Luego Envía Actualizaciones
   ├── Ejecuta cambios en cola
   ├── Escribe en plataforma
   └── Borra cola

3. Se completa con estado final

Cuándo Usar Sincronizar vs Operaciones Separadas

SituaciónUsa
Sincronización diaria regularBotón Sincronizar
Solo recuperando datos nuevosObtener Actualizaciones
Solo enviando cambiosEnviar Actualizaciones
Catálogo grande con muchos cambiosPrimero Obtener, revisar, luego Enviar
Verificación rápida de actualizacionesSincronizar
Cambios manuales únicosEnviar Actualizaciones

Botón 4: Reproducir/Pausar

Propósito

El botón Reproducir/Pausar controla si una conexión está activamente monitoreando y procesando cambios de datos.

Qué Hace

Modo Reproducir (Activo)

Cuando una conexión está en Modo Reproducir (el estado por defecto):

  • La conexión está inactiva pero lista para recibir comandos de obtener y enviar
  • Puede transicionar a obtención activa de datos
  • Puede enviar actualizaciones en cola
  • Puede procesar operaciones en lote
  • Las sincronizaciones programadas automáticas pueden ejecutarse (si están configuradas)

Modo Pausar (Inactivo)

Cuando haces clic en Pausar, la conexión está bloqueada:

  • No puede obtener datos de la plataforma
  • No puede enviar actualizaciones a la plataforma
  • Los cambios en cola existentes se preservan pero no se envían
  • Las sincronizaciones programadas automáticas se detienen
  • La conexión está "congelada" en el tiempo

Casos de Uso

Cuándo Pausar una Conexión

✓ Mantenimiento Temporal

  • Estás haciendo cambios directamente en la plataforma
  • No quieres que Talk2sync interfiera
  • Estás resolviendo problemas
  • Duración: Minutos a horas

✓ Tiempo de Inactividad de Plataforma

  • La plataforma externa está en mantenimiento
  • Problemas de conectividad de red
  • Límites de velocidad de API excedidos
  • Duración: Horas

✓ Problemas de Integridad de Datos

  • Has descubierto conflictos de datos
  • Necesitas tiempo para arreglar problemas manualmente
  • Esperando clarificación del cliente
  • Duración: Horas a días

✓ Operaciones de Lote Grandes

  • Realizando actualizaciones mayores de plataforma
  • Cargando catálogos grandes
  • Reestructurando datos
  • No quieres interferencia de sincronización

Cuándo Reanudar Modo Reproducir

  • El mantenimiento está completo
  • Los problemas se resolvieron
  • La plataforma está nuevamente en línea
  • Las operaciones en lote terminaron

Mejores Prácticas

✓ Haz:

  • Usa Pausar cuando hagas cambios mayores
  • Documenta por qué pausaste una conexión
  • Reanuda Reproducir una vez resueltos los problemas
  • Monitorea conexiones pausadas

✗ No hagas:

  • Dejes conexiones pausadas indefinidamente
  • Pauses sin anotar la razón
  • Ignores cambios que se acumulan mientras está pausada
  • Olvides reanudar después de arreglar problemas

Botón 5: Configuración

Propósito

El botón Configuración abre una ventana modal donde puedes personalizar cómo se comporta esta conexión específica.

Configuración Disponible

Cada tipo de conexión tiene su propio panel de configuración personalizado para esa plataforma, pero típicamente incluye:

Configuración General

ConfiguraciónQué Hace
Nombre de ConexiónRenombra la conexión
Credenciales de APIReautentica con la plataforma
URL de EndpointActualiza el endpoint de conexión
Zona HorariaEstablece la zona horaria para manejo de fecha/hora

Configuración de Campo

ConfiguraciónQué Hace
Mapeo de CampoMapea campos externos a campos estándar de Talk2sync
Campos de Solo LecturaEspecifica qué campos no deben modificarse
Campos OcultosOculta campos de la interfaz
Valores por DefectoEstablece valores por defecto para registros nuevos

Comportamiento de Sincronización

ConfiguraciónQué Hace
Absorber Productos AutomáticamenteCrea automáticamente productos nuevos de esta plataforma
Absorber Órdenes AutomáticamenteCrea automáticamente órdenes nuevas de esta plataforma
Detección de CambiosEstablece qué campos disparan detección de cambios
Reiniciar Reloj de CambiosReinicia el timestamp de última sincronización

Configuración Específica de Plataforma

ConfiguraciónQué Hace
MonedaEstablece o cambia la moneda para esta plataforma
Márgenes de PrecioDefine porcentajes de margen/descuento
Campos Color/TamañoEspecifica qué campos representan colores y tamaños
Categorías por DefectoEstablece categorías de productos por defecto
Mapeo de AtributoMapea atributos específicos de plataforma

Procesamiento de Orden

ConfiguraciónQué Hace
Estado de Orden por DefectoEstablece estado inicial para órdenes nuevas
Mapeo de EstadoMapea valores de estado externos a estados de Talk2sync
Reglas de EnvíoConfigura métodos de envío por defecto
Procesar Órdenes AutomáticamenteHabilita procesamiento automático de órdenes

Tareas Comunes de Configuración

Dejar de Detectar Cambios en un Campo

  1. Abre Configuración
  2. Ve a Configuración de Campo
  3. Encuentra el campo
  4. Cambia "Monitorear Cambios" OFF
  5. Guarda

Cambiar Detección de Moneda

  1. Abre Configuración
  2. Ve a configuración de Moneda
  3. Selecciona la moneda correcta
  4. Aplica a todos los productos (si es necesario)
  5. Guarda y sincroniza

Reautenticar

  1. Abre Configuración
  2. Localiza sección de Credenciales de API
  3. Ingresa credenciales nuevas
  4. Prueba conexión
  5. Guarda

Establecer Categorías por Defecto

  1. Abre Configuración
  2. Ve a configuración de Categoría
  3. Selecciona categoría por defecto
  4. Define categorías alternativas
  5. Guarda

Definir Campos Color/Tamaño

  1. Abre Configuración
  2. Ve a configuración de Variación
  3. Selecciona qué campo contiene colores
  4. Selecciona qué campo contiene tamaños
  5. Guarda

Habilitar Absorber Automáticamente

  1. Abre Configuración
  2. Encuentra "Absorber Productos Automáticamente" o "Absorber Órdenes Automáticamente"
  3. Cambia ON
  4. Configura reglas de absorción
  5. Guarda

Mejores Prácticas

✓ Haz:

  • Revisa y configura la configuración antes de la primera sincronización
  • Documenta elecciones de configuración
  • Prueba cambios de configuración con un lote pequeño primero
  • Actualiza credenciales si expiran
  • Revisa configuración periódicamente

✗ No hagas:

  • Cambies configuración durante sincronización activa
  • Modifiques mapeos de campo después de que los datos ya estén sincronizados
  • Compartas credenciales en la configuración
  • Cambies configuración crítica sin respaldo

Botón 6: Estadísticas

Propósito

El botón Estadísticas abre una ventana modal que muestra estadísticas e información de diagnóstico sobre datos escaneados de tu plataforma. También proporciona herramientas de mantenimiento de datos.

Pestaña Estadísticas

Ve estadísticas rápidas sobre tu conexión:

Resumen de Datos

MétricaQué Muestra
Total de ProductosNúmero total de productos sincronizados
Total de ÓrdenesNúmero total de órdenes sincronizadas
Fecha Último EscaneoCuándo se obtuvieron datos por última vez
Tamaño de DatosAlmacenamiento total usado por esta conexión
Estado de SincronizaciónEstado actual de conexión

Salud de Conexión

MétricaQué Muestra
Último ÉxitoTimestamp de última operación exitosa
Último ErrorÚltimo error encontrado (si hay alguno)
Velocidad de ConexiónTiempo promedio de respuesta de API
Tamaño de ColaNúmero de cambios pendientes
Conteo de ImágenesTotal de imágenes almacenadas

Desglose de Datos

MétricaQué Muestra
Productos ActivosProductos actualmente activos/publicados
Productos InactivosProductos archivados/inactivos
Órdenes PendientesÓrdenes esperando acción
Órdenes CompletadasÓrdenes terminadas/enviadas
Por CategoríaConteo de productos por categoría
Por EstadoDesglose de datos por estado

Pestaña Mantenimiento

Accede a herramientas de mantenimiento y reparación de datos:

Herramientas de Integridad de Datos

HerramientaPropósito
Arreglar Esquema de DatosActualiza datos a formato de esquema actual
Validar RegistrosVerifica todos los registros para errores
Limpiar Datos HuérfanosElimina registros con referencias faltantes
Reiniciar TimestampsReinicia timestamps de detección de cambios
Reconstruir ÍndicesReconstruye índices de búsqueda

Cuándo Usar Mantenimiento

Actualización de Esquema de Datos

  • Después de actualización de plataforma Talk2sync
  • Cuando se añaden campos nuevos
  • Antes de usar características nuevas
  • Recomendado: Cada actualización mayor

Validación de Datos

  • Periódicamente (mensualmente)
  • Después de importaciones en lote
  • Si notas problemas de sincronización
  • Si los datos se ven incompletos

Limpieza de Datos Huérfanos

  • Cuando conexiones han sido eliminadas
  • Si ves datos inconsistentes
  • Después de reestructuración de datos mayores
  • Libera espacio de almacenamiento

Reiniciar Timestamps

  • Para forzar una re-sincronización completa
  • Si detección de cambios está atrapada
  • Cuando resuelves problemas de sincronización
  • Usar con cuidado

Reconstruir Índices

  • Si la búsqueda es lenta
  • Después de operaciones en lote grandes
  • Periódicamente para rendimiento
  • Puede tomar varios minutos

Mejores Prácticas

✓ Haz:

  • Revisa estadísticas regularmente (semanalmente o mensualmente)
  • Ejecuta mantenimiento después de operaciones mayores
  • Valida datos antes de sincronizaciones mayores
  • Documenta problemas encontrados en mantenimiento
  • Mantén registros de mantenimiento realizado

✗ No hagas:

  • Ejecutes mantenimiento durante sincronización activa
  • Ignores advertencias de mantenimiento
  • Ejecutes mantenimiento muy frecuentemente (puede ralentizar sistema)
  • Omitas validación antes de usar características nuevas
  • Borres todos los datos sin respaldo

Estados de Botón e Indicadores

Estados Visuales

BotónEstadoSignificado
Cualquier BotónGrisOperación en progreso, botón deshabilitado
Cualquier BotónAzul/ActivoBotón es clickeable y listo
Enviar ActualizacionesDistintivo RojoCambios están en cola para envío
Reproducir/PausarIcono ReproducirConexión está activa
Reproducir/PausarIcono PausarConexión está pausada

Indicadores de Estado

La tarjeta de conexión también muestra:

IndicadorSignificado
Círculo VerdeConexión está saludable y activa
Círculo AmarilloConexión tiene advertencias o cambios pendientes
Círculo RojoConexión tiene errores o está desconectada
Círculo GrisConexión está pausada

Referencia Rápida: Árbol de Decisión de Botones

¿Qué quieres hacer?

├─ ¿Obtener datos más recientes de la plataforma?
│  └─ Haz clic: OBTENER ACTUALIZACIONES

├─ ¿Enviar cambios a la plataforma?
│  └─ Haz clic: ENVIAR ACTUALIZACIONES

├─ ¿Hacer ambas (obtener y enviar)?
│  └─ Haz clic: SINCRONIZAR

├─ ¿Prevenir sincronización temporalmente?
│  └─ Haz clic: PAUSAR

├─ ¿Reanudar sincronización?
│  └─ Haz clic: REPRODUCIR

├─ ¿Personalizar comportamiento de conexión?
│  └─ Haz clic: CONFIGURACIÓN

└─ ¿Ver estadísticas de datos?
   └─ Haz clic: ESTADÍSTICAS

Resumen

BotónFunciónUsar Cuando
Obtener ActualizacionesRecupera datos de plataformaQuieres datos más recientes
Enviar ActualizacionesEmpuja cambios a plataformaTienes cambios en cola
SincronizarObtener + Enviar en una operaciónSincronización rutinaria diaria
Reproducir/PausarControla actividad de conexiónPausando/reanudando sincronización
ConfiguraciónConfigura conexiónConfigurando o personalizando
EstadísticasVe datos y mantenimientoRevisando salud o arreglando datos

Siguientes Pasos

  • Guía de Plataforma Talk2sync - Explora otras características
  • Gestión de Productos - Gestiona tus productos
  • Procesamiento de Órdenes - Maneja órdenes
  • Configuración y Personalización - Opciones avanzadas
Actualizado el: 28/08/26, 12:58 a.m.
Next
Sistema de Códigos de Color