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

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


