Анықтамасы
Каталогты шығарып алу және жүктеу — сатушының есеп жүйесі мен Kaspi.kz сауда платформасы арасында тауарлар туралы мәліметтерді файл түрінде немесе API арқылы жіберіп, карточкаларды, бағаларды және қалдықтарды құру мен жаңарту процесі.
Процесс қалай жұмыс істейді: форматтар, кезеңдер және сценарийлер
Процесс әдетте үш негізгі кезеңнен тұрады: бастапқы файлды дайындау, платформға жіберу және нәтижені валидациялау. Техникалық тұрғыдан мұны бірнеше тәсілмен жүзеге асыруға болады:
- Kaspi сатушы кабинеті арқылы қолмен жүктеу (Excel немесе CSV) — шағын ассортимент үшін оңай бастама.
- FTP/HTTP арқылы жоспар бойынша жиынтық шығару/импорт CSV немесе XML форматында алдын ала анықталған шаблон бойынша.
- API арқылы интеграция — алдын ала баптау талап етеді, бірақ қалдықтар мен бағаларды жедел синхрондауға мүмкіндік береді.
- Аралық интеграторлар немесе ETL‑құралдар (мысалы, AWW) — 1C, қойма жүйесі мен Kaspi арасындағы деректерді автоматты түрде түрлендіру мен валидациялауды қамтамасыз етеді.
Массовая жүктеу үшін файлдың типтік құрылымы мына өрістерден тұруы мүмкін: SKU, Атауы, Артикул, Баға, Қалдық, Бренд, Штрихкод (EAN), Санат, Суретке сілтеме, Сипаттама. Жібермес бұрын файлдың кодировкасын (әдетте UTF-8 немесе кейбір кабинеттер үшін CP1251) платформа талаптарына сәйкес таңдаңыз.
Жүктелгеннен кейін платформа мынадай ережелер бойынша валидация жүргізеді: SKU‑нің бірегейлігі, санаттың дұрыстығы, баға форматтарының сәйкестігі, сурет сілтемесінің қолжетімділігі және т.б. Валидация нәтижесі қабылданған және қабылданбаған жазбалар саны туралы және қателер сипаттамасымен есеп түрінде келеді.
Неліктен сатушыға керек: нақты мысалдар мен сатылымға әсері
Каталогты басқару тауар карточкаларының көрінуі мен конверсиясына тікелей әсер етеді. Практикалық тиімділіктер:
- Қалдықтардың синхрондалуы тапсырыстардың болдырылуын азайтады. Мысал: 2 000 SKU бар сатушы қалдықтарды күніне бір рет қолмен жаңартып, жеткіліксіздік себебінен 3–5% тапсырыстардың тоқтатылуына тап болған. API арқылы 15 минут сайын автоматты синхрондау енгізілгеннен кейін тоқтатулар бірнеше есе азайды.
- Акциялар кезінде бағаны жедел өзгерту. Мысал: 1 200 SKU бар сатушы акция басталғанда файл арқылы бағаны топтап өзгертіп, 15 минут ішінде жүктеп қойды; ал қолмен өзгерту 2 күнге созылып маржа шығынға ұшырауы мүмкін еді.
- Карточкалардың сапасы: дұрыс атрибуттар мен сапалы суреттер CTR мен конверсияны жоғарылатады. 500 SKU‑ге 3 сурет пен егжей‑тегжейлі сипаттама қосқан сатушы іздеу нәтижелеріндегі конверсияның өскенін байқады.
- Қызмет шығындарын үнемдеу: массалық жүктеу қызметкерлер уақытын едәуір қысқартады. Мысал ретінде 5 000 позицияны қолмен жаңарту бірнеше жұмыс күнін алса, автоматтандырылған жүктеу бірнеше сағатқа сыяды.
Сонымен қатар, дұрыс ұйымдастырылған шығару/жүктеу fulfilment операциялары ( FBS/FBO) үшін және сұранысқа сай деректерді уақытылы беру үшін маңызды.
Kaspi.kz‑тегі типтік қателер мен жағдайлар мысалдары
- Қате санат таңдалған: Тауар дұрыс санатқа қойылмаса, қажетті атрибуттар жоқ болады және жазба қабылданбайды. Шешімі — Kaspi санат идентификаторларын пайдаланып маппинг жасау және алдын‑ала тестілеу.
- Кодировканың бұзылуы: UTF‑8 орнына басқа кодировка қолданылса атаулар мен сипаттамалар бұзылып көрінеді. Шешімі — файлды UTF‑8 немесе платформаның көрсеткен кодировкасына ауыстырып жіберу, BOM туралы талапты тексеру.
- Дубликаттар немесе бірегей емес SKU: Бірдей SKU бірнеше рет болмауы керек — қайталанулар жүктеуде қателікке әкеледі. Алгоритмдік тексеру және алдын ала сүзу қажет.
- Суретке сілтеменің қолжетімсіздігі: HTTP немесе авторизация талап ететін сілтемелер 200 кодын қайтармаса сурет қабылданбайды. Суреттерді HTTPS пен тұрақты URL арқылы беру немесе кабинеттің ішіне жүктеу керек.
- Баға форматындағы қателер: Десимал бөлгіштің («,» немесе «.») дұрыс қолданылмауы, валюта көрсетілмеуі. Шешімі — шаблонға сай форматтау және тестілеу.
- Файл көлемі немесе уақыттың таусылуы: Үлкен файлдарды бірден жіберу орындалмай қалуы мүмкін. Шешімі — файлды батчтарға бөліп жіберу немесе API‑дан партиямен жүктеу.
- Маппингтің дұрыс еместігі: Атрибуттар сіздің ішкі жүйеңізде басқа атаумен болса, платформа талап ететін өрістер толтырылмайды. Шешімі — тұрақты маппинг кестесін жасау және оны документациялау.
Дұрыс шығарып алу және жүктеу үшін практикалық кеңестер мен чек‑лист
- Бірінші қадам — кішкене таңдамалы тест файлмен процесс пен валидацияны тексеріңіз.
- Файл кодировкасын нақтылаңыз: көбінесе UTF‑8, кейде CP1251 талап етіледі.
- SKU бірегейлігін қамтамасыз етіңіз және негізгі сәйкестендіргішті өзгермеуші етіңіз.
- Санаттар үшін Kaspi идентификаторларын қолданыңыз, тек мәтінге сенбеңіз.
- Суреттерге тек тұрақты HTTPS URL беріңіз; қажет болса файлды кабинеттің ішіне немесе CDN‑ге орналастырыңыз.
- Ұсақ өзгерістер үшін дифф/инкременталды жүктеуді қолданыңыз, толық дампты тек үлкен өзгерістерде ғана жіберіңіз.
- Жіберілгеннен кейін келетін валидация есептерін автоматты түрде талдап, алынған қателер бойынша әрекет ету процесін жоспарлаңыз.
- Автоматтандыруды енгізгенде кестелер мен триггерлер арқылы версиялау және откат (rollback) мүмкіндігін сақтаңыз.
- ETL немесе интегратор (AWW сияқты) қолданса — маппинг пен трансформация логикасын доку мен конфигурациялаңыз.
Техникалық жайттар және интеграция бойынша ұсыныстар
- API қолданғанда токендерді қауіпсіз сақтаңыз, мерзімін бақылап, автоматты жаңарту механизмін орнатыңыз.
- Рейт‑лимиттер мен тайм‑ауттарды ескеріп, retry‑механизм ұйымдастырыңыз; idempotency (қайталанатын сұраныстар да бір нәтиже беруі) қағидатын қолданыңыз.
- Партия көлемін (batch size) тестілеңіз: үлкен партиялар сервердің уақытынан асып кетуі мүмкін — 500–5 000 жазба аралығын сынап көріңіз.
- Файл форматтары: CSV үшін бөлгіштің (,) немесе (;) екеніне назар аударып, өрістерді кавычкалармен қоршау, escape ережелерін ұстаныңыз; Excel (.xlsx) форматында кестелердің дұрыс парақта екеніне көз жеткізіңіз.
- Баға дәлдігін және валюта көрсетуді бірдей ұстаңыз (мысалы, KZT, ондық бөлшек нүктесі). Дата/уақыт форматында ISO стандартын қолдану ұсынылады.
- Өзгерістерді инкременталды жіберіңіз: timestamp немесе updated_at өрісі арқылы өзгеріс тұрған жазбаларды ғана жіберу жүйені үнемдеп, синхрондау жылдамдығын арттырады.
- Логтау мен мониторинг орнатыңыз: сәтсіз жүктемелер, қателер және уақыттан асулар туралы хабарламалар болсын.
- Тесттік ортада (staging) толық түрде тексеріп, өзгерістерді бірден production‑ке жібермей бұрын сынаңыз.
Қысқаша қорытынды және практикалық кеңес
Каталогты дұрыс ұйымдастыру — карточкалардың көрінуі, тапсырыстардың орындалуы және сатылымдардың өсуі үшін негізгі элемент. Бастапқыда маппинг пен шағын тесттен бастап, кейінірек автоматтандыру мен мониторингті енгізіңіз. Практикалық кеңес: алғаш жүктеуді шағын бөліктен өткізіп, алынған валидация есептерін талдап барып масштабтаңыз.
Часто задаваемые вопросы
- Массовая жүктеу кезінде қандай кодировка мен файл форматты қолдану керек Kaspi.kz үшін?
- Сатушы кабинеті қолдайтын форматты қолданыңыз — көбінесе CSV ( үтір немесе нүктелі үтір бөлгіш ), Excel (.xlsx) немесе платформаның XML шаблоны. Кодировка ретінде жиі UTF-8 талап етіледі, бірақ кейбір кабинеттер CP1251 қабылдауы мүмкін — нақты интерфейс талаптарын алдын ала тексеріңіз. Қате кодировка атаулар мен сипаттамаларды бұзады, сондықтан әрқашан шағын тест жасаңыз.
- Валидация есебінде қателер шықса (мысалы, «қате санат» немесе «EAN жоқ»), не істеу керек?
- Толық есепті жүктеп, қателер көрсетілген жолдар бойынша жазбаларды түзетіңіз; бастапқы файлды немесе интегратордағы маппингті өзгертіп, тек түзетілген жолдарды қайта жіберіңіз. Егер платформа бір бөлігін қабылдаса, статустарды синхрондап және категориялар бойынша міндетті атрибуттарды тексеріңіз. Үлкен көлемдегі түзетулер үшін скрипт немесе ETL‑құрал арқылы автоматтандыру енгізіңіз.
- Қалдықтар мен бағаларды қаншалықты жиі синхрондау керек және қай әдісті таңдау — FTP, API немесе қолмен жүктеу?
- Шағын ассортимент үшін күніне бір рет қолмен немесе жоспарлы FTP/HTTP жаңарту жеткілікті. Динамикалық қимылдар мен жиі өзгеріп тұратын баға/қалдықтар үшін API‑интеграция қажет — нақты уақыт немесе бірнеше минут аралығы ұсынылады. API кідірісті азайтады және бәсекелестік жағдайында қателерді төмендетеді; FTP/CSV болса, аз критикалық тауарлар үшін жарайды. Әдісті көлем, айналым жылдамдығы және есеп жүйеңіздің мүмкіндігіне қарай таңдаңыз.
- Суреттерді дұрыс қалай беру керек және «сурет сілтемесі қолжетімсіз» қатесі шықса не істеу керек?
- Суреттерге тікелей ашық HTTPS сілтемелер беріңіз, URL 200 статусын қайтаруын және авторизация талап етпеуін тексеріңіз. Kaspi талаптарына сәйкес формат пен өлшемді ұстаныңыз; қажет болса суреттерді CDN‑ге немесе тұрақты сақтаушы сервиске орналастырыңыз. Егер сілтеме қолжетімсіз болса, суретті сатушы кабинетінен жүктеп көріңіз немесе URL‑ды түзетіп қайта тексеріңіз.
- Массалық жүктеу кезінде санаттарды және міндетті атрибуттарды қалай дұрыс сәйкес келтіру керек?
- Тек мәтіндік атауға сенбей, Kaspi‑ның санат идентификаторларын қолданыңыз және өз номенклатураңыз бен платформаның санат ағашы арасындағы маппинг жасаңыз. Әр санат үшін міндетті атрибуттарды (өлшем, түс, шығу елі және т.б.) толтырыңыз, әйтпесе жазбалар қабылданбайды. Үлкен каталог үшін маппингті ETL‑құралда автоматтандырып, тесттік таңдауда тексеріңіз.
