Skip to main content
Басты бетБлогНұсқаулықтарЛогистикалық технология платформалары жөнелтілімдерді бақылауды өз өнімдеріне қалай енгізе алады

Логистикалық технология платформалары жөнелтілімдерді бақылауды өз өнімдеріне қалай енгізе алады

17TRACK

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

Логистика технологиялары платформалары жөнелтілімдерді бақылауды қалай ендіре алады

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

Өніміңіз бақылау функциясымен не істеуі керек екенін анықтаңыз

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

Бұл — әртүрлі өнім талаптары. Оларды бір ғана бақылау виджеті ретінде қарастыру маңызды жұмыс процестерін қолдаусыз қалдыруы мүмкін.

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

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

Интерфейсті жобалаудан бұрын интеграция моделін таңдаңыз

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

ТәсілҚолдануға ыңғайлы жағдайНегізгі жауапкершілік
Тасымалдаушылармен тікелей интеграцияларӨніміңіз нақты тасымалдаушы өрістеріне немесе тар ауқымдағы тасымалдаушылар желісіне тәуелді болғанда.Әр байланыс үшін аутентификацияны, деректерді сәйкестендіруді, қателерді өңдеуді және өзгерістерді қолдау.
Бірнеше тасымалдаушыны қолдайтын бақылау API интерфейсіӨніміңізге бірнеше тасымалдаушы үшін ортақ интеграция қабаты қажет болғанда.Нақты жөнелтілімдерді қолдауды, оқиға мағыналарын, жеткізу тетіктерін және коммерциялық шарттарды тексеру.
Гибридті интеграцияОртақ бақылау қабаты қажеттіліктердің көпшілігін қанағаттандырғанда, бірақ кейбір тасымалдаушыларға тікелей байланыстар қажет болғанда.Қайшы жаңартуларды шешу және бірізді ішкі жөнелтілім моделін сақтау.

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

17TRACK қай жерде сәйкес келеді

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

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

Браузерден провайдерге тікелей қосылмай, бақылау конвейерін құрыңыз

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

1. Ішкі жөнелтілім идентификаторын жасаңыз

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

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

2. Тіркеуді қалпына келтірілетін етіңіз

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

Сәтті тіркеу тек бақылау көзі сұрауды құжатталған мағынасына сәйкес қабылдағанын білдіруі керек. Бұл тасымалдаушының сәлемдемені физикалық түрде қабылдағанын автоматты түрде білдірмейді.

3. Іскерлік логикаға бөгелмей жаңартуларды қабылдаңыз

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

Сауалнама арқылы тексеру қажет болса, оны провайдердің шектеулері мен өніміңіздің жаңалық талаптарына сай жоспарлаңыз. Қолдау көрсетіліп, рұқсат етілген жағдайда, салыстыру сұраулары үзіліс кезінде өткізіп алған жаңартуларды қалпына келтіруге көмектеседі. Сауалнама арқылы тексеру мен push арқылы жеткізудің жүктемелері немесе есептеу салдары бірдей деп ойламаңыз.

4. Бастапқы дерек мәліметтерін сақтай отырып, оқиғаларды қалыпқа келтіріңіз

Өнім әрекеті үшін шағын ішкі күй сөздігін пайдаланыңыз, бірақ қолдау көрсету және тексеру үшін тасымалдаушының бастапқы сипаттамасын сақтаңыз. Ықтимал ішкі санаттарға ақпарат алынды, жолда, жеткізуге шығарылды, жеткізілді және ерекше жағдай жатады. Бұл — ұсынылатын өнім санаттары; әрбір дерек көзі дәл осы атауларды пайдаланады деген тұжырым емес.

Пайдалы қалыпқа келтірілген жазба мыналарды қамтиды:

  • Ішкі жөнелтілім ID және жалға алушы ID.
  • Бастапқы жүйе, тасымалдаушы идентификаторы және тиісті бақылау нөмірі.
  • Бастапқы күй сипаттамасы және қалыпқа келтірілген күй.
  • Оқиғаның болған уақыты, берілген жағдайда уақыт белдеуі туралы ақпаратпен бірге.
  • Платформаңыз жаңартуды алған уақыт.
  • Қолжетімді әрі сақтауға орынды болса, орналасқан жер туралы ақпарат.
  • Бастапқы оқиға ID немесе ішкі жасалған қайталануды жою кілті.
  • Қалыпқа келтіру шешімдерін қадағалау үшін сәйкестендіру нұсқасы.

Белгісіз мәндерді нақты күйінде сақтаңыз. Орналасқан жері көрсетілмесе, оны алдыңғы сканерлеуден болжамай, бос күйінде қалдыру керек. Шикі жүктемелерді тек тиісті қолжетімділік және сақтау саясаты аясында сақтаңыз; оларда клиентке арналған интерфейске қажет емес ақпарат болуы мүмкін.

Кешіктірілген, қайталанған және қайшы оқиғаларды өңдеңіз

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

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

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

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

Белгісіздікті түсіндіретін бақылау тәжірибесін жобалаңыз

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

Интерфейсте мына күйлерді ажыратыңыз:

  • Бақылау тіркелген, қозғалыс хабарланбаған: Жүйеде бақылау нөмірі бар, бірақ расталған қозғалыс оқиғасы жоқ.
  • Жөнелтілім жылжып жатыр: Жеткізу болжамы болмаса да, оқиғалар қозғалысты көрсетеді.
  • Бақылау ақпараты ескірген: Жазба сіз анықтаған жаңалық шегінен асып кеткен.
  • Жаңарту қызметі қолжетімсіз: Платформаңыз қазір жаңа ақпаратты ала немесе өңдей алмайды.
  • Жеткізу ерекше жағдайы: Жөнелтілім оқиғасы түсіндіруді немесе әрекетті қажет ететін мәселені көрсетеді.

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

Жалға алушылар шекарасын және бақылау қолжетімділігін қорғаңыз

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

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

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

Кеңейтпес бұрын нақты жөнелтілімдермен тексеріңіз

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

Логистикалық оқиғаларды да, инфрақұрылым ақауларын да сынаңыз:

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

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

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

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

Жиі қойылатын сұрақтар

Ендірілген бақылау беті логистика платформасы үшін жеткілікті ме?

Талап тек пайдаланушыларға жөнелтілім барысын көруге мүмкіндік беру болса, жеткілікті болуы мүмкін. Егер бақылау ескертулерді, ішкі тапсырмаларды, талдауды немесе серіктестердің API интерфейстерін іске қосуы керек болса, серверлік деректер интеграциясы да қажет. Көрсету қабаты мен оқиғалар конвейерін бөлек талаптар ретінде бағалаңыз.

Бақылау жаңартулары вебхуктарды немесе сауалнама арқылы тексеруді пайдалануы керек пе?

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

Платформа белгісіз тасымалдаушыны қалай өңдеуі керек?

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

Бақылау деректері тапсырыстың толық орындалғанын дәлелдей ала ма?

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

Командалар бақылау API интерфейсін таңдаудан бұрын нені тексеруі керек?

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

Дереккөздер

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