API Hata Mesajları ve Açıklamaları

 

RestAPI Ürün Hata Mesajları

 

İşlem Hata Mesajı Çözüm
Ürün Yükleme Girdiğiniz X seller stock code tarafınızdan kullanılmaktadır. Başka bir seller stock code ile kayıt oluşturabilirsiniz. Satıcı stok kodu kontrol edilmelidir. Gönderilen stok kodu n11 mağazasında yer almaktadır. 
Ürün Yükleme Girdiğiniz X nolu katalog id X mağaza ürün kodu ve X seller stock kodu ile ürün listenizde mevcuttur. Gönderilen ürün içeride mevcut bir ürün ile çakışmaktadır, ürün bazlı çakışan alanlar revize edilerek tekrar gönderim sağlanabilir.
Ürün Yükleme Marka ve Kategori id değerlerini doğru girdiğinizi kontrol edin. Doğru girilmişse, ürününüzün kaydedilebilmesi için daha fazla ayrıntı vermelisiniz. Ürün adı örneği gerekli ise Search API ile ürün arama yapabilirsiniz Ürün başlık karakteri az girilmiş olabilir, kategorinize uygun başlıkta gönderim sağlayabilirsiniz ya da ürün başlık alanı n11 katalogu ile eşleşiyor olabilir bu durumda ürün başlığını farklılaştırmak için sonuna kod ekleyebilirsiniz.
Ürün Yükleme Kataloğa ürün önerme başarısız oldu. Katalog mesaj Girdiğiniz ürün bilgisi ürün grubu bilgisiyle uyumlu değil. Gönderilen ürün n11 kataloğunda farklı bir kategoride ya da doğru kategori ile farklı bir markayla gönderildiğinde bu hata alınmaktadır.
Ürün Yükleme
  • Üzgünüz, seçtiğiniz kategoriye ürün yükleyemezsiniz. Bu kategoride ürün yükleyebilmek için tedarik faturalarınız ile birlikte https://magazadestek.n11.com/talepler linkinden talep açmanız durumunda destek sağlanacaktır.
  • Üzgünüz, seçtiğiniz kategoriye girmiş olduğunuz marka ile ürün yükleyemezsiniz. Bu markada ürün yükleyebilmek için tedarik faturalarınız ile birlikte https://magazadestek.n11.com/talepler linkinden talep açmanız durumunda destek sağlanacaktır.

 

Ürün orijinallik kontrolü kaynaklı bu hata mesajı dönmektedir, tedarik faturası ile talep oluşturmalısınız.
Ürün Yükleme Marka bilgisi girilmelidir. Gönderilen ürün yükleme isteğinde marka özellik değeri yer almadığından bu hata mesajı dönmektedir.
Ürün Yükleme marka özellik değeri boş geçilemez. Marka özellik değeri boş (null) değer gönderilmemelidir.
Ürün Yükleme X idli marka özellik değeri {categoryName}[{categoryId}] kategorisinde bulunmamaktadır. Gönderilen marka değeri ilgili kategoride yer almadığından bu hata mesajı alınmaktadır, bu kategorilerde markanızın oluşması için isteğinizde marka özelliğini serbest giriş şeklinde göndermelisiniz.
Ürün Yükleme X idli {attributeName} özellik değeri {categoryName}[{categoryId}] kategorisinde bulunmamaktadır.

