• Импорт ұсыныстары көп компанияларға — тауарлар, жылжымайтын мүлік нысандары немесе қызметтер — қолайлы. Сіз өз сайтыңызға бүкіл каталогы бар файлды орналастырасыз, ал біздің сайт оны шамамен сағатына бір рет жүктеп алады да, сол арқылы хабарландыруларыңызды жасайды, жаңартады және көрсетуден алады. Әр хабарландыруды қолмен жариялап, өңдеудің қажеті жоқ. Қосылу және жүктеп алу тегін.

    Мұндай файл фид деп аталады. Оның форматы — YML: көптеген интернет-дүкендер мен CMS жүйелері экспорттай алатын XML файлы.

    Фидті бағдарламашы немесе ЖИ агенті дайындай ма? Оған ЖИ агенті мен бағдарламашыға арналған нұсқаулықты (орыс тілінде) беріңіз. Онда файлға қойылатын барлық талаптар, орындаушы сізге қоюы тиіс сұрақтар және тексеру тізімі бар. ЖИ агентіне (мысалы, ChatGPT, Claude немесе Cursor) осы файлды тапсырмаға тіркеу жеткілікті. Егер фидті дайындайтын адам болмаса, кері байланыс формасы арқылы бізге жазыңыз.

    Мазмұны

    Импортты қалай қосу керек

    1. Фидті дайындаңыз осы мақаладағы талаптар бойынша және оны тұрақты мекенжайға орналастырыңыз, мысалы https://сіздің-сайтыңыз.kz/export/catalog.xml. Мекенжай браузерде құпиясөзсіз ашылуы тиіс.
    2. Сілтемені сақтаңыз. Сайтқа кіріп, жеке кабинеттегі «Хабарландыруларды импорттау» бөлімін ашыңыз. Фид мекенжайын енгізіп, «Сілтемені сақтау» түймесін басыңыз.
    3. Сайтты растаңыз. «Сайтты растау» блокында partner-verification-….txt түріндегі аты бар файл пайда болады. Оны «Файлды жүктеп алу» түймесімен жүктеп алып, фидтегі shop/url элементінде көрсетілген сайттың түбіріне орналастырыңыз. Файл https://сіздің-сайтыңыз.kz/partner-verification-….txt мекенжайы бойынша ашылуы тиіс. Осылайша фидті сайт иесі жариялап отырғанына көз жеткіземіз.
    4. Фидті тексеріңіз. «Фидті тексеру» түймесін басыңыз. Әдетте бірнеше минуттан кейін «Фидтің соңғы тексерісі» блокында есеп пайда болады. Тексеру ештеңе жарияламайды: ол файлдағы қателерді іздейді, растау файлын тексереді және санаттарыңыздың тізімін жүктейді. Қателерді түзетіп, фидті қайта тексеріңіз — қайта тексеру 2 минуттан кейін қолжетімді.
    5. Бөлімдер мен аумақты таңдаңыз. «Санаттар мен аумақ» блокында фидтегі әр санат үшін біздің сайттың бөлімін немесе «Импорттамау» таңдауын таңдаңыз. Елді, облысты және қаланы көрсетіңіз: олар барлық хабарландыруға бірдей болады. «Параметрлерді сақтау» түймесін басыңыз.
    6. Байланыс деректерін таңдаңыз. «Хабарландырулардағы байланыс» блокында хабарландыруларда нені көрсету керектігін белгілеңіз: аты, email, телефон, Telegram, қосымша байланыс деректері. Деректердің өзі профильден алынады және «Менің жеке ақпаратым» бөлімінде өзгертіледі. Таратуға келісімді белгілеп, «Байланысты сақтау» түймесін басыңыз.
    7. Шарттарды қабылдаңыз. «Хабарландыруларды импорттау шарттары» блокында шарттарды оқып, «Хабарландыруларды импорттау шарттарын қабылдаймын» түймесін басыңыз.
    8. Өтініш жіберіңіз. «Автоматты импортқа өтініш» блокында «Өтініш жіберу» түймесін басыңыз. Егер бірнәрсе дайын болмаса, кабинет нақты не екенін көрсетеді. Әкімші өтінішті мақұлдағаннан кейін алғашқы жүктеп алу бір сағат ішінде орындалады, содан кейін сайт фидті өзі жүктеп алады.

    Файлға қойылатын талаптар

    • Файлда әрқашан тек өзгерістер емес, бүкіл өзекті каталог болады. Файлдың жаңа нұсқасында жоқ ұсыныс көрсетуден алынады.
    • Формат — UTF-8 немесе Windows-1251 кодтауындағы YML (XML). XML орнына ZIP немесе GZ мұрағаты қолайлы емес.
    • Мекенжай http:// немесе https:// арқылы басталады, стандартты портта жұмыс істейді, логин мен құпиясөзсіз ашылады және интернеттен қолжетімді болады.
    • Сайт фидті браузермен емес, бағдарламамен жүктеп алады. Боттардан қорғау — капча, браузерді тексеру немесе IP мекенжайы бойынша бұғаттау — фидті, растау файлын және фотосуреттерді жаппауы тиіс. Сұраулар құрамында PartnerImport бар User-Agent тақырыбымен келеді — оны қорғаудың ерекшеліктеріне қосуға болады.
    • Сервер файлды толық 60 секундтан аспайтын уақытта береді. Көлемі — 50 МБ-қа дейін.
    • Ұсыныстар — сатылымнан алынғандарды қоса, 1000-ға дейін. Көбірек қажет болса, бізге жазыңыз. Лимиттен асқан файл түгелімен қабылданбайды.
    • Санаттар — жоғарыдағы және бос санаттарды қоса, 150-ге дейін.

    Фид үлгісі:

    <?xml version="1.0" encoding="UTF-8"?>
