API referansı · Siparişler

Satırların fatura bilgisini kaydet

Sipariş satırlarını faturalandı/faturalanmadı olarak işaretler; fatura, paket ve irsaliye numarası ile tarihlerini kaydeder.

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

Veri değiştirir

Bilgi yalnızca StockMount'a yazılır; pazaryerine gönderilmez. Fatura linkini pazaryerine iletmek için SetEinvoiceLink kullanın.

Her satır için OrderDetailId ve StoreId gönderin. StoreId yanlış veya eksikse satır sessizce güncellenmez, yine de Result true döner.

Invoiced her çağrıda yazılır; gönderilmezse false kabul edilir ve satır faturalanmadı olarak işaretlenir. Fatura kayıt tarihi her çağrıda şimdiki zamana çekilir.

InvoiceNumber, PackageNumber, WayBillNumber yalnızca dolu gönderilirse güncellenir; boş metin veya gönderilmemesi mevcut değeri korur. Tarih alanları da yalnızca gönderilirse güncellenir. Tarihleri ofsetsiz Türkiye saatiyle gönderin; GetSales bu tarihleri UTC'ye çevirerek döndürür.

Satırlar tek tek işlenir; işlem bütünsel (transaction) değildir. Başka bir kullanıcıya ait satır işlemi durdurur ve 99999 döndürebilir; önceki satırlar güncellenmiş kalır. Başarıda Response boştur.

OrderDetails boşsa 00003 / OrderDetails, bir satırda OrderDetailId < 1 ise 00003 / OrderDetailId döner.

İstek alanları

Alan	Tip	Açıklama
`ApiCode` zorunlu	string	`DoLogin` ile aldığınız API kodu.
`OrderDetails` zorunlu	object[]	Güncellenecek satırlar.
OrderDetails[]. `OrderDetailId` zorunlu	integer	StockMount sipariş satırı ID'si.
OrderDetails[]. `StoreId` zorunlu	integer	Satırın mağaza ID'si. Doğrulanmaz ama yanlışsa satır güncellenmez.
OrderDetails[]. `Invoiced`	boolean	Faturalandı işareti. Varsayılan `false`.
OrderDetails[]. `InvoiceNumber`	string	Fatura numarası. En fazla 64 karakter.
OrderDetails[]. `InvoiceTime`	datetime	Fatura tarihi.
OrderDetails[]. `PackageNumber`	string	Paket numarası. En fazla 64 karakter.
OrderDetails[]. `PackageTime`	datetime	Paket tarihi.
OrderDetails[]. `WayBillNumber`	string	İrsaliye numarası. En fazla 64 karakter.
OrderDetails[]. `WayBillTime`	datetime	İrsaliye tarihi.

Yanıt alanları (Response)

Başarılı çağrıda Response alanı boş döner; sonucu Result alanından okuyun.

Bu servisin hata kodları

Kod	Ne zaman
`99999`	Veritabanı hatası veya başka bir kullanıcıya ait satır.

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

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9876543,
      "StoreId": 12345,
      "Invoiced": true,
      "InvoiceNumber": "ABC2026000000123",
      "InvoiceTime": "2026-11-05T15:00:00"
    }
  ]
}

curl -X POST 'https://out.stockmount.com/api/Integration/SetOrderDetailInvoiced' \
  -H 'Content-Type: application/json' \
  -d '{
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9876543,
      "StoreId": 12345,
      "Invoiced": true,
      "InvoiceNumber": "ABC2026000000123",
      "InvoiceTime": "2026-11-05T15:00:00"
    }
  ]
}'

using System.Net.Http;
using System.Text;

using var http = new HttpClient();
var json = """
{
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9876543,
      "StoreId": 12345,
      "Invoiced": true,
      "InvoiceNumber": "ABC2026000000123",
      "InvoiceTime": "2026-11-05T15:00:00"
    }
  ]
}
""";

var response = await http.PostAsync(
    "https://out.stockmount.com/api/Integration/SetOrderDetailInvoiced",
    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",
  "OrderDetails": [
    {
      "OrderDetailId": 9876543,
      "StoreId": 12345,
      "Invoiced": true,
      "InvoiceNumber": "ABC2026000000123",
      "InvoiceTime": "2026-11-05T15:00:00"
    }
  ]
}
JSON;

$ch = curl_init('https://out.stockmount.com/api/Integration/SetOrderDetailInvoiced');
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",
    "OrderDetails": [
        {
            "OrderDetailId": 9876543,
            "StoreId": 12345,
            "Invoiced": True,
            "InvoiceNumber": "ABC2026000000123",
            "InvoiceTime": "2026-11-05T15:00:00"
        }
    ]
}

response = requests.post("https://out.stockmount.com/api/Integration/SetOrderDetailInvoiced", json=payload, timeout=60)
result = response.json()

if not result["Result"]:
    print(result["ErrorCode"], result["ErrorMessage"])

const payload = {
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9876543,
      "StoreId": 12345,
      "Invoiced": true,
      "InvoiceNumber": "ABC2026000000123",
      "InvoiceTime": "2026-11-05T15:00:00"
    }
  ]
};

const response = await fetch("https://out.stockmount.com/api/Integration/SetOrderDetailInvoiced", {
  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
}

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.

Gövde (JSON)

{
  "ApiCode": "{{apiCode}}",
  "OrderDetails": [
    {
      "OrderDetailId": 9876543,
      "StoreId": 12345,
      "Invoiced": true,
      "InvoiceNumber": "ABC2026000000123",
      "InvoiceTime": "2026-11-05T15:00:00"
    }
  ]
}

Bu isteğin hesabımdaki gerçek verileri değiştireceğini biliyorum.