API
English

API referansı · Siparişler

Siparişleri listele

Bir mağazanın belirli bir durumdaki siparişlerini sayfa sayfa döndürür.

POST https://out.stockmount.com/api/Integration/GetSales

StoreId ve OrderStatus her zaman zorunludur. Ayrıca şu üç yöntemden birini kullanmalısınız: (1) StartDate + EndDate tarih aralığı, (2) BiggestOrderDetailId veya SmallestOrderDetailId ile ID tabanlı artımlı çekim, (3) LastModificationTimeFrom ile değişiklik tabanlı çekim. (2) veya (3) kullanıldığında tarih alanları zorunlu değildir ve 7 gün sınırı uygulanmaz. Yine de gönderirseniz filtre olarak uygulanır.

Tarih aralığı modunda StartDate, EndDate'ten küçük olmalı ve aradaki fark en fazla 7 gün olmalıdır (tam 7 gün kabul edilir). Filtre siparişin OrderDate alanına uygulanır. Dikkat: sunucu EndDate'e 1 gün ekler ve sınırları dahil eder. Örneğin StartDate=2026-11-01T00:00:00, EndDate=2026-11-02T00:00:00 isteği 1 Kasım 00:00 ile 3 Kasım 00:00 arasındaki siparişleri döndürür. Ardışık pencerelerle tarama yaparsanız aynı sipariş iki kez gelebilir; OrderId ile tekilleştirin.

Tarihleri ISO 8601 biçiminde, ofsetsiz Türkiye saatiyle (UTC+3) gönderin, örn. 2026-11-05T14:30:00. Sondaki Z yok sayılır: değer yine Türkiye saati kabul edilir. +03:00 gibi açık bir ofset doğru dönüştürülür. 05.11.2026 gibi yerel biçimleri kullanmayın; ay ve gün yer değiştirebilir.

Yanıttaki saat dilimleri karışıktır. OrderDate, CargoDate, InvoiceTime, PackageTime ve WayBillTime UTC'ye çevrilip Z ekiyle döner. LastModificationTime ise çevrilmeden, ofsetsiz Türkiye saatiyle döner. Yanıttaki bir OrderDate değerini yeni istekte StartDate olarak kullanacaksanız önce Türkiye saatine çevirin.

Boş tarih alanları null olarak dönmez. CargoDate, InvoiceTime, PackageTime ve WayBillTime boşsa 1899-12-31T22:03:00Z döner (1900-01-01 Türkiye saatinin UTC karşılığı). 1900'den önceki her tarihi boş kabul edin. Değeri null olan alanlar (ör. PaymentMethod, CompanyTitle) yanıtta hiç yer almaz.

Sayfalama: PageIndex 1'den başlar; 0 veya gönderilmezse 1 kabul edilir. RowsByPage sayfa başına sipariş sayısıdır (satır değil); gönderilmezse veya 0 ise 20'dir, en fazla 200'dür. Daha büyük değerler hata vermeden 200'e düşürülür. Sıralama her zaman OrderDate azalan (en yeni önce) şeklindedir. TotalOrderCount filtreye uyan toplam sipariş sayısıdır; sayfa sayısı ceil(TotalOrderCount / RowsByPage). Sayfalama kaydırma (offset) tabanlıdır; tarama sırasında yeni sipariş gelirse kayıtlar sayfalar arasında kayabilir.

Durum filtresi satır (sipariş kalemi) düzeyindedir. Bir sipariş yalnızca istenen durumdaki satırlarıyla döner; aynı siparişin başka durumdaki satırları bu yanıtta yer almaz. Tüm satırları almak için her durum kodu için ayrı istek yapın ya da GetOrder kullanın. Geçerli kodları GetIntegrationOrderListingStatus döndürür ve pazaryerine göre değişir. Bilinmeyen bir kod hata vermez, boş liste döner.

