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

Implementación de almacenamiento: productos y órdenes

La implementación de almacenamiento es responsable de recibir productos y órdenes actualizados desde Talk2Sync, transformar los datos recibidos e insertarlos o actualizarlos en la aplicación externa.

El sistema destino puede ser un ERP, una base de datos u otra aplicación. La operación de almacenamiento puede realizarse mediante diferentes mecanismos de integración, incluyendo:

  • Acceso directo a bases de datos mediante JDBC u ODBC.
  • APIs como SOAP o REST.
  • Interfaces COM.
  • Integraciones basadas en el sistema de archivos.
  • Otros mecanismos compatibles con la aplicación destino.

El requisito fundamental es que la implementación determine si los datos fueron realmente almacenados o actualizados correctamente y comunique el resultado a Talk2Sync.

Implementación de almacenamiento de productos

Cuando Talk2Sync envía un producto actualizado, el conector debe:

  1. Recibir el producto desde Talk2Sync.
  2. Transformarlo al formato requerido por el sistema destino.
  3. Insertarlo si no existe o actualizarlo si ya existe.
  4. Verificar si la operación fue exitosa.
  5. Comunicar el resultado a Talk2Sync.

Si la operación de almacenamiento falla, el conector debe informar el error para que Talk2Sync pueda volver a intentar la misma inserción o actualización durante una sincronización posterior.

Implementación de almacenamiento de órdenes

El proceso de almacenamiento de órdenes sigue el mismo patrón.

Cuando Talk2Sync envía una orden actualizada, el conector debe:

  1. Recibir la orden desde Talk2Sync.
  2. Transformarla al formato del sistema destino.
  3. Insertar o actualizar la orden.
  4. Verificar que la operación haya terminado correctamente.
  5. Comunicar el resultado a Talk2Sync.

Si la operación falla, el error debe comunicarse a Talk2Sync para que la actualización pueda volver a intentarse durante una sincronización posterior.

Por qué es necesario reportar los errores

El resultado de la operación de almacenamiento es una parte esencial de la transacción de sincronización.

Cuando el conector reporta un error, Talk2Sync sabe que la operación no se completó y puede intentar enviar nuevamente la misma actualización durante una sincronización posterior hasta que el almacenamiento sea exitoso.

Si el conector no reporta un error, Talk2Sync asume que la operación de almacenamiento fue exitosa. Por lo tanto, no volverá a intentar la actualización posteriormente.

En ese escenario, una sincronización posterior podría interpretar los valores anteriores como un nuevo cambio y propagar esas modificaciones hacia otras conexiones configuradas en Talk2Sync.

Importante: Siempre informa el resultado real de la operación de almacenamiento. No confirmes una transacción como exitosa a menos que el sistema destino haya almacenado o actualizado correctamente los datos.

Flujo de almacenamiento

Siguientes pasos

  • Consulta Implementación de consulta: productos y órdenes para implementar la recuperación y transformación de datos.
  • Consulta Notificar éxito del almacenamiento de productos para el flujo de notificación de productos procesados correctamente.
  • Consulta Notificar error del almacenamiento de productos para gestionar errores de productos.
  • Consulta Notificar éxito del almacenamiento de órdenes para el flujo de notificación de órdenes procesadas correctamente.
  • Consulta Notificar error del almacenamiento de órdenes para gestionar errores de órdenes.
Actualizado el: 21/08/26, 12:13 p.m.
Prev
Implementación de consulta: productos y órdenes
Next
Sleep y timeouts