API Hata Mesajları ve Açıklamaları
RestAPI Ürün Hata Mesajları
| İşlem | Hata Mesajı | Çözüm |
| Ü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 | X idli marka özellik değeri {categoryName}[{categoryId}] kategorisinde bulunmamaktadır. | Gönderilen marka Id bilgisi 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 | 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 | vatRate alanı boş olamaz. | KDV oranı alanı zorunlu beklenmektedir, bu alan eksik olduğunda bu hata mesajı dönmektedir. |
| Ürün Yükleme | X ö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 | 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. | Ürün orijinallik kontrolü kaynaklı bu hata mesajı dönmektedir, tedarik faturası ile talep oluşturmalısınız. |
| Ü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 ismi 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 | Kataloğa ürün önerme başarısız oldu. Katalog mesaj X gerekli. | Katalog mesaj alanında belirtilen özellik değeri geçersiz olduğunda dönmektedir, tekrar eşleştirme yaparak güncel değerler ile gönderim sağlanabilir. |
| Ü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 | 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 | Ortalama gönderim süreniz ve mağaza puanınız doğrultusunda en az X gün hazırlık süresi seçebilirsiniz. | Mağaza kargo gönderim süresinin altında bir değer girdiğinizde bu hata mesajı dönmektedir. |
| Ürün Yükleme |
|
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 | 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 Ü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 | 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 | Category alanı geçersizdir | Ürün eğer daha önce canlıda olan fakat şuan kapatılan bir category ile eşleştirildiyse bu hata alınmaktadır. Bu durumda kategori eşleştirmesini tekrar yapmalısınız. |
| Ü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 | 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 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 |