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

Obtener página de productos

La operación Obtener página de productos inicializa el proceso de descarga de productos y verifica que la reverse connection esté preparada para proporcionar datos de productos al daemon.

Antes de continuar, el daemon debe verificar el estado actual de la conexión upstream y confirmar que la entidad solicitada sea products.

1. Consultar el estado upstream

Primero, recupera el estado actual de la conexión upstream:

GET https://api.talk2sync.com/api/adapters/custom/reverse/connection/{{your key}}/upstreamstatus

La respuesta debe tener una estructura similar a:

{
  "connectionstatus": "waiting"
}

El estado waiting indica que el proceso de descarga está listo para ser inicializado.

2. Consultar la entidad solicitada

Recupera la entidad que actualmente está solicitando Talk2Sync:

GET https://api.talk2sync.com/api/adapters/custom/reverse/connection/{{your key}}/entity

La respuesta puede identificar productos u órdenes:

{
  "entity": "products"
}

o:

{
  "entity": "orders"
}

Para esta operación, continúa únicamente cuando la entidad solicitada sea products.

3. Inicializar la descarga de productos

Inicializa el proceso de descarga:

POST https://api.talk2sync.com/api/adapters/custom/reverse/connection/{{your key}}/pull/initialize

Después de la inicialización, consulta nuevamente el estado upstream:

GET https://api.talk2sync.com/api/adapters/custom/reverse/connection/{{your key}}/upstreamstatus

Espera hasta que la conexión devuelva:

{
  "connectionstatus": "initialized"
}

El daemon debe continuar con las siguientes operaciones de descarga de productos únicamente después de que la conexión alcance el estado initialized.

Proceso

Siguientes pasos

  • Continúa con Obtener siguiente producto para recuperar el siguiente producto.
  • Consulta Notificar éxito del producto y Notificar error del producto para informar los resultados del almacenamiento.
  • Consulta Finalizar obtención de productos para finalizar la descarga de productos.
  • Consulta el Protocolo de descarga de productos para revisar el flujo completo de sincronización de productos.
Actualizado el: 21/08/26, 12:13 p.m.
Prev
Obtener el siguiente producto
Next
Notificar almacenamiento exitoso del producto