SelSup Developers

Przepływ pracy od końca do końca · Przewodniki

Zamówienia i stopniowa synchronizacja

Tworzenie zamówień w sklepie internetowym, zapobieganie kopiom, wywozie na stronach i przetwarzanie zamówiec zmienionych.

4 sekcjePrzewodnik dla programistów
→

Wiarygodna integracja oddziela początkowy obciążenie, przepływ zmian i uzgodnienie. externalOrderId łączy zamówienie SelSup do systemu.

Sklepy internetowe, systemy zarządzania zamówieniami i dostawy

01

Tworzenie zamówienia w sklepie internetowym

Przed dokonaniem zamówienia przechowywać produkty na mapie do produktu SelSup. Nie rozwiązuj produktów przez zmienne nazwy wyświetlania podczas wypożyczania.

Wysyłaj numer zamówienia zewnętrznego w externalOrderId i sprawdź go w bazie danych przed ponownym wypróbowaniem.

Włączyć produkt, ilość i cenę wymagany przez logikę kanału sprzedaży dla każdego przedmiotu.

!
Więcej próby POST

Po wycofaniu sieci najpierw wyszukaj zamówienie zewnętrzne.

Zamówienie detaliczne · JSON
{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

Powiązane punkty końcowe API

POST/api/order//Wypracowanie porządkuGET/api/product/findProdukty z map

02

Wywóz w pierwszym zamówieniu

Przeczytaj zamówienia na stronach o stałej wielkości. Użyj konta=prawdziwego tylko w przypadku, gdy potrzeba zgłoszenia postępu lub pojedynczenia końcowego konta jest całkowita.

Wystarczy utrzymać identyfikator SelSup i externalOrderId.

  1. 1

    Złapać granicę wywozu

    Zapisz czas startu, aby zmiany występujące podczas pełnego skanowania były odbierane przez przejście stopniowe.

  2. 2

    Przetwarzanie każdej strony

    Unikaj równoległych stron z tego samego zakresu, gdy sortowanie i podstawowe zapisy mogą ulec zmianie.

  3. 3

    Wybierz przepustkę

    Po pełnym załadunku żądać zamówienia modyfikowane od zapisanego granicy z niewielką pokryciem.

Powiązane punkty końcowe API

GET/api/order/findRozkaz przeszukiwania

03

Zmiany procesu bez luki

Użyj filtra modifiedDate, gdy jest obecny w bieżącej umowie wyszukiwania.

Okna czasu pokrywają się o kilka minut i odtwarzają się przez id i modifiedDate.

Zastąpić lokalne przedstawienie zamówienia, ponieważ status, adres, elementy, kody oznaczania lub powiązane dane mogą się zmienić.

i
Przeprowadzanie czasu

Przechowywanie kursoru w UTC przy użyciu dokładnej dokładności API. Nie okrągnij sekund ani nie używaj czasu serwera lokalnego bez offsetu.

Zmiana zamówienia · HTTP
GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

Powiązane punkty końcowe API

GET/api/order/findWzrost poszukiwaniaGET/api/order/{orderId}Włóż zamówienie za pomocą ID

04

Przeprowadzenie nieprawidłowości i niezgodności

  1. 1

    Wydanie przed wysyłką

    Sprawdź organizację, typ zamówienia, magazyn, miejsce sprzedaży, ilość i cenę każdego przedmiotu.

  2. 2

    Oddzielne błędy przejściowe i trwałe

    Nieprawidłowe dane wymagają poprawy, podczas gdy awaria sieci wymaga kontrolowanej ponownej próby po sprawdzeniu wyniku.

  3. 3

    Okresowe pojednanie

    Porównaj statusy i treści zamówienia w okresie pokrycia się niezależnie od głównego przepływu zmian.

!
Kod błędu, nie tekst

Oddział na error. localMessage jest lokalizowany dla właściciela tokena i może się zmieniać.