BiggestOrderDetailId verildiğinde OrderDetailId değeri bu sayıdan büyük en az bir satırı olan siparişler döner; SmallestOrderDetailId küçük olanlar için çalışır. Bu filtreler, InvoiceStatus ve LastModificationTimeFrom/To yalnızca hangi siparişlerin seçileceğini belirler. Seçilen siparişin istenen durumdaki tüm satırları döner; daha önce aldığınız satırlar tekrar gelebilir. OrderDetailId ile tekilleştirin.

LastModificationTimeFrom/To satırın LastModificationTime değerine göre filtreler (Türkiye saati, sınırlar dahil, 2000 yılından sonraki değerler). Satır durumu değiştiğinde bu değer güncellenir. Tarih zorunluluğunu yalnızca LastModificationTimeFrom kaldırır; sadece LastModificationTimeTo gönderirseniz StartDate/EndDate yine zorunludur. LastModificationTime değeri boş olan satırlar bu filtreyle hiç dönmez.

Doğrulama hataları 00003 koduyla döner. ErrorMessage alan adını (StoreId, OrderStatus) ya da Türkçe bir açıklamayı içerir: StartDate parametresi boş olamaz, EndDate parametresi boş olamaz, StartDate parametresi EndDate parametresinden büyük olamaz (eşitlikte de döner), EndDate parametresi ile StartDate parametresi farkı 7 günden fazla olamaz.

Amazon mağazalarında alıcı ve adres alanları veritabanında şifreli tutulur; yanıt dönmeden önce çözülür. İstekteki OrderId ve LiveResult alanları bu uçta yok sayılır. GetOrders aynı işi yapan eski bir takma addır; yeni entegrasyonlarda GetSales kullanın.

TotalNotInvoicedCount ve TotalUnreadCount her zaman 0 döner; kullanmayın.

İstek alanları

Alan Tip Açıklama
ApiCode zorunlu string DoLogin ile aldığınız API kodu.
StoreId zorunlu integer Mağaza ID'si (GetStores).
OrderStatus zorunlu string Satır durum kodu. Mağazanın pazaryerine ait kodları GetIntegrationOrderListingStatus döndürür (Code alanı). StockMount mağazaları için kodlar aşağıdadır.
New
Yeni.
Approved
Onaylandı.
Rejected
Reddedildi.
Shipped
Kargoya verildi.
Delivered
Teslim edildi.
Completed
Tamamlandı.
StartDate datetime Başlangıç tarihi (OrderDate), ofsetsiz Türkiye saati. Tarih aralığı modunda zorunlu.
EndDate datetime Bitiş tarihi. StartDate'ten büyük olmalı, fark en fazla 7 gün. Sunucu bu değere 1 gün ekler. Tarih aralığı modunda zorunlu.
BiggestOrderDetailId integer Bu ID'den büyük satırı olan siparişleri getirir (yeni siparişleri artımlı çekmek için son gördüğünüz en büyük OrderDetailId).
SmallestOrderDetailId integer Bu ID'den küçük satırı olan siparişleri getirir.
LastModificationTimeFrom datetime Satırın LastModificationTime değeri bu zamandan büyük veya eşit olanlar. Verildiğinde tarih aralığı zorunlu değildir.
LastModificationTimeTo datetime Satırın LastModificationTime değeri bu zamandan küçük veya eşit olanlar.
InvoiceStatus integer Fatura durumuna göre filtre. Varsayılan 0. Listede olmayan değerler 0 gibi davranır.
0
Tümü.
1
Faturalandı (Invoiced = true).
2
Faturalanmadı.
PageIndex integer Sayfa numarası, 1'den başlar. Varsayılan 1.
RowsByPage integer Sayfa başına sipariş sayısı. Varsayılan 20, en fazla 200.

Yanıt alanları (Response)

