API
English

API referansı · Siparişler

Sipariş oluştur veya güncelle

StockMount tipi bir mağazaya dışarıdan sipariş ekler veya mevcut siparişi günceller.

POST https://out.stockmount.com/api/Integration/SetOrder
Veri değiştirir

Yalnızca StockMount tipi mağazalarda (pazaryeri IntegrationId = 9999) çalışır. Pazaryeri mağazalarına (Trendyol, Hepsiburada vb.) sipariş yazamazsınız; bu durumda 10001 / Store has to be StockMount store! döner.

Order.OrderId 0 veya gönderilmezse yeni sipariş oluşturulur. Aynı mağazada aynı IntegrationOrderCode zaten varsa sipariş eklenmez ve hata döner. Order.OrderId doluysa o sipariş güncellenir; siparişin mağazada olmaması 50006 döndürür.

Güncellemede siparişin tüm satırları silinip istekteki satırlar yeniden eklenir; bu yüzden satırların OrderDetailId değerleri değişir. Güncelleme CompanyTitle, Nickname ve IntegrationOrderCode alanlarını değiştirmez. İşlem tek bir veritabanı işleminde (transaction) yapılır; hata olursa hiçbir değişiklik kalmaz.

Varsayılanlar: OrderDate gönderilmezse veya 2000'den önceyse sunucu saati (Türkiye) kullanılır. Name boşsa Fullname kullanılır. Satırda Address boşsa sipariş adresi, il, ilçe, posta kodu, telefon ve teslimat adı (unvan ya da ad soyad) kopyalanır. Satır OrderStatus boşsa siparişin durumu kullanılır. CargoPayment değeri Seller, Buyer veya Unknown değilse Unknown olur.

Tarihleri ofsetsiz Türkiye saatiyle gönderin (bkz. GetSales). Price ve Quantity veritabanında 2 ondalık basamakla saklanır.

Başarılı olursa Response kaydedilen siparişi GetOrder biçiminde döndürür. İstekteki Order.Email, satır InvoiceNumber, InvoiceTime, PackageNumber, PackageTime, WayBillNumber, WayBillTime ve VariantProductCode alanları kaydedilmez; fatura bilgisi için SetOrderDetailInvoiced kullanın.

Doğrulama hataları 00003 ile döner ve ErrorMessage eksik alanı belirtir: OrderDetails, StoreId, IntegrationOrderCode, Nickname, OrderStatus, CompanyTitle/Fullname, Address, OrderDetail.IntegrationProductCode, OrderDetail.ProductName, OrderDetail.Quantity.

İstek alanları

