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 la siguiente orden

La operación Obtener la siguiente orden recupera las órdenes individualmente desde Talk2Sync para insertarlas o actualizarlas en el sistema externo.

Antes de solicitar la siguiente orden, el daemon debe verificar que Talk2Sync haya terminado de procesar la transacción anterior. Esto se controla mediante el estado hasmore.

1. Verificar si hay más órdenes disponibles

Primero, consulta el estado de la descarga de órdenes:

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

El endpoint devuelve un estado similar a:

{
  "hasmore": "waiting"
}

o:

{
  "hasmore": "ready"
}

waiting

El estado waiting indica que el servidor todavía está procesando la transacción anterior.

El daemon debe esperar y volver a consultar el endpoint hasta que el estado cambie a ready.

ready

El estado ready indica que el daemon puede solicitar la siguiente orden.

2. Obtener la siguiente orden

Una vez que el estado hasmore sea ready, solicita la siguiente orden:

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

La respuesta contiene la orden que debe insertarse o actualizarse en el sistema externo:

{
  "order": {
    "_id": "75554554546",
    "orderid": "777777",
    "last_updated": 1517360038797,
    "status": "paid",
    "dateCreated": "",
    "dateClosed": "",
    "total": {
      "amount": 350,
      "currency": "USD"
    },
    "orderItems": [
      {
        "id": "7778545",
        "variation_id": "0",
        "quantity": "1",
        "unitPrice": "350",
        "currencyId": "USD"
      }
    ],
    "buyer": {
      "id": "4578889",
      "email": "testbuyer@example.com",
      "phone": "88888888",
      "firstName": "John",
      "lastName": "Doe"
    }
  }
}

El daemon puede procesar la orden recibida y posteriormente informar si la operación de almacenamiento fue exitosa o fallida.

Proceso

Siguientes pasos

  • Consulta Obtener página de órdenes para revisar la inicialización de la descarga de órdenes.
  • Continúa con Notificar éxito del almacenamiento de órdenes para informar una operación exitosa.
  • Continúa con Notificar error del almacenamiento de órdenes para informar una operación fallida.
  • Consulta Finalizar obtención de órdenes para finalizar la descarga de órdenes.
Actualizado el: 28/08/26, 12:58 a.m.
Next
Obtener página de órdenes