İş Ortağı Fiyat Listesi

Fiyat listelerini, hem Yandex Business’ta Kişisel Hesap oluşturan şirketler (ayrıntılar için Şirket Fiyat Listesi bölümüne bakın) hem de Yandex Business iş ortakları yükleyebilir.

İş Ortağı, şirketler, ürünleri ve hizmetleri hakkında bilgi toplayan bir hizmettir.

İş Ortağı Gereksinimleri

  • İş ortağının, Yandex Maps’te yer alan şirketlerin güncel ürün ve hizmetleri hakkında bilgisi vardır.
  • Bilgi sağlanan şirket sayısı 1.000’den az değildir.
  • Ürün ve hizmet verileri yasal yollarla elde edilmiştir ve fiyat listesi gereksinimlerine uygundur.
  • Veriler, çevrimdışı çalışan ve fiziksel bir adresi olan şirketlerden alınmıştır (Adres ve Konum bölümüne bakın).

Nasıl Bağlanır

Bir Besleme Oluşturun

Tüm ürün ve/veya hizmetlerin listesini içeren bir dosya olan bir besleme oluşturun.

Dosya Gereksinimleri

Format: Satır bazında JSON. Her satır, bir JSON nesnesi olarak temsil edilen bir ürün veya hizmet içerir.

Veri kodlaması: UTF-8.

Zorunlu alanlar yıldız işaretiyle belirtilmiştir.

Alan

Açıklama

yandex_company_id *

Yandex Maps’teki kuruluş ID’si. Örneğin: 1124715036.

Bunu, şirketin doğrudan bağlantısından alabilirsiniz, örneğin: https://yandex.com.tr/maps//org/yandex/1124715036.

yandex_company_ids *

Bir ürün veya hizmet birden fazla şirketle ilişkiliyse, liste formatında yandex_company_id değeri.

Not

Her satırda yalnızca yandex_company_id veya yandex_company_ids alanlarından birini belirtmeye izin verilir.

source_id *

Ürünün benzersiz stok kodu, SKU.

80 karaktere kadar.

Rakamlar, Latin ve Türk harfleri ve ., ,, \, /, (, ), [, ], -, = sembollerini içerebilir.

name*

Ürün veya hizmetin adı.

250 karaktere kadar.

description

Ürün açıklaması.

250 karaktere kadar.

price*

Ürün veya hizmetin net fiyatı. Fiyat aralığı belirtmeye izin verilmez.

20 karaktere kadar.

Yalnızca rakamlar, ., , içerebilir.

Not

“0” fiyatlı veya fiyatsız ürün veya hizmet yayınlanmayacaktır.

currency_id

ISO 4217 formatında para birimi kodu.

Belirtilmezse, şirketin faaliyet gösterdiği ülke için varsayılan değer kullanılacaktır: Türkiye için TRY.

is_popular

Seçilen ürün veya hizmetin, şirket profilindeki Genel Bakış sekmesinde popüler ürünler galerisinde görüntülenmesi için true belirtin.

Fiyat listesinde toplamda 10’dan fazla popüler ürün veya hizmet işaretlenemez.

category

Ürün veya hizmetin ait olduğu fiyat listesi bölümü.

250 karaktere kadar.

Şirket profilinde fiyat listesi, belirtilen kategorilere göre ayrılarak yayınlanır.

photo_link

Görsel dosyasına doğrudan bir bağlantı.

Not

Yandex Disk bağlantısı, bir görsel yerine bir HTML sayfasına götürdüğü için uygun değildir.

Bağlantı şu şekilde olabilir:

  • TCP portunun açıkça belirtilmediği;
  • Şu portlardan biriyle: 80, 443 veya 8080.

Yalnızca HTTP ve HTTPS protokolleri üzerinden yükleme desteklenir. FTP, SMB ve diğer protokoller üzerinden yükleme desteklenmez.

Dosya Satırı Şeması
{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "definitions": {
        "price_item": {
            "description": "Product placement",
            "type": "object",
            "properties": {
                "yandex_company_id": {
                    "description": "The organization's ID on Yandex Maps",
                    "type": "integer"
                },
                "yandex_company_ids": {
                    "description": "Multiple organization IDs on Yandex Maps",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    },
                    "uniqueItems": true
                },
                "source_id": {
                    "description": "The product ID in your system",
                    "type": "string",
                    "maxLength": 80
                },
                "name": {
                    "description": "Product Name",
                    "type": "string",
                    "maxLength": 250
                },
                "is_popular": {
                    "description": "Popular products form a showcase (no more than 10 pieces)",
                    "type": "boolean"
                },
                "price": {
                    "description": "Product price",
                    "type": "number"
                },
                "description": {
                    "description": "Product Description",
                    "type": "string",
                    "maxLength": 250
                },
                "category": {
                    "description": "Product category",
                    "type": "string",
                    "maxLength": 250
                },
                "photo_link": {
                    "description": "Link to the photo",
                    "type": "string"
                },
                "currency_id": {
                    "description": "ISO 4217 currency code",
                    "type": "string",
                    "maxLength": 10
                }
            },
            "required": [
                "source_id",
                "name",
                "price",
                "currency_id"
            ],
            "oneOf": [
                {
                    "required": [
                        "yandex_company_id"
                    ]
                },
                {
                    "required": [
                        "yandex_company_ids"
                    ]
                }
            ]
        }
    },
    "$ref": "#/definitions/price_item"
}
Dosya örneği

Dosyayı korumak için, istek headerveya parametresinde ileteceğimiz bir dize olan bir gizli anahtar ayarlayabilirsiniz.

Beslemeyi Yandex Business’a Bağlayın

  1. Dosya için kalıcı bir bağlantı oluşturun.

    Dikkat

    Veri güncellemeleri bağlantı değiştirilmeden gerçekleşmelidir.

  2. Şirket Ürün ve Hizmetleri formuna gidin.

  3. What happened? listesinden İş ortağı ürün beslemesini bağla seçeneğini belirleyin.

Dosyanın yüklenme ve güncellenme periyodu günde bir kezdir.

Nasıl Çalışır

Entegrasyondan sonra veri kaynağı bilgisi şurada görünecektir:

  • Yandex Business Kişisel Hesabı’nda, Ürünler ve hizmetler bölümünde, Ürün ve hizmet kaynağı menüsünde. Ayrıntılar için Başka bir kaynaktan fiyat listesi nasıl yüklenir bölümüne bakın.

    Örnek

  • Yandex Maps’teki şirket profilinde, Ürünler ve hizmetler veya Menü sekmesinde.

    Örnek

Destek mektubu



Ayrıca şu servise de geçebilirsiniz