Belirtilen özellik değeri Id'si geçersiz ya da ilgili kategoride aynı değer yer almamaktadır, güncel kategori özellik listesi çekilerek tekrar eşleştirme yapılıp güncel değerler ile gönderim sağlanmalıdır.
Ürün Yükleme {attributeId} ID’li {attributeName} özellik alanı boş olamaz. Örneğin X özellik zorunlu alan olduğu için uyarı verir. Zorunlu alanlar eşleştirme yapılmalıdır.
Ürün Yükleme İlk görsel boş olamaz Görsel linklerinin gönderildiği alanda null değer kabul edilmemektedir.
Ürün Yükleme Kataloğa ürün önerme başarısız oldu. Katalog mesaj All Images are invalid Gönderilen görsel linkleri geçersizdir, link erişimini ve görsel tipini kontrol etmelisiniz.
Ürün Yükleme vatRate alanı boş olamaz. KDV oranı alanı zorunlu beklenmektedir, bu alan eksik olduğunda bu hata mesajı dönmektedir.
Ürün Yükleme X stockCode maxPurchaseQuantity 1 değerinden büyük yada eşit olmalı Maksimum satın alım limiti olmayacaksa parametre gönderilmemelidir, 0 gönderildiğinde ilgili hata mesajı dönmektedir.
Ürün Yükleme X stockCode vatRate VatRate 0,1,10,20 değerlerinden biri olmak zorundadır. Girilen KDV oranı değeri geçerli değerlerin dışında gönderilmiştir.
Ürün Yükleme Ürün ekleme isteğinizde 15 karakter altında ürün adları tespit edilmiştir. Bu değerler için işlem sağlanamamaktadır. Ürün adı minimum 15 karakter olmalıdır, daha kısa ürün başlıklarınız var ise revize edip tekrar gönderim sağlayabilirsiniz.
Ürün Yükleme catalogId alanı geçersizdir. Gönderilen n11 katalog Id değeri hatalıdır, ürünün doğru katalog Id değeri gönderim sağlanmalıdır.
Ürün Yükleme Girilen catalogId katalog tarafından reddedildi. Farklı bir catalogId giriniz veya catalogId olmadan öneri yapınız. Gönderilen n11 katalog Id ile kayıtlı katalog ürünü onaylanmamıştır, onaylanmış olan katalog Id değeri gönderim sağlanmalıdır.
Ürün Yükleme shipmentTemplate alanı geçersizdir. Teslimat şablonu hatalı gönderildiğinde bu hata mesajı dönmektedir. n11 satıcı panelinizde yer alan teslimat şablonunu seçmelisiniz.
Ürün Yükleme X stockCode shipmentTemplate boş değer olamaz. Teslimat şablonu alanı gönderimi zorunludur.
Ürün Yükleme
  • X stockCode preparingDay 1 değerinden büyük yada eşit olmalı.
  • X stockCode preparingDay 30 değerinden küçük yada eşit olmalı
 Kargo gönderim süresi 1 ve 30 aralığında seçilebilmektedir, 1'den düşük ya da 30'dan fazla kabul edilmemektedir.
Ürün Yükleme

X id li kategorideki Y id li özellik için sadece valueId ile ürün girişi yapılabilir. GetCategoryAttributeValue metodu üzerinden valueId bilgilerine ulaşabilirsiniz.

