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

Conceptos Fundamentales

Entender estos conceptos fundamentales es esencial para trabajar efectivamente con Talk2sync. Esta sección presenta la terminología clave y conceptos arquitectónicos que encontrarás en toda la plataforma.

Job (Trabajo)

Definición

Un job es un proceso asincrónico que se ejecuta en Talk2sync para realizar tareas automatizadas. La mayoría de los procesos en Talk2sync funcionan de forma asincrónica, lo que significa que se ejecutan en segundo plano mientras continúas trabajando, con progreso reportado en tiempo real en el panel de Talk2sync.

Cómo Funcionan los Jobs

Cuando desencadenas una acción en Talk2sync (como sincronizar productos u obtener órdenes), se crea un job para manejar esa tarea. El sistema procesa el job y muestra actualizaciones de progreso a medida que se completa.

Duración del Job

El tiempo que tarda un job en completarse depende de:

  • Complejidad de la Tarea - Operaciones simples como verificar el estado de la conexión se completan rápidamente, mientras que operaciones complejas como sincronización de catálogo completo tardan más
  • Cantidad de Datos - La cantidad de información siendo procesada, leída, transformada o cargada impacta directamente el tiempo de ejecución
  • Carga del Sistema - La carga general del sistema y la cola de jobs concurrentes afectan la velocidad de procesamiento
  • Tipo de Datos - Sincronizar PRODUCTOS u ÓRDENES DE VENTA puede tomar diferentes cantidades de tiempo dependiendo del volumen y complejidad de datos

Ejemplo

  • Sincronizar 100 productos: ~30 segundos
  • Sincronizar 10,000 productos: ~5-10 minutos
  • Recuperar órdenes con seguimiento: ~1-2 minutos por 1,000 órdenes

Conexión

Definición

Una conexión representa una plataforma, marketplace o aplicación que deseas integrar con Talk2sync. Es el vínculo entre tu sistema externo y Talk2sync para gestionar tu catálogo y órdenes.

Componentes de la Conexión

Una conexión incluye:

  • Identidad de la Plataforma - Qué plataforma o servicio estás conectando
  • Configuración - Cómo se configura la conexión (credenciales, endpoints, mapeos)
  • Estado - Estado actual de la conexión (activa, pausada, error, etc.)
  • Estructura de Datos - Cómo se organizan tus PRODUCTOS y ÓRDENES DE VENTA

Representación de Conexión

En el panel de Talk2sync, una conexión se muestra como una tarjeta o elemento visual que muestra:

  • Nombre y tipo de conexión
  • Estado actual
  • Última hora de sincronización
  • Detalles de configuración
  • Número de productos/órdenes sincronizados

Qué Se Conecta

Una conexión típicamente se conecta a sistemas que almacenan:

  • Catálogos de Productos - Tu inventario y listados de productos
  • Órdenes de Venta - Tus órdenes de clientes y transacciones
  • Información del Cliente - Detalles del comprador e historial
  • Niveles de Inventario - Disponibilidad de inventario en tiempo real

Plataforma / Aplicación / Canal / Marketplace / Cuenta de Marketplace / ERP / Carrito de Compras / Base de Datos / Servicio de Dropshipping / Cuenta de Publicidad / Sitio de Comercio Electrónico

El Desafío

Puede causar confusión usar diferentes términos para referirse a la misma cosa. Talk2sync soporta muchos tipos de integraciones, e industrias diferentes usan terminología diferente.

Concepto Unificado

Todos estos términos se refieren al mismo concepto en Talk2sync:

Una PLATAFORMA es cualquier sistema externo o servicio conectado a tu Cuenta Talk2sync.

Tipos Comunes de Plataforma

Talk2sync soporta conexiones a:

Tipo de PlataformaEjemplos
Plataformas de Comercio ElectrónicoShopify, WooCommerce, Magento, BigCommerce
MarketplacesAmazon, eBay, MercadoLibre, Linio
Plataformas de PublicidadFacebook Ads, Google Shopping, Instagram
Sistemas de InventarioERPs, WMS, bases de datos, hojas de cálculo
Carrito de ComprasCarritos personalizados, sistemas heredados
Servicios de CumplimientoProveedores de dropshipping, servicios 3PL
Sistemas PersonalizadosAPIs, webhooks, aplicaciones personalizadas

Concepto Clave

Ya sea que estés conectando:

  • Una cuenta de marketplace
  • Un sistema ERP
  • Una base de datos personalizada
  • Un servicio de dropshipping

Talk2sync los trata de la misma manera: como PLATAFORMAS en tu cuenta.


