оргсофт интеграциялары: маркетплейстер, CRM және интернет-дүкендер

1. Алмасуды қалай ұйымдастыру керек және кім не үшін жауап береді

Адаптер — Торгсофт файлдарын сыртқы сервис API-іне сұрауларға түрлендіретін және Торгсофт үшін жаңа тапсырыстар файлдарын дайындайтын жеке бағдарлама немесе сайт модулі. Платформаның API-і оның тауарларымен, тапсырыстарымен немесе контактілерімен рұқсат етілген операцияларды ұсынады. Фид — сервис сілтеме арқылы жүктеп алатын немесе өзінің импорттау механизмі арқылы қабылдайтын каталог файлы.

Қосылым екі бөліктен тұрады. Интегратор Торгсофтта экспорт пен импортты баптайды. Әзірлеуші сайт, CRM немесе маркетплейс жағынан үйлесімді модуль жасайды немесе орнатады. Опцияны белсендіру Торгсофт мүмкіндіктерін оның құжаттамасы аясында қамтамасыз етеді; үшінші тарап алмасу сервисі деректерді түрлендіреді және таңдалған платформаның API-імен жұмыс істейді.

Бір адам бірнеше рөлді атқара алады. Әрбір учаскеге арналған техникалық тапсырмада жұмысты тексеретін орындаушы мен нәтиже бәрібір анықталады.

Деректерді беру бағыттары

Қосылудың үш тәсілі

1. Штаттық интеграция. Иесі опцияны немесе ТОМ модулін белсендіреді, интегратор оны нұсқаулыққа сәйкес баптайды. Операциялар тізімі қосылым құжаттамасымен анықталады.
2. Үшінші тарап адаптері. Интегратор Торгсофт файлдық алмасуын дайындайды, әзірлеуші платформаның API немесе фидімен жұмыс істейді және тапсырыс файлдарын жасайды.
3. Сайт немесе CRM арқылы қосылу. Торгсофт басқа арналарға коннекторлары бар бір жүйемен деректер алмасады. Әзірлеуші барлық буындар үшін тапсырыстар маршрутын, қалдықтар көзін және резервтеу ережелерін анықтайды.

Әрбір арна үшін тапсырыстың Торгсофтқа түсуінің бір маршруты анықталады. Мысалы, маркетплейс тапсырыстары тікелей адаптер арқылы немесе CRM арқылы беріледі. Екі маршрут бойынша бір уақытта импорттау дубликаттарды болдырмайтын ортақ механизмді қажет етеді.

2. Торгсофтта нені дайындау керек және оның файлдарын қалай оқу керек

Адаптердің негізі интернет-дүкенді Торгсофтпен синхрондау форматы болып табылады. Баптаулар опция нұсқаулығында сипатталған. Әзірлеуге дейін интегратор әзірлеушіге тауарлардың нақты файлын, экспорттау баптауларын және дерекқор нұсқасының нөмірін береді.

2.1. Синхрондау объектісін дайындау

1. «Интернет-дүкенмен синхрондауды» белсендіріп, Қойма → Интернет-дүкенмен синхрондау бөлімін ашыңыз.
2. Арна атауымен объектіні жасаңыз. Экспорттау үшін есепке алу орталықтарын және тапсырыстар рәсімделетін орталықты таңдаңыз.
3. Шот үшін баға көзін анықтаңыз: Торгсофт немесе интернет-дүкен. Платформада сатып алу бағасын сақтау үшін «Шот тауарлары үшін бағаларды алу» параметрін тексеріңіз.
4. Резервтеуді, жоқ мөлшерді өңдеуді және төлемдерге арналған шотты немесе кассаны келісіңіз.
5. Өрістерді, файл атауларын, кодтауды, клиенттерді беруді және фотосуреттерді жеткізу тәсілін орнатыңыз.
6. Алмасу мекенжайын баптап, тестілік тауарларды қолмен жіберіңіз және бір тапсырысты жүктеңіз.
7. Тексергеннен кейін кестені және жауапты қызметкерге хабарламаларды қосыңыз.

