Toplu Ürün Durumu Sorgulama

Ürün Toplu İşlem Sorgulama(batch-result)

Bu metod ile ürün create işleminde almış olduğunuz ‘batchRequestId’ bilgisi ile ürünlerinizin durumunu sorgulayabilirsiniz. Alacağınız statüye göre belli endpointlerde ya da merchant center backoffice ekranları üzerinde işlemler yapmanız gerekecektir.

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

GET batch-result

https://merchantapi.idefix.com/pim/pool/{vendorId}/batch-result/{batchId}

Örnek Servis Cevabı:
{
    "products": [
        {
            "barcode": "16925281947333",
            "title": "JBL Tune 560Bt Wireless Kulaklık",
            "productMainId": "Test2123der82s33392",
            "brandId": 68540,
            "categoryId": 110682144,
            "inventoryQuantity": 19,
            "vendorStockCode": "301823219133543",
            "weight": 195,
            "description": "Kablosuz Bluetooth Akışı Eller serbest aramalar 16saat pil ömrü - 2saat şarj süresi ve hızlı şarj (5dk = 1saat)",
            "price": 159,
            "comparePrice": 189,
            "vatRate": 18,
            "deliveryDuration": 1,
            "deliveryType": "regular",
            "cargoCompanyId": null,
            "shipmentAddressId": null,
            "returnAddressId": null,
            "images": [
                {
                    "url": "https://i.dr.com.tr/cache/500x400-0/originals/0001909754002-3.jpg"
                }
            ],
            "attributes": [
                {
                    "attributeId": 188,
                    "attributeValueId": 110330,
                    "customAttributeValue": null
                },
                {
                    "attributeId": 1,
                    "attributeValueId": 100140,
                    "customAttributeValue": null
                }
            ],
            "status": "decline",
            "statusDateCreatedAt": "2023-02-07T10:23:56+03:00",
            "reference": 385,
            "failureReasons": "CATEGORY_MANDATORY_ATTRIBUTE_MISSED",
            "matchedProduct": null,
            "needAutoMatch": false,
            "addType": "integration",
            "erpId": null,
            "authorId": null
        }
    ],
    "lastUpdatedAt": "2023-02-07T10:23:56+03:00",
    "completedAt": "2023-02-07T10:23:56+03:00",
    "createdAt": "2023-02-07T10:23:56+03:00",
    "status": "COMPLETED",
    "batchRequestId": "4b-63e1fc8c78387"
}

Servisten Dönen Parametreler

Parametre Ad Açıklama
status Ürün gönderimi sonrasında dönen ürünün güncel durum bilgisidir. Detaylı tablo aşağıda "Ürün Statüleri" tablosunda paylaşılmıştır.
failureReasons Ürün gönderimi sırasında hata alınması durumunda, hata sebebine ilişkin detaylı bilgileri içerir.
matchedProduct Gönderilen ürünün idefix sistemindeki eşleşen ürün karşılığıdır.

failureReasons Hata Kodları

Hata Kodu Açıklama
CATEGORY_MANDATORY_ATTRIBUTE_MISSED Kategorinin zorunlu olarak gönderilmesi gereken özellik bilgisi eksiktir.
ATTRIBUTE_MULTIPLE_NOT_ALLOWED Aynı attribute birden fazla kez gönderilmiştir.
CUSTOM_ATTRIBUTE_NOT_SUPPORTED_YET Sistemde tanımlı olmayan bir özellik gönderilmiştir.
ATTRIBUTEVALUE_NOT_DEFINED Sistemde tanımlı olmayan özellik değeri gönderilmiştir.
BRAND_NOT_EXIST Böyle bir marka tanımı idefix sisteminde bulunmamaktadır.
VENDOR_RETURN_ADDRESS_NOT_CORRECT Gönderilen iade adresi ile sistemde tanımlı iade adresi uyuşmamaktadır.
VENDOR_SHIPMENT_ADDRESS_NOT_CORRECT Gönderilen sevkiyat adresi ile sistemde tanımlı sevkiyat adresi uyuşmamaktadır.
PRODUCT_IMAGE_MANDATORY_ONCREATE Ürün görseli zorunludur.
VENDOR_CATEGORY_ACCESS_DENIED Satıcının ilgili kategoriye ürün ekleme yetkisi bulunmamaktadır.
BRAND_EXCLUSIVE_NOT_AUTHORIZED Satıcı ilgili marka için münhasır yetkiye sahip değildir.
VENDOR_BRAND_ACCESS_DENIED Satıcının markaya erişim yetkisi bulunmamaktadır.
VENDOR_ACCESS_DENIED Satıcı onaylı değildir.
DATA_PARSE_ERROR Gönderilen request içeriği parse edilememiştir.
NO_BATCH_ID_EXIST Hatalı veya sistemde bulunmayan batchId gönderilmiştir.
PRODUCT_POOL_ALREADY_EXIST Ürün zaten satıcının ürün havuzunda bulunmaktadır.
VENDOR_IN_VACATION_MODE Satıcının tatil modu aktiftir.
BRAND_FAILED_TO_MATCH Ürün katalogda yer almaktadır ancak gönderilen marka katalogdaki marka ile uyuşmamaktadır. Doğru marka ID bilgisi response içerisinde iletilir.
CATEGORY_FAILED_TO_MATCH Ürün katalogda yer almaktadır ancak gönderilen kategori katalogdaki kategori ile uyuşmamaktadır. Doğru kategori ID bilgisi response içerisinde iletilir.

Ürün Statüleri

Değer Açıklama
waiting_catalog_action Ürün inceleme sürecindedir.
waiting_vendor_approve Eklenen ürün idefix kataloğunda mevcuttur. Ürünü satışa açmak veya reddetmek için approve-item / decline-item servisleri kullanılabilir.
ready_for_sale Ürün satışa açılmaya hazırdır.
vendor_declined Ürünün eşleşmesi satıcı tarafından reddedilmiştir.
missing_info Ürüne ait eksik bilgi bulunmaktadır.
platform_declined Ürün platform tarafından reddedilmiştir.
not_matched Ürün katalogda bulunan bir ürün ile eşleştirilememiştir. Ürün operatörler tarafından incelemeye alınır; onay, red veya revize gönderim işlemleri yapılabilir. Ürünlerinizi ve güncel durumunu list servisinden görüntüleyebilirsiniz.
auto_matched Ürün katalogda bulunan bir ürün ile otomatik olarak eşleştirilmiştir.
manual_matched Ürün manuel olarak eşleştirilmiştir.

Batch Statüleri

Değer Açıklama
created Talep oluşturuldu.
completed İşlem başarıyla tamamlandı.
running İşlem devam ediyor.
failed İşlem başarısız oldu.
cancelled İstek iptal edildi.