Producto

Definición

Un producto es una entidad de datos compleja que almacena información comprensiva sobre algo que vendes. Los productos son centrales en Talk2sync y representan artículos en tu catálogo.

Terminología de Producto

Diferentes plataformas usan términos diferentes para esencialmente el mismo concepto:

  • Listado - Amazon, eBay
  • Publicación - MercadoLibre
  • Oferta - Algunos marketplaces
  • Artículo de Catálogo - ERPs
  • Objeto SKU - Sistemas de inventario
  • Mercancía - Sistemas de venta al por menor
  • Artículo de Compra - Plataformas de comercio electrónico

Talk2sync estandariza todos estos como: PRODUCTO

Tipos de Producto

Un producto puede representar:

  • Objetos Físicos - Bienes tangibles
  • Paquetes - Múltiples artículos vendidos juntos
  • Ofertas al por Mayor - Productos B2B
  • Bienes Digitales - Software, descargas, licencias
  • Servicios - Servicios profesionales, consultoría

Estructura de Datos del Producto

Un registro de producto de Talk2sync almacena:

Información Básica

  • Título - Nombre del producto
  • Descripción - Información detallada del producto
  • SKU - Unidad de Mantenimiento de Stock
  • UPC/Código de Barras - Identificadores de producto

Precios y Disponibilidad

  • Precio - Precio de venta (soporta múltiples monedas)
  • Disponibilidad de Inventario - Cantidad disponible por ubicación
  • Costo - Costo del producto (si aplica)

Clasificación

  • Marca - Nombre del fabricante o marca
  • Modelo - Número de modelo del producto
  • MPN - Número de Parte del Fabricante
  • Categorías - Clasificación del producto

Medios

  • Imágenes - Fotos del producto
  • Videos - Enlaces de video del producto
  • URLs - Enlaces/URLs del producto

Variaciones

  • Colores - Variantes de color
  • Tamaños - Variantes de tamaño
  • Configuraciones - Opciones de variante personalizadas
  • SKUs de Variante - Identificadores de variante individual

Específico de la Plataforma

  • Categorías - Categorías específicas de la plataforma
  • Estado de Publicación - Activo, borrador, inactivo, etc.
  • Clasificaciones - Clasificaciones de plataforma
  • Campos Personalizados - Atributos específicos de la plataforma

Estructura de Producto Universal

Talk2sync proporciona una estructura universal estándar que puede representar cualquier interpretación de información de producto de cualquier plataforma, asegurando compatibilidad en todas las conexiones.


Órdenes de Venta

Definición

Una orden de venta (también llamada orden o transacción) es una entidad de datos compleja que almacena información sobre un evento de venta. Representa el registro completo de una transacción de cliente en una plataforma.

Terminología de Orden de Venta

Diferentes plataformas usan términos diferentes:

  • Orden - La mayoría de plataformas de comercio electrónico
  • Venta - Sistemas CRM y contables
  • Transacción de Venta - Sistemas de facturación
  • Documento de Venta - Sistemas ERP
  • Documento de Transacción - Sistemas contables

Talk2sync estandariza todos estos como: ORDEN DE VENTA

Componentes de la Orden de Venta

Un registro de orden de venta de Talk2sync almacena:

Detalles de la Orden

  • Número de Orden - Identificador único de orden
  • Fecha de Orden - Cuándo se colocó la orden
  • Estado de la Orden - Estado actual (pendiente, pagada, enviada, etc.)
  • Total de la Orden - Monto total y moneda

Artículos de la Orden

  • IDs de Productos - Qué productos fueron ordenados
  • Cantidades - Cuántos de cada producto
  • Precios Unitarios - Precio por unidad
  • Totales de Línea - Montos de línea de artículos

Información del Comprador

  • Nombre del Comprador - Nombre del cliente
  • Correo Electrónico - Dirección de correo del cliente
  • Teléfono - Número de teléfono del cliente
  • ID del Cliente - Identificador único del cliente

Direcciones

  • Dirección de Envío - Ubicación de entrega
  • Dirección de Facturación - Dirección de pago
  • Detalles de Dirección - Calle, ciudad, estado, código postal, país

Envío y Cumplimiento

  • Estado del Envío - Pendiente, enviado, entregado
  • Números de Seguimiento - Identificadores de seguimiento del transportista
  • Información del Transportista - Transportista de envío (FedEx, UPS, etc.)
  • Etiquetas de Envío - Documentos de envío imprimibles
  • Entrega Estimada - Fecha de entrega esperada

