SelSup Developers

Flux de travail de bout en bout · Les guides

Les commandes et la synchronisation progressive

Créer des commandes dans les magasins Web, empêcher les copies, les exportations en pages et traiter les commandes modifiées.

4 sectionsGuide du développeur

Une intégration fiable sépare la charge initiale, le flux de changement et la reconciliation. externalOrderId connecte l'ordre SelSup à votre système.

Les magasins en ligne, la gestion des commandes et les systèmes de livraison

01

Créer une commande en magasin

Mettez les produits en cartographie sur SelSup productId avant de créer des commandes. Ne résolvez pas les produits par un nom d'affichage mutable pendant la mise en cache.

Envoyez le numéro de commande externe dans externalOrderId et vérifiez-le dans votre base de données avant de réessayer.

Incluez l'identification du produit, la quantité et le prix requis par votre logique de canal de vente pour chaque article.

!
Retour à POST

Après une interruption de temps de réseau, recherchez d'abord l'Ordre externe. Ne réalisez pas aveuglément parce que la première demande a peut-être été commise avant que sa réponse ne soit perdue.

Commande de détail · JSON
{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

02

Export de commande initiale

Lire les commandes dans les pages de taille fixe. Utilisez count=true uniquement lorsque les besoins de rapport d'avancement ou de réconciliation du compte final sont totaux.

Persistez à la fois sur l'ID SelSup et sur l"ID de commande externe.

  1. 1

    Capture de la limite d'exportation

    Gardez le temps de démarrage afin que les changements qui se produisent pendant la scan complète soient détectés par le passage incrémentiel.

  2. 2

    Traiter chaque page

    Évitez les pages parallèles de la même plage lorsque le tri et les enregistrements sous-jacents peuvent changer.

  3. 3

    Exécutez le passe de change

    Après la charge complète, demandez des commandes modifiées depuis la limite enregistrée avec une petite chevauchée.

03

Changements de processus sans écart

Utilisez le filtre modifiéDate lorsqu'il est présent dans le contrat de recherche actuel. Avancez le curseur seulement après le traitement de la page complète.

Les fenêtres de temps se chevauchent de quelques minutes et sont déduplicées par id et modifiéDate.

Remplacez la représentation de l'ordre local car le statut, l'adresse, les éléments, les codes de marquage ou les données connexes peuvent tous changer.

i
Traitement du temps

Conservez le curseur en UTC en utilisant la précision exacte API. Ne faites pas le tour de secondes ou n'utilisez pas l'heure locale du serveur sans compensation.

Les ordres modifiés · HTTP
GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

04

Gérer les défaillances et les divergences

  1. 1

    Valider avant expédition

    Vérifiez l'organisation, le type de commande, l'entrepôt, le marché, la quantité et le prix de chaque article.

  2. 2

    Échecs séparés transitoires et permanents

    Les données non valides doivent être corrigées, tandis qu'une défaillance du réseau doit être réessayée avec contrôle après vérification du résultat.

  3. 3

    Réconcilier périodiquement

    Comparer les statuts et les contenus des commandes pendant une période de chevauchement indépendamment du flux de changement principal.

!
Code d'erreur, pas de texte

La branche sur error. localMessage est localisé pour le propriétaire du jeton et peut changer.