Satır durumunu değiştir

StockMount tipi mağazalardaki sipariş satırlarının durumunu toplu olarak günceller.

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

Veri değiştirir

Yalnızca StockMount tipi mağazalarda (IntegrationId 9999) çalışır ve pazaryerine bir şey göndermez. Pazaryeri mağazalarının satırları için hata döner.

Satırlar tek tek işlenir. Response her satır için bir sonuç listesidir: Result, ErrorCode, ErrorMessage ve satırın OrderDetailId değerini taşıyan Response. Üst düzey Result yalnızca tüm satırlar başarılıysa true olur; kısmi hatada üst düzey ErrorCode boştur, ayrıntı için listeye bakın.

OrderStatus değeri doğrulanmaz (en fazla 50 karakter). Tutarlılık için StockMount durum kodlarını kullanın. Durum değişirse satırın LastModificationTime değeri güncellenir; bu sayede değişiklikler GetSales + LastModificationTimeFrom ile izlenebilir.

Yalnızca satır durumu değişir; siparişin genel durumu değişmez. Bu nedenle GetOrder eski genel durumu göstermeye devam eder; GetSales ve GetOrderDetailStatus satır durumunu gösterir.

İ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 (StockMount tipi mağaza).
OrderDetails[]. `OrderStatus` zorunlu	string	Yeni durum kodu. `New` Yeni. `Approved` Onaylandı. `Rejected` Reddedildi. `Shipped` Kargoya verildi. `Delivered` Teslim edildi. `Completed` Tamamlandı.

Yanıt alanları (Response)

Alan	Tip	Açıklama
`Result`	boolean	Bu satır güncellendiyse `true`.
`ErrorCode`	string	Satır hatası kodu: doğrulama/mağaza hatalarında `00003`, diğerlerinde `99999`.
`ErrorMessage`	string	Satır hatası: `OrderDetail.StoreId`, `OrderDetail.OrderDetailId`, `OrderDetail.OrderStatus`, `InvalidStore`, `Store has to be StockMount store!` veya satır bulunamadıysa `NotExisted`. Satır başka bir kullanıcıya aitse boş.
`Response`	integer	İstekteki `OrderDetailId`.

Bu servisin hata kodları

Kod	Ne zaman
`99999`	Beklenmeyen hata (tüm istek). Satır bazlı hatalar `Response` listesindedir.

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

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9877001,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    },
    {
      "OrderDetailId": 9877002,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    }
  ]
}

curl -X POST 'https://out.stockmount.com/api/Integration/SetOrderDetailStatus' \
  -H 'Content-Type: application/json' \
  -d '{
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9877001,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    },
    {
      "OrderDetailId": 9877002,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    }
  ]
}'

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

using var http = new HttpClient();
var json = """
{
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9877001,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    },
    {
      "OrderDetailId": 9877002,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    }
  ]
}
""";

var response = await http.PostAsync(
    "https://out.stockmount.com/api/Integration/SetOrderDetailStatus",
    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": 9877001,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    },
    {
      "OrderDetailId": 9877002,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    }
  ]
}
JSON;

$ch = curl_init('https://out.stockmount.com/api/Integration/SetOrderDetailStatus');
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": 9877001,
            "StoreId": 67890,
            "OrderStatus": "Shipped"
        },
        {
            "OrderDetailId": 9877002,
            "StoreId": 67890,
            "OrderStatus": "Shipped"
        }
    ]
}

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

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

const payload = {
  "ApiCode": "API_CODE",
  "OrderDetails": [
    {
      "OrderDetailId": 9877001,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    },
    {
      "OrderDetailId": 9877002,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    }
  ]
};

const response = await fetch("https://out.stockmount.com/api/Integration/SetOrderDetailStatus", {
  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": false,
  "Response": [
    {
      "Result": true,
      "Response": 9877001
    },
    {
      "Result": false,
      "ErrorCode": "99999",
      "ErrorMessage": "NotExisted",
      "Response": 9877002
    }
  ]
}

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": 9877001,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    },
    {
      "OrderDetailId": 9877002,
      "StoreId": 67890,
      "OrderStatus": "Shipped"
    }
  ]
}

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