Orden y sincronización incremental

Almacenar productos en el mapa a SelSup productId antes de realizar pedidos. No resuelva los productos con un nombre de pantalla mutable durante el checkout.

Enviar el número de pedido externo en externalOrderId y comprobarlo en su base de datos antes de volver a intentarlo.

Incluya el producto, la cantidad y el precio requerido por la lógica de su canal de ventas para cada artículo.

{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

Leer órdenes en páginas de tamaño fijo. Utilice count=true sólo cuando los informes de progreso o las necesidades de conciliación de recuento final sean totales.

Persiste tanto en el ID SelSup como en el de orden externa. Compromete cada página procesada de forma atómica antes de pasar a la siguiente página.

1. 1

   Captura de la frontera de exportación

   Guarde el tiempo de inicio para que los cambios que ocurran durante el escaneo completo sean recogidos por el paso incremental.

2. 2

   Procesar cada página

   Evite páginas paralelas del mismo rango cuando la clasificación y los registros subyacentes puedan cambiar.

3. 3

   Ejecutar el pase de cambio

   Después de la carga completa, solicite órdenes modificadas desde el límite guardado con una pequeña superposición.

Utilice el filtro modificadoDate cuando esté presente en el contrato de búsqueda actual. Avance el cursor solo después de que la página completa haya sido procesada con éxito.

Las ventanas de tiempo se superponen en unos minutos y se deduplican por id y modificadoDate. Esto protege contra retrasos de escritura y diferencias de reloj.

Reemplazar la representación de orden local porque el estado, la dirección, los elementos, los códigos de marcado o los datos relacionados pueden cambiar.

GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

1. 1

   Validación antes de enviar

   Compruebe la organización, el tipo de pedido, el almacén, el mercado, la cantidad y el precio de cada artículo.

2. 2

   Erros transitorios y permanentes separados

   Los datos inválidos necesitan ser corregidos, mientras que una falla de red necesita un retiro controlado después de verificar el resultado.

3. 3

   Conciliar periódicamente

   Comparar los estados y los contenidos de los pedidos durante un período superpuesto independientemente del flujo de cambios principal.