Alan Tip Açıklama
ApiCode zorunlu string DoLogin ile aldığınız API kodu.
StoreId zorunlu integer StockMount tipi mağazanın ID'si.
Order zorunlu object Sipariş.
Order. OrderId integer Güncellenecek siparişin ID'si. Yeni sipariş için 0 veya göndermeyin.
Order. IntegrationOrderCode zorunlu string Sipariş numaranız. Mağaza içinde benzersiz olmalı. En fazla 50 karakter.
Order. OrderStatus zorunlu string Sipariş durumu (büyük/küçük harf duyarsız).
New
Yeni.
Approved
Onaylandı.
Rejected
Reddedildi.
Shipped
Kargoya verildi.
Delivered
Teslim edildi.
Completed
Tamamlandı.
Order. Nickname zorunlu string Alıcının kullanıcı adı / müşteri kodu. En fazla 100 karakter.
Order. Fullname string Alıcının adı soyadı. CompanyTitle boşsa zorunlu.
Order. CompanyTitle string Firma unvanı. Fullname boşsa zorunlu. Güncellemede değişmez.
Order. Address zorunlu string Adres. En fazla 500 karakter.
Order. OrderDate datetime Sipariş tarihi, ofsetsiz Türkiye saati. Varsayılan: şimdiki zaman.
Order. Name string Alıcının adı. Boşsa Fullname kullanılır.
Order. Surname string Alıcının soyadı.
Order. City string İl.
Order. District string İlçe.
Order. PostalCode string Posta kodu. En fazla 10 karakter.
Order. Telephone string Telefon.
Order. PersonalIdentification string TC kimlik numarası.
Order. TaxAuthority string Vergi dairesi.
Order. TaxNumber string Vergi numarası.
Order. Notes string Sipariş notu.
Order. OrderDetails zorunlu object[] Sipariş satırları; en az bir satır.
Order.OrderDetails[]. IntegrationProductCode zorunlu string Ürün kodu. En fazla 50 karakter.
Order.OrderDetails[]. ProductName zorunlu string Ürün adı. En fazla 200 karakter.
Order.OrderDetails[]. Quantity zorunlu integer Adet; en az 1.
Order.OrderDetails[]. Price number Birim fiyat.
Order.OrderDetails[]. TaxRate number KDV oranı (ör. 20).
Order.OrderDetails[]. IntegrationOrderDetailId string Satırın sizin sisteminizdeki ID'si.
Order.OrderDetails[]. ProductId integer Bağlanacak StockMount ürün ID'si. Varsayılan 0 (eşleşme yok).
Order.OrderDetails[]. ProductVariantId integer Bağlanacak StockMount varyant ID'si.
Order.OrderDetails[]. MerchantSku string Satıcı stok kodu.
Order.OrderDetails[]. ProductImage string Ürün görsel adresi.
Order.OrderDetails[]. OrderStatus string Satır durumu. Boşsa sipariş durumu kullanılır. Doğrulanmaz.
Order.OrderDetails[]. DetailType integer Satır tipi. Varsayılan 0.
0
Belirtilmemiş (varsayılan).
1
Ürün satırı.
2
Ek hizmet satırı (hizmet bedeli, kargo ücreti vb.).
3
Vade farkı satırı.
Order.OrderDetails[]. Invoiced boolean Faturalandı işareti. Varsayılan false.
Order.OrderDetails[]. DeliveryTitle string Teslimat adı / unvanı.
Order.OrderDetails[]. Address string Teslimat adresi. Boşsa sipariş adresi ve iletişim alanları kopyalanır.
Order.OrderDetails[]. City string Teslimat ili.
Order.OrderDetails[]. District string Teslimat ilçesi.
Order.OrderDetails[]. PostalCode string Teslimat posta kodu.
Order.OrderDetails[]. Telephone string Teslimat telefonu.
Order.OrderDetails[]. CargoCompany string Kargo firması.
Order.OrderDetails[]. CargoLabelCode string Kargo takip kodu.
Order.OrderDetails[]. CargoPayment string Kargo ödemesi.
Seller
Satıcı öder.
Buyer
Alıcı öder.
Unknown
Bilinmiyor (geçersiz değerler buna çevrilir).
Order.OrderDetails[]. CargoDate datetime Kargo tarihi; yalnızca 2000 sonrası değerler kaydedilir.
Order.OrderDetails[]. ShipmentCampaignCode string Kargo kampanya / gönderi kodu.
Order.OrderDetails[]. PaymentMethod string Ödeme yöntemi. En fazla 50 karakter.
Order.OrderDetails[]. VariantName1 string 1. varyant özelliğinin adı.
Order.OrderDetails[]. VariantValue1 string 1. varyant özelliğinin değeri.
Order.OrderDetails[]. VariantName2 string 2. varyant özelliğinin adı.
Order.OrderDetails[]. VariantValue2 string 2. varyant özelliğinin değeri.
Order.OrderDetails[]. VariantName3 string 3. varyant özelliğinin adı.
Order.OrderDetails[]. VariantValue3 string 3. varyant özelliğinin değeri.

Yanıt alanları (Response)

