API referansı · Siparişler
Tek siparişi getir
OrderId ile tek bir siparişi tüm satırlarıyla döndürür.
https://out.stockmount.com/api/Integration/GetOrder
Yalnızca OrderId kullanılır. StoreId filtre değildir; sadece Amazon mağazalarında şifre çözme için okunur. Diğer GetSales alanları yok sayılır.
Yanıt GetSales içindeki tek bir sipariş ile aynı yapıdadır, ancak farkları vardır: tüm satırlar durumdan bağımsız döner; OrderStatus siparişin genel durumudur ve her satırda aynı değer görünür (satır durumu için GetOrderDetailStatus kullanın); PersonType, PaymentType ve Country dönmez; LastModificationTime her zaman 0001-01-01T00:00:00 döner; PackageNumber pazaryeri paket numarası yerine SetOrderDetailInvoiced ile yazılan değeri içerir.
Tarih kuralları GetSales ile aynıdır: OrderDate, CargoDate, InvoiceTime, PackageTime, WayBillTime UTC'dir (Z ekli); boş tarihler 1899-12-31T22:03:00Z döner.
Alıcı ve adres alanları sipariş kaydından okunur. GetSales ayrıca güncellenmiş adres kaydını da okur; iki uçta adres farklıysa GetSales değerini esas alın.
Var olmayan bir OrderId için Result false, ErrorCode 99999 döner (ErrorMessage bir .NET hata metnidir). OrderId gönderilmezse 00003 / OrderId döner.
İstek alanları
| Alan | Tip | Açıklama |
|---|---|---|
ApiCode
zorunlu
|
string |
DoLogin ile aldığınız API kodu.
|
OrderId
zorunlu
|
integer |
StockMount sipariş ID'si (GetSales yanıtındaki OrderId).
|
StoreId
|
integer | İsteğe bağlı. Yalnızca Amazon şifre çözme kontrolü için kullanılır; gönderilmezse siparişin mağazası kullanılır. |
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.
|
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.
|
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ı
| Kod | Ne zaman |
|---|---|
50006 |
Sipariş hesabınızdaki bir mağazaya ait değil (ErrorMessage: Order not found.). |
99999 |
Sipariş bulunamadı veya beklenmeyen bir hata oluştu. |
Oturum hataları (00001, 00006) ve tüm kodlar için hata kodları.
İlgili servisler
Örnek istek
{
"ApiCode": "API_CODE",
"OrderId": 4567890
}
curl -X POST 'https://out.stockmount.com/api/Integration/GetOrder' \
-H 'Content-Type: application/json' \
-d '{
"ApiCode": "API_CODE",
"OrderId": 4567890
}'
using System.Net.Http;
using System.Text;
using var http = new HttpClient();
var json = """
{
"ApiCode": "API_CODE",
"OrderId": 4567890
}
""";
var response = await http.PostAsync(
"https://out.stockmount.com/api/Integration/GetOrder",
new StringContent(json, Encoding.UTF8, "application/json"));
var result = await response.Content.ReadAsStringAsync();
// Result == false ise ErrorCode ve ErrorMessage alanlarına bakın.
Console.WriteLine(result);
<?php
$body = <<<'JSON'
{
"ApiCode": "API_CODE",
"OrderId": 4567890
}
JSON;
$ch = curl_init('https://out.stockmount.com/api/Integration/GetOrder');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (!$result['Result']) {
echo $result['ErrorCode'] . ' ' . $result['ErrorMessage'];
}
import requests
payload = {
"ApiCode": "API_CODE",
"OrderId": 4567890
}
response = requests.post("https://out.stockmount.com/api/Integration/GetOrder", json=payload, timeout=60)
result = response.json()
if not result["Result"]:
print(result["ErrorCode"], result["ErrorMessage"])
const payload = {
"ApiCode": "API_CODE",
"OrderId": 4567890
};
const response = await fetch("https://out.stockmount.com/api/Integration/GetOrder", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
const result = await response.json();
if (!result.Result) {
console.error(result.ErrorCode, result.ErrorMessage);
}
Örnek yanıt
{
"Result": true,
"Response": {
"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",
"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",
"Notes": "",
"Member": "",
"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",
"PostalCode": "34710",
"Telephone": "05551112233",
"CargoCompany": "",
"CargoLabelCode": "",
"CargoPayment": "Seller",
"CargoDate": "1899-12-31T22:03:00Z",
"ShipmentCampaignCode": "7330012345678",
"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.
Son istekler
Bu sekmeden gönderdiğiniz son istekler; birine tıklayınca gövdesi yeniden yüklenir.