Tracking API мен Shipping API: Электрондық коммерция стегіңізге қайсысы қажет (әлде екеуі де ме)?
Электрондық коммерция стегіңізге жөнелтілімдер жасап, жөнелту жапсырмаларын жасау қажет болса, shipping API пайдаланыңыз. Жөнелтілімдер жіберілгеннен кейін олардың қозғалысын бақылап, тасымалдаушы жаңартуларын операциялық немесе клиенттерге арналған пайдалы ақпаратқа айналдыру қажет болса, tracking API пайдаланыңыз. Бағдарламалық жасақтамаңыз жөнелтілім жасауды және сатып алғаннан кейінгі көрінімділікті басқаруы тиіс болса, сізге екі мүмкіндік те қажет, бірақ міндетті түрде екі провайдер немесе екі бөлек интеграция қажет емес.
Бұл шешім фулфилмент архитектурасына жауапты тұлғаға тиесілі: әдетте инженерлік топпен бірге жұмыс істейтін электрондық коммерция операцияларының жетекшісіне. Дүкеніңіз, қоймаңыз немесе фулфилмент серіктесіңіз қазірдің өзінде нені басқаратынын анықтаудан бастаңыз. Қосымша API жұмыс істеп тұрған процесті қайталамай, нақты олқылықтың орнын толтыруы керек.
Tracking API мен shipping API арасындағы айырмашылық неде?
Айырмашылық негізінен әр API орындайтын міндетке байланысты, өнім санаттары арасындағы қатаң шекараға емес. Жөнелту платформасында бақылау endpoint-тері болуы мүмкін, ал бақылау қызметі хабарландырулар мен клиенттерге арналған жеткізу жаңартуларын ұсынуы мүмкін. Өнім атауына сүйенбей, құжатталған endpoint-тер мен оқиғалардың әрекетін бағалаңыз.
| Шешім өлшемі | Tracking API | Shipping API |
|---|---|---|
| Негізгі міндеті | Жөнелтілім мәртебесі мен бақылау оқиғаларын алу немесе қабылдау. | Жөнелтілімдер жасап, жапсырмалар мен байланысты жөнелту құжаттарын алу. |
| Әдеттегі кіріс деректері | Бақылау нөмірі, тасымалдаушы идентификаторы және қажет болуы мүмкін қосымша жөнелтілім мәліметтері. | Жіберуші мен алушының деректері, қаптама туралы ақпарат, қызметті таңдау және қолданылатын кедендік деректер. |
| Әдеттегі шығыс деректері | Жөнелтілім мәртебесі, оқиғалар тарихы және қолжетімді басқа жеткізу ақпараты. | Жөнелтілім идентификаторлары, жапсырмалар және қолдау көрсетілетін құжаттар. |
| Негізгі жұмыс процесі | Жеткізу көрінімділігі, ерекше жағдайларды өңдеу және сатып алғаннан кейінгі жаңартулар. | Қоймадан жіберу және жөнелтілімді жөнелтуге дайындау. |
| Нені болжамау керек | Бақылау мүмкіндігі жапсырма жасауды немесе тасымалдаушыға тапсырыс беруді қамтиды деп. | Жапсырма жасау сізге қажет бақылау тереңдігі мен хабарландыру басқаруын қамтиды деп. |
Тасымалдаушы құжаттамасы бұл бөліністі көрсетеді. FedEx жөнелтілім жасауды өзінің Ship API documentation құжатында, ал бақылау мүмкіндіктерін өзінің tracking API documentation құжатында сипаттайды. Бұл белгілі бір тасымалдаушыны таңдауға берілген ұсыныс емес, әртүрлі техникалық жауапкершіліктердің мысалдары.
Жөнелтілім жасау оның қозғалысын бақылаумен бірдей емес
Жөнелтілімді сәтті жасау туралы жауап бағдарламалық жасақтамаңызға жөнелту сұрауының өңделгенін хабарлайды. Бұл тасымалдаушының сәлемдемені физикалық түрде қабылдағанын білдірмейді. Сол сияқты, бақылау нөмірі бақылау тарихында қозғалыс пайда болмай тұрып та болуы мүмкін.
Сондықтан тапсырыстарды басқару жүйеңіз жапсырма жасауды, қоймаға тапсыруды, тасымалдаушының қабылдауын және жеткізуді ажыратуы керек. Мұның бәрін бір ғана «жіберілді» оқиғасы ретінде қарастыру клиенттерге мерзімінен бұрын хабарлама жіберуге және қоймадан іс жүзінде шықпаған сәлемдемелерді байқамай қалуға әкелуі мүмкін.
Ағымдағы тар орын мәселесін шешетін мүмкіндікті таңдаңыз
Жіберу жетіспейтін бөлік болса, shipping API таңдаңыз
Өз қолданбаңыз тапсырыс деректерін жөнелтілімге айналдыруы керек болса, shipping API маңызды бастапқы нұсқа болып табылады. Мысалы, қойма тобы мекенжайларды тасымалдаушы порталдарына қолмен көшіретін жағдай немесе жапсырма жасай алмайтын арнайы тапсырыстарды басқару жүйесі.
Интеграцияны таңдамас бұрын нақты жіберу процесін анықтаңыз. Сізге тек жөнелтілім жасау қажет пе, әлде тарифтерді алу, жою, алып кету сұраулары, кедендік құжаттама немесе күн соңындағы процестер де керек пе? Бұл функциялар бөлек API болуы, тасымалдаушыға байланысты болуы немесе қосымша есептік жазба рұқсаттарын талап етуі мүмкін. «shipping API» деп белгіленген өнім барлық жөнелту операцияларын қамтиды деп болжамаңыз.
Жалғыз шешім ретінде мінсіз емес: клиенттерге қызмет көрсету тобы тасымалдаушылардың жеке веб-сайттарын тексеруге мәжбүр болып қалатын жапсырма жасау интеграциясы. Ол жіберу мәселесін шешкенімен, жеткізу көрінімділігін айтарлықтай өзгертпеуі мүмкін.
Жөнелтілім жасау қазірдің өзінде жұмыс істесе, tracking API таңдаңыз
Жапсырмаларды қойманы басқару жүйесі, фулфилмент серіктесі, маркетплейс немесе қолданыстағы жөнелту интеграциясы жасап қойған, бірақ жеткізу ақпараты бөлшектеніп кеткен жағдайда tracking API тікелей сәйкес келеді.
Мұндай жағдайда жапсырма жасау процесін ауыстыру негізгі мәселені шешпей, көшіру жұмысын көбейтуі мүмкін. Оның орнына жоғарыда жасалған бақылау нөмірлерін тапсырыстарды басқару жүйесі, қолдау құралдары және клиенттік коммуникациялар пайдалана алатын көрінімділік қабатына қосыңыз.
Бұл санат үшін 17TRACK Tracking API — сәйкес интеграция нұсқасы. Оның official API documentation құжатында бақылау нөмірін тіркеу және бақылау деректері процестері, соның ішінде push-хабарландырулар сипатталған. Бұл процестерді қажет тасымалдаушыларыңызбен, жөнелтілім түрлеріңізбен және қолданба архитектураңызбен салыстырып бағалаңыз. Бұл бақылау қабатына қатысты мәселе, қызмет жапсырма жасау интеграциясын алмастырады деген дәлел емес.
Жалғыз шешім ретінде мінсіз емес: бағдарламалық жасақтамаңыз жауапты болатын жөнелтілімдерді әлі де жасай алмайтын жағдайда tracking API пайдалану. Бақылау көрінімділігі жөнелтуді орындау мүмкіндігінің жоқтығын шешпейді.
Қолданбаңыз жіберу мен жеткізу көрінімділігіне жауапты болса, екеуін де пайдаланыңыз
Стегіңіз жапсырмалар жасап, кейін жөнелтілім барысының сенімді көрінісін сақтауы керек болса, екі мүмкіндік те орынды. Олар бір платформадан, бөлек қызметтерден немесе тасымалдаушы интеграциялары мен бақылау қабатының үйлесімінен алынуы мүмкін.
Жөнелту және бақылау функциялары құжатталған талаптарыңызға қажетсіз ымырасыз сәйкес келсе, бір интеграцияны таңдаңыз. Қолданыстағы жөнелту процесін сақтау маңызды болса немесе бақылау талаптары сол процестің мүмкіндіктерінен айтарлықтай өзгеше болса, бөлек интеграцияларды қарастырыңыз. Бөлек бақылау провайдері автоматты түрде жақсырақ болмайды; ол қосымша интеграцияны, төлемді және операциялық жауапкершілікті ақтауы керек.
Екі API электрондық коммерция стегіне қалай үйлеседі
Практикалық дизайн тапсырысты, жөнелтілімді және бақылау оқиғасын бөлек жазбалар ретінде сақтайды. Бір тапсырыс бірнеше сәлемдеме тудыруы мүмкін, ал әр сәлемдеменің жеке бақылау тарихы болуы мүмкін. Клиентке көрсетілетін тапсырыс мәртебесі осы жөнелтілім жазбаларынан алынуы керек, оларды қайта жазбауы тиіс.
- Тапсырыс фулфилментке дайын болады. Дүкен немесе тапсырыстарды басқару жүйесі қажетті фулфилмент деректерін жауапты қоймаға жібереді.
- Жөнелту процесі жөнелтілімді жасайды. Қолданба қайтарылған жөнелтілім идентификаторын, бақылау нөмірін, тасымалдаушыны, қызметті және жапсырма сілтемесін сақтайды.
- Қойма тапсыруды аяқтайды. Қойманың растауы мен тасымалдаушының қабылдауы ажыратылатын оқиғалар болып қалады.
- Бақылау процесі басталады. Қолданба таңдалған интеграция талаптарына сәйкес бақылау нөмірін тіркейді немесе жібереді.
- Бақылау жаңартулары қолданбаңызға жетеді. Webhook-тар, polling немесе қолдау көрсетілетін олардың үйлесімі жөнелтілім жазбасын жаңартады.
- Келесі әрекетті бизнес ережелері анықтайды. Тиісті шарттар орындалғанда жүйеңіз клиентке көрсетілетін мәртебені жаңартады, операциялық тапсырма жасайды немесе хабарлама жібереді.
Мысалы, үшінші тараптың фулфилмент қоймасын пайдаланатын сатушыға өз бағдарламалық жасақтамасында тек төртіншіден алтыншыға дейінгі қадамдар қажет болуы мүмкін. Жөнелтілім жасауды қойма қазірдің өзінде басқарады. Өз қоймасын басқаратын сатушыға толық процесс қажет болуы мүмкін.
Әр кейінгі әрекетке бір жауапты жүйе белгілеңіз
Егер екі интеграция да бақылау жаңартуларын берсе, клиент хабарландыруларын және дүкенде көрсетілетін жөнелтілім мәртебесін қай жүйе басқаратынын белгілеңіз. Әйтпесе клиенттер қайталанатын хабарламалар алуы немесе қарама-қайшы жеткізу мәртебелерін көруі мүмкін.
Әр дереккөздің электрондық пошта жіберуіне мүмкіндік бермей, тексеру үшін қосалқы деректерді сақтай аласыз. Қолдау қызметкерлері жүйенің жөнелтілімді неге белгілі бір жолмен жіктегенін түсінуі үшін бастапқы тасымалдаушы оқиғасын ішкі мәртебе сәйкестендіруімен бірге сақтаңыз.
Функция атауларын емес, операциялық сәйкестікті салыстырыңыз
Іс жүзінде пайдаланатын тасымалдаушылар мен қызметтерді тексеріңіз
Тасымалдаушы қолдауы бір ғана «иә» немесе «жоқ» сұрағы емес. Қызмет тасымалдаушы үшін бақылауды қолдауы мүмкін, бірақ сол тасымалдаушыға жапсырма жасауды қолдамауы мүмкін. Жапсырма жасау жөнелту еліне, тасымалдаушы есептік жазбасының бапталуына немесе қызметтің жарамдылығына да байланысты болуы мүмкін.
Нақты жөнелту бағыттарыңыздан сынақ тізімін жасаңыз. Ішкі сәлемдемелерді, халықаралық жөнелтілімдерді және көлік серіктестері арасындағы кез келген тапсыруды қосыңыз. Әрқайсысына қажет операцияны: жөнелтілім жасау, оны бақылау немесе екеуін де растаңыз. Кең қамту туралы мәлімдемеден гөрі бизнесіңіз сүйенетін қызметтерді нақты сынау пайдалырақ.
Оқиғалардың мағынасы мен деректердің толықтығын тексеріңіз
Бақылау үшін алғашқы сканерлеуге дейін, жеткізудегі ерекше жағдай кезінде, сәтсіз жеткізу әрекетінен кейін және жеткізу сәтінде не болатынын сынаңыз. Уақыт белгілерінде уақыт белдеуі туралы ақпарат бар-жоғын және бастапқы тасымалдаушы сипаттамаларының сақталатынын тексеріңіз.
Қалыпқа келтірілген мәртебені әр тасымалдаушыда деректер бірдей болады деген уәде ретінде түсінбеңіз. Болжалды жеткізу күндері, орналасу мәліметтері және жеткізілгенін растау ақпараты негізгі тасымалдаушы мен жөнелтілімге байланысты болуы мүмкін. Бұл өрістер болмаған кезде интерфейсіңіздің қалай әрекет ететінін анықтаңыз.
Екі тараптағы ақаудан кейін қалпына келуді тексеріңіз
Жөнелту үшін жөнелтілім жасау кезіндегі тайм-аутқа ерекше назар аударыңыз: қолданбаңыз жауап алмаса да, сұрау сәтті орындалған болуы мүмкін. Қайта әрекетті соқыр түрде жасамас бұрын, провайдердің қайталанудың алдын алу және сәйкестендіру үшін қолдайтын механизмдерін тексеріңіз.
Бақылау үшін қайталанатын хабарландыруларды, кешіккен оқиғаларды, сәтсіз webhook жеткізілуін және endpoint-тердің уақытша істен шығуын сынаңыз. Тиісті құжаттамадан аутентификацияны, қайта әрекет ету тәртібін және қалпына келтіру мүмкіндіктерін растаңыз. Жаңартуды қайта ойнату бір клиенттік хабарламаны қайта жібермейтіндей етіп оқиғаларды өңдеуді жобалаңыз.
Баға моделін болжамай, жалпы операциялық шығынды салыстырыңыз
API төлемдерін пошта және тасымалдаушы есептік жазбасы төлемдерінен бөлек қарастырыңыз. Жөнелту және бақылау қызметтері әртүрлі есептеу бірліктерін пайдалануы мүмкін, ал біріктірілген платформа мүмкіндіктерді басқаша топтастыруы мүмкін. Жүргізгіңіз келетін нақты процесс үшін баға ұсынысын алыңыз немесе тиісті жоспарды қарап шығыңыз.
Есептелетін пайдалану қалай анықталатынын, сәтсіз сұраулардың есепке алынатынын, қайталанған бақылау жіберілімдері қалай өңделетінін және пайдалану белгіленген мөлшерден асқанда не болатынын сұраңыз. Инженерлік қызмет көрсетуге, қолдау жұмысына және екі интеграцияның сәйкестігін сақтауға кететін шығынды қосыңыз. Жөнелтілімдер құрамы мен қолданыстағы коммерциялық шарттар анықталмайынша, санаттардың бірін арзанырақ деп жариялау жаңылыстырады.
Қауіпсіздік пен деректерді сақтау мерзімін қарап шығыңыз
Жөнелту интеграциялары алушының мекенжайлары мен кедендік ақпаратты өңдеуі мүмкін. Бақылау интеграциялары жөнелтілім идентификаторлары мен байланысты клиент деректерін де өңдеуі мүмкін. Қай өрістер қажет екенін растаңыз, тіркелгі деректеріне тек қажетті қолжетімділік беріңіз және құпияларды браузерлік кодта сақтамаңыз.
Сақтау, жою және қолжетімділікті басқару талаптарын бизнес талаптарыңызбен салыстырып тексеріңіз. Ыңғайлы интеграция процесс қажет етпейтін клиент ақпаратын жіберуді талап етпеуі керек.
Шешім қабылдамас бұрын практикалық тексеру жоспары
Жылдам бастау нұсқаулығындағы бір сәтті мысалмен ғана шектелмей, нақты жөнелтілімдерге ұқсас жөнелтілімдерді пайдаланып тұжырымдаманы тексеріңіз. Операциялар, инженерия және клиенттерді қолдау топтарымен қабылдау критерийлерін келісіңіз.
- Жіберу: қажет жапсырма пішімдерін жасаңыз және қойма жабдығы оларды пайдалана алатынын растаңыз.
- Тапсырыстарды сәйкестендіру: бастапқы тарихты жоғалтпай, бөлінген жөнелтілімдерді, бірнеше сәлемдемені және ауыстырылатын жөнелтілімдерді сынаңыз.
- Бақылау: бизнесіңіз үшін маңызды тасымалдаушылар мен бағыттар бойынша нақты оқиғалар ретін тексеріңіз.
- Ерекше жағдайлар: орындалатын жеткізу мәселесі әрбір әдеттен тыс сканерлеуді автоматты түрде ақау деп санамай, дұрыс топқа жететінін тексеріңіз.
- Қалпына келтіру: сұрауды немесе webhook endpoint-ін тоқтатып, қолданбаның жетіспейтін ақпаратты қалай сәйкестендіретінін көрсетіңіз.
- Коммуникациялар: әр клиенттік хабарламаны тек белгіленген жүйе жіберетінін растаңыз.
- Коммерциялық сәйкестік: күтілетін пайдалану көлеміңіз бен провайдердің расталған есептеу анықтамаларын пайдаланып төлемдерді бағалаңыз.
Шешім ережесі: алдымен жетіспейтін мүмкіндікті сатып алыңыз. Егер жіберу қазірдің өзінде жұмыс істесе, фулфилментті қайта құрмай, бақылау интеграциясын бағалаңыз. Егер жапсырма жасау жетіспесе, алдымен жөнелту орындалуын шешіңіз. Қолданбаңыз жөнелтілімнің толық өмірлік цикліне жауапты болса, екі мүмкіндікті де тексеріп, біріктірілген немесе бөлінген архитектураның қайсысын командаңыз пайдалана алатынын таңдаңыз.
Жиі қойылатын сұрақтар
Shipping API әрқашан бақылауды қамти ма?
Жоқ. Кейбір қызметтер екі мүмкіндікті де қамтиды, ал басқалары оларды бөлек endpoint-тер, өнімдер немесе жоспарлар арқылы ұсынады. Бақылау қосылған болса да, оны сатып алғаннан кейінгі бақылау шешімі ретінде қарастырмас бұрын оқиғалар егжей-тегжейін, жаңарту жеткізу әдісін, тасымалдаушы қолдауын және пайдалану шарттарын тексеріңіз.
Жапсырмаларын фулфилмент серіктесі жасаған сәлемдемелерді бақылай аламын ба?
Иә, мүмкін. Қолданбаңызға бақылау интеграциясы талап ететін идентификаторлар, әдетте бақылау нөмірі және қажет болған жағдайда тасымалдаушы идентификаторы немесе қосымша растау ақпараты керек. Серіктестің тасымалдаушыларына қолдау көрсетілетінін растаңыз және бақылау нөмірлерінің жүйеңізге сенімді түрде түсетініне көз жеткізіңіз.
Tracking API тасымалдаушының сканерлеуін ертерек жасай ма?
Ол физикалық тасымалдаушы сканерлеуін жасай алмайды. Ол қолданбаңызға бақылау көздері арқылы қолжетімді болған ақпаратты алуға, ұйымдастыруға және таратуға көмектесе алады. API әр қозғалыс туралы бірден көрінімділікке кепілдік береді деп болжамай, нақты жөнелтілімдер арқылы жаңарту тәртібін бағалаңыз.
Екі мүмкіндікті де пайдалану үшін екі API провайдері қажет пе?
Жоқ. Сізге екі жеткізуші емес, екі функция қажет. Бір провайдер жөнелту және бақылау талаптарыңызға сәйкес келсе, соны пайдаланыңыз. Жұмыс істеп тұрған процесті сақтап қалса немесе біріктірілген нұсқа орындай алмайтын нақты талапты қамтамасыз етсе, оларды бөлек пайдаланыңыз.
Tracking API тапсырыстарды басқару жүйесін алмастыра ала ма?
Жоқ. Бақылау деректері — тапсырыстарды басқаруға кіріс дерегі, тауар қорын бөлуге, фулфилмент шешімдеріне, төлемдерді өңдеуге немесе тапсырыс жазбаларына балама емес. Қолданбаңыз әлі де әр жөнелтілімді дұрыс тапсырыспен байланыстырып, жөнелтілім оқиғаларының бизнес процестеріне қалай әсер ететінін шешуі керек.
Дереккөздер
- FedEx Ship API documentation — жөнелтілім жасауға, жапсырмаларға және жөнелту процесінің талаптарына арналған анықтамалық.
- FedEx tracking API documentation — бақылау сұраулары мен жөнелтілім мәртебесі туралы ақпаратқа арналған анықтамалық.
- 17TRACK Tracking API — бақылау интеграциясы санатына арналған ресми өнім анықтамалығы.
- 17TRACK API documentation — бақылауды тіркеуге, бақылау деректеріне және push-хабарландыру интеграциясына арналған анықтамалық.