«Клиенттер» қойындысында телефон арқылы іздеу, жаңа клиенттерді жасау және олардың деректерін жаңарту тексеріледі. Әзірлеуші телефонды келісілген халықаралық форматта жібереді. Телефон арқылы іздеу тапсырыс кілтін ауыстырмайды және құжаттың қайта жасалуынан қорғамайды.

2.2. Файлдарды жеткізу: SSL/TLS бар FTP немесе веб-сервер каталогы

«Web-сервер» түрі көрсетілген каталогтағы файлдармен жұмыс істейді. Ол Торгсофт үшін әмбебап REST API жасамайды. SFTP — басқа хаттама; оның Make, n8n немесе маркетплейсте қолдау табуы таңдалған Торгсофт жеткізу тәсілінде қолдау бар екенін білдірмейді.

Тауар фидінің, тапсырыстардың, контактілердің және сертификаттардың каталогтары кіру құқықтары бойынша бөлінеді. Жарнама жүйесінің ашық URL мекенжайының артында тек рұқсат етілген тауар файлы мен суреттер орналастырылады.

2.3. Тауарлар, бағалар, қалдықтар және фотосуреттер

TSGoods.trs — бұл ; бөлгіші бар CSV үшін типтік атау. Өрістер, олардың атаулары, реті, тақырыбы және файл атауы бапталады. Балама формат — YML, тиісті тегтер құрылымы бар XML-каталог.

CSV парсері нақты экспорт бойынша бапталады: бөлгіш, тақырыптар, кодтау, тырнақшалар және сандар. Арнайы таңбалар тестілік файлда тексеріледі. UTF-8 режимінде Торгсофт файлдың басындағы қызметтік кодтау белгісі — BOM бар тауар CSV жасайды; адаптер оны өңдеуі керек.

Торгсофттың YML-і әрбір сервис үшін дайын фид емес. Әзірлеуші түбірлік элементті, міндетті тегтерді, сипаттамаларды, тілдерді және алушының ID-ін тексереді. Мысалы, Hotline өзінің XML құрылымын пайдаланады, ал маркетплейстер категория кодтары мен сипаттама мәндерін қажет етеді.

2.4. Жаңа тапсырыс форматы

Торгсофт .sal мәтіндік файлдарын қабылдайды. ДҚ-ның 493 нұсқасынан бастап UTF-8-дегі XML және JSON да қолдау табады. SAL үшін синхрондау объектісінің кодталуы қолданылады; UTF-8 режимінде BOM қажет. Файл атауы ASCII таңбаларынан құралады: латын әріптері, сандар және қауіпсіз бөлгіштер.

API деректері Торгсофт схемасына түрлендіріледі: сатып алушы Client ішіне, параметрлер — Options ішіне, позициялар — Goods ішіне түседі. Міндетті өрістер: Client.Name, Options.OrderNumber, Options.SaleType және әр тауар үшін GoodID, Price, Count.

Алдын ала тапсырысқа арналған шартты деректері бар JSON мысалы:

{
  "Client": {
    "Name": "Тестілік сатып алушы",
    "MPhone": "+380670000000",
    "EMail": "buyer@example.com"
  },
  "Options": {
    "OrderNumber": "SHOP-A-100042",
    "SaleType": "1",
    "OrderDate": "2026-10-05 12:00:00",
    "CurrencyInternationalCode": "UAH",
    "Comment": "Сыртқы арнаның тестілік тапсырысы"
  },
  "Goods": [
    { "GoodID": "201", "Price": "1290.00", "Count": "1" },
    { "GoodID": "202", "Price": "350.00", "Count": "2" }
  ]
}

Жүктемес бұрын интегратор тестілік базаның нақты GoodID-лерін ауыстырады және бағдарламадағы құжаттарды тексереді. Әзірлеуші арна кодынан, дүкеннен және сыртқы ID-ден тұрақты OrderNumber жасайды. Түрлі тапсырыстар мен дүкендердің нөмірлері сәйкес келмеуі керек.

Қосымша өрістер мекенжайды, жеткізуді, резервтеу күнін, валюта кодын, сауда түрін және есепке алу орталығын береді. Қолжетімділік ДҚ нұсқасына байланысты. WarehouseID Торгсофттан алынады; маркетплейс қоймасының коды сәйкестендіруді қажет етеді. Жалпы параметрлердегі және тауар жолындағы WarehouseID-дің мақсаты алмасу форматында сипатталған.

