Ürün Oluşturma

Ürün Oluşturma (create)

Ürünleriniz idefix MP sistemine yüklenirken bu metod kullanılmalıdır.

Bu method ile ürün aktarımı sağlanmadan önce idefix Marka Liste ve Kategori / Kategori Özellik bilgileri servisleri üzerinden ilgili bilgiler alınmalıdır. Aksi halde ürünleriniz idefix sisteminde oluşmayacaktır.

Bu method ile ürün aktarımı sağlanmadan önce attributeler çekildiğinde required = true olan alanlar ürün oluşturma isteğinde mutlaka gönderilmelidir. Aksi halde ürünleriniz idefix sisteminde oluşmayacaktır.

Ürün aktarım işlemi sonrasında response içerisinde yer alan batchRequestId ile ürünlerinizin ve aktarım işleminin durumunu batch-result servisi üzerinden kontrol etmelisiniz.

vendor her satıcının unique bir tanımlayıcısıdır. Zorunlu bir alandır.

❗ NOT: Ürün güncelleme işlemleri API servisleri üzerinden yapılmamaktadır.

POST create Tekli ürün:

https://merchantapi.idefix.com/pim/pool/{vendorId}/create

  • olarak belirtilenler zorunlu parametrelerdir.
Parametre Ad Açıklama
barcode * Ürünün barkodu
title * Ürünün ismi
productMainId * Ana ürün kodu
brandId * İdefix marka ID’si. Marka bilgilerini çekmek için Marka Liste servisini kullanabilirsiniz.
categoryId * İdefix kategori ID’si. Kategori bilgilerini çekmek için Kategori Liste servisini kullanabilirsiniz.
inventoryQuantity * Ürünün satılabilir stok adedi
vendorStockCode * Satıcının kendi sistemindeki ürün stok kodu
desi Ürünün kargoya verileceği paketin boyutsal ağırlığı
weight Ürünün ağırlığı
description * Ürün açıklama bilgileri
price * Ürünün idefix satış fiyatı
comparePrice Ürünün tavsiye edilen satış fiyatı
vatRate * Ürün KDV oranı (0, 1, 8, 18 gibi)
deliveryType regular, same_day_shipping
cargoCompanyId İdefix kargo firması bilgisi
shipmentAddressId Ürünün idefix sistemindeki sevkiyat depo adresi ID bilgisi
returnAddressId Ürünün idefix sistemindeki iade depo adresi ID bilgisi
images.url * Ürün görsellerine ait URL listesi. Görseller SSL sertifikalı https formatında olmalı ve bir barkod için maksimum 8 adet görsel eklenebilir.
attributes.attributeId * Ürünün kategori bilgisine göre gönderilebilecek özellik bilgileri
originCountryId Ürün denetim bilgileri gönderilecekse ülke menşei bilgisi
manufacturer Ürün denetim bilgileri gönderilecekse üretici bilgisi
importer Ürün denetim bilgileri gönderilecekse ithalatçı / yetkili temsilci bilgisi
ceCompatibility Ürün denetim bilgileri gönderilecekse CE uygunluk sembolü
usageInstructionsImage Ürün denetim bilgileri için kullanım talimatı görseli
packageFrontImage Ürün denetim bilgileri için ön yüz paket görseli
packageBackImage Ürün denetim bilgileri için arka yüz paket görseli
productInfoFormImage Ürün denetim bilgileri için ürün bilgi formu
energyClassImage Ürün denetim bilgileri için enerji sınıfı görseli
energyNutritionImage Ürün denetim bilgileri için enerji ve besin değerleri görseli
lotInfo Parti / Lot / SKT bilgisi
Örnek Servis İsteği:
{
  "products": [
    {
      "barcode": "60511581",
      "title": "dispacthtime Ürün 1",
      "productMainId": "60511581",
      "brandId": 1,
      "categoryId": 15031706,
      "inventoryQuantity": 20,
      "vendorStockCode": "60511581",
      "desi": 0,
      "description": "dispacthtime Ürün 1",
      "price": 110,
      "comparePrice": 110,
      "vatRate": 0,
      "deliveryDuration": 21,
      "deliveryType": "regular",
      "cargoCompanyId": 0,
      "shipmentAddressId": 0,
      "returnAddressId": 0,
      "images": [
        {
          "url": "https://image01.idefix.com/resize/800/0/product/258625/lenco-tt-27-dahili-speaker-pikap-kirmizi-665046ef23cc9.jpg"
        },{
          "url": "https://image01.idefix.com/resize/800/0/product/258625/lenco-tt-27-dahili-speaker-pikap-kirmizi-665046ef23cc9.jpg"
        }
      ],
      "status": "string",
      "statusDateCreatedAt": "2025-05-08T13:05:08.845Z",
      "reference": 0,
      "failureReasons": null,
      "matchedProduct": "string",
      "needAutoMatch": true,
      "addType": "string",
      "originCountryId": 12,
      "manufacturer": "Üretici Test",
      "importer": "string",
      "ceCompatibility": true,
      "usageInstructionsImage": "https://image01.idefix.com/resize/800/0/product/1269837/babyhope-436-akulu-araba-kirmizi-06043610-66c533c7b7136.jpg",
      "packageFrontImage": "https://image01.idefix.com/resize/800/0/product/1269837/babyhope-436-akulu-araba-kirmizi-06043610-66c533c7b7136.jpg",
      "packageBackImage": "https://image01.idefix.com/resize/800/0/product/1269837/babyhope-436-akulu-araba-kirmizi-06043610-66c533c7b7136.jpg",
      "productInfoFormImage": "https://image01.idefix.com/resize/800/0/product/1269837/babyhope-436-akulu-araba-kirmizi-06043610-66c533c7b7136.jpg",
      "energyClassImage": "https://image01.idefix.com/resize/800/0/product/1269837/babyhope-436-akulu-araba-kirmizi-06043610-66c533c7b7136.jpg",
      "energyNutritionImage": "https://image01.idefix.com/resize/800/0/product/1269837/babyhope-436-akulu-araba-kirmizi-06043610-66c533c7b7136.jpg"
      "lotInfo": null
    }
  ],
  "lastUpdatedAt": "2025-05-08T13:05:08.845Z",
  "completedAt": "2025-05-08T13:05:08.845Z",
  "createdAt": "2025-05-08T13:05:08.845Z",
  "status": "string",
  "batchRequestId": "string"
}
POST create Varyantlı Ürün