Bu özellik serbest girişe kapalıdır, n11 kategorisinde yer alan özellikleri göndermeniz gerekmektedir ( iscustomValue:False olan özelliklerde valueId gönderilmelidir, GetCategoryAttribute servislerinden güncel değerleri çekip gönderilmelidir ).
Ürün Yükleme Kataloğa ürün önerme başarısız oldu. Katalog mesaj Ürün Adı alanında X sözcükleri kullanılamaz. Yasaklı kelime kontrolü, ürün başlığında belirtilen yasaklı kelime yer almamalıdır.
Ürün Yükleme Bu kelimeler yasaklıdır. Kelimeler : X Yasaklı kelime kontrolü, ürün açıklamasında belirtilen yasaklı kelime almamalıdır.
Ürün Yükleme category alanı geçersizdir Ürün eğer daha önce canlıda olan fakat şuan kapatılan bir category ile eşleştirildiyse ya da geçersiz bir id değeri gönderildiyse bu hata alınmaktadır. Bu durumda kategori eşleştirmesini tekrar yapmalısınız.
Ürün Yükleme Önerdiğiniz kategori ürün ile uyumlu değildir, ürününüzü {categoryId} idli {categoryName} kategorisinde önerebilirsiniz. Ürünü hata mesajında belirtilen kategoride önermelisiniz.
Ürün Yükleme description alanı boş olamaz. Ürün açıklama alanı boş olduğunda bu hata alınmaktadır, ürün açıklamasını kontrol etmelisiniz.
Ürün Yükleme description alanı geçersizdir. Açıklama alanında fazla sayıda açık HTML tag vb. bulunmaktadır, düzenleme yaparak tekrar gönderim sağlanmalıdır.
Ürün Yükleme Teslimat tipini Diğer seçiniz. Dijital kod gönderimi sağlanıyor ise satıcı panelinden kargo şablonunda Teslimat Metodu : Diğer seçilmelidir.
Ürün Yükleme {stockCode}, catalogId, barcode veya images ve attributes aynı anda boş olamaz. Belirtilen stok kodu için barkod ya da katalog id değeri gönderilmiyor ise, kataloğa ürün önerisi için ürün özellikleri ve ürün görselleri gönderilmelidir.
Ürün Yükleme Bu ürün için girdiğiniz fiyatta fahiş fiyat düşüklüğü olduğundan dolayı fiyat hatası riski içermektedir (Minimum X TL). Lütfen fiyatı kontrol ediniz. Dilerseniz mağaza destek merkezinden talep oluşturabilirsiniz. Bu hata mesajı satıcılara düşük fiyatla ürün yüklememeleri için yükleme engellendiğinden dolayı dönmektedir. Belirtilen minimum fiyattan daha düşük fiyat gönderilemez.
Ürün Yükleme Bu ürün için girdiğiniz fiyatta fahiş fiyat artışı olduğundan dolayı fiyat hatası riski içermektedir (Maximum X TL). Lütfen fiyatı kontrol ediniz. Dilerseniz mağaza destek merkezinden talep oluşturabilirsiniz. Bu hata mesajı satıcılara hatalı/yüksek fiyatla ürün yüklememeleri için yükleme engellendiğinden dolayı dönmektedir. Belirtilen maksimum fiyattan daha yüksek fiyat gönderilemez.
Ürün Yükleme X stok kodlu üründe listPrice salePrice dan küçük olamaz. Liste fiyatı, satış fiyatından küçük olamaz. Ürünlerinizde indirimli fiyat mevcut ise üzeri çizili fiyat (Liste fiyatı) daha yüksek olmalıdır.
Ürün Yükleme X, ..., Y stok kodlu ürünlerinizde aynı attributes kullanılmıştır. attributes : {title}[attributeId-value] Ürün oluşturma isteğinde ürün başlığı ve özellikleri aynı olan birden fazla ürün mevcuttur, mükerrer ürün kaydı oluşturulamaz.
Ürün Yükleme X, ..., Y stok kodlu ürünlerinizde aynı barcode kullanılmıştır. barcode : {barcode} Ürün oluşturma isteğinde mükerrer barkod değeri kullanılmıştır, tekil gönderilmelidir.
Ürün Yükleme X, ..., Y stok kodlu ürünlerinizde aynı catalogId kullanılmıştır. catalogId : {catalogId} Ürün oluşturma isteğinde mükerrer katalog Id değeri kullanılmıştır, tekil gönderilmelidir.
Ürün Yükleme Farklı ürünlerinizde aynı Stok Kodu kullanılmıştır. Stok Kodu : X Ürün oluşturma isteğinde mükerrer stok kodu kullanılmıştır, tekil gönderilmelidir.
Ürün Yükleme {categoryId} id li {categoryName} kategorisinde mainId girişi zorunludur. Slicer True olan kategorilerde mainId girilmesi gerekmektedir. Model Kodu alanı zorunlu olan kategorilerde model kodu gönderilmezse bu mesaj dönmektedir.
Ürün Yükleme / Ürün Güncelleme X stok kodlu üründe listPrice alanında virgülden sonrası 2 haneden fazla tanımlanmıştır. Liste fiyatı alanında küsürat 2 haneden uzun olamaz.
Ürün Yükleme / Ürün Güncelleme X stok kodlu üründe salePrice alanında virgülden sonrası 2 haneden fazla tanımlanmıştır. Satış fiyatı alanında küsürat 2 haneden uzun olamaz.
Ürün Güncelleme Girilen X SellerStockCode ile mağazanızda ürün bulunamamaktadır. Hata mesajında yer alan stok kodlu ürün mağazanızda olmayıp güncelleme gönderildiğinde alınan bir hatadır. İlgili satıcı stok kodlu ürünü n11'e yükledikten sonra güncelleme yapabilirsiniz.
Ürün Güncelleme Ürünü yalnızca onaylı ve beklemede statülerini seçerek güncelleyebilirsiniz. Ürün onay durumu "Onaylı" ya da "Beklemede" statüsü haricindeyken güncelleme yapılamamaktadır. Ürün aktarım sonucu, ürün "Katalog Onay Sürecinde" statüsündeyken ürün güncelleme isteği gönderildiğinde bu hata mesajı dönecektir.
Ürün Güncelleme Ürün, katalog tarafından reddedildi. Satıcı panelinden red nedenini kontrol edip ürünü yeniden onaya gönderebilirsiniz. Ürün katalogtan reddedildiğinde bu hata alınmaktadır. Reddedilen ürünler satıcı panelden silinip ret nedenine göre düzenlenip tekrar gönderilmelidir.

 