2.5. SaleType: импорт қандай құжаттар жасайды

SaleType 2–5 үшін құжаттама есепке алу орталығында барлық қажетті мөлшердің болуын қарастырады. Тауар жоқ болған жағдайда сатылым минусқа кетуі мүмкін. Құжаттарды автоматты түрде жасамас бұрын, санды және ол жетіспеген жағдайдағы әрекеттер ережелерін тексереді.

«Төленді» пікірі төлемді жүргізбейді. SaleType төлем сервисінде қаражатты қайтаруды орындамайды. Әзірлеуші мен интегратор платформа оқиғасын, құжат түрін, түсім шотын және қызметкердің одан әрі әрекеттерін келіседі.

2.6. Клиенттер, көтерме бағалар және сертификаттар

Баптау бойынша Торгсофт TSClients.trs экспорттайды: ТАӘ, контактілер, мекенжай, клиент карточкасы, жеңілдік, оны есептеуге арналған сома және жинақталған бонустар. Әзірлеуші сәйкестендіру кілтін анықтайды және алушыға тек қажетті өрістерді береді. Сатып алу тарихы бұл файлға кірмейді.

«Көтерме бағалар саясаты» опциясы мөлшер шектері мен бағалары бар XML қосады. Сертификаттар үшін TSGiftCertificate.trs CSV қарастырылған. Алушы бағалардың немесе лоялдылықтың тиісті ережелерін іске асыруы керек.

Пайдаланылған бонустар мен сертификаттар тапсырыста BonusPay және GiftCertificate арқылы беріледі. Интегратор қажетті опциялар мен баптауларды белсендіреді; әзірлеуші төлемес бұрын келісілген процесс бойынша өзекті деректерді тексереді. Команда Торгсофттағы соңғы есептен шығаруды және сатып алудан бас тарту ережелерін салыстырып тексереді.

Бонустар мен сертификаттарды экспорттау жасалу кезіндегі кесінді болып табылады. Бірнеше арнада лоялдылықты пайдалану үшін тексеру және есептен шығарудың келісілген процесі қажет. Файлдың өзі сертификатты басқа дүкенде қайта пайдалануды бұғаттамайды.

2.7. Кесте, POST-хабарламалар және импортты растау

Тауарлар мен тапсырыстардың бөлек тапсырмалары болуы мүмкін. Интегратор синхрондау түрін және орындаушыны таңдайды: Торгсофт немесе автоматты тапсырмалар сервері. Бағдарламамен іске қосу үшін көрсетілген компьютерде көрсетілген пайдаланушымен ашық бағдарлама болуы қажет. Фондық жұмыс үшін қызмет, оның нұсқасы, құқықтары және файлдарға қолжетімділік тексеріледі.

Интервал анықтамалықтың ұсыныстарына сәйкес орнатылады: басқа объектілерді ескере отырып, 10 минутта бір реттен жиі емес. Әзірлеуші API сұрауларының жиілігін бөлек баптайды. Платформадан жиі сұрау жасау файлды Торгсофтқа кестеден тыс импорттауды тездетпейді.

«Синхрондаудан кейін POST-сұрауын жіберу» алмасудың аяқталғаны туралы сайтқа хабарлайды. Әзірлеуші URL мекенжайын, атауын және параметр мәнін ұсынады; интегратор оларды бағдарламада орнатады. Сұрау үшін соңғы тайм-аут, рұқсат етілген User-Agent және қайта бағыттау орнатылады. 0 тайм-аут шексіз күтуді білдіреді.

Бұл хабарлама барлық сатылым немесе қайтару оқиғаларының ағыны емес. Одан кейін адаптер дайын файлдарды оқиды. Сыртқы платформаның Webhooks-ын адаптердің өзінің HTTP-өңдеушісі қабылдайды.

FTP-сценарийінде тапсырыс файлы жергілікті түрде жүктеледі және FTP-ден жойылады, содан кейін бағдарламамен өңделеді және сәтті импортталғаннан кейін жергілікті түрде жойылады. Файлдың FTP-ден жоғалуы құжаттың жасалуын растамайды. Жергілікті каталогтағы қате файл одан әрі импорттауға кедергі келтіруі мүмкін; интегратор журналды және құжаттарды тексереді.

