Siparişleri aktarma

1. Mağazaları ve durum kodlarını öğrenin

• GetStores hesabınızdaki mağazaları StoreId ve pazaryeri (IntegrationId) bilgisiyle verir. Siparişler mağaza bazında çekilir.
• GetIntegrationOrderListingStatus her mağazanın sipariş durum kodlarını verir (ör. Created, Shipped, Cancelled). Kodlar pazaryerine göre değişir; sabit bir listeye güvenmeyin. Erp: 1 olan durumlar ERP/muhasebe aktarımına uygun durumlardır.

2. Siparişleri çekin

Siparişleri GetSales ile alırsınız. StoreId ve OrderStatus her zaman zorunludur. Siparişleri seçmek için üç yöntemden birini kullanın:

Artımlı çekim örneği:

{
  "ApiCode": "API_CODE",
  "StoreId": 12345,
  "OrderStatus": "Created",
  "BiggestOrderDetailId": 9876543,
  "PageIndex": 1,
  "RowsByPage": 200
}

Tarih aralığı örneği (1–3 Kasım arasındaki siparişler):

{
  "ApiCode": "API_CODE",
  "StoreId": 12345,
  "OrderStatus": "Created",
  "StartDate": "2026-11-01T00:00:00",
  "EndDate": "2026-11-03T00:00:00",
  "PageIndex": 1,
  "RowsByPage": 200
}

3. Sayfalama

• PageIndex 1'den başlar. RowsByPage sayfa başına sipariş sayısıdır (satır değil); varsayılan 20, en fazla 200'dür.
• Yanıttaki TotalOrderCount filtreye uyan toplam sipariş sayısıdır. Aldığınız sipariş sayısı bu değere ulaşana kadar PageIndex değerini artırın.
• Sıralama her zaman sipariş tarihine göre yeniden eskiyedir.

4. Durumlar satır düzeyindedir

Bir siparişin her satırının (kaleminin) kendi durumu vardır. GetSales durum filtresini satırlara uygular: sipariş yalnızca istenen durumdaki satırlarıyla döner. Bu yüzden:

• Aktarmak istediğiniz her durum kodu için ayrı istek yapın.
• Bir siparişin tüm satırlarını görmek için GetOrder kullanın.
• Belirli satırların güncel durumunu GetOrderDetailStatus ile sorgulayın.

5. Tarih ve saatler

• İstek tarihlerini saat dilimi eki olmadan Türkiye saatiyle gönderin: 2026-11-05T14:30:00. 05.11.2026 gibi yerel biçimler kullanmayın.
• Yanıtta OrderDate, CargoDate, InvoiceTime, PackageTime ve WayBillTime UTC olarak (Z ekiyle) döner. LastModificationTime ise ekli olmadan Türkiye saatiyle döner.
• Boş tarihler null değil, 1899-12-31T22:03:00Z olarak gelir. 1900'den önceki tarihleri boş kabul edin.

Önerilen akış

1. Başlangıçta her mağaza için durum kodlarını alın ve aktaracağınız durumları seçin.
2. Birkaç dakikada bir, her mağaza ve durum için GetSales'i BiggestOrderDetailId ile çağırın; tüm sayfaları okuyun.
3. Siparişleri OrderId, satırları OrderDetailId ile kaydedin; aynı kimlik ikinci kez gelirse güncelleyin, yeni kayıt açmayın.
4. En büyük OrderDetailId değerini yalnızca siparişler kendi sisteminize başarıyla yazıldıktan sonra saklayın.
5. İptal ve iadeleri yakalamak için ayrıca LastModificationTimeFrom ile değişen satırları çekin.
6. Faturayı kestikten sonra fatura bilgisini geri gönderin: Kargo ve fatura.

Diğer sipariş işlemleri

• SetOrderNotes: siparişe StockMount içinde not yazar; pazaryerine gönderilmez.
• SetOrder ve SetOrderDetailStatus: yalnızca StockMount tipi (kendi) mağazalarınızda sipariş oluşturur ve satır durumu değiştirir. Pazaryeri siparişlerinin durumu pazaryerinden gelir.
• ConfirmOrRejectOrderItem: N11 sipariş kalemlerini onaylar veya reddeder.