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

Prueba tu Integración

Paso 4 - Prueba tu Integración

En este último paso, verificarás que tu integración personalizada está funcionando correctamente probando la conexión con tus endpoints.

Ejecutar la Prueba

Procedimiento

  1. En la interfaz de conexión de Talk2sync, navega a la sección "Prueba de Conexión" o "Escanear Productos"
  2. Haz clic en el botón "Escanear Productos" para iniciar la prueba
  3. Talk2sync intentará:
    • Conectarse a la URL de tu tienda
    • Autenticarse usando tu clave de seguridad
    • Recuperar productos de tu endpoint /api/products
  4. Espera a que se complete la prueba (puede tomar algunos momentos)

Entendiendo los Resultados de la Prueba

Escenario de Éxito ✓

Si la prueba es exitosa, deberías ver:

  • Estado: ✓ Conexión Exitosa
  • Productos Recuperados: Un contador de productos de tu catálogo
  • Mensaje: Tu tienda está ahora conectada con Talk2sync

Esto significa:

  • ✓ La URL de tu tienda es accesible
  • ✓ Tus endpoints están respondiendo correctamente
  • ✓ Tu clave de seguridad está validada
  • ✓ Tus productos se están recuperando en el formato JSON esperado

Solución de Problemas en Pruebas Fallidas ✗

Si la prueba falla, Talk2sync mostrará un mensaje de error. Aquí hay problemas comunes y cómo resolverlos:

ErrorCausaSolución
Timeout de ConexiónLa URL de la tienda no es accesibleVerifica que tu URL de tienda sea correcta y tu servidor esté en funcionamiento
401 No AutorizadoClave de seguridad inválida o faltanteVerifica que tus endpoints estén validando la clave correctamente
Formato JSON InválidoLa respuesta no es JSON válidoAsegúrate de que tus endpoints devuelvan respuestas JSON correctas
No se Encontraron ProductosEl endpoint de productos no funcionaPrueba manualmente tu endpoint /api/products
Error de CertificadoProblema con el certificado HTTPSAsegúrate de que tu certificado SSL sea válido (para producción)

Prueba Manual (Opcional)

Si quieres probar tus endpoints manualmente antes de usar la interfaz de Talk2sync:

Probar Endpoint de Productos:

curl -H "Authorization: Bearer TU_CLAVE_GENERADA" \
  https://www.example.com/api/products

Probar Endpoint de Órdenes:

curl -H "Authorization: Bearer TU_CLAVE_GENERADA" \
  https://www.example.com/api/orders

Ambos endpoints deben responder con datos JSON válidos.

Qué Sucede Después del Éxito

Una vez que tu integración pasa todas las pruebas:

  1. Conexión Activa: Talk2sync comenzará a sincronizar datos con tus endpoints
  2. Sincronización Automática: Tus productos y órdenes se sincronizarán según el programa configurado en Talk2sync
  3. Monitoreo Continuo: Talk2sync monitoreará tus endpoints en busca de cambios y actualizaciones
  4. Alertas de Error: Si la sincronización falla, recibirás notificaciones sobre los problemas

Siguientes Pasos

¡Tu integración personalizada con Talk2sync está ahora completa! Puedes:

  • Acceder a tus datos en la plataforma Talk2sync
  • Configurar sincronizaciones automáticas para mantener los datos actualizados
  • Configurar alertas para fallos de sincronización
  • Monitorear tu integración a través del panel de control
  • Conectar tiendas adicionales usando el mismo proceso

Para características más avanzadas y documentación detallada de API, consulta:

  • API de Webhooks
  • API de Invocación Inversa

¡Felicidades! 🎉

Tu tienda está ahora exitosamente integrada con Talk2sync. Puedes comenzar a aprovechar las capacidades completas de la plataforma para gestionar tus productos y órdenes en múltiples canales de venta.

¿Necesitas Ayuda?

Si encuentras algún problema:

  • Revisa la sección de FAQ
  • Analiza cuidadosamente los mensajes de error
  • Contacta al equipo de soporte de Talk2sync

Pasos Relacionados

  • Anterior: Generar Claves
  • Todos los Quick Start: Descripción General de Quick Start
Actualizado el: 28/08/26, 12:58 a.m.
Prev
Generar Claves