Comunicación y Retroalimentación

  • Mensajes del Cliente - Comunicaciones del comprador
  • Calificaciones - Calificación del cliente para la transacción
  • Retroalimentación/Reseñas - Texto de reseña del cliente
  • Notas del Vendedor - Notas internas sobre la orden

Información Financiera

  • Estado de Pago - Pagado, pendiente, reembolsado
  • Información de Factura - Números y fechas de factura
  • Descuento/Promoción - Cualquier descuento aplicado
  • Impuestos - Cálculos de impuestos

Estructura Universal de Orden de Venta

Talk2sync proporciona una estructura universal estándar que captura cualquier interpretación de datos de orden de cualquier plataforma, asegurando compatibilidad de datos y consistencia.


Multidimensionalidad de Registros (Productos u Órdenes de Venta)

Qué es Multidimensionalidad

Los registros en Talk2sync son multidimensionales. Este es un concepto poderoso que permite que un único registro tenga múltiples representaciones o equivalencias en diferentes plataformas conectadas.

Cómo Funciona

Un único registro de Talk2sync puede tener:

  • 0 a N equivalencias - Desde cero hasta equivalentes ilimitados en plataformas conectadas
  • Cada una conectada a una conexión - Cada equivalencia está vinculada a una conexión de plataforma específica
  • Múltiples equivalencias por conexión - Una única conexión puede tener múltiples equivalencias para el mismo registro de Talk2sync
  • Una conexión por equivalencia - Cada equivalencia no puede estar vinculada a múltiples conexiones simultáneamente

Ejemplo Visual

Registro de Talk2sync (Maestro)
├── Equivalencia 1 → Conexión Amazon
├── Equivalencia 2 → Conexión MercadoLibre
├── Equivalencia 3 → Conexión Shopify
└── Equivalencia 4 → Conexión Sistema ERP

Escenario del Mundo Real

Ejemplo de Producto:

Vendes una camiseta azul en tres plataformas:

  • Amazon: Listado como "T-Shirt Blue SKU-001" (ASIN: B12345)
  • MercadoLibre: Listado como "Remera Azul Código 001" (ID: 987654)
  • Shopify: Listado como "Classic Blue T-Shirt" (Shopify ID: 456789)

En Talk2sync:

  • Un registro de producto maestro representa este artículo
  • Tres equivalencias existen (una para cada plataforma)
  • Cada equivalencia almacena datos específicos de la plataforma (IDs, títulos, precios)
  • Cuando actualizas el registro maestro, los cambios se propagan a todas las equivalencias

Ejemplo de Orden:

Un cliente compra en tu tienda Amazon:

  • Orden de Venta Maestro creada en Talk2sync
  • Una equivalencia vincula a la orden de Amazon
  • Puede crear equivalencias adicionales si la información de orden se envía a otros sistemas
  • Las actualizaciones de estado de orden van al maestro, luego a todas las equivalencias

Beneficios de la Multidimensionalidad

✓ Fuente Única de Verdad - Un registro maestro representa el mismo artículo lógico en todas las plataformas

✓ Sincronización Automática - Los cambios en equivalencias se propagan al maestro y a otras equivalencias

✓ Agnóstico de Plataforma - Añade o elimina plataformas sin perder integridad de datos

✓ Mapeo Flexible - Cada equivalencia puede mapear datos específicos de plataforma diferente

✓ Auditoría - Rastrear qué producto/orden física corresponde a qué listado en qué plataforma

Principio Clave

Piensa en un registro de Talk2sync como una entidad lógica que existe en múltiples formas físicas en diferentes plataformas, todas unificadas y gestionadas bajo un registro maestro.


Resumen

Estos conceptos fundamentales forman la base de cómo opera Talk2sync:

ConceptoQué EsPunto Clave
JobProceso asincrónicoSe ejecuta en segundo plano, reporta progreso
ConexiónVínculo a plataforma externaAlmacena tus productos/órdenes
PlataformaSistema o servicio externoPuede ser marketplace, ERP, BD, etc.
ProductoArtículo que vendesFormato estandarizado en plataformas
Orden de VentaTransacción del clienteRegistro completo de orden con detalles
MultidimensionalMúltiples representaciones de plataformaUn maestro, muchas equivalencias

Siguientes Pasos

Ahora que entiendes estos conceptos fundamentales, explora:

  • Guía de la Plataforma Talk2sync - Aprende cómo usar la interfaz
  • Gestión de Productos - Crea y gestiona productos
  • Procesamiento de Órdenes - Maneja órdenes de venta
Actualizado el: 28/08/26, 12:58 a.m.
Prev
Guía del Usuario: Introducción