Кез келген нәрсені қосу
HTTP кіреді, HTTP шығады, қиын бөліктер өңделген
Әрбір автоматтандыру құралы интеграциялар санын жариялайды. Бұл сан әрқашан үлкен және әрқашан дұрыс емес сұрақ, себебі сізге шыны керек жүйе — 2014 жылы кетіп қалған біреу ішкі күшпен жасаған жүйе. Маңыздысы — құралдың олардың барлығының астындағы хаттаманы қаншалықты жақсы меңгергені.
Дайын байланыстар
Көптеген бизнестер жүргізетін қосымшалардың дайын қадамдары бар: дүкендер мен маркетплейстер, бухгалтерия мен шот-фактура, кестелер мен дерекқорлар, күнтізбелер мен пошта, сақтау орны мен хабар алмасу, CRM және helpdesk, төлем провайдерлері мен жеткізу операторлары. Аккаунты бір рет рұқсат етесіз және өрістер қосымшаның өз тілінде аталады, оның JSON тілінде емес.
Қосымшаның поляк нарығына тән ерекшелігі болса — KSeF-ке дайын болуы тиіс шот-фактура жүйесі, этикеткалары ұлттық стандарт болып табылатын оператор — дайын қадам оны біледі, себебі отбасы сол нарыққа сатады және үйренуге тура келген.
Ал содан кейін жалпы жағдай
Қалғанының бәрі — HTTP қадамы, және мұндағы HTTP қадамы жұбату сыйы емес. Ол дайын байланыстар салынған сол машиналық, өзіңіз жазуы қиын шақтарды өңдеу де сол.
Шаршататын бөліктер
Өңделген, сондықтан оларды қайта жазбайсыз
Түпнұсқалықты растау
API кілттері, bearer токендер, basic auth, жаңартуы бар OAuth 2, HMAC сұраныс қолтаңбасы, өзара TLS. Растақырық бір рет сақталады, атауымен сілтемеленеді және ешқашан журналға немесе жұмыс жазбасына шығарылмайды.
Беттерге бөлу
Курсорлар, бет нөмірлері, офсеттер, Link тақырыптары және бос массив қайтарап соңын білдіретін API. Қандай пішін екенін айтыңыз, қадам бүкіл жиынды аралайды.
Сұраныс шектеулері
Бір байланысқа белгіленген шек, оны пайдаланатын әрбір workflow-да сақталады. Провайдер Retry-After тақырыбымен 429 жауап берсе, қадам қайталап соғып тұрмай, сол уақытқа дейін күтеді.
Қайталаулар және ұлғаймалы күту
Уақытша сәтсіздіктер ұлғайып отыратын кідіріспен және шекпен қайта жасалады. Қадам өз кірістерінің таза функциясы болғандықтан, қайталау бүкіл іске қосуды емес, тек сол қадамды қайта жүргізеді.
Қиын деректер пакеттері
JSON, форма кодтауы, XML, қарапайым мәтін, multipart жүктеулер. Жауаптар атауымен сілтеме жасауға болатын өрістерге талданады, төрт деңгей тереңдікте жатқандарын да қоса.
Уақыт шектеулері
Әр қадамға белгіленген шек, сондықтан баяу тәуелділік бір жұмыскерді ұстап тұрып, артындағының бәрін кезекте қалдыра алмайды. Шек асқанда не болатынын әр қадам бойынша сіз өзіңіз шешесіз.
Егер ол HTTP тілінде сөйлесе, әңгіме әлдеқашан басталып қойған.
Кіріс вебхуктар — толыққанды қарастырылған
Әрбір workflow-ның оны іске қосатын URL мекенжайы болуы мүмкін. Бұл URL қолтаңбаларды тексереді — кең таралған провайдерлер қолданатын HMAC нысандарын және жіберушінің мүмкіндігі соған ғана жететін жағдайда ортақ құпиясөзді. Қолтаңба күтетін workflow-ға жасалған қолтаңбасыз сұраныс қабылданбайды және тіркеледі, үнсіз өңделмейді.
Дедупликация пакеттің өз идентификаторы бойынша жасалады, сондықтан сіздің 200 жауабыңызды уақытында көрмегені үшін қайталап жіберген жіберуші үш іске қосудың орнына біреуін ғана алады. Бұзылған пакеттер қабылданбау себебімен бірге сақталады, өйткені автоматтандырудағы жұмбақ ақаудың ең жиі себебі — жіберушінің бір өріс туралы ойын өзгертуі.
Тек CSV тілінде сөйлейтін жүйелер
Олар бар. Түн сағат төртте SFTP серверінде файл пайда болады, немесе тіркемемен келеді, немесе ортақ қалтаға түседі. Workflow оны бақылап, оқып, әр жолды жазба ретінде қарастыра алады — байт-белгісі бар, нүктелі үтірмен бөлінген және поляк тіліндегі тақырып жолы бар файлды да қоса, өйткені экспорт шын мәнінде дәл осылай көрінеді.
Кері бағытта да жұмыс істейді: workflow файл құрастырып, оны екінші жүйе күтетін жерге қоя алады, бұл 2006 жылғы бағдарламалық жасақтаманың жиі жалғыз интерфейсі болып табылады.
- ⚡ТриггерЖеткізушінің SFTP-сында жаңа файл:
stock-2026-09-09.csv. - 2ТалдауНүктелі үтіірлер, байт-белгісі, поляк тақырыптары. 4 118 жол.
- 3НормалауВалюта кодтары анықтамалық деректермен тексерілді; екеуі жарамсыз деп қабылданбады.
- 4Жүктеп салуHTTP
PATCH200-ден топтап жіберілді, сұраныс шегі сақталды. - !Ерекше жағдайларЕкі жол бір адамға қатысты жеке файлға берілді, жол нөмірі мен себебі көрсетілген. Қалған 4 116 жол өтті.
Модельге қоңырау шалған қадамдар: 0Осы іске қосудың құны: ештеңе
Тіркелгі деректері қайда сақталады
Шифрланған, атауымен сілтеме жасалған, оларға ие жұмыс кеңістігіне шектелген және ешқашан іске қосу журналына, қате хабарламасына немесе қолдау көрсету әңгімесіне шығарылмайды. Іске қосу жазбасы қадамның supplier-sftp ретінде аутентификацияланғанын көрсетеді; supplier-sftp дегеніміз не екенін көрсетпейді.
Отыз клиентке бір workflow жүргізетін агенттік әр клиентке өз тіркелгі деректерін береді, ал workflow құпиясөздің өзін емес, сол жиынды сілтемейді. Кілтті ауыстыру — бір жерде жасалатын бір өңдеу, агенттіктердің осында келуінің басты себебі де осы.
Білуге тұратын шек: мүлде интерфейсі жоқ жүйе — API-і де, вебхугы да, файл түсіретін жері де жоқ, тек браузерде басатын адам ғана бар — мұнымен де, адал ешбір тәсілмен де автоматтандырылмайды. Мұнда қолданушының орнына жүретін headless браузер жоқ, өйткені ол қарсы жақ батырмасын бірінші ауыстырғанда-ақ үзіледі, және үнсіз үзіледі.