Alan Tip Açıklama
TotalOrderCount integer Filtreye uyan toplam sipariş sayısı (tüm sayfalar).
TotalNotInvoicedCount integer Her zaman 0.
TotalUnreadCount integer Her zaman 0.
Orders object[] Bu sayfadaki siparişler.
Orders[]. OrderId integer StockMount sipariş ID'si. GetOrder, SetOrderNotes gibi uçlarda bu değeri kullanın.
Orders[]. StoreId integer Mağaza ID'si.
Orders[]. IntegrationOrderCode string Pazaryerinin sipariş numarası.
Orders[]. OrderDate datetime Sipariş tarihi, UTC (Z ekli). Örn. Türkiye saatiyle 14:30 olan sipariş …T11:30:00Z döner.
Orders[]. OrderStatus string İstekte gönderdiğiniz durum kodu (satır düzeyindeki filtre).
Orders[]. OrderType integer Sipariş tipi.
0
Standart sipariş.
1
Trendyol muadil ürün siparişi.
2
Trendyol yurt dışı (mikro ihracat) siparişi.
3
Trendyol yurt dışı ve muadil sipariş.
10
Hepsiburada Şimdi Al Sonra Öde (BNPL) siparişi.
Orders[]. Name string Alıcının adı.
Orders[]. Surname string Alıcının soyadı.
Orders[]. Fullname string Alıcı kurumsal ise firma unvanı, değilse ad soyad (o da yoksa Name). Ayrı bir CompanyTitle alanı dönmez.
Orders[]. Nickname string Alıcının pazaryerindeki kullanıcı adı.
Orders[]. PersonType string Alıcı tipi; Türkçe sabit metin.
Gerçek Kişi
Bireysel: PersonalIdentification = TaxNumber.
Tüzel Kişi
Kurumsal: TCKN yok, vergi no ve vergi dairesi var.
Belirlenemedi.
Orders[]. PersonalIdentification string TC kimlik numarası.
Orders[]. TaxAuthority string Vergi dairesi.
Orders[]. TaxNumber string Vergi numarası.
Orders[]. Email string Alıcının e-posta adresi.
Orders[]. Telephone string Alıcının telefonu.
Orders[]. Address string Fatura adresi, posta kodu, ilçe ve il değerlerinin boşlukla birleştirilmiş hali.
Orders[]. District string İlçe.
Orders[]. City string İl.
Orders[]. PostalCode string Posta kodu.
Orders[]. Country string Ülke. Boş dönebilir.
Orders[]. Notes string Sipariş notu (SetOrderNotes ile yazılır).
Orders[]. Member string Pazaryerinin ham üyelik bilgisi (ör. IdeaSoft JSON metni). Çoğunlukla boş.
Orders[]. PaymentType string Pazaryerinin bildirdiği ödeme tipi (ör. ÇiçekSepeti, IdeaSoft, Pazarama). Çoğunlukla boş.
Orders[]. RowSalt string İç alan (şifreleme tuzu, Base64). Normalde dönmez; dönerse yok sayın.
Orders[]. OrderDetails object[] Siparişin istenen durumdaki satırları.
Orders[].OrderDetails[]. OrderDetailId integer StockMount sipariş satırı ID'si. Diğer satır uçlarında bu değeri kullanın.
Orders[].OrderDetails[]. StoreId integer Mağaza ID'si.
Orders[].OrderDetails[]. IntegrationOrderDetailId string Satırın pazaryerindeki ID'si. Ek hizmet satırlarında {siparişNo}_Service gibi _ içeren yapay bir değer olabilir.
Orders[].OrderDetails[]. ProductId integer Eşleşen StockMount ürün ID'si. Eşleşme yoksa 0.
Orders[].OrderDetails[]. IntegrationProductCode string Ürünün pazaryerindeki kodu. Ek hizmet satırlarında sabit kodlar kullanılır: 999999999999 hizmet bedeli, 999999999998 vade farkı, 999999999997 komisyon, 999999999996 ödeme hizmet bedeli, 999999999995 kargo ücreti, 999999999994 hediye paketi, 999999999993 cari ödeme hizmet bedeli.
Orders[].OrderDetails[]. ProductName string Pazaryerindeki ürün adı. Boşsa eşleşen StockMount ürününün adı. İkisi de yoksa alan dönmez.
Orders[].OrderDetails[]. ProductCode string Eşleşen StockMount ürün kodu. Eşleşme yoksa MerchantSku, o da yoksa IntegrationProductCode.
Orders[].OrderDetails[]. ProductCode2 string StockMount ürününün ikinci kodu. Yoksa boş metin.
Orders[].OrderDetails[]. Barcode string Eşleşen StockMount ürününün barkodu. Eşleşme yoksa boş metin.
Orders[].OrderDetails[]. MerchantSku string Pazaryerinin satıcı stok kodu (SKU).
Orders[].OrderDetails[]. ProductImage string Eşleşen StockMount ürününün ilk görseli. Yoksa pazaryerinin görsel adresi.
Orders[].OrderDetails[]. ProductUnit string Satış birimi (pazaryeri bildiriyorsa).
Orders[].OrderDetails[]. ProductVariantCode string Satırın varyant kodu. Yoksa boş metin.
Orders[].OrderDetails[]. ProductVariantId integer Her zaman 0 döner; kullanmayın.
Orders[].OrderDetails[]. VariantProductCode string Eşleşen StockMount varyantının kodu. Yoksa boş metin.
Orders[].OrderDetails[]. VariantProductBarcode string Eşleşen StockMount varyantının barkodu. Yoksa boş metin.
Orders[].OrderDetails[]. VariantPhrase string Pazaryerinin varyant açıklaması (ör. Renk: Siyah, Beden: M).
Orders[].OrderDetails[]. VariantName1 string 1. varyant özelliğinin adı.
Orders[].OrderDetails[]. VariantValue1 string 1. varyant özelliğinin değeri.
Orders[].OrderDetails[]. VariantName2 string 2. varyant özelliğinin adı.
Orders[].OrderDetails[]. VariantValue2 string 2. varyant özelliğinin değeri.
Orders[].OrderDetails[]. VariantName3 string 3. varyant özelliğinin adı.
Orders[].OrderDetails[]. VariantValue3 string 3. varyant özelliğinin değeri.
Orders[].OrderDetails[]. Price number Birim fiyat. Satır toplamı = Price × RawQuantity (StockMount raporları da böyle hesaplar).
Orders[].OrderDetails[]. Quantity integer Adet; küsuratlı miktarlarda aşağı yuvarlanmış tam sayı. Kesin değer için RawQuantity kullanın.
Orders[].OrderDetails[]. RawQuantity number Ondalıklı (kesin) miktar.
Orders[].OrderDetails[]. TaxRate number KDV oranı (ör. 20). Satır bir StockMount ürünüyle eşleşmişse ve ürünün oranı 0'dan büyükse ürünün oranı kullanılır; aksi halde pazaryerinin bildirdiği oran. OrderType = 2 olan siparişlerde her zaman pazaryeri oranı döner.
Orders[].OrderDetails[]. DetailType integer Satır tipi.
0
Belirtilmemiş (varsayılan).
1
Ürün satırı.
2
Ek hizmet satırı (hizmet bedeli, kargo ücreti vb.).
3
Vade farkı satırı.
Orders[].OrderDetails[]. OrderStatus string Bu satırın durumu. GetSales yanıtında istekteki OrderStatus ile aynıdır.
Orders[].OrderDetails[]. Invoiced boolean Satır faturalandı olarak işaretliyse true.
Orders[].OrderDetails[]. InvoiceNumber string Fatura numarası. Yoksa boş metin.
Orders[].OrderDetails[]. InvoiceTime datetime Fatura tarihi, UTC (Z ekli). Değer yoksa null yerine 1899-12-31T22:03:00Z döner (1900-01-01 Türkiye saatinin UTC karşılığı).
Orders[].OrderDetails[]. PackageNumber string Pazaryerinin paket numarası (ör. Trendyol paket ID'si). Yoksa boş metin. Not: GetOrder bu alanda SetOrderDetailInvoiced ile yazılan StockMount paket numarasını döndürür.
Orders[].OrderDetails[]. PackageTime datetime Paket tarihi, UTC. Değer yoksa null yerine 1899-12-31T22:03:00Z döner (1900-01-01 Türkiye saatinin UTC karşılığı).
Orders[].OrderDetails[]. WayBillNumber string İrsaliye numarası. Yoksa boş metin.
Orders[].OrderDetails[]. WayBillTime datetime İrsaliye tarihi, UTC. Değer yoksa null yerine 1899-12-31T22:03:00Z döner (1900-01-01 Türkiye saatinin UTC karşılığı).
Orders[].OrderDetails[]. Unread boolean Satır StockMount panelinde okunmadı olarak işaretliyse true.
Orders[].OrderDetails[]. SmUserSchemaId integer Eşleşen StockMount ürününün şablon (şema) ID'si. Eşleşme yoksa 0.
Orders[].OrderDetails[]. SchemaName string Eşleşen ürünün şablon adı. Yoksa boş metin.
Orders[].OrderDetails[]. DeliveryTitle string Teslimat adresindeki alıcı adı/unvanı.
Orders[].OrderDetails[]. Address string Teslimat adresi, posta kodu, ilçe ve il değerlerinin boşlukla birleştirilmiş hali. Satırda adres yoksa yalnızca boşluklardan oluşabilir.
Orders[].OrderDetails[]. District string Teslimat ilçesi.
Orders[].OrderDetails[]. City string Teslimat ili.
Orders[].OrderDetails[]. Country string Teslimat ülkesi. Boş dönebilir.
Orders[].OrderDetails[]. PostalCode string Siparişin (satırın değil) posta kodu.
Orders[].OrderDetails[]. Telephone string Teslimat telefonu.
Orders[].OrderDetails[]. CargoCompany string Kargo firması adı.
Orders[].OrderDetails[]. CargoLabelCode string Kargo takip / etiket kodu. Boşsa satıra henüz kargo bilgisi girilmemiştir.
Orders[].OrderDetails[]. CargoPayment string Kargo ücretini kimin ödediği; genelde Seller, Buyer veya Unknown.
Orders[].OrderDetails[]. CargoDate datetime Kargo bilgisinin girildiği tarih, UTC. Değer yoksa null yerine 1899-12-31T22:03:00Z döner (1900-01-01 Türkiye saatinin UTC karşılığı).
Orders[].OrderDetails[]. ShipmentCampaignCode string Pazaryerinin kargo kampanya / gönderi kodu.
Orders[].OrderDetails[]. LastModificationTime datetime Satırın son değişiklik zamanı. Diğer tarihlerden farklı olarak UTC'ye çevrilmez; ofsetsiz Türkiye saatidir (ör. 2026-11-05T14:30:00).
Orders[].OrderDetails[]. RowSalt string İç alan (şifreleme tuzu, Base64). Normalde dönmez; dönerse yok sayın.

Bu servisin hata kodları

KodNe zaman
10001 StoreId hesabınıza ait bir mağaza değil (ErrorMessage: Invalid store.).
99999 Veritabanı hatası veya beklenmeyen bir istisna.

Oturum hataları (00001, 00006) ve tüm kodlar için hata kodları.

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "StoreId": 12345,
  "OrderStatus": "New",
  "StartDate": "2026-11-01T00:00:00",
  "EndDate": "2026-11-04T00:00:00",
  "InvoiceStatus": 0,
  "PageIndex": 1,
  "RowsByPage": 100
}