3. Штаттық интеграциялар және ТОМ мүмкіндіктері

Бұл сценарийлер үшін Торгсофт функциялары немесе мамандандырылған опциялар қолданылады. Иесі сыртқы сервисте рұқсат алады, интегратор режимді баптайды. Қолдау қосылудың құжатталған операцияларын қамтиды.

Құжаттама: Торгсофт интеграциялары, бағдарлама анықтамалығы, банк көшірмелері.

Дайын Торгсофт Онлайн Маркет модульдері

Торгсофт Онлайн Маркет, ТОМ — Торгсофтпен бірге жұмыс істейтін интернет-дүкен платформасы. Рұқсаттар, төлемдер, фидтер және сыртқы ресурстар ТОМ панелінде бапталады. Оның интеграциялары дүкен деректеріне қатысты және Торгсофттың барлық құжаттары үшін API жасамайды.

4. Интернет-дүкен платформалары

CMS үшін сайт позицияларын Торгсофт тауарларымен сәйкестендіретін, келісілген өрістерді жаңартатын және жаңа тапсырыстарды беретін модуль қажет. Иесі дүкенге рұқсат береді және қойманы анықтайды. Интегратор файлдық алмасуды дайындайды. Әзірлеуші үйлесімді коннектор орнатады немесе платформа API-іне адаптер жасайды.

Іске қоспас бұрын тауар карточкаларын кім жасайтынын және сипаттамаларды басқаратынын бекітіңіз. Қазірдің өзінде толтырылған сайт үшін тек бағалар мен қалдықтарды беруге болады. Егер карточкаларды адаптер жасайтын болса, оған қосымша категориялар, сипаттамалар, нұсқалар, фотосуреттер және жариялау ережелері қажет.

5. Маркетплейстер және хабарландыру сервистері

Prom.ua, Rozetka және Satu.kz штаттық опциялар арасында қаралған. Бұл кестедегі платформалар үшін үшінші тарап адаптерінің жұмысы сипатталған. Иесі алдымен сатушы кабинетін және қажетті операцияларға кіруді рәсімдейді. Әзірлеуші қосымша рұқсаттарын, категория талаптарын, баға және мөлшер форматын тексереді, ал интегратор Торгсофт алмасуын дайындайды.

Жасалған ұсыныстардың бір бөлігін жаңарту үшін тек артикулды, атауды және бағаны беру жеткілікті. Жаңа карточканы жариялау үшін платформаның барлық міндетті атрибуттары қажет. Тауар файлында жоқ деректер сәйкестіктер кестесінде немесе адаптер анықтамалықтарында сақталады.

Маркетплейстің міндетті сәйкестіктері

• Тауар: Торгсофт GoodID → сатушы SKU-ы → ұсыныс пен оның нұсқасының ID-і. Жинақ үшін құрамы және санды қайта есептеу ережесі сақталады.
• Қойма: есепке алу орталығы → платформаның warehouse/location/storefront-ы. Маркетплейс қоймаларынан сату өз қоймаларынан бөлінеді.
• Тапсырыс: арна + сатушы кабинеті + сыртқы ID → OrderNumber. Нөмір барлық қайта алуларда өзгеріссіз пайдаланылады.
• Баға: валюта, салықтар, акциялық және нақты сатып алу бағасы. Платформа комиссиясы тапсырыстағы тауарлар сомасын автоматты түрде азайтпайды.
• Күй: қандай мәртебелер импорттауға, резервтеуге, төлеуге, жөнелтуге және қолмен бас тартуға рұқсат береді. Әртүрлі жүйелердің мәртебелерінің өз мәндері бар.

6. Тауар каталогтары және жарнамалық арналар

Бұл сервистер ұсыныстарды көрсету үшін тауар деректерін алады. Тапсырыс белгіленген сатылым арнасында рәсімделеді, сол жерден ол Торгсофтқа беріледі. Иесі бизнес-кабинет пен сайтты дайындайды; әзірлеуші фид жасайды немесе дайын дүкен модулін пайдаланады; маркетолог диагностика мен жарнаманы тексереді.

