Skip to main content
Басты бетБлогНұсқаулықтарШетелдегі қоймалар жергілікті жеткізілімдерді бақылау үшін Tracking API интерфейстерін қалай пайдалана алады

Шетелдегі қоймалар жергілікті жеткізілімдерді бақылау үшін Tracking API интерфейстерін қалай пайдалана алады

17TRACK

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

Шетелдегі қоймалар жергілікті жеткізілімдерді бақылау үшін tracking API интерфейстерін қалай пайдалана алады

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

Қойма көрінуі аяқталатын және тасымалдаушы көрінуі басталатын жерді анықтаңыз

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

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

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

API-ге қосылмас бұрын жөнелтілім жазбасын жасаңыз

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

ЖазбаҰсынылатын өрістерОперациялық мақсат
Жөнелтілім идентификациясыІшкі жөнелтілім ID, тапсырыс ID, сәлемдеме ID, сатушы аккаунтыБөлінген жөнелтілімдер мен әртүрлі клиенттерді бөлек сақтау.
Тасымалдаушы идентификациясыТасымалдаушы идентификаторы, tracking нөмірі, белгілі болса қызмет түріДұрыс tracking сұрауын жіберу және тексерулерді тиісті бағытқа жіберу.
Қоймадағы тапсыруҚойма, жөнелту уақыты, алу сілтемесі, манифест сілтемесіФизикалық жөнелту дәлелдерін тасымалдаушы оқиғаларымен салыстыру.
Tracking тарихыШикі оқиға, сәйкестендірілген мәртебе, оқиға уақыты, қабылдау уақыты, берілген кездегі орналасқан жеріДәлелдерді сақтау және оқиға уақыты мен есеп беру кідірістерін ажырату.
Ерекше жағдайлар жұмыс процесіМәселе түрі, жауапты тұлға, келесі әрекет, тексеру мерзімі, шешімTracking ақпаратын жауапты жұмысқа айналдыру.

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

Қоймадағы тасымалдаушылар құрамына сәйкес интеграцияны таңдаңыз

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

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

Байланысты нақты операциялық талаптар бойынша бағалаңыз:

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

Tracking байланысы жапсырма сатып алуды, мекенжайды түзетуді, жеткізуді қайта жоспарлауды немесе талап қоюды қамтиды деп есептемеу керек. Тиісті өнім құжаттамасы мұны нақты растамаса, оларды бөлек жұмыс процестері ретінде қарастырыңыз.

Жөнелтуді, tracking жаңартуларын және ерекше жағдайларды өңдеуді байланыстырыңыз

1. Сәлемдемелерді бақыланатын жөнелту кезеңінде тіркеңіз

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

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

2. Бақылау тақтасын негізгі шындық көзіне айналдырмай жаңартуларды алыңыз

API құжаттарында көрсетілген мүмкіндіктерге қарай жаңартулар сұраулар арқылы алынуы немесе webhook хабарламалары арқылы қабылдануы мүмкін. Webhook — провайдерде жаңарту болған кезде жүйеңізге жіберілетін хабарлама; polling — ақпаратты жүйеңіздің сұратуы.

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

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

3. Бастапқы дәлелдерді сақтай отырып, мәртебелерді біріздендіріңіз

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

Бастапқы сипаттаманы сәйкестендірілген санатпен бірге сақтаңыз. “Available for collection” үнсіз түрде “delivered” мәртебесіне айналмауы керек, ал “return initiated” “received back at warehouse” мәртебесіне айналмауы тиіс. Бейтаныс оқиғалар тексеру үшін көрінетін болып қалуы үшін белгісіз немесе сәйкестендірілмеген күйге рұқсат беріңіз.

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

4. Ерекше жағдайларға әрекет ететін жауапты тұлғаларды тағайындаңыз

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

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

Ерікті таймерлерге емес, қызмет көрсету күтілімдеріне негізделген ескертулер орнатыңыз

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

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

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

Әр командаға пайдалануға болатын көрініс беріңіз

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

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

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

Жұмыс процесін кеңейтпес бұрын пилоттық сынақтан өткізіңіз

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

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

Операциялық қызметкерлер ерекше жағдайлар кезегін сенімді өңдей алғаннан және техникалық қызметкерлер сәтсіз жаңартуларды қалпына келтіре алғаннан кейін ғана кеңейтіңіз. Практикалық мақсат — мәртебелерге толы бақылау тақтасы емес. Мақсат — қоймадан жөнелтуден тасымалдаушының жеткізуіне дейінгі бақыланатын байланыс және осы сапар назар аударуды қажет еткен кезде нақты жауапкершілік.

FAQ

Tracking API қойманы басқару жүйесін алмастыра ала ма?

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

Tracking API нақты уақыттағы GPS орналасуын бере ме?

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

Сәлемдемеде tracking жаңартулары болмаған кезде қызметкерлер не істеуі керек?

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

Tracking оқиғалары қайтарымдарды немесе қор жаңартуларын автоматты түрде іске қоса ала ма?

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

Бөлінген тапсырыстар сатушыны қолдау топтарына қалай көрсетілуі керек?

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

Дереккөздер

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