Alan Tip Açıklama
OrderId integer StockMount sipariş ID'si. GetOrder, SetOrderNotes gibi uçlarda bu değeri kullanın.
StoreId integer Mağaza ID'si.
IntegrationOrderCode string Pazaryerinin sipariş numarası.
OrderDate datetime Sipariş tarihi, UTC (Z ekli). Örn. Türkiye saatiyle 14:30 olan sipariş …T11:30:00Z döner.
OrderStatus string Siparişin genel durumu (sipariş tablosundaki değer). Satırların güncel durumu farklı olabilir; GetOrderDetailStatus ile kontrol edin.
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.
Name string Alıcının adı.
Surname string Alıcının soyadı.
Fullname string Alıcı kurumsal ise firma unvanı, değilse ad soyad. Ayrı bir CompanyTitle alanı dönmez.
Nickname string Alıcının pazaryerindeki kullanıcı adı.
PersonalIdentification string TC kimlik numarası.
TaxAuthority string Vergi dairesi.
TaxNumber string Vergi numarası.
Email string Alıcının e-posta adresi.
Telephone string Alıcının telefonu.
Address string Fatura adresi, posta kodu, ilçe ve il değerlerinin boşlukla birleştirilmiş hali.
District string İlçe.
City string İl.
PostalCode string Posta kodu.
Notes string Sipariş notu (SetOrderNotes ile yazılır).
Member string Pazaryerinin ham üyelik bilgisi (ör. IdeaSoft JSON metni). Çoğunlukla boş.
RowSalt string İç alan (şifreleme tuzu, Base64). Normalde dönmez; dönerse yok sayın.
OrderDetails object[] Siparişin tüm satırları.
OrderDetails[]. OrderDetailId integer StockMount sipariş satırı ID'si. Diğer satır uçlarında bu değeri kullanın.
OrderDetails[]. StoreId integer Mağaza ID'si.
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.
OrderDetails[]. ProductId integer Eşleşen StockMount ürün ID'si. Eşleşme yoksa 0.
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.
OrderDetails[]. ProductName string Pazaryerindeki ürün adı. Boşsa eşleşen StockMount ürününün adı. İkisi de yoksa alan dönmez.
OrderDetails[]. ProductCode string Eşleşen StockMount ürün kodu. Eşleşme yoksa MerchantSku, o da yoksa IntegrationProductCode.
OrderDetails[]. ProductCode2 string StockMount ürününün ikinci kodu. Yoksa boş metin.
OrderDetails[]. Barcode string Eşleşen StockMount ürününün barkodu. Eşleşme yoksa boş metin.
OrderDetails[]. MerchantSku string Pazaryerinin satıcı stok kodu (SKU).
OrderDetails[]. ProductImage string Eşleşen StockMount ürününün ilk görseli. Yoksa pazaryerinin görsel adresi.
OrderDetails[]. ProductUnit string Satış birimi (pazaryeri bildiriyorsa).
OrderDetails[]. ProductVariantCode string Satırın varyant kodu. Yoksa boş metin.
OrderDetails[]. ProductVariantId integer Her zaman 0 döner; kullanmayın.
OrderDetails[]. VariantProductCode string Eşleşen StockMount varyantının kodu. Yoksa boş metin.
OrderDetails[]. VariantProductBarcode string Eşleşen StockMount varyantının barkodu. Yoksa boş metin.
OrderDetails[]. VariantPhrase string Pazaryerinin varyant açıklaması (ör. Renk: Siyah, Beden: M).
OrderDetails[]. VariantName1 string 1. varyant özelliğinin adı.
OrderDetails[]. VariantValue1 string 1. varyant özelliğinin değeri.
OrderDetails[]. VariantName2 string 2. varyant özelliğinin adı.
OrderDetails[]. VariantValue2 string 2. varyant özelliğinin değeri.
OrderDetails[]. VariantName3 string 3. varyant özelliğinin adı.
OrderDetails[]. VariantValue3 string 3. varyant özelliğinin değeri.
OrderDetails[]. Price number Birim fiyat. Satır toplamı = Price × RawQuantity (StockMount raporları da böyle hesaplar).
OrderDetails[]. Quantity integer Adet; küsuratlı miktarlarda aşağı yuvarlanmış tam sayı. Kesin değer için RawQuantity kullanın.
OrderDetails[]. RawQuantity number Ondalıklı (kesin) miktar.
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ı, aksi halde pazaryerinin bildirdiği oran.
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ı.
OrderDetails[]. OrderStatus string Siparişin genel durumu (sipariş tablosundan); satırın kendi durumu değildir. Satır durumu için GetOrderDetailStatus kullanın.
OrderDetails[]. Invoiced boolean Satır faturalandı olarak işaretliyse true.
OrderDetails[]. InvoiceNumber string Fatura numarası. Yoksa boş metin.
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ığı).
OrderDetails[]. PackageNumber string SetOrderDetailInvoiced ile yazılan paket numarası. Yoksa boş metin. Not: GetSales bu alanda pazaryerinin paket numarasını döndürür.
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ığı).
OrderDetails[]. WayBillNumber string İrsaliye numarası. Yoksa boş metin.
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ığı).
OrderDetails[]. Unread boolean Satır StockMount panelinde okunmadı olarak işaretliyse true.
OrderDetails[]. SmUserSchemaId integer Eşleşen StockMount ürününün şablon (şema) ID'si. Eşleşme yoksa 0.
OrderDetails[]. SchemaName string Eşleşen ürünün şablon adı. Yoksa boş metin.
OrderDetails[]. DeliveryTitle string Teslimat adresindeki alıcı adı/unvanı.
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.
OrderDetails[]. District string Teslimat ilçesi.
OrderDetails[]. City string Teslimat ili.
OrderDetails[]. PostalCode string Siparişin (satırın değil) posta kodu.
OrderDetails[]. Telephone string Teslimat telefonu.
OrderDetails[]. CargoCompany string Kargo firması adı.
OrderDetails[]. CargoLabelCode string Kargo takip / etiket kodu. Boşsa satıra henüz kargo bilgisi girilmemiştir.
OrderDetails[]. CargoPayment string Kargo ücretini kimin ödediği; genelde Seller, Buyer veya Unknown.
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ığı).
OrderDetails[]. ShipmentCampaignCode string Pazaryerinin kargo kampanya / gönderi kodu.
OrderDetails[]. LastModificationTime datetime Bu uçta doldurulmaz; her zaman 0001-01-01T00:00:00 döner. Gerçek değer için GetSales kullanın.
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.).
50001 Sipariş kaydedilemedi. Aynı IntegrationOrderCode mağazada zaten varsa da bu kod döner; Response mevcut siparişin ID'sini içeren bir dizidir (ör. [4567999]).
50002 Alıcı kaydı yazılamadı.
50003 Bir sipariş satırı yazılamadı.
50004 Güncellemede eski satırlar silinemedi.
50006 Order.OrderId verilen sipariş bu mağazada yok (Order does not exist !).
99999 Beklenmeyen hata; mağaza başka bir kullanıcıya aitse de bu kod döner.

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

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "StoreId": 67890,
  "Order": {
    "IntegrationOrderCode": "WEB-2026-000123",
    "OrderStatus": "New",
    "OrderDate": "2026-11-05T14:30:00",
    "Nickname": "musteri-4411",
    "Fullname": "Mehmet Demir",
    "Name": "Mehmet",
    "Surname": "Demir",
    "Address": "Atatürk Cad. No:12",
    "District": "Nilüfer",
    "City": "Bursa",
    "PostalCode": "16110",
    "Telephone": "05321234567",
    "PersonalIdentification": "11111111111",
    "TaxNumber": "11111111111",
    "Notes": "Kapıya bırakılabilir.",
    "OrderDetails": [
      {
        "IntegrationOrderDetailId": "WEB-2026-000123-1",
        "IntegrationProductCode": "KUPA-350",
        "ProductName": "Seramik Kupa 350 ml",
        "Quantity": 3,
        "Price": 129.9,
        "TaxRate": 20,
        "DetailType": 1,
        "CargoPayment": "Seller"
      }
    ]
  }
}