Фид толығымен жарияланады: әзірлеуші құрылымды, позициялар санын және сілтемелердің қолжетімділігін тексереді, содан кейін жұмыс нұсқасын ауыстырады. Сыртқы сервис ағымдағы ұсыныстарды жариялаудан алып тастамауы үшін, бос немесе толық емес файл себебі анықталғанша бұғатталады.

7. CRM және көп арналы сатылымдар

CRM сайттар мен маркетплейстердің тапсырыстарын біріктіре алады. Мұндай схема үшін CRM мен Торгсофт арасында жеке көпір қажет. CRM-де арналарға коннекторлардың болуы бұл көпірді автоматты түрде баптамайды.

Иесі қалдықтар көзін және резервтеу тәртібін анықтайды. Әзірлеуші тапсырыстарды жинайды, бастапқы арна мен ID сақтайды, тауарларды сәйкестендіреді және Торгсофт файлын жасайды. Интегратор нәтижелі құжаттарды тексереді. Тапсырыс импортталып, есепке алу қорына әсер етпегенше, адаптер немесе CRM оны арнаның келісілген резервінде ескереді.

Мәртебелерді қалай бөлуге болады

Әзірлеуші сәйкестіктер кестесін жүргізеді: CRM мәртебесі, импорт шарты, SaleType және менеджер әрекеті. Мысалы, расталған төленбеген тапсырыс жөнелтусіз шот жасай алады. Қазірдің өзінде жасалған шотты нақты төлегеннен кейін, менеджер немесе жеке қолдау көрсетілетін механизм төлемді тіркейді. Сол тапсырысты жаңа шот ретінде қайта импорттау алынып тасталады.

Импортталғаннан кейінгі бас тартулар мен қайтарулар салыстырып тексеру кезегіне түседі. Жауапты қызметкер Торгсофт құжаттарын өзгертеді және операцияның аяқталғанын растайды. Бұл кезеңді автоматтандыру құжатпен жұмыс істеудің нақты қолдау көрсетілетін тәсілімен ғана қосылады.

8. Таратылымдар, телефония және мессенджерлер

SMS, Viber, электрондық хаттар және телефония үшін алдымен 3-бөлімдегі Торгсофттың штаттық баптаулары тексеріледі. Маркетингтік платформалар үшін әзірлеуші рұқсат етілген контактілер экспортын пайдаланады. Иесі беру мақсатын, хабарламалар жіберу негізін және жазылымнан бас тарту тәртібін анықтайды.

Мессенджердің Webhook-ын адаптер қабылдайды. Ол оқиғаны тексереді, оны журналға сақтайды және платформаға жауап береді. Торгсофтқа арналған файл тапсырыс тексерілгеннен кейін жасалады. Бұл құжатты қайта жасамай-ақ оқиғаны қайта өңдеуге мүмкіндік береді.

Binotel телефонияның штаттық сценарийі аясында қолданылады. Қоңырауды CRM немесе бөлек ботпен байланыстыру үшін өз маршруты және сөйлесулер деректеріне кіру құқықтары анықталады. Сатып алушының телефон нөмірі оның тапсырысының идентификаторы емес.

9. Төлемдер және жеткізу

9.1. Онлайн төлем және банк көшірмесі

LiqPay, Portmone және monobank-қа арналған ТОМ модульдері және штаттық банк көшірмелері 3-бөлімде келтірілген. Басқа сайт үшін төлем провайдері сайт жағынан қосылады. Әзірлеуші төлем нәтижесін растайды, ал интегратор оның Торгсофтта көрсетілуін келіседі.

Егер жаңа тапсырыс қазірдің өзінде расталған толық төлеммен алынса, ол үшін SaleType=2 келісуге болады. Автоматты есепке алу жөнелту үшін бөлек келісілген SaleType=3 сценарийі қажет. Егер шот Торгсофтта жасалған болса, кешіктірілген төлем бұл тапсырысты жаңа ретінде қайта жүктеуге негіз болмайды.

Ішінара төлемдер, кейін төлеу, комиссиялар, қайтарулар және сомалардың сәйкессіздігі бөлек ережелер бойынша өңделеді. Интегратор түсім шотын көрсетеді, менеджер сатылым сомасын төлеммен, бухгалтер — провайдердің төлемімен салыстырып тексереді. Ұсталған комиссия және банкке түскен сома сатып алынған тауарлардың бағасын автоматты түрде өзгертпейді.