Örnek yanıt

{
  "Result": true,
  "Response": {
    "TotalOrderCount": 1,
    "TotalNotInvoicedCount": 0,
    "TotalUnreadCount": 0,
    "Orders": [
      {
        "OrderId": 4567890,
        "StoreId": 12345,
        "IntegrationOrderCode": "10293847",
        "OrderDate": "2026-11-04T07:12:45Z",
        "OrderStatus": "New",
        "OrderType": 0,
        "Name": "Ayşe",
        "Surname": "Yılmaz",
        "Fullname": "Ayşe Yılmaz",
        "Nickname": "ayseyilmaz",
        "PersonType": "Gerçek Kişi",
        "PersonalIdentification": "11111111111",
        "TaxAuthority": "",
        "TaxNumber": "11111111111",
        "Email": "ayse@example.com",
        "Telephone": "05551112233",
        "Address": "Örnek Mah. Deneme Sok. No:5 D:3 34710 Kadıköy İstanbul",
        "District": "Kadıköy",
        "City": "İstanbul",
        "PostalCode": "34710",
        "Country": "Türkiye",
        "Notes": "",
        "Member": "",
        "PaymentType": "",
        "OrderDetails": [
          {
            "OrderDetailId": 9876543,
            "StoreId": 12345,
            "IntegrationOrderDetailId": "3456789012",
            "ProductId": 554433,
            "IntegrationProductCode": "TSH-001-BLK-M",
            "ProductName": "Basic Tişört Siyah M",
            "ProductCode": "TSH-001",
            "ProductCode2": "",
            "Barcode": "8691234567890",
            "MerchantSku": "TSH-001-BLK-M",
            "ProductImage": "https://cdn.example.com/img/tsh-001.jpg",
            "ProductUnit": "Adet",
            "ProductVariantCode": "TSH-001-BLK-M",
            "ProductVariantId": 0,
            "VariantProductCode": "TSH-001-BLK-M",
            "VariantProductBarcode": "8691234567890",
            "VariantPhrase": "Renk: Siyah, Beden: M",
            "VariantName1": "Renk",
            "VariantValue1": "Siyah",
            "VariantName2": "Beden",
            "VariantValue2": "M",
            "VariantName3": "",
            "VariantValue3": "",
            "Price": 249.9,
            "Quantity": 2,
            "RawQuantity": 2.0,
            "TaxRate": 20.0,
            "DetailType": 1,
            "OrderStatus": "New",
            "Invoiced": false,
            "InvoiceNumber": "",
            "InvoiceTime": "1899-12-31T22:03:00Z",
            "PackageNumber": "",
            "PackageTime": "1899-12-31T22:03:00Z",
            "WayBillNumber": "",
            "WayBillTime": "1899-12-31T22:03:00Z",
            "Unread": true,
            "SmUserSchemaId": 77,
            "SchemaName": "Giyim",
            "DeliveryTitle": "Ayşe Yılmaz",
            "Address": "Örnek Mah. Deneme Sok. No:5 D:3 34710 Kadıköy İstanbul",
            "District": "Kadıköy",
            "City": "İstanbul",
            "Country": "Türkiye",
            "PostalCode": "34710",
            "Telephone": "05551112233",
            "CargoCompany": "",
            "CargoLabelCode": "",
            "CargoPayment": "Seller",
            "CargoDate": "1899-12-31T22:03:00Z",
            "ShipmentCampaignCode": "7330012345678",
            "LastModificationTime": "2026-11-04T10:15:22"
          }
        ]
      }
    ]
  }
}

Deneyin

İstek tarayıcınızdan doğrudan out.stockmount.com adresine gider. ApiCode bu sitede saklanmaz; yalnızca bu sekme açıkken tutulur.

İstek göndermek için önce ApiCode alın.

↑ ↓ ile gezinin, Enter ile açın, Esc ile kapatın.

Out API'ye bağlan

DoLogin çağrılır ve dönen ApiCode bu sekmede tutulur. API şifreniz bu siteye gönderilmez.