<yml_catalog>
  <shop>
    <url>http://partner.example/</url>
    <categories>
      <category id="10">Тасымалдағыштар мен сөмкелер</category>
    </categories>
    <offers>
      <offer id="SKU-0042" available="true">
        <name>Мысыққа арналған тасымалдағыш</name>
        <url>http://partner.example/products/SKU-0042</url>
        <price>1500</price>
        <currencyId>RUB</currencyId>
        <categoryId>10</categoryId>
        <picture>http://partner.example/images/SKU-0042-main.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-side.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-detail.jpg</picture>
        <description>Жаңа тасымалдағыш. Өлшемі 48 × 32 × 30 см. Өзі алып кету.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

    Жүктеп алу: бұл үлгі, барлық қолдау табылатын өрістері бар үлгі.

    Сайт файлдан қандай деректер алады

    shop/url — міндетті
    Сіздің сайтыңыздың мекенжайы. Оның түбіріне растау файлы орналастырылады, ал ұсыныс беттерінің сілтемелері дәл осы сайтқа бағытталуы тиіс.
    category — міндетті
    Сіздің санаттарыңыз. id атрибуты — файлда бірегей, оң бүтін сан; parentId — жоғарыдағы санаттың id-сі. Кабинетте әр санат біздің сайттың бөлімімен сәйкестендіріледі.
    offer, id атрибуты — міндетті
    Ұсыныстың тұрақты идентификаторы, 80 таңбаға дейін. Сайт оны келесі жүктеп алулар кезінде ұсынысты тану үшін пайдаланады.
    offer, available атрибуты — міндетті емес
    true — көрсету, false — көрсетуден алу. Атрибут болмаса, ұсыныс қолжетімді деп есептеледі.
    name — міндетті
    Хабарландыру атауы. Оның орнына ұсыныста type="vendor.model" және typePrefix, vendor, model элементтерін көрсетуге болады.
    categoryId — міндетті
    Ұсыныс санатының id-сі.
    description — міндетті
    Хабарландыру мәтіні. HTML рұқсат: сайт белгілерді өшіріп, абзацтарды сақтайды.
    price — міндетті емес
    Баға. Баға болмаса, хабарландыру келісім бағасымен жарияланады.
    currencyId — міндетті емес
    Бағаның валютасы. Ол болмаса — рубль қолданылады.
    url — міндетті емес
    Сіздің сайтыңыздағы ұсыныс беті. Хабарландыруда «Веб-сайт» жолы ретінде көрсетіледі.
    picture — міндетті емес
    Фотосуреттер, 5-ке дейін. Біріншісі — басты фотосурет.

    Қалған YML элементтерін — сипаттамалар, жеңілдіктер, жеткізу және басқаларын — сайт өткізіп жіберіп, есепте ескерту ретінде көрсетеді. Бұл қате емес. Импортталатын барлық хабарландыру «Ұсыныс» түрін алады, ал бөлімді, аумақ пен байланыс деректерін файл емес, кабинет параметрлері береді.

    Атау мен сипаттама

    Атау мен сипаттама қолмен жарияланған хабарландырулармен бірдей ережелер бойынша тексеріледі. Ережені бұзған ұсыныс өткізіліп жіберіледі, ал себебі есепте көрсетіледі. Мәтіндер автоматты түрде түзетілмейді және қысқартылмайды.

    • Атау — 150 таңбаға дейін, сипаттама — 5000 таңбаға дейін. Сипаттама міндетті.
    • Сілтемелерсіз, email мекенжайларысыз және телефон нөмірлерісіз: байланыс деректерін сайт хабарландыруға өзі қосады. 7 немесе 8 санынан басталатын 11 таңбалы тізбек телефон нөмірі деп есептеледі, тіпті ол тауар коды болса да.
    • Бос орынсыз 30 және одан көп таңбалы сөздерсіз: ұзын тауар кодтары мен қосылып жазылған сөздерді бос орынмен бөліңіз.
    • Атауда кабинетте хабарландырулар үшін таңдалған қаланың атауы болмайды.
    • Бұзық сөздерсіз және тыйым салынған тақырыптарсыз: алкоголь, темекі, қару, рецептпен берілетін дәрілер, құмар ойындар, несиелер мен қарыздар және басқалар.

    «Фидті тексеру» түймесі бұл ережелерді тексермейді — мұны өтініш мақұлданғаннан кейінгі жүктеп алулар тексереді. Бос сипаттаманы және жоқ categoryId мәнін ол табады: мұндай ұсыныстар есепте қатемен көрсетіледі. Мәтін ережелерінің бұзылуы туралы алғашқы есептен білмеу үшін мәтіндерді алдын ала тексеріңіз: ЖИ агенті мен бағдарламашыға арналған нұсқаулықта (орыс тілінде) ережелер толық сипатталған.

    Баға, валюта және фотосуреттер

    • Баға — нүктемен жазылған сан: 1500 немесе 1499.90, бос орынсыз, үтірсіз және валюта белгісіз. Сома бүтін санға дөңгелектеледі: 1499.50 — 1500 болады. Баға жоқ, бос немесе 0-ге тең болса, хабарландыруда «келісім» деп көрсетіледі.
    • Валюта — RUB (немесе RUR), USD, EUR, AMD, KZT, GEL, BYN, UAH, AZN, KGS, RSD. Баға бағам бойынша қайта есептелмейді.
    • Фотосуреттер — JPEG, PNG немесе WebP, әрқайсысы 15 МБ-қа дейін. Сайт picture ішіндегі алғашқы 5 сілтемені алады.
    • Сайт фотосуретті сілтеме бойынша есте сақтайды. Фотосуретті ауыстыру үшін сілтемені, мысалы файл атын өзгертіңіз. Ескі сілтемедегі жаңа файлды сайт байқамайды.
    • Фотосурет жүктелмесе де, хабарландыру жарияланады, ал сайт шамамен бір тәуліктен кейін қайта әрекет етеді.

    Ұсыныстарды жаңарту және алу

    • Баға, мәтін немесе фотосуреттер өзгерсе, бұрынғы id-ді сақтаңыз. Сайт дәл сол хабарландыруды жаңартады, оның мекенжайы мен жарияланған күні сақталады.
    • Бар ұсыныстардың id-сін өзгертпеңіз және сатылымнан алынған тауардың id-сін басқа тауарға бермеңіз. Жаңа id — жаңа хабарландыру, ал ескісі көрсетуден алынады. Регистр маңызды: SKU-42 және sku-42 — әртүрлі ұсыныстар.
    • Ұсынысты алу үшін available="false" көрсетіңіз немесе оны файлдан алып тастаңыз. Хабарландыру жасырылады және 180 күн сақталады: ұсыныс сол id арқылы оралса, бұрынғы хабарландыру да оралады. 180 күннен кейін хабарландыру жойылады.
    • Кабинетте санат үшін «Импорттамау» таңдауын таңдау, параметрлер сақталғаннан кейін оның барлық хабарландыруларын дереу жасырады.
    • Ұсыныстардың бос тізімі <offers/> барлық хабарландыруды көрсетуден алады. Егер файлда offers элементі мүлдем болмаса, файл зақымдалған деп есептеледі және хабарландырулар өзгермейді.
    • Сайт әкімшісі жойған хабарландыру сол id арқылы қайта жасалмайды.

    Қателер мен есептер

    Тексеру есебі «Фидтің соңғы тексерісі» блокында, ал тұрақты жүктеп алу есебі «Соңғы жүктеу» блокында көрсетіледі. Хабарламалардың үш түрі бар.

    • Файл қатесі — файл қабылданбайды, хабарландырулар өзгермейді. Мысалы: зақымдалған XML, shop/url жоқ, лимиттен асу немесе сайт расталмаған.
    • Ұсыныс қатесі — тек сол ұсыныс өткізіліп жіберіледі: жаңа хабарландыру жасалмайды, ал бар хабарландыру бұрынғы деректерін сақтайды. Қалған ұсыныстар өңделеді, жүктеп алу нәтижесі — «Жартылай».
    • Ескерту — жариялауға әсер етпейді. Мысалы: файлдағы артық элементтер, available атрибутының болмауы немесе фотосуреттің жүктелмеуі.

    Қатені түзету мүмкін болмаса, есеп мәтінін нұсқаулықпен бірге бағдарламашыңызға немесе ЖИ агентіңізге беріңіз — онда әр хабарлама үшін нені түзету керегі көрсетілген.

    Файл жүктелмей қалғанда

    Файл қабылданбай жатқан кезде — сервер қолжетімсіз, файлда қате бар немесе растау файлы жоғалған — хабарландырулар соңғы қабылданған нұсқада қалады. Егер бұл жалғаса берсе:

    • 24 сағаттан кейін себебі көрсетілген хат аласыз;
    • 7 күннен кейін қосылымның барлық хабарландырулары жасырылады, ал жүктеп алулар сиректейді — тәулігіне бір рет;
    • 180 күннен кейін импорт тоқтайды, ал хабарландырулар жойылады.

    Файл қайта қабылданғаннан кейін хабарландырулар сайтқа оралады.

    Хабарландыруларды басқару

    • Импортталған хабарландыруларды сайтта өңдеуге және жоюға болмайды: «Өңдеу» орнына оларда «Фидпен басқарылады» жазуы тұрады. Деректерді фидте өзгертіңіз.
    • Хабарландыруларыңыздың тізімінде «Көрсетуді тоқтату» және «Хабарландыруды жабу» (мұрағатқа өткізу) әрекеттері қолжетімді. Ұсыныстың фидке оралуы бұл әрекеттерді болдырмайды.
    • «Хабарландыруларды импорттау» бөлімінде импортты уақытша тоқтатуға, барлық хабарландыруды жасыруға, фид мекенжайын өзгертуге немесе барлық хабарландыруды жойып, импортты тоқтатуға болады.

    Импорттың жұмыс шарттары — Хабарландыруларды импорттау шарттары құжатында. Сұрақтарды кері байланыс формасы арқылы қойыңыз.