9.2. Жеткізу деректерін беру

Сату құжаты мен көлік жүкқұжатының (ТТН) мақсаты әртүрлі. Жеткізу үшін иесі тасымалдаушының аккаунтын ресімдейді. Әзірлеуші мекенжай деректерін және сыртқы идентификаторларды береді; интегратор ТТН қайда жасалатынын және қызметкер оны Торгсофтта қалай көретінін анықтайды.

Сәйкестендіруді қажет ететін Нова пошта өрістері

NewPostDeliveryOptions ішінде RecepientType, ТАӘ және телефон беріледі. Бөлімшеге жеткізу үшін WarehouseRef немесе қала және бөлімше нөмірі пайдаланылады. Егер WarehouseRef берілсе, бұл іздеу үшін қала мен бөлімше нөмірі қажет емес. Мекенжайға жеткізу үшін көше, үй және пәтерге арналған тиісті өрістер толтырылады.

Егер DeclarationNumber толтырылған болса, бұл блоктың басқа өрістері еленбейді: бар ТТН пайдаланылады. Оны жүктеу шығыс жүкқұжатымен — SaleType 3 немесе 4 — немесе алдын ала тапсырыстан шот қалыптастырғаннан кейін импорттау үшін қарастырылған. Интегратор бұл процесті өз сценарийінде тексереді.

10. Аналитика және файлдарды автоматтандыру

Аналитикалық сервисқа белгіленген деректер жиынтығы беріледі: каталог, қалдықтар, клиенттер немесе экспортталған есеп. Әзірлеуші мен аналитик өріс атауларын, кесінді (snapshot) күнін, валютаны және кезеңді келіседі. Тауар файлы сатылымдардың толық тарихының көзі ретінде пайдаланылмайды.

Есепті тұрақты экспорттау үшін интегратор оны Торгсофтта қалыптастыру тәсілін бөлек анықтайды. Әзірлеуші тек файлдық синхрондаудың болуы негізінде базаның кез келген деректеріне автоматты түрде қол жеткізуді жоспарламайды.

11. Сенімділікті, қауіпсіздікті және сүйемелдеуді қалай қамтамасыз етуге болады

11.1. Сәйкестіктерді тауар атауынан бөлек сақтау

Әзірлеуші сәйкестіктер үшін тұрақты қойма жасайды. Тауар атауы өзгеруі мүмкін, ал штрихкод барлық жазбалар үшін әрқашан бірегей бола бермейді. Бастапқы сәйкестендіру алдында интегратор анықтамалықты тексереді; келісілмеген сәйкестіктер автоматты түрде біріктірілмейді.

11.2. Қалдық үшін бірыңғай ережені анықтау

Интегратор әзірлеушіге экспортталатын мөлшердің құрамында дәл не бар екенін көрсетеді: физикалық қор немесе ескерілген резервтерге азайтылған қолжетімділік. Әзірлеуші әр арна үшін есептеуді құжаттайды.

Бірнеше тауардан тұратын жинақ үшін әзірлеуші жинақ құрамы бойынша жинақтар санын есептейді. Бөлшек тауар үшін өлшем бірлігін және платформаның рұқсат етілген дәлдігін тексереді. Нөлдік мөлшер қолжетімділікпен келісілген әрекетті білдіреді, ал карточканы жою тек жеке ереже бойынша орындалады.

11.3. Файлды жарияламас бұрын тапсырысты тексеру

1. Дереккөзді, аккаунтты, сыртқы ID және рұқсат етілген мәртебені тексеру.
2. Әрбір позиция үшін GoodID табу. Белгісіз SKU болған жағдайда бүкіл тапсырысты түзету кезегіне жіберу.
3. Мөлшерді, бірліктерді, валютаны, бағаларды және жеңілдіктерді тексеру. Қорытындыны есептеп, оны платформа деректерімен салыстыру.
4. Жеткізуді, қосымша ақыларды және сыйлықтарды көрсетуді келісу. Егер жеке қызмет пайдаланылса, оның GoodID және есепке алу мінез-құлқын интегратор тексереді.
5. Таңдалған сценарий үшін қажетті сатып алушыны, мекенжайды және тасымалдаушы параметрлерін тексеру.
6. Келісілген кесте бойынша SaleType таңдау және база нұсқасы қолдайтын схема файлын жасау.

