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

Қайтарым операциялары немесе өнім тобы үшін пайдалы сұрақ API қадағалау күйін көрсете ала ма дегенмен ғана шектелмейді. Маңыздысы — интеграция дұрыс қайтарым жөнелтілімін сенімді түрде анықтай ала ма, қабылдайтын оқиғаларды түсіндіре ала ма және қадағалау жаңартуының қате клиенттік хабарламаны немесе ақшаны қайтару әрекетін іске қосуына жол бермей ме деген сұрақ.
Қадағалау қайтарым процесіне қай жерде кіреді
Қайтарым бизнес жазбасы ретінде басталады: клиент тауарды кері жіберуді сұрайды, ал сатушы неге рұқсат берілетінін шешеді. Қадағалау жазбасы басқа нәрсені — сәлемдеменің қозғалысын сипаттайды. Осы екі жазбаны байланыстыру қайтарым платформасына клиент сәлемдемені тасымалдаушыға тапсырған сияқты ма, сәлемдеме қайтару мекенжайына қарай қозғалып жатыр ма және жеткізу оқиғасы тіркелді ме деген сұрақтарға жауап беруге мүмкіндік береді.
Бұл байланыс нақты көрсетілуі керек. Бір тапсырыста бірнеше тауар болуы мүмкін, клиент бір тапсырыс бойынша бірнеше қайтарым жасай алады, ал бір қайтарым бірнеше сәлемдемені қамтуы мүмкін. Бастапқы жөнелтілімнің қадағалау нөмірін қайтарым қадағалау нөмірімен шатастыруға болмайды. Практикалық деректер моделі тапсырыс, қайтаруға рұқсат, қайтарым сәлемдемесі, тасымалдаушы және қадағалау жазбасы үшін бөлек идентификаторларды сақтап, олардың арасындағы байланыстарды тіркейді.
Қадағалаудың да нақты шекарасы бар. Тасымалдаушының жеткізу оқиғасы сәлемдеменің мекенжайға немесе нысанға жеткенін көрсетуі мүмкін. Бірақ ол қойманың күтілген тауарды алғанын, тауар тексеруден өткенін немесе ақшаны қайтару қажет екенін дәлелдемейді. Бұл шешімдер үшін жеке дәлелдер мен ережелер қажет.
Рұқсат беруден қабылдауға дейінгі интеграция процесі
1. Сәлемдемені қадағаламас бұрын қайтарым жазбасын жасау
Қайтарым платформасы алдымен сұрауды, қатысты тауарларды, рұқсат етілген бағытты және рұқсат етілген шешімді тіркейді. Егер қайтарымда сатушы берген жапсырма қолданылса, платформа жапсырманың қадағалау идентификаторын қайтарым сәлемдемесімен байланыстыра алады. Егер клиент жеткізуді өз бетінше ұйымдастырса, бақылау басталғанға дейін тасымалдаушы мен қадағалау нөмірін жинап, тексеру қажет болуы мүмкін.
Бұл — деректер сапасы көрінуге әсер ететін алғашқы кезең. Сәлемдемені қайтарыммен сенімді байланыстырмайтын қадағалау нөмірі дұрыс тасымалдаушы жаңартуын қате қайтарымға қолдануы мүмкін. Топтар түзетілген қадағалау нөмірлерін, ауыстырылған жапсырмаларды және бір идентификаторды екі рет жіберетін клиенттерді қалай өңдейтінін де алдын ала шешуі керек.
2. Жөнелтілімді тіркеу немесе іздеу
Платформа жөнелтілім жазбасын жасау немесе алу үшін таңдалған қадағалау провайдері талап ететін ақпаратты жібереді. Нақты сұрау өрістері мен реттілігі провайдердің құжаттамасына байланысты. Кемінде провайдердің жөнелтілім сілтемесін өз қайтарым сәлемдемесі жазбасымен сенімді байланыстыру тәсілі болуы керек. Тасымалдаушыны анықтау қажет болса, платформа тек қадағалау нөмірі жеткілікті деп болжамай, белгісіз немесе қолдау көрсетілмейтін тасымалдаушы деректерінің қалай өңделетінін нақтылауы керек.
Провайдердің жауабын, интеграция қателерін және платформа бақылауды бастаған күнді сақтаңыз. Қабылданған сұрау тасымалдаушының сәлемдемені сканерлегенін білдірмейді. Алғашқы сканерлеуге дейін клиентке көрсетілетін күй қайтарым жолда деп емес, қадағалау күтілуде деп жазылуы мүмкін.
3. Бастапқы оқиғаны жоғалтпай жаңартуларды қабылдау
API интерфейсіне байланысты жаңартулар веб-хук арқылы келуі, сұрау арқылы алынуы немесе құжатталған басқа әдісті пайдалануы мүмкін. Интеграция провайдердің бастапқы оқиға ақпаратын қайтарым платформасында көрсетілетін жеңілдетілген күймен қатар сақтауы керек. Пайдалы өрістерге оқиға сипаттамасы, оқиға уақыты, көрсетілген болса орналасқан жері, тасымалдаушының сілтемесі және платформа жаңартуды алған уақыт кіруі мүмкін.
Бұл екі уақыт әртүрлі сұрақтарға жауап береді. Оқиға уақыт белгісі әрекеттің қашан болғаны хабарланғанын сипаттайды; қабылдау уақыт белгісі қайтарым платформасының ол туралы қашан білгенін көрсетеді. Әйтпесе кідірістер, қайталанған жеткізулер және ретсіз хабарламалар қайтарым кері бағытта қозғалып жатқандай әсер қалдыруы мүмкін. Провайдер оқиға идентификаторларын ұсынса, оларды қайталануды жою үшін пайдаланыңыз. Егер ұсынбаса, сақтықпен қайталануды жою әдісін анықтап, оны нақты интеграциялық үлгілермен сынаңыз.
4. Қадағалау оқиғаларын қайтарым күйлеріне аудару
Тасымалдаушы оқиғаларының сипаттамалары қайтарым саясаты емес. Қайтарым платформасы оларды әдетте тапсыруды күтуде, жолда, жеткізу хабарланды немесе тексеру қажет сияқты аздаған операциялық күйлерге сәйкестендіреді. Сәйкестендіру белгісіз оқиғаларды ескеруі керек және танылмаған әр жаңартуды үнсіз түрде прогресс деп қабылдамауы тиіс.
Мысалы, тасымалдаушының алғашқы сканерлеуі клиентке сәлемдемесі жолда сияқты екенін айтуға жеткілікті болуы мүмкін. Бірақ бұл ақшаны қайтару күнін уәде етуге жеткіліксіз болуы мүмкін. Жеткізу оқиғасы қоймаға сәйкес сәлемдемеге басымдық беруге көмектеседі, алайда ақшаны қайтару ережесі нақты қабылдау мен тексеруді талап етуі мүмкін. Топтар күйлерді автоматтандырылған әрекеттермен байланыстырмас бұрын, осы айырмашылықтарды жұмыс процесіне енгізуі керек.
5. Қойма дәлелдерімен процесті аяқтау
Сәлемдеме келгеннен кейін қойма немесе қайтарым нысаны ішкі штрихкодты сканерлеуі, сәлемдемені қайтаруға рұқсатпен сәйкестендіруі, құрамын тексеруі және нәтижесін тіркеуі мүмкін. Бұл — тасымалдаушы қадағалау оқиғалары емес, қайтарымдарды басқару оқиғалары. Екі жүйе байланыстырылған жағдайда платформа пайдалырақ реттілікті көрсете алады: жөнелтілім қозғалысы, тасымалдаушы хабарлаған жеткізу, нысан қабылдаған сәлемдеме және аяқталған шешім.
Бұл реттілік ерекшеліктерді шешуге де көмектеседі. Қадағалау жеткізілді деп көрсетіп, бірақ қоймада қабылдау жазбасы болмаса, оператор клиентке мәлімдеме жасамас бұрын бағытты, тасымалдаушы оқиғасын, нысанның қабылдау кезегін және сәлемдеме идентификаторын тексере алады. Егер қойма сәлемдемені жарамды қадағалау тарихынсыз алса, нақты қабылдауды бәрібір тіркеуге болады; жетіспейтін қадағалау деректері тәуелсіз қойма дәлелдерін жоймауы тиіс.
Қадағалау API интерфейсі платформаға нені айта алады және нені айта алмайды
Жөнелтілімдерді қадағалау API интерфейсі провайдердің құжатталған қамтуына, оқиғалардың қолжетімділігіне және интеграция тәртібіне байланысты тасымалдаушы хабарлаған қозғалысты басқа қолданбаға ұсына алады. Бірақ ол қайтарым құрамын өздігінен тексере алмайды немесе сатушы саясатының орындалғанын шеше алмайды. Сондай-ақ алғашқы тасымалдаушы сканерлеуіне дейін хабарлайтын жаңарту болмауы мүмкін.
Автоматтандыруды жобалағанда бұл айырмашылық маңызды. Күйлерді бір-бірінің орнына қолданылатын дәлел ретінде емес, нақты қолдану мақсаты бар сигналдар ретінде қарастыру керек. Тасымалдаушыға тапсырылғаны туралы оқиға прогресс хабарламасын іске қосуы мүмкін. Жеткізу оқиғасы қоймаға кейінгі әрекет тапсырмасын жасауы мүмкін. Қойманың расталған қабылдауы қайтарымды тексеруге жылжытуы мүмкін. Ақшаны қайтару немесе айырбастау туралы шешім сатушының нақты ережелері мен сол ережелер талап ететін дәлелдерге негізделуі керек.
Клиентке арналған тіл де осы шекараны көрсетуі керек. Тексеру жүргізілмеген жағдайда «Қайтарымыңыз жеткізілгенін тасымалдаушы хабарлады» деген сөз «Ақшаңызды қайтаруды мақұлдадық» дегеннен дәлірек. Сол сияқты «Біз тасымалдаушының алғашқы жаңартуын күтіп отырмыз» деген түсіндірме берілмеген бос қадағалау бетінен пайдалырақ.
Қайтарым қадағалауындағы алдын алуға болатын қателерді болдырмайтын жобалау тексерістері
- Сәлемдеме деңгейінде сәйкестендіріңіз. Бөлінген қайтарымдарды, бір рұқсатқа тиесілі бірнеше сәлемдемені, ауыстырылған жапсырмаларды және бір тапсырыс бойынша қайталанған қайтарымдарды сынаңыз. Әр сәлемдеме өз қадағалау жазбасымен бірмәнді байланысуы керек.
- Күйлердің басымдығын анықтаңыз. Жеткізу оқиғасынан кейін ескі жолдағы оқиға келсе не болатынын шешіңіз. Оқиғалар тарихын сақтаңыз, бірақ көрсетілген қайтарым күйін автоматты түрде төмендетпеңіз.
- Провайдер қателерін тасымалдаушының үнсіздігінен ажыратыңыз. Аутентификация қатесі, қабылданбаған сұрау немесе веб-хукты өңдеудің сәтсіздігі — интеграция мәселесі. Әзірге сканерлеу болмауы — басқа жағдай және ол басқаша хабарлануы керек.
- Қайталанулар мен қайта әрекеттерді жоспарлаңыз. Жеткізу жаңартуы қайталануы мүмкін. Оқиғаларды қабылдауды қайта орындауға қауіпсіз етіңіз және бір клиент хабарламасын екі рет жібермеңіз немесе бір тапсырманы екі рет жасамаңыз.
- Клиент пен жөнелтілім деректерін қорғаңыз. Қадағалау тіркелгі деректеріне қолжетімділікті шектеңіз, жұмыс процесіне қажет деректерді ғана сақтаңыз және іске қоспас бұрын провайдердің құжатталған аутентификациясы мен қауіпсіздік талаптарын тексеріңіз.
- Қолмен өңдеу жолын сақтаңыз. Кейбір қайтарымдарда қадағалау ақпараты толық емес, кешігіп келген немесе сәйкес келмейтін болады. Операторларға тасымалдаушы оқиғаларын ойдан шығармай, қайтарым жазбасын тексеріп, түзету мүмкіндігі қажет.
Бұл тексерістер бір ғана сәтті жөнелтіліммен емес, нақты сценарийлермен сыналғанда пайдалырақ. Шағын сынақ жиынтығына алғашқы сканерлеудің болмауы, қате қадағалау нөмірі, қайталанған оқиға, ретсіз оқиға, қойма қабылдауынсыз жеткізу туралы есеп және сәйкес жеткізу есебінсіз қойма қабылдауы кіруі керек. Әр жағдай үшін күтілетін клиент хабарламасы мен оператор әрекеті көрсетілуі тиіс.
API интерфейсін таңдау және жұмыс бөлінісін анықтау
Алдымен бизнес нақты пайдаланатын қайтарым бағыттары мен тасымалдаушылардан бастаңыз. Содан кейін провайдердің қолданыстағы құжаттамасынан жөнелтілімді тіркеу қалай орындалатынын, қандай идентификаторлар қажет екенін, жаңартулардың қалай жеткізілетінін, қандай оқиға деректері ашық екенін және қателер мен қайта әрекеттердің қалай өңделетінін тексеріңіз. Тасымалдаушылардың қамтылуы туралы жалпы мәлімдемеден қорытынды жасамай, тиісті тасымалдаушылар мен қайтарым бағыттарын тікелей растаңыз. Клиенттермен байланыс немесе автоматтандыру үшін сәйкестендірілген күйлерге сүйенбес бұрын, өкілдік жөнелтілімдермен сынақ жүргізіңіз.
17TRACK қадағалау API интерфейсіне шолуды және API құжаттамасын жариялайды; оның 17RETURNS өнім беті жұмыс процесінің қайтарымдарды басқару бөлігіне арналған. Бұл қайтарым процесімен қатар қадағалау көрінуін бағалайтын топ үшін маңызды бастапқы нүктелер. Екі өнім бағытының болуы белгілі бір интеграцияның, тасымалдаушының, оқиғаның немесе автоматтандырылған ақшаны қайтару ережесінің қолжетімді екенін дәлелдемейді. Нақты жұмыс процесін қолданыстағы құжаттамадан және қажет болса провайдерден тексеріңіз.
Сатып алу немесе тұжырымдаманы тексеру кезінде қайтарым саясаты мен қойма операцияларына жауапты топтан күй сәйкестендіруін инженерлермен бірге қарауды сұраңыз. Инженерлер API интерфейсінің қолдануға жарамды оқиғаларды жеткізетінін растай алады; операциялар тобы бұл оқиғалардың ұсынылған әрекетті ақтайтынын тексере алады. Сәтті интеграция қызметкерлер мен клиенттерге сәлемдемені бақылауға көмектеседі, сонымен бірге рұқсат беруді, қабылдауды, тексеруді және шешімді бөлек кезеңдер ретінде сақтайды.
Жиі қойылатын сұрақтар
Қайтарымға бастапқы тапсырыстан бөлек қадағалау нөмірі қажет пе?
Платформа бастапқы жөнелтілім мен қайтарым жөнелтілімінің жазбаларын бөлек сақтауы керек. Қайтарым әдетте бөлек жөнелтілім ретінде тасымалданады, сондықтан оның қадағалау идентификаторы бастапқы тапсырыстың шығыс идентификаторы деп қабылданбай, қайтарым сәлемдемесімен байланыстырылуы керек. Қолжетімді нақты идентификаторлар қайтарымның қалай жіберілгеніне байланысты.
Қадағалау API интерфейсі ақшаны қайтару керектігін растай ала ма?
Жоқ. Бірде-бір қадағалау оқиғасы қайтарылған тауардың сатушының ақшаны қайтару шарттарына сәйкес келетінін жалғыз өзі растамайды. Платформа тасымалдаушы оқиғаларын жұмыс процесіне кіріс ретінде пайдалана алады, бірақ ақшаны қайтару құқығы рұқсатқа, нақты қабылдауға, тексеруге және сатушы саясатына да байланысты болуы мүмкін.
Қадағалау жеткізілді деп көрсетіп, бірақ қойма сәлемдемені таба алмаса не болады?
Тасымалдаушы хабарлаған жеткізу оқиғасы мен қойманың қабылдау жазбасын бөлек сақтаңыз. Көрсетілген бағыт пен оқиға мәліметтерін тексеріп, нысанның қабылдау және сәйкестендіру процесін зерттеңіз. Тасымалдаушы жеткізуін қойма қабылдауы расталды деп үнсіз өзгертпеңіз.
Қайтарым жөнелтілімдерін қадағалау үшін веб-хуктар міндетті ме?
Міндетті емес. Жаңарту әдісі таңдалған провайдерге және оның құжатталған мүмкіндіктеріне байланысты. Веб-хуктар қолжетімді болса, аутентификацияны, қайта әрекеттерді, қайталанған жеткізулерді және өңдеу сәтсіздіктерін жоспарлаңыз. Сұрау әдісі қолданылса, қайтарым процесі мен провайдердің талаптарына сәйкес келетін аралық пен тоқтату ережесін таңдаңыз.
Клиент алғашқы қадағалау жаңартуын қашан көруі керек?
Бұл тасымалдаушының оқиғаны қашан хабарлайтынына және интеграцияның оны қашан алатынына байланысты. Жапсырма жасау немесе жөнелтілімді тіркеу тасымалдаушы сканерлеуінен бұрын орындалуы мүмкін. Клиенттер күтудегі алғашқы жаңартуды расталған қозғалыс деп түсінбеуі үшін бұл айырмашылықты анық көрсетіңіз.


