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.
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 livraison01
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.
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.
{
"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
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
Traiter chaque page
Évitez les pages parallèles de la même plage lorsque le tri et les enregistrements sous-jacents peuvent changer.
- 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.
Points d'extrémité API connexes
GET/api/order/findLes ordres de recherche
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.
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.
GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN
Points d'extrémité API connexes
GET/api/order/findRecherche en augmentationGET/api/order/{orderId}Charger une commande par ID
04
Gérer les défaillances et les divergences
- 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
É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
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.
La branche sur error. localMessage est localisé pour le propriétaire du jeton et peut changer.