Позициясы өткізіп жіберілген немесе тауары белгісіз файл жеке келісілген процесссіз ішінара тапсырыс ретінде жарияланбайды. Қате деректері түзету үшін сақталады; одан кейін сол сыртқы ID пайдаланылады.

11.4. Импортты қайталанудан қорғау

Әзірлеуші журналда «арна + аккаунт + сыртқы ID» бірегей кілтін жүргізеді. Қайталанған оқиға осы жазбаның күйін жаңартады. Жаңа жарияланым алдында адаптер файлдың бұрын берілген-берілмегенін және Торгсофтта құжаттың расталған-расталмағанын тексереді.

Журналдың практикалық күйлері: алынды → тексерілді → файл дайындалды → жарияланды → импорт расталды. Қателер және салыстырып тексеруді қажет ететін жазбалар бөлек жүргізіледі. Соңғы күйдің расталуы нақты интеграцияның нақты қолжетімді механизмімен немесе жауапты қызметкердің тексеруімен анықталады.

FTP-сервермен қабылдану, HTTP 200 және файлды жою құжатты әмбебап растау болып саналмайды. Беру шекарасындағы ақаудан кейін адаптер салыстырып тексеруге дейін бұл тапсырысты қайта жариялауды тоқтатады. OrderNumber мәнінің өзі барлық қайта импорттаулардан қорғаудың құжатталған кепілдігі емес.

11.5. Тек аяқталған файлдарды ғана жариялау

Кіріс тауар файлы қалыптасу аяқталып, құрылымы тексерілгеннен кейін оқылады. POST-хабарлама, кесте немесе шлюз бапталған маршрутқа сәйкес пайдаланылады. Адаптер файлдың тұтастығын бақылайды және толық емес жазбаларды қабылдамайды.

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

Жұмыс тауар фиді келесі нұсқаны сәтті тексергенге дейін сақталады. Тауарлар саны, нөлдік қалдықтар үлесі, міндетті өрістер және файл көлемі салыстырылады. Ассортиментті жоспарлы түрде алып тастау түсіндірмесіз бұғатталмауы үшін аномалия шектері иесімен келісіледі.

11.6. Қателер мен қайталау әрекеттерін бөлу

• Авторизация: тиісті маршрутты тоқтату, әкімшіге хабарлау, платформа ережелері бойынша рұқсатты жаңарту.
• API лимиті немесе уақытша қолжетімсіздік: тапсырманы сақтау және басқарылатын кідіріспен және егер ол берілсе, Retry-After сақтай отырып қайталау.
• Қате деректер: жазбаны түзетуге беру; өзгермеген қате файлды қайта жарияламау.
• Пакеттің ішінара нәтижесі: әрбір тауар үшін жауаптарды оқу және тек рұқсат етілген орындалмаған операцияларды қайталау.
• Анықталмаған импорт нәтижесі: қайталау алдында құжатты салыстырып тексеру.

Мониторинг соңғы сәтті жаңартуды, қалдықтардың жасын, берілмеген тапсырыстардың саны мен жасын, SKU қателерін және мерзімі өткен растауларды көрсетеді. Иесі хабарламалардың әр түрі үшін қызметкерді тағайындайды. Сәтті HTTP коды бар API сұрауы жауап денесіндегі бизнес-қателерге қосымша тексеріледі.

11.7. Рұқсаттар мен жеке деректерді қорғау

• Торгсофт FTP үшін SSL/TLS қосу және нақты шифрлауды тексеру. Адаптердің сыртқы HTTP-интерфейстері HTTPS арқылы жұмыс істейді.
• Кілттер мен құпия сөздерді қорғалған баптауларда сақтау. Оларды жалпыға ортақ фидтердің URL мекенжайларына, репозиторийлерге, хабарламалар мен журналдарға қоспау.
• Минималды құқықтар беру. Өнімдік орта мен сынақтар үшін бөлек рұқсаттарды пайдалану.
• Провайдер нұсқаулығы бойынша webhook қолтаңбасын және авторизацияның өзектілігін тексеру. Оқиғаның қабылданғанын растамас бұрын оны сенімді қоймаға жазу.
• Ортақ каталогты клиенттердің, тапсырыстардың, бонустардың және сертификаттардың файлдарынан бөлу. Сақтау мерзімін және қызметкерлердің қолжетімділігін шектеу.
• Журналдарда артық контакт және төлем деректерін бүркемелеу. Жарнама үшін контактілерді беруді келісім және жазылымнан бас тарту ережелерімен үйлестіру.

