Başlangıç

Hata kodları

İş kuralı hataları HTTP 200 ile döner: Result alanı false olur, ErrorCode ve ErrorMessage doldurulur. Kararı her zaman ErrorCode üzerinden verin; ErrorMessage metni değişebilir ve dili servise göre farklıdır.

HTTP durum kodları

HTTP	Anlamı
`200`	İstek işlendi. Başarılı olup olmadığını Result alanından okuyun.
`400`	Gövde boş ya da geçerli bir JSON değil. Yanıt ResultInfo değil, standart ProblemDetails biçimindedir.
`404`	Adres yanlış. Controller ve Action adlarını kontrol edin.
`410`	Servis kaldırıldı. Servis sayfasında yerine kullanılacak servis yazar.
`5xx`	Geçici sunucu hatası. Bir süre bekleyip tekrar deneyin.

Hata kodları

Kod	Anlamı	Ne yapmalı
`00001`NotAuthenticated	Kimlik doğrulanamadı. `ApiCode` çözülemedi veya oturum süresi doldu; `DoLogin` için hatalı kimlik bilgisi, pasif hesap ya da pasif API anahtarı.	`DoLogin` ile yeni bir `ApiCode` alıp isteği tekrarlayın. `DoLogin` de `00001` dönüyorsa kimlik bilgilerinizi ve paneldeki hesap/API anahtarı durumunu kontrol edin.
`00002`AccountPassive	Hesap pasif durumda.	Hesabınızın durumunu panelden kontrol edin veya destek ekibine başvurun.
`00003`MissingParameter	Zorunlu bir alan eksik veya geçersiz (ör. 0 ya da boş). `ErrorMessage` çoğunlukla eksik alanın adını içerir.	`ErrorMessage` alanındaki parametreyi ekleyip isteği tekrarlayın. `ErrorMessage` `ApiCode` ise önce `DoLogin` çağırın.
`00004`RequiredField	Bir alanın değeri kabul edilmedi; ör. kargo firması kodu pazaryerinin listesinde yok.	`ErrorMessage` alanını kontrol edin. Kargo kodları için `GetIntegrationShipmentCompanies` listesini kullanın.
`00005`BadReqeust	İstek işlenemedi ("Bad request!").	İstek gövdesini ve alan değerlerini kontrol edip tekrar deneyin.
`00006`SessionTimedOut	`ApiCode` geçerli bir oturum bilgisi içermiyor (eksik veya bozuk kod).	`DoLogin` ile yeni bir `ApiCode` alın ve değeri değiştirmeden gönderin.
`00007`TooManyRequests	Dakika başına istek sınırı aşıldı (kullanıcı başına ya da IP başına DoLogin).	Bir dakika bekleyip tekrar deneyin. İstekleri sıraya alın; `DoLogin`'i her istekten önce değil, yalnızca `00001`/`00006` aldığınızda çağırın.
`10001`InvalidStore	Mağaza geçersiz: bulunamadı, hesabınıza ait değil veya bu işlem için uygun değil.	`StoreId` değerini `GetStores` ile doğrulayın.
`20001`UserWasNotFound	Kullanıcı bulunamadı.	Hesap bilgilerinizi kontrol edin.
`50001`SetOrder	Sipariş kaydedilemedi.	Gönderdiğiniz veriyi kontrol edip tekrar deneyin. Sorun sürerse `ErrorMessage` ile birlikte destek ekibine başvurun.
`50002`SetOrderBuyer	Siparişin alıcı bilgileri kaydedilemedi.	Alıcı alanlarını kontrol edip tekrar deneyin.
`50003`SetOrderDetail	Sipariş satırı kaydedilemedi.	Sipariş satırı alanlarını kontrol edip tekrar deneyin.
`50004`DeleteOrderDetail	Sipariş satırı silinemedi.	Gönderdiğiniz veriyi kontrol edip tekrar deneyin. Sorun sürerse `ErrorMessage` ile birlikte destek ekibine başvurun.
`50005`OrderExist	Sipariş zaten kayıtlı. `SetOrder` bu durumda `Response` alanında mevcut siparişi döndürür.	Siparişi tekrar oluşturmayın; `Response` içindeki kaydı kullanın.
`50006`OrderNotExisted	Sipariş bulunamadı.	Sipariş kimliğini kontrol edin.
`50007`SetOrderListingStatus	Sipariş durumu güncellenemedi.	Durum kodunu `GetIntegrationOrderListingStatus` ile doğrulayıp tekrar deneyin.
`60001`IntegrationError	Pazaryeri veya platform işlemi reddetti ya da hata döndü. Ayrıntı `ErrorMessage` içindedir.	`ErrorMessage` içindeki pazaryeri hatasını giderin. Geçici bir hataysa daha sonra tekrar deneyin.
`60002`SaleItemWasShippedBefore	Sipariş satırı daha önce kargoya verilmiş.	Kargo bilgisini tekrar göndermeyin.
`60003`IntegrationSettingNotFound	Mağazanın entegrasyon ayarları (pazaryeri API bilgileri) bulunamadı.	Panelde mağazanın entegrasyon ayarlarını tamamlayın.
`60004`IntegrationOrderCanNotBeRetrieved	Sipariş pazaryerinden alınamadı.	Daha sonra tekrar deneyin. Sorun sürerse sipariş numarasını kontrol edin.
`60005`ProductQuantityIsLessThanMinQuantity	Ürün stoğu, gönderim için tanımlı en düşük miktarın altında.	Stoğu veya en düşük miktar ayarını güncelleyin.
`60006`ListingTempalteWasNotFound	Ürün için ilan şablonu bulunamadı.	Panelde mağaza için ilan şablonu tanımlayın.
`60007`CategoryMappingWasNotFound	Ürünün kategorisi pazaryeri kategorisiyle eşleştirilmemiş.	Panelde kategori eşleştirmesini yapın.
`60008`ProductPriceIsEqualToZero	Ürün fiyatı sıfır.	Ürüne sıfırdan büyük bir fiyat girin.
`60009`ProductPriceLessThanMinPrice	Ürün fiyatı tanımlı en düşük fiyatın altında.	Fiyatı veya en düşük fiyat ayarını güncelleyin.
`60010`ProductHasNoImage	Ürünün görseli yok.	Ürüne en az bir görsel ekleyin.
`60011`ProductDeleted	Ürün silinmiş.	Silinmiş ürün için işlem yapmayın veya ürünü yeniden ekleyin.
`60012`LanguageWasNotFoundForSchema	Ürün kaynağı için dil tanımı bulunamadı.	Panelde ürün kaynağının dil ayarını yapın.
`60013`ProductCouldNotBePrepared	Ürün pazaryerine gönderilmek üzere hazırlanamadı.	Ürün verisini veya panel eşleştirmelerini düzeltip ürünü tekrar gönderin.
`60014`ProductVariantMappingWasNotFound	Ürün varyantları pazaryeri varyantlarıyla eşleştirilmemiş.	Panelde varyant eşleştirmesini yapın.
`60015`ProductMarketPriceLessThanPrice	Ürünün piyasa (liste) fiyatı satış fiyatından düşük.	Piyasa fiyatını satış fiyatına eşit veya ondan yüksek yapın.
`60016`ProductMarketStoreCodeInvalid	Ürünün pazaryeri mağaza kodu geçersiz.	Ürün verisini veya panel eşleştirmelerini düzeltip ürünü tekrar gönderin.
`60017`BrandMappingNotFound	Ürünün markası pazaryeri markasıyla eşleştirilmemiş.	Panelde marka eşleştirmesini yapın.
`60101`IntegrationCategorySynchronization	Pazaryeri kategorileri senkronize edilirken hata oluştu.	Daha sonra tekrar deneyin.
`60501`ProductSourceUrlInvalid	Ürün kaynağı adresi (URL) geçersiz veya erişilemiyor.	Adresi ve erişim izinlerini kontrol edin.
`60502`FtpDirectoryCouldNotBeCreated	Ürün kaynağı dosyası için sunucuda klasör oluşturulamadı.	Daha sonra tekrar deneyin; sürerse destek ekibine başvurun.
`60503`FtpFileCanNotBeUploded	Ürün kaynağı dosyası sunucuya yüklenemedi.	Daha sonra tekrar deneyin; sürerse destek ekibine başvurun.
`70001`InvalidTaxRate	KDV oranı geçersiz.	Geçerli bir KDV oranı gönderin.
`70002`InvalidProductSource	Ürün kaynağı geçersiz veya bulunamadı.	Ürün kaynağı kimliğini kontrol edin.
`70003`InvalidProductSourceType	Ürün kaynağının tipi bu işlem için uygun değil.	StockMount tipinde bir ürün kaynağı kullanın.
`70004`InsertedProductCodeExists	Aynı ürün koduyla başka bir ürün var.	Farklı bir ürün kodu kullanın veya mevcut ürünü güncelleyin.
`70005`ProductWasNotFound	Ürün bulunamadı.	Ürün kimliğini veya kodunu kontrol edin.
`70006`BrandNameRequired	Marka adı zorunlu.	Ürüne marka adı ekleyin.
`70007`BarcodeRequired	Barkod zorunlu.	Ürüne barkod ekleyin.
`70008`ProductWasAddedBefore	Ürün daha önce eklenmiş veya pazaryerinde zaten listelenmiş.	Ürünü tekrar eklemek yerine mevcut kaydı güncelleyin.
`70009`InvalidProductCodeLength	Ürün kodu çok uzun (en fazla 50 karakter).	Ürün kodunu 50 karakter veya daha kısa yapın.
`70010`InvalidBarcode	Barkod geçersiz.	Geçerli bir barkod gönderin.
`70011`InvalidProductType	Ürün tipi geçersiz.	Geçerli bir ürün tipi gönderin.
`70012`BarcodeContainsSpecialChar	Barkod, pazaryerinin kabul etmediği özel karakterler içeriyor.	Barkoddan özel karakterleri kaldırın.
`70013`ProductWasNotChanged	Son gönderimden bu yana ürün değişmediği için pazaryerine tekrar gönderilmedi.	İşlem gerekmez.
`70014`ProductInProgress	Ürün pazaryerinde işleniyor.	Bir süre sonra durumu tekrar kontrol edin.
`70015`InvalidImageFormatWebp	Ürün görseli .webp formatında; pazaryeri bu formatı kabul etmiyor.	Görseli JPG veya PNG gibi desteklenen bir formatta gönderin.
`70016`InvalidImageUrlProtocol	Ürün görseli adresi `http://` veya `https://` ile başlamıyor.	Görsel adreslerini tam URL olarak gönderin.
`70017`InCatalogApproval	Ürün N11 katalog onay sürecinde.	Onay sonucunu bekleyin.
`70018`ProductPackageRequired	Ürün işlemleri için aktif Ürün Paketi gerekir ("Ürün entegrasyonu için aktif Ürün Paketi gereklidir."). Paket bilgisi doğrulanamazsa bunun yerine `99999` döner ("Paket bilgisi doğrulanamadı. Lütfen tekrar deneyin.").	Panelden Ürün Paketi satın alın veya paketinizi yenileyin.
`89001`InsertError	Kayıt eklenemedi.	Gönderdiğiniz veriyi kontrol edip tekrar deneyin. Sorun sürerse `ErrorMessage` ile birlikte destek ekibine başvurun.
`89002`UpdateError	Kayıt güncellenemedi.	Gönderdiğiniz veriyi kontrol edip tekrar deneyin. Sorun sürerse `ErrorMessage` ile birlikte destek ekibine başvurun.
`89003`DeleteError	Kayıt silinemedi.	Gönderdiğiniz veriyi kontrol edip tekrar deneyin. Sorun sürerse `ErrorMessage` ile birlikte destek ekibine başvurun.
`89004`InsertUpdateError	Kayıt eklenemedi veya güncellenemedi.	Gönderdiğiniz veriyi kontrol edip tekrar deneyin. Sorun sürerse `ErrorMessage` ile birlikte destek ekibine başvurun.
`99988`PackageValidation	`DoLogin`: hesapta API erişimi veren geçerli bir paket veya Out API hizmeti yok ya da paket bilgisi okunamadı. `ErrorMessage` "Package can not be validated! ..." ile başlar.	Panelden paketinizi veya API hizmetinizi kontrol edin; gerekirse satın alın ya da yenileyin. Mesaj "Type: 3" ise daha sonra tekrar deneyin.
`99999`Exception	Beklenmeyen bir sunucu hatası oluştu. `ErrorMessage` boş olabilir veya teknik hata metni içerebilir.	Kısa bir süre sonra tekrar deneyin. Veri değiştiren isteklerde tekrar denemeden önce işlemin uygulanıp uygulanmadığını kontrol edin. Sorun sürerse `ErrorMessage` ile destek ekibine başvurun.