Skip to main content
Басты бетБлогНұсқаулықтарҰлыбритания жөнелтілімдерін қадағалау API интерфейсін қалай таңдауға болады: тасымалдаушыларды қамту және интеграция

Ұлыбритания жөнелтілімдерін қадағалау API интерфейсін қалай таңдауға болады: тасымалдаушыларды қамту және интеграция

17TRACK

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

UK жөнелтілімдерін қадағалау API тасымалдаушы қамтуын қалай таңдауға болады

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

Провайдердің тасымалдаушылар санынан емес, жөнелтілімдеріңіздің құрамынан бастаңыз

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

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

Келесі өрістері бар талаптар кестесін жасаңыз:

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

Міндетті қамту тізіміңіз келісімшарттарыңызға байланысты Royal Mail, Parcelforce Worldwide, Evri немесе DPD қамтуы мүмкін. Бұл — тек тексеруге арналған мысалдар; қандай да бір нақты API осы тасымалдаушылар ұсынатын барлық қызметті қолдайды деген тұжырым емес.

Тасымалдаушы қамтуы іс жүзінде нені білдіруі керек

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

Қызмет деңгейі мен бағыт деңгейіндегі қамтуды тексеріңіз

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

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

Халықаралық тапсыруларды бөлек тексеріңіз

Трансшекаралық жөнелтілімдерге бірнеше жеткізу серіктесі қатысуы мүмкін. Ақпарат қолжетімді болған кезде интеграция кейінгі тасымалдаушыны немесе қадағалау нөмірін көрсете ме — тексеріңіз. Сондай-ақ қолданбаңыз бір жөнелтілімге бірнеше қадағалау нөмірін клиенттерге қайталама хабарламалар жасамай байланыстыра алатынын тексеріңіз.

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

Тасымалдаушыны анықтау мен екіұшты нөмірлерді тексеріңіз

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

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

Тікелей тасымалдаушы интеграциялары мен көптасымалдаушылы API арасынан таңдаңыз

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

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

17TRACK бұл бағалауға өзінің Tracking API offering ұсынысы арқылы қатысы бар. Интеграция талаптарын тексеруді бастау үшін оның official API documentation құжатын пайдаланыңыз, содан кейін тасымалдаушы және қызметтер тізімін тікелей растаңыз. Бұл — сол қабылдау процесі аясында бағаланатын кандидат, қамту немесе сенімділік сынақтарын өткізбеуге себеп емес.

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

Клиенттік жұмыс процестерін құрудан бұрын оқиғалар моделін бағалаңыз

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

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

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

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

Тек сәтті сұрауларды емес, webhook қателерін де ескеріп жобалаңыз

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

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

Іске асырудан бұрын мына сұрақтарға жауап беріңіз:

  • Соңғы нүктеңіз сұраудың провайдерден келгенін қалай тексереді?
  • Соңғы нүктеңіздің уақыты бітіп қалса немесе қате қайтарса не болады?
  • Жеткізілімдер қайталануы немесе ретсіз келуі мүмкін бе?
  • Өткізіп алған жаңартуларды алуға немесе қайта ойнатуға бола ма?
  • Қызметті үзбей есептік деректер қалай ауыстырылады?
  • Қалпына келтіру кезінде жылдамдық шектеріне жеткенде не болады?

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

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

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

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

Сынақ жағдайыНені тексеру керекҚабылдау қағидасы
UK ішіндегі жеткізілімОқиғалардың толықтығы және соңғы мәртебеҚажетті кезеңдер дұрыс тапсырысқа жетеді.
Трансшекаралық тапсыруТасымалдаушы өзгерістері және қосымша идентификаторларҚолжетімді тапсыру ақпараты жөнелтіліммен байланысын сақтайды.
Жеткізу ерекшелігіМәртебе мәні және бастапқы мәліметТиісті топ келесі әрекетті анықтай алады.
Қайталама немесе ескі жаңартуҚайталануды жою және оқиғалар ретіҚайталама хабарлама немесе қате күйге қайту болмайды.
Соңғы нүктенің уақытша істен шығуыҚайта әрекеттер және салыстырып тексеруӨткізіп алған ақпаратты тексерілген процесс арқылы қалпына келтіруге болады.

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

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

Жалпы шығынды, деректерді өңдеуді және қолдауды салыстырыңыз

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

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

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

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

Іске қосуды кері қайтаруға болатын етіп жасаңыз

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

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

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

FAQ

UK бизнесіне UK аумағында хостинг жасалған қадағалау API қажет пе?

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

Жөнелтілімді тек тапсырыс нөмірі арқылы қадағалай аламын ба?

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

Webhook әрқашан polling-тен жақсы ма?

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

Тасымалдаушы беті мен API келіспегенде не істеуім керек?

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

Sources

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

  • 17TRACK Tracking API — осы нұсқаулықта талқыланған API ұсынысының ресми өнім анықтамасы.
  • 17TRACK API documentation — іске асыруға дейін интеграция талаптарын тексеруге арналған ресми техникалық анықтама.