Örnek yanıt

{
  "Result": true,
  "Response": {
    "OrderId": 4567999,
    "StoreId": 67890,
    "IntegrationOrderCode": "WEB-2026-000123",
    "OrderDate": "2026-11-05T11:30:00Z",
    "OrderStatus": "New",
    "OrderType": 0,
    "Name": "Mehmet",
    "Surname": "Demir",
    "Fullname": "Mehmet Demir",
    "Nickname": "musteri-4411",
    "PersonalIdentification": "11111111111",
    "TaxAuthority": "",
    "TaxNumber": "11111111111",
    "Email": "",
    "Telephone": "05321234567",
    "Address": "Atatürk Cad. No:12 16110 Nilüfer Bursa",
    "District": "Nilüfer",
    "City": "Bursa",
    "PostalCode": "16110",
    "Notes": "Kapıya bırakılabilir.",
    "Member": "",
    "OrderDetails": [
      {
        "OrderDetailId": 9877001,
        "StoreId": 67890,
        "IntegrationOrderDetailId": "WEB-2026-000123-1",
        "ProductId": 0,
        "IntegrationProductCode": "KUPA-350",
        "ProductName": "Seramik Kupa 350 ml",
        "ProductCode": "KUPA-350",
        "ProductCode2": "",
        "Barcode": "",
        "MerchantSku": "",
        "ProductImage": "",
        "ProductUnit": "",
        "ProductVariantCode": "",
        "ProductVariantId": 0,
        "VariantProductCode": "",
        "VariantProductBarcode": "",
        "Price": 129.9,
        "Quantity": 3,
        "RawQuantity": 3.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": false,
        "SmUserSchemaId": 0,
        "SchemaName": "",
        "DeliveryTitle": "Mehmet Demir",
        "Address": "Atatürk Cad. No:12 16110 Nilüfer Bursa",
        "District": "Nilüfer",
        "City": "Bursa",
        "PostalCode": "16110",
        "Telephone": "05321234567",
        "CargoCompany": "",
        "CargoLabelCode": "",
        "CargoPayment": "Seller",
        "CargoDate": "1899-12-31T22:03:00Z",
        "ShipmentCampaignCode": "",
        "LastModificationTime": "0001-01-01T00:00:00"
      }
    ]
  }
}

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.

Bu servis hesabınızdaki gerçek verileri değiştirir.

↑ ↓ 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.