11.8. Қолмен және фондық іске қосуды бөлек тексеру

Әкімші мен интегратор Торгсофттың өзекті нұсқасын, автоматты тапсырмалар серверін және осы қосылым үшін жеткізілетін кітапханаларды тексереді. Үйлесімсіз SSL-кітапханалары бөтен сайттардан алынған кездейсоқ DLL-дермен ауыстырылмайды.

Бақылау тапсырысы қолмен және нақты қызмет арқылы іске қосылады. Қызмет пайдаланушысы, құқықтар, каталогтар, тіл және аймақтық баптаулар, желіге кіру және қайта іске қосқаннан кейінгі нәтиже салыстырылады. Сәтті қолмен импорттау фондық тапсырманың жұмысын растамайды.

Бағдарлама нұсқасы, файлдар схемасы, баға белгілеу, сайт модульдері немесе API өзгергеннен кейін негізгі тестілер қайталанады. Әзірлеуші адаптер мен алмасу келісімшартының нұсқаларын жүргізеді; иесі жаңартуларға жауапты адамды анықтайды.

12. Интеграцияны тестілеу және қабылдау жоспары

Опцияның тегін 30 күнін таңдалған сервиспен алмасуды тексеру үшін пайдалануға болады. Алдымен иесі рұқсаттарды рәсімдейді және сценарийді келіседі; одан кейін интегратор опцияны белсендіреді, ал әзірлеуші дайындалған адаптерді іске қосады. Сыртқы платформаның қосымшаны мақұлдауы, оның тарифтері және әзірлеу бөлек ескеріледі.

Бірінші іске қосуға дейін не дайын болуы керек

Жұмыстардың реттілігі

1. Рұқсаттарды тексеру. Әзірлеуші каталог пен тапсырыстарды рұқсат етілген оқуды орындайды, авторизацияны және қажетті операцияларды тексереді.
2. Каталогты тексеру. Интегратор бақылау тауарларын экспорттайды; әзірлеуші жаңа және бар карточкаларды, нұсқаларды, бағаларды және нөлдік мөлшерді тексереді.
3. Тапсырысты тексеру. Әзірлеуші файл береді; интегратор сатып алушыны, әрбір GoodID-ді, мөлшерді, бағаны, валютаны және жасалған құжаттарды салыстырып тексереді.
4. Төлемдер және жеткізу. Менеджер мен интегратор келісілген төлем түрлерін, резервті, жөнелтуді және ТТН-ді тексереді.
5. Бас тартулар және қайталаулар. Команда қайталанған оқиғаларды, рұқсатты жоғалтуды, толық емес файлды, белгісіз SKU-ды және қызметті қайта іске қосуды сынайды.
6. Шектеулі іске қосу. Иесі келісілген ассортимент пен арнаға рұқсат береді; команда бірнеше толық циклді бақылайды және нәтижені салыстырып тексереді.
7. Қабылдау. Иесі нұсқаулықты, тестілер журналын, мониторингке рұқсаттарды және сүйемелдеу тәртібін алады.

Бақылау тестілері

Әрбір тест үшін команда журналға нақты нәтижені, сыртқы ID, OrderNumber және Торгсофт құжатын жазады. JSON мысалы және оның синтаксисін тексеру бағдарламаның орнатылған нұсқасына импорттауды ауыстырмайды.

Жұмысқа бермес бұрын иесі автоматтандырылған операциялар, қолмен жасалатын ерекшеліктер, жаңарту интервалдары және жауапты адамдар тізімін алады. Платформа тарифтері, қажетті опциялар, адаптерді қолдау мерзімі, жаңартулар тәртібі және ақаудан кейін қалпына келтіру бөлек бекітіледі.