RestAPI Sipariş Servis Bilgilendirmeleri

 

  • RestAPI sipariş statüleri tablonun sağ tarafındaki sütunda yer almaktadır. Eski statülere göre mapleme yapabilirsiniz.

 

Sipariş maddesi durum bilgisi
1:İşlem Bekliyor Verdiğimiz bir değer değildir.
2:Ödendi Created
3:Geçersiz Verdiğimiz bir değer değildir.
4:İptal Edilmiş Canceled
5:Kabul Edilmiş Picking
6:Kargoda Shipped
7:Teslim Edilmiş Delivered
8:Reddedilmiş UnSupplied
9:İade Edildi Delivered
10:Tamamlandı Delivered
11: İade İptal Değişim Talep Edildi Delivered
12: İade İptal Değişim Tamamlandı Delivered
13:Kargoda İade Shipped
14:Kargo Yapılması Gecikmiş Created
15:Kabul Edilmiş Ama Zamanında Kargoya Verilmemiş Picking
16:Teslim Edilmiş İade, Delivered
17:Ödeme Ertelendi Delivered
51: İptal Talep Edildi Picking
52: İade Talep Edildi(sipariş tamamlanması sonrası) Delivered
53: Değişim Talep Edildi(sipariş tamamlanması sonrası) Delivered
  • SOAP API DetailedOrderList ve RestAPI GetShipmentPackages parametre karşılıkları aşağıdaki tabloda yer almaktadır.

* ile belirtilen parametreler RestAPI sipariş listeleme servisinde yer almamaktadır.

 

SOAP API Rest API
orderList.order.billingAddress.address billingAddress.address
orderList.order.billingAddress.city billingAddress.city
orderList.order.billingAddress.district billingAddress.district
orderList.order.billingAddress.fullName billingAddress.fullName
orderList.order.billingAddress.gsm billingAddress.gsm
orderList.order.billingAddress.neighborhood billingAddress.neighborhood
orderList.order.billingAddress.postalCode billingAddress.postalCode
orderList.order.billingAddress.taxHouse billingAddress.taxHouse
orderList.order.billingAddress.taxId billingAddress.taxId
orderList.order.billingAddress.tcId billingAddress.tcId
orderList.order.buyer.email customerEmail
orderList.order.buyer. fullName customerfullName
orderList.order.buyer.id customerId
orderList.order.buyer.taxId taxId
orderList.order.buyer.taxOffice taxOffice
orderList.order.buyer.tcId tcIdentityNumber
orderList.order.citizenshipId *
orderList.order.createDate

packageHistories.createdDate = 1731312671000

packageHistories.status = Created
orderList.order.id *
orderList.order.invoiceType billingAddress.invoiceType
orderList.order.orderItemList.orderItem.approvedDate

packageHistories.createdDate = 1731312671000

packageHistories.status = Picking
orderList.order.orderItemList.orderItem.attributes lines.variantAttributes
orderList.order.orderItemList.orderItem.bundle *
orderList.order.orderItemList.orderItem.commission *
orderList.order.orderItemList.orderItem.customTextOptionValues lines.customTextOptionValues
orderList.order.orderItemList.orderItem.deliveryFeeType *
orderList.order.orderItemList.orderItem.dueAmount lines.dueAmount
orderList.order.orderItemList.orderItem.id lines.orderLineId
orderList.order.orderItemList.orderItem.installmentChargeWithVAT lines.installmentChargeWithVAT
orderList.order.orderItemList.orderItem.mallDiscount lines.mallDiscount
orderList.order.orderItemList.orderItem.price lines.price
orderList.order.orderItemList.orderItem.productId lines.productId
orderList.order.orderItemList.orderItem.productName lines.productName
orderList.order.orderItemList.orderItem.productSellerCode *
orderList.order.orderItemList.orderItem.quantity lines.quantity
orderList.order.orderItemList.orderItem.sellerCouponDiscount lines.sellerCouponDiscount
orderList.order.orderItemList.orderItem.sellerDiscount lines.sellerDiscount
orderList.order.orderItemList.orderItem.sellerInvoiceAmount lines.sellerInvoiceAmount
orderList.order.orderItemList.orderItem.sellerStockCode lines.stockCode
orderList.order.orderItemList.orderItem.shipmenCompanyCampaignNumber cargoTrackingNumber
orderList.order.orderItemList.orderItem.shipmentInfo.campaignNumber cargoTrackingNumber
orderList.order.orderItemList.orderItem.shipmentInfo.campaignNumberStatus *
orderList.order.orderItemList.orderItem.shipmentInfo.shipmentCode *
orderList.order.orderItemList.orderItem.shipmentInfo.shipmentCompany.id shipmentCompanyId
orderList.order.orderItemList.orderItem.shipmentInfo.shipmentCompany.name cargoProviderName
orderList.order.orderItemList.orderItem.shipmentInfo.shipmentCompany.shortName *
orderList.order.orderItemList.orderItem.shipmentInfo.shipmentMethod shipmentMethod
orderList.order.orderItemList.orderItem.shipmentInfo.shippingDate

packageHistories.createdDate = 1731312671000

packageHistories.status = Shipped
orderList.order.orderItemList.orderItem.shipmentInfo.sppApproved *
orderList.order.orderItemList.orderItem.status lines.orderItemLineItemStatusName ( Sipariş statü tablosunda eşleşen değerler mevcut )
orderList.order.orderItemList.orderItem.stockKeepingUnitId *
orderList.order.orderItemList.orderItem.totalMallDiscountPrice lines.totalMallDiscountPrice
orderList.order.orderItemList.orderItem.updatedDate lastModifiedDate
orderList.order.orderItemList.orderItem.version *
orderList.order.orderNumber orderNumber
orderList.order.paymentType *
orderList.order.serviceItemList.serviceItem.intallmentChargeWithVAT *
orderList.order.serviceItemList.serviceItem.orderItemList.orderItem *
orderList.order.serviceItemList.serviceItem.orderItemType *
orderList.order.serviceItemList.serviceItem.price *
orderList.order.serviceItemList.serviceItem.quantity *
orderList.order.serviceItemList.serviceItem.sellerInvoiceAmount *
orderList.order.serviceItemList.serviceItem.totalDiscountPrice *
orderList.order.shippingAddress.address shippingAddress.address
orderList.order.shippingAddress.city shippingAddress.city
orderList.order.shippingAddress.district shippingAddress.district
orderList.order.shippingAddress.fullName shippingAddress.fullName
orderList.order.shippingAddress.gsm shippingAddress.gsm
orderList.order.shippingAddress.neighborhood shippingAddress.neighborhood
orderList.order.shippingAddress.postalCode shippingAddress.postalCode
orderList.order.shippingAddress.taxHouse *
orderList.order.shippingAddress.taxId *
orderList.order.shippingAddress.tcId shippingAddress.tcId
orderList.order.status shipmentPackageStatus ( Sipariş statü tablosunda eşleşen değerler mevcut )
orderList.order.totalAmount totalAmount
orderList.order.totalDiscountAmount totalDiscountAmount

 

  • SOAP DetailedOrderList servisinde yer almayan, RestAPI GetShipmentPackages servisine eklenen parametreler

 

Rest API Açıklama
id Sipariş Paket Numarası
cargoSenderNumber Kargo takip numarası
cargoTrackingLink Kargo takip linki
installmentChargeWithVATprice KDV dahil vade farkı
lines.totalSellerDiscountPrice Mağaza indirim toplamı
agreedDeliveryDate Maksimum kargolama tarihi
packageHistories.createdDate Tüm statülerin paket statü geçmişi bazlı tarihleri bu alanda yer almaktadır.
packageHistories.status Tüm statülerin paket statü geçmişi bu alanda yer almaktadır.
sellerId n11 satıcı ID bilgisi