API referansı · Siparişler
Kargo bilgisini gönder
Bir sipariş satırının kargo firması ve takip kodunu pazaryerine gönderir ve StockMount'a kaydeder.
https://out.stockmount.com/api/Integration/SetOrderShipmentInformation
Yalnızca şu mağaza tiplerinde iş yapar: N11 (IntegrationId 2), T-Soft (22) ve StockMount (9999). GittiGidiyor (1) kodu hâlâ vardır ancak pazaryeri kapalıdır. Diğer pazaryerlerinde (Trendyol, Hepsiburada vb.) çağrı kargo bilgisi göndermez; Result false ve ErrorCode 60001 döner.
IntegrationId gönderilmezse mağazadan bulunur. Mağazanın pazaryerini bildiğiniz için göndermeniz önerilir.
SendShipmentInformation true olmalıdır; aksi halde 00003 / SendShipmentInformation döner. OrderId ve IntegrationOrderDetailId gönderilmezse OrderDetailId üzerinden bulunur.
ShipmentCompany, pazaryerinin kargo firması kodudur: GetIntegrationShipmentCompanies yanıtındaki Code değeri. N11 için sayısal olmalıdır. T-Soft için T-Soft panelindeki kargo kodu ile karşılaştırılır. StockMount mağazalarında serbest metindir. Kod bulunamazsa 00004 / ShipmentCompany döner.
Satırda zaten kargo takip kodu varsa 60002 / Order item shipment information already exists ! döner; bilgi değiştirilemez.
Başarılı olunca StockMount'ta kargo firması (ShipmentCompany veya kargo firmasının adı, ardından ShipmentBranch), takip kodu ve kargo tarihi (şimdi) kaydedilir. Bu değerler siparişin aynı mağazadaki tüm satırlarına yazılır. Durum güncellenir: N11 ve StockMount için Shipped, T-Soft için 6.
ShipmentCompanyName, ShipmentCompanyId, ShipmentMethod, CampaignNumber, SendPhoneMessage, UserMessage ve SmUser alanları yok sayılır.
İstek alanları
| Alan | Tip | Açıklama |
|---|---|---|
ApiCode
zorunlu
|
string |
DoLogin ile aldığınız API kodu.
|
StoreId
zorunlu
|
integer | Mağaza ID'si. |
IntegrationId
|
integer |
Mağazanın pazaryeri kimliği: N11 2, T-Soft 22, StockMount 9999. Gönderilmezse mağazadan bulunur.
|
OrderDetailId
zorunlu
|
integer | StockMount sipariş satırı ID'si. |
SendShipmentInformation
zorunlu
|
boolean |
true olmalıdır.
|
ShipmentCompany
zorunlu
|
string |
Kargo firması kodu (GetIntegrationShipmentCompanies → Code).
|
ShipmentTrackingCode
zorunlu
|
string | Kargo takip kodu. |
ShipmentBranch
|
string | Kargo şubesi. StockMount'ta firma adının sonuna eklenir. GittiGidiyor için zorunluydu. |
OrderId
|
integer | StockMount sipariş ID'si. Gönderilmezse satırdan bulunur. |
IntegrationOrderDetailId
|
string | Pazaryeri satır ID'si (N11, T-Soft). Gönderilmezse satırdan alınır. |
IntegrationOrderCode
|
string | Pazaryeri sipariş numarası. Yalnızca GittiGidiyor için kullanılırdı. |
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 |
|---|---|
00004 |
ShipmentCompany bu pazaryeri için tanımlı bir kod değil. |
10001 |
StoreId hesabınıza ait bir mağaza değil (ErrorMessage: Invalid store.). |
60001 |
Mağaza N11, T-Soft veya StockMount tipinde değil ya da pazaryeri kargo bilgisini kabul etmedi. |
60002 |
Satırda zaten kargo takip kodu var. |
99999 |
Beklenmeyen hata (ör. N11 için sayısal olmayan ShipmentCompany, IntegrationId gönderilmemesi). |
Oturum hataları (00001, 00006) ve tüm kodlar için hata kodları.
İlgili servisler
Örnek istek
{
"ApiCode": "API_CODE",
"StoreId": 12345,
"IntegrationId": 2,
"OrderDetailId": 9876543,
"SendShipmentInformation": true,
"ShipmentCompany": "344",
"ShipmentTrackingCode": "1234567890123"
}
curl -X POST 'https://out.stockmount.com/api/Integration/SetOrderShipmentInformation' \
-H 'Content-Type: application/json' \
-d '{
"ApiCode": "API_CODE",
"StoreId": 12345,
"IntegrationId": 2,
"OrderDetailId": 9876543,
"SendShipmentInformation": true,
"ShipmentCompany": "344",
"ShipmentTrackingCode": "1234567890123"
}'
using System.Net.Http;
using System.Text;
using var http = new HttpClient();
var json = """
{
"ApiCode": "API_CODE",
"StoreId": 12345,
"IntegrationId": 2,
"OrderDetailId": 9876543,
"SendShipmentInformation": true,
"ShipmentCompany": "344",
"ShipmentTrackingCode": "1234567890123"
}
""";
var response = await http.PostAsync(
"https://out.stockmount.com/api/Integration/SetOrderShipmentInformation",
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",
"StoreId": 12345,
"IntegrationId": 2,
"OrderDetailId": 9876543,
"SendShipmentInformation": true,
"ShipmentCompany": "344",
"ShipmentTrackingCode": "1234567890123"
}
JSON;
$ch = curl_init('https://out.stockmount.com/api/Integration/SetOrderShipmentInformation');
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",
"StoreId": 12345,
"IntegrationId": 2,
"OrderDetailId": 9876543,
"SendShipmentInformation": True,
"ShipmentCompany": "344",
"ShipmentTrackingCode": "1234567890123"
}
response = requests.post("https://out.stockmount.com/api/Integration/SetOrderShipmentInformation", json=payload, timeout=60)
result = response.json()
if not result["Result"]:
print(result["ErrorCode"], result["ErrorMessage"])
const payload = {
"ApiCode": "API_CODE",
"StoreId": 12345,
"IntegrationId": 2,
"OrderDetailId": 9876543,
"SendShipmentInformation": true,
"ShipmentCompany": "344",
"ShipmentTrackingCode": "1234567890123"
};
const response = await fetch("https://out.stockmount.com/api/Integration/SetOrderShipmentInformation", {
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.
Son istekler
Bu sekmeden gönderdiğiniz son istekler; birine tıklayınca gövdesi yeniden yüklenir.