RestAPI Satıcı Ürün Sorgulama

Satıcı Ürün Sorgulama  (GetProductQuery)

GET https://api.n11.com/ms/product-query
  • Authorization no auth seçiniz.
  • Headers alanına appkey ve appsecret bilgisini eklemeniz gerekir.
  • HTTP isteğinizi 'GET' methoduyla ilgili endpoint'e gönderin.

 

Dikkat Edilmesi Gerekenler;

  • Request parametrelerinde zorunluluk yer almamaktadır, parametreler boş olacak şekilde listeleme yapabilirsiniz. Hiçbir parametre girilmediğinde satıcının tüm ürünleri page 0 size 20 olacak şekilde listelenecektir.
  • stockCode parametresi her istekte tek bir değer alabilmektedir, birden fazla ürün listelemek için satıcı stok kodu bazlı istek atmanız gerekmektedir.
  • Pagination yapısı kullanıyorsanız page 0 başlatarak responsede dönen totalPages alanını dikkate alarak content boş dönen sayfayı son sayfa olarak belirleyebilirsiniz.
  • Response Body içerisindeki parametre değerleri karakter sayısı ve veri tipleri sipariş sayısının doğal artışıyla beraber değişebilmektedir ( Örneğin n11ProductId alanı 9 haneden 10 haneye çıkabilir, entegratör üzerinde tanımlama yapılırken bu durumlar göz önünde bulundurulması sağlıklı olacaktır ).
Parametre Parametre Değer Açıklama Tip
id N11 Ürün Kodu N11 Ürün kodu ile listeleme long
productMainId Grup Kodu Ürün grup kodu ile listeleme string
stockCode Satıcı Ürün Kodu Satıcı ürün kodu ile listeleme string
saleStatus On_Sale : Satışta
Out_Of_Stock : Stokta Yok		 Ürün satış durumuna göre listeleme string
productStatus Active : Onaylı
InCatalogApproval : Katalog Onay Sürecinde
Suspended : Beklemede
CatalogRejected : Katalogdan Reddedildi
Prohibited : Yasaklı
Unlisted : Limit Dışı		 Ürün onay durumuna göre listeleme string
brandName Marka ismi N11 Satıcı panelinde yer alan ürünleri marka ismine göre listelemesini sağlar string
categoryIds Kategori ID bilgisi Kategori ID ile listeleme long list
page Varsayılan 0   int
size Varsayılan 20 maksimum 250   int
Parametre(Cevap) Açıklama
n11ProductId N11 Ürün Kodu
sellerId Satıcı ID
stockCode Satıcı Stok Kodu
title Ürün Adı
description Ürün açıklaması
categoryId Kategori ID
productMainId Model Kodu
status Ürün Aktifliği
saleStatus Satış Durumu
preparingDay Kargo Hazırlık Süresi
shipmentTemplate Kargo Şablonu
maxPurchaseQuantity Maksimum Satın Alım Adedi
customTextOptions Müşteriye Özel Ürün Seçeneği
catalogId Ürün Katalog ID
barcode Barkod
currencyType Para Birimi
salePrice Satış Fiyatı
listPrice Liste Fiyatı
quantity Stok Adedi
attributes Ürün Özellikleri
totalElements Toplam Ürün Sayısı
totalPages Toplam Sayfa Sayısı
number Mevcut Sayfa Numarası
numberOfElements Sayfadaki Ürün Sayısı
size Listelenen Ürün Adedi

Satıcı ürünlerini listeleme

Örnek Request
GET https://api.n11.com/ms/product-query?id=&productMainId=&stockCode=&saleStatus=&productStatus=&brandName=&categoryIds=&page=&size=
Örnek Response
{
    "content": [
        {
            "n11ProductId": 123456789,
            "sellerId": xxxxxxx,
            "stockCode": "TestSKU123",
            "title": "Test Ürünü Kontrol Amaçlı Gri",
            "description": "Açıklama bilgisi uzun açıklama",
            "categoryId": 1231231,
            "productMainId": "GrupKoduModellemeİçin",
            "status": "Active",
            "saleStatus": "On_Sale",
            "preparingDay": 3,
            "shipmentTemplate": "1",
            "maxPurchaseQuantity": 5,
            "customTextOptions": [],
            "catalogId": 987654321,
            "barcode": null,
            "groupId": 12345678,
            "currencyType": "TL",
            "salePrice": 10000.0,
            "listPrice": 10000,
            "quantity": 2,
            "attributes": [
                {
                    "attributeId": 1,
                    "attributeName": "Marka",
                    "attributeValue": "Diğer"
                },
                {
                    "attributeId": 429,
                    "attributeName": "Renk",
                    "attributeValue": "Gri"
                },
                {
                    "attributeId": 845,
                    "attributeName": "Ölçüler",
                    "attributeValue": "0.5 CMx 1 M"
                }
            ]
        }
    ],
    "pageable": {
        "sort": null,
        "pageNumber": 0,
        "pageSize": 20,
        "offset": 0,
        "paged": true,
        "unpaged": false
    },
    "last": true,
    "totalElements": 1,
    "totalPages": 1,
    "first": true,
    "number": 0,
    "sort": null,
    "numberOfElements": 1,
    "size": 20,
    "empty": false
}