Bir ürünün birden fazla varyantı olması durumunda productMainId değeri aynı olacak şekilde (ör. ürünün 16 GB ve 64 GB hafızası gibi) varyantlı örnekte olduğu biçimde isteğin gönderilmesi beklenmektedir.

Örnek Servis İsteği:
{
  "products": [
    {
      "barcode": "8879615313219",
      "title": "test MATTEL Barbie Bebek Bakıcılığı Oyun Seti Esmer Bebek - Yeşil Biberon",
      "productMainId": "FHY777",
      "brandId": 68699,
      "categoryId": 110665444,
      "inventoryQuantity": 61,
      "vendorStockCode": "FHY77PMB",
      "desi": 0 ,
      "weight": 195,
      "description": "MATTEL Barbie Bebek Bakıcılığı Oyun Seti Esmer Bebek - Yeşil Biberon",
      "price": 149,
      "comparePrice": 159,
      "vatRate": 18,
      "deliveryDuration": 1,
      "deliveryType": "regular",
      "cargoCompanyId": null,
      "shipmentAddressId": null,
      "returnAddressId": null,
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/81PuNLCAvwL.jpg"
        }
      ],
      "attributes": [
        {
          "attributeId": 7,
          "attributeValueId": 103400,
          "customAttributeValue": null
        },
        {
          "attributeId": 1,
          "attributeValueId": 100090,
          "customAttributeValue": null
        }
      ],
      "erpId": null,
      "authorId": null
    },
    {
      "barcode": "8879615313500",
      "title": "MATTEL Barbie Bebek Bakıcılığı Oyun Seti Esmer Bebek - Yeşil Biberon",
      "productMainId": "FHY777",
      "brandId": 68699,
      "categoryId": 110665444,
      "inventoryQuantity": 52,
      "vendorStockCode": "FHY77YSL",
      "weight": 195,
      "description": "MATTEL Barbie Bebek Bakıcılığı Oyun Seti Esmer Bebek - Yeşil Biberon",
      "price": 149,
      "comparePrice": 159,
      "vatRate": 18,
      "deliveryDuration": 1,
      "deliveryType": "regular",
      "cargoCompanyId": null,
      "shipmentAddressId": null,
      "returnAddressId": null,
      "images": [
        {
          "url": "https://cdn.dsmcdn.com/mnresize/1200/1800/ty96/product/media/images/20210404/22/57317cde/59506322/1/1_org_zoom.jpg"
        }
      ],
      "attributes": [
        {
          "attributeId": 7,
          "attributeValueId": 103400,
          "customAttributeValue": null
        },
        {
          "attributeId": 1,
          "attributeValueId": 100130,
          "customAttributeValue": null
        }
      ],
      "erpId": null,
      "authorId": null
    }
  ]
}