SelSup Developers

Sonundan sonuna iş akışı · Rehberler

Siparişler ve aşamalı senkronizasyon

Web mağazası siparişlerini oluşturmak, kopyaları önlemek, sayfa dışı göndermeler ve değiştirilmiş siparişin işlenmesi.

4 bölümlerGeliştiriciler rehberi
→

Güvenilir bir entegrasyon, başlangıç yükünü, değişim akışını ve uzlaşmalarını ayırır. externalOrderId SelSup siparişini sisteminize bağlar.

Web mağazaları, sipariş yönetimi ve teslimat sistemleri

01

Web mağazası siparişi oluştur

Siparişler vermeden önce ürünleri SelSup productId'e haritasında saklayın.

Dış sipariş numarasını externalOrderId'e gönderin ve tekrar denemeden önce veritabanınızda kontrol edin. organizasyonId, çok organizasyonlu hesaplarda özellikle önemlidir.

Her ürün için satış kanal mantığınızla ilgili ürün kimliği, miktar ve fiyatı ekleyin.

!
POST' i yeniden denemek

Ağ zaman kesildikten sonra önce dış siparişini arayın. İlk istek yanıt kaybolmadan önce gerçekleştirilmiş olabilir.

Tüketici siparişi · JSON
{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

İlişkili API uç noktaları

POST/api/order/Bir sipariş oluşturGET/api/product/findHarita ürünleri

02

Başlangıç siparişleri ihracatı

Sıkı boyutlu sayfalarda siparişleri okuyun. Sadece ilerleme raporlama veya son sayım uyumluluğu gereksinimleri toplam olduğunda count=true kullanın.

SelSup kimliğini ve dışKörnek Kimliğini de kalır.

  1. 1

    Dışarı çıkış sınırını yakalayın

    Başlangıç zamanını kaydet, böylece tam tarama sırasında meydana gelen değişiklikler, artış geçiş ile algılanır.

  2. 2

    Her sayfayı işleme

    Sortlama ve alt kayıtlar değişebilirse aynı aralıktan paralel sayfalardan kaçının.

  3. 3

    Değişiklik kartını çalıştır .

    Tam yüklenmeden sonra, kaydedilen sınırdan itibaren küçük bir örtüşme ile değiştirilmiş siparişleri isteyin.

İlişkili API uç noktaları

GET/api/order/findArama emri

03

Boşluksuz süreç değişiklikleri

Geçerli arama sözleşmesinde bulunduğunuzda modifiedDate filtreyi kullanın. Kursor tamamı sayfanın başarılı bir şekilde işlenmesinden sonra ilerleyin.

Zaman pencereleri birkaç dakika içinde üst üste geçiyor ve id ve modifiedDate ile çoğaltılır. Bu yazma gecikmelerinden ve saat farklarından korunur.

Yerel sipariş temsilini değiştir, çünkü durum, adres, öğeler, işaretleme kodları veya ilgili veriler değişebilir.

i
Zaman yönetimi

Kürsörü API hassasiyetini kullanarak UTC'de saklayın.

Değişmiş siparişler · HTTP
GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

İlişkili API uç noktaları

GET/api/order/findArama artışıGET/api/order/{orderId}İzinle sipariş yükle

04

Başarısızlıkları ve ayrılığı ele alın

  1. 1

    Göndermeden önce geçerli hale getirilsin

    Her ürün için örgüt, sipariş türü, depo, pazar, miktar ve fiyatı kontrol edin.

  2. 2

    Geçici ve kalıcı hatalar

    Geçersiz veriler düzeltilmelidir, ağ arızası ise sonuç kontrolden sonra kontrol edilmiş bir tekrar deneme gerektirir.

  3. 3

    Devamlı uyum sağlayın

    Ana değişim akışından bağımsız olarak üst üste bir dönem için durumları ve sipariş içeriğini karşılaştırın.

!
Hata kodu, metin değil

error'de şubesi. localMessage token sahibi için yerleştirilmiştir ve değiştirilebilir.