Жөнелтімді қадағалау деректерін Oms жүйесіне қосу: тапсырыстарды сәйкестендіру және синхрондау ережелері
Жөнелтуді қадағалау деректерін тапсырыстарды басқару жүйесіне (OMS) қосу үшін әр қадағаланатын сәлемдемені ішкі жөнелту жазбасымен сәйкестендіріңіз, содан кейін сол жөнелтуді оның тапсырысымен және орындау жолдарымен байланыстырыңыз. Қадағалау жаңартуларын провайдер қолдайтын интерфейс арқылы қабылдаңыз, бастапқы оқиғаларды сақтаңыз және қайталанатын оқиғаларға, кешіктірілген жаңартуларға, жөнелту күйіне және тапсырыстың аяқталуына қатысты нақты ережелерді қолданыңыз. Қадағалау нөмірін жалғыз тапсырыс идентификаторы ретінде пайдаланбаңыз және бір жеткізу оқиғасының бірнеше сәлемдемеден тұратын тапсырысты автоматты түрде жабуына жол бермеңіз.
Бұл нұсқаулық осы байланысты жүзеге асыратын интеграция инженерлері мен электрондық коммерция операциялары топтарына арналған. Ұсынылатын жобалау тасымалдаушының бақылауларын бизнес шешімдерінен бөледі: қадағалау деректері сәлемдеменің жолын сипаттайды, ал OMS бұл жолдың орындау, клиенттермен байланыс және тапсырысты жабу тұрғысынан нені білдіретінін шешеді.
Әр жазбаның иелік етуші жүйесін анықтаңыз
API байланысын құрудан бұрын OMS әкімшісімен, орындау тобымен және клиенттерге қызмет көрсету тобымен иелік ету мәселесін келісіңіз. Әйтпесе техникалық тұрғыдан сәтті интеграцияның өзі жарамды бизнес деректерін қайта жазуы мүмкін.
- OMS: Тапсырыстарға, тапсырыс жолдарына, қажетті мөлшерлерге, жоюларға және тапсырыстың аяқталу ережелеріне иелік етеді.
- Орындау жүйесі: Өзі жасайтын жөнелту немесе сәлемдеме жазбаларына, соның ішінде орау бөліністері мен жапсырма тағайындауларына иелік етеді. Бұл OMS-тің өзі немесе бөлек қойма жүйесі болуы мүмкін.
- Қадағалау провайдері: Қадағалау бақылауларын және провайдер анықтаған кез келген күй санаттарын ұсынады.
- Интеграция қабаты: Идентификаторлардың өзара сәйкестігіне, оқиғаларды өңдеуге, қалыпқа келтіруге, қайталап орындауды басқаруға және синхрондау аудиті жазбаларына иелік етеді.
Бұларды бағдарламалық жасақтамаңыз туралы болжамдар емес, ұсынылатын шекаралар ретінде қарастырыңыз. Ерекшеліктерді құжаттаңыз. Мысалы, қойма жөнелту жапсырмасын ауыстыра алса, интеграция жаңадан байқалған нөмір ескісін алмастырды деп болжаудың орнына, сол жүйеден нақты жаңартуды қажет етеді.
Күйлерді синхрондамас бұрын тапсырыстан сәлемдемеге дейінгі сәйкестікті құрыңыз
Практикалық байланыс мынадай: тапсырыс → орындау → сәлемдеме → қадағалауды тағайындау. OMS басқа атауларды пайдалануы немесе осы жазбалардың кейбірін біріктіруі мүмкін. Дерекқор құрылымы өзгеше болса да, байланыстарды сақтаңыз.
Тапсырыста бірнеше орындау болуы мүмкін, ал бір орындауда бірнеше сәлемдеме болуы мүмкін. Сәлемдемеге ауыстырылған қадағалау тағайындауы немесе байланыстырылған соңғы миля идентификаторы берілуі мүмкін. Бұл идентификаторлар тапсырыс берілген мөлшерлерді арттырмауы тиіс.
| Жазба | Ұсынылатын өрістер | Мақсаты |
|---|---|---|
| Тапсырыс | Тенант немесе дүкен ID-і, өзгермейтін OMS тапсырыс ID-і | Сатушыларды ажыратады және көрсетілетін тапсырыс нөмірлеріне тәуелділікті болдырмайды. |
| Орындау | Орындау ID-і, тапсырыс ID-і, бөлінген жол ID-лері мен мөлшерлері | Сатып алынған заттардың қайсысы орындалып жатқанын анықтайды. |
| Сәлемдеме | Ішкі сәлемдеме ID-і, орындау ID-і, қолжетімді болса сәлемдеме бөліністері | Қадағалау жапсырмаларына тәуелсіз тұрақты идентификация береді. |
| Қадағалауды тағайындау | Тағайындау ID-і, сәлемдеме ID-і, провайдер тіркелгісі, тасымалдаушы идентификаторы, қадағалау нөмірі, белсенді кезең | Келіп түсетін қадағалау бақылауларын тиісті сәлемдемемен және тағайындау кезеңімен байланыстырады. |
Жаңартуларды сақталған өзара сәйкестік арқылы сәйкестендіріңіз
Жөнелту жасалған кезде оны қадағалауға тіркемес бұрын ішкі ID-лерін сақтаңыз. Құжатталған тіркеу процесі қайтарған провайдер берген қадағалау жазбасының ID-ін сақтаңыз. Провайдер сатушы сілтемесін қолдаса, ашық емес ішкі сілтемені пайдаланып, сәйкестікті жергілікті жерде сақтаңыз.
Келіп түсетін жаңартулар үшін алдымен сақталған провайдер жазбасының ID-ін тиісті провайдер тіркелгісі мен тенант аясында анықтаңыз. Бұл идентификатор қолжетімді болмаса, қадағалау нөмірі, тасымалдаушы идентификациясы, тіркелгі контексті және тағайындау тарихының құжатталған үйлесімін пайдаланыңыз. Мұны іздеу стратегиясы ретінде қарастырыңыз, бұл үйлесім жаһандық деңгейде бірегей деген кепілдік емес.
Клиент аты, электрондық пошта мекенжайы немесе ауқымы көрсетілмеген көрсетілетін тапсырыс нөмірі бойынша сәйкестендірмеңіз. Қадағалау нөмірлерін бастапқы нөлдері сақталуы үшін жол ретінде сақтаңыз. Тиісті тасымалдаушы немесе провайдер келісімі рұқсат етпесе, таңбаларды алып тастамаңыз және регистрді өзгертпеңіз.
Іздеу ешбір сәйкестік немесе бірнеше ықтимал сәйкестік қайтармаса, жаңартуды тексеру үшін оқшаулаңыз. Шешілмеген оқиға — қате клиенттің тапсырысына сенімді түрде жаңарту енгізуден қауіпсіз.
Бөлінген тапсырыстарды сәлемдеме бөліністерін ойдан шығармай өңдеңіз
Үш бірліктен тұратын мысалдық тапсырысты қарастырайық. А сәлемдемесінде екі бірлік, ал B сәлемдемесінде бір бірлік бар. А сәлемдемесінің жеткізілуі екі бірліктің жеткізілгенін дәлелдейді; бұл бүкіл тапсырыс жеткізілді дегенді білдірмейді.
Егер орындау жүйесі екі сәлемдеменің бір орындауға тиесілі екенін ғана тіркесе, бірлік деңгейіндегі бөліністерді ойдан шығармаңыз. Барлық қажетті сәлемдемелердің жеткізілгенін есептей аласыз, бірақ бөлініс деректері пайда болғанға дейін зат деңгейіндегі жеткізу есебі қолжетімсіз немесе анық белгісіз күйінде қалуы тиіс.
Қадағалау API-ін сенімді қабылдау қабаты арқылы қосыңыз
Провайдермен байланысты OMS жазбаларынан бөлек ұстайтын құбырды пайдаланыңыз:
Жөнелтуді жасау → қадағалауға тіркеу → келіп түсетін жаңарту немесе жоспарлы алу → оқиғаларды тұрақты сақтау → сәйкестендіру және қалыпқа келтіру → OMS жаңартуы → салыстырып тексеру
17TRACK іске асыруы үшін Tracking API өнім беті және ресми API құжаттамасы тиісті бастапқы нүктелер болып табылады. Адаптерді іске асырудан бұрын қолданылатын тіркеу интерфейсін, тасымалдаушы идентификаторларын, жаңартуларды жеткізу нұсқаларын, аутентификация талаптарын, күй анықтамаларын және тіркелгі шектеулерін растаңыз. Бұл нұсқаулықтағы деректер моделі — интеграция бойынша ұсыныс; ол 17TRACK осы өріс атауларын пайдаланады немесе OMS үшін жергілікті коннектор ұсынады деген мәлімдеме емес.
Таңдалған провайдер вебхуктарды қолдаса, келіп түсетін сұрауларды оның құжатталған механизмі арқылы аутентификациялаңыз және қабылданған хабарламаларды растаудан бұрын тұрақты түрде сақтаңыз. Баяу OMS жұмысын сұрау жолынан тыс орындаңыз. Белгілі бір жауап денесі немесе күту уақыты болады деп болжаудың орнына, провайдердің нақты растау және қайталап орындау келісімін ұстаныңыз.
Сауалнама арқылы алу қажет болса, API қолдайтын жерде алу барысын сақтаңыз, қатар орындалуды бақылаңыз және құжатталған жиілік шектеулерін ұстаныңыз. Вебхуктың қабылдануы да, сәтті сауалнама сұрауы да OMS жаңартылғанын дәлелдемейді; бұл нәтижелерді бөлек тіркеңіз.
Қайталап орындаулар мен кеш оқиғаларға төтеп беретін синхрондау ережелерін анықтаңыз
1. Өңдеуді идемпотентті етіңіз
Бір бақылауды екі рет өңдеу жөнелтуді қайталамауы, мөлшерлерді екі рет жылжытпауы немесе клиентке бірдей хабарламаны қайта жібермеуі тиіс. HTTP кез келген POST операциясын идемпотентті етпейді; интеграция қайталанудан қорғауды іске асыруы керек. RFC 9110 HTTP әдістерінің идемпотенттілігін түсіндіреді.
Құжатталған әрі қолжетімді болса, тұрақты провайдер оқиғасының ID-ін пайдаланыңыз. Әйтпесе тағайындау ID-і мен оқиғаның уақыт белгісі, бастапқы күйі және орналасқан жері сияқты тиісті оқиға өрістерінен саусақ ізін анықтаңыз. Соқтығысу немесе оқиға сипаттамаларының өзгеру мүмкіндігін құжаттаңыз. Бастапқы бақылауды ол қосымша OMS әрекетіне әкелмесе де сақтаңыз.
Әр жанама әсерді бөлек қорғаңыз. Мысалы, OMS күйін жазу мен электрондық пошта хабарламасының өз дедупликация басқаруы болуы керек. Процесс істен шыққанда қабылданған оқиға жоспарланған жаңартусыз қалмауы үшін транзакциялық outbox немесе соған баламалы тұрақты жұмыс жазбасын пайдаланыңыз.
2. Оқиға уақытын және қабылдау уақытын бөлек сақтаңыз
Оқиғаның болған уақыты мен интеграция оны қабылдаған уақыт әртүрлі сұрақтарға жауап береді. Екеуін де бастапқы уақыт белгісінің көрсетілімімен және берілген уақыт белдеуі ығысымымен бірге сақтаңыз. Уақыт белдеуі белгісіз оқиғаға қойма уақыт белдеуін үнсіз тағайындамаңыз.
Кеш келген жолда келе жатыр сканы әдетте тарихты толықтыруы керек, жаңарақ жеткізілді күйін алмастырмауы тиіс. Алайда тек уақыт белгілері жеткіліксіз: провайдер түзету шығаруы мүмкін, ал оқиғаларда уақыт туралы толық ақпарат болмауы ықтимал. Қолжетімді болса, құжатталған реттік немесе түзету өрістерін және нақты түзету саясатын пайдаланыңыз.
3. Бастапқы дерек мәліметтерін өшірмей күйлерді қалыпқа келтіріңіз
OMS түсінетін шағын ішкі сөздік жасаңыз: тасымалдаушының қабылдауын күту, жолда, жеткізуге шығарылды, жеткізілді, ерекше жағдай және қайтарылуда. Провайдердің құжатталған күйлерін осы санаттарға сәйкестендіріңіз. Бұл — тасымалдаушылардың әмбебап анықтамалары емес, ұсынылатын ішкі санаттар.
Бастапқы күй кодын, сипаттамасын, оқиға орнын, провайдер жазбасына сілтемені және сәйкестендіру ережесінің нұсқасын сақтаңыз. Сәйкестендірілмеген мән жеткізілді немесе орындалмады күйіне әдепкі түрде ауысудың орнына тексеруге болатын жағдай жасауы тиіс. Жапсырманың жасалуы, бастапқы оқиға бұл түсіндірмені нақты қолдамаса, тасымалдаушының сәлемдемені физикалық қабылдағанының дәлелі ретінде қарастырылмауы керек.
4. Қарапайым сандық дәрежелеудің орнына ауысу ережелерін пайдаланыңыз
Жөнелту күйлері әрқашан түзу сызық бойымен жүрмейді. Ерекше жағдайдан кейін қалыпты тасымал жалғасуы мүмкін, ал жеткізу әрекеті жеткізілді дегенді білдірмейді. Қайтару қозғалысы бұрынғы жеткізу оқиғасынан кейін басталуы мүмкін.
- Кейінгі дәлелдер қозғалыстың қайта басталғанын көрсетсе, ерекше жағдайдың жойылуына мүмкіндік беріңіз.
- Қалыпты тарихи сканның жеткізілді күйін үнсіз алмастыруына жол бермеңіз.
- Құжатталған түзетуге бақыланатын қайта қарау жолы арқылы рұқсат беріңіз.
- OMS қолдаса, қайтару қозғалысын жөнелтудің аяқталуынан бөлек бақылаңыз.
- Түсініксіз немесе қарама-қайшы дәлелдерді операциялық кезекке жіберіңіз.
Бұл ережелердің нұсқаларын басқарыңыз. Сәйкестендіру өзгерген кезде оның тек жаңа оқиғаларға қолданылатынын немесе тарихи жазбаларға бақыланатын қайта есептеу қажет екенін шешіңіз.
Тапсырыс күйін қажетті орындау міндеттемелері негізінде есептеңіз
Сәлемдеме күйі мен тапсырыс күйі бөлек өрістер болуы керек. Жеткізілді деп белгіленген сәлемдеме сол сәлемдемеге қатысты дәлел береді; тапсырыстың аяқталуы қалған қажетті мөлшерлер мен бизнес саясатыңызға байланысты.
Пайдалы әдепкі ереже — барлық жеткізілуі қажет мөлшерлерде сәлемдеме деңгейіндегі жарамды жеткізу дәлелі болғанда және ешбір қажетті бөлініс шешілмей қалмағанда ғана тапсырысты толық жеткізілді деп белгілеу. OMS-тің жою ережелеріне сәйкес жойылған мөлшерлерді алып тастаңыз. Цифрлық заттарды, алып кету тапсырыстарын және басқа да жөнелтілмейтін міндеттемелерді өздерінің аяқталу шарттары арқылы өңдеңіз.
Ауыстырылатын жөнелтулер нақты байланыстарды қажет етеді. Жоғалған сәлемдеме ауыстырылса, ауыстыру бастапқы жеткізу міндеттемесінің орнын баса ма, соны шешіңіз. Әйтпесе бастапқы сәлемдеме аяқталуға шексіз кедергі келтіруі немесе екі сәлемдеме де орындауға есептелуі мүмкін. Шешімді тек қадағалау күйінен шығармай, оны тіркеңіз.
Жеткізудің аяқталуын қаржылық жабудан, қайтарымға жарамдылықтан және дауды шешуден бөлек ұстаңыз. Тасымалдаушының жеткізу оқиғасы қайтарымды автоматты түрде мақұлдамауы немесе клиент талабын реттемеуі тиіс.
Аудит ізін жоғалтпай ақаулардан қалпына келіңіз
Уақытша ақауларды шектелген артқа шегеру және құжатталған қайталап орындау нұсқауларын пайдаланып қайталаңыз. Уақытша байланыс ақауларын жарамсыз идентификаторлардан, мерзімі өткен тіркелгі деректерінен, рұқсат қателерінен және схема үйлесімсіздігінен ажыратыңыз. Соңғылары шексіз қайталауды емес, түзету әрекетін талап етеді.
Ақаулы жұмыс кезегінде тиісті тенантты, сәлемдемені, оқиға сілтемесін, орындалған операцияны, қате санатын және келесі әрекетті сақтаңыз. Қажетсіз клиент деректерін немесе тіркелгі деректерін журналдарға көшірмей, тексеруге жеткілікті контексті тіркеңіз.
Қалыпты жаңарту жолына қосымша салыстырып тексеруді іске қосыңыз. Қадағалау ақпараты ескірген белсенді жөнелтулерді, OMS жазбасы сәтсіз аяқталған қабылданған оқиғаларды, сәйкестендірілмеген бақылауларды және интеграция есептеген күй мен OMS арасындағы айырмашылықтарды тексеріңіз. Тексеру жиілігін кез келген әмбебап кестені қолданудың орнына жеткізу міндеттемелеріне, API шектеулеріне және операциялық тәуекелге қарай таңдаңыз.
Иелік етуді белгілеңіз: инженерия қабылдау және жазу ақауларын өңдейді; орындау операциялары жетіспейтін сәлемдеме байланыстарын шешеді; клиенттерге қызмет көрсету клиентпен байланыс қажет ететін ерекше жағдайларды қарайды. Жауапты иесі жоқ кезек — жай ғана сақтау орны.
Іске қоспас бұрын сәйкестендіру мен бизнес ережелерін тексеріңіз
Бақыланатын тест деректерін және өндірістің шектеулі іске қосылуын пайдаланыңыз. Келесі жағдайларды оқиғалар тарихына да, нәтижесінде пайда болған OMS жазбасына да қатысты тексеріңіз:
- Бір сәлемдемелі тапсырыс қалыпты түрде жеткізуге дейін ілгерілейді.
- Бөлінген тапсырыста бір сәлемдеме жеткізілген, ал екіншісі әлі жолда.
- Бір оқиға қайталама жанама әсерлерсіз бірнеше рет қабылданады.
- Ескі жолдағы скан жеткізілгеннен кейін келеді.
- Белгісіз тасымалдаушы немесе күй тексеру кезегіне түседі.
- Басқа орындау міндеттемесін жасамай, жапсырма ауыстырылады.
- Бекітілген ереже бойынша ауыстырылатын жөнелту бастапқы сәлемдеменің орнын басады.
- Оқиға қабылданғаннан кейін OMS қолжетімсіз болады.
- Процесс OMS жазуы мен оның расталуы арасында қайта іске қосылады.
- Айқас тенанттық сәйкестендірусіз екі дүкенде бірдей көрсетілетін тапсырыс нөмірі болады.
Әр қабылданған оқиғаның қадағаланатын өңдеу нәтижесі болғанда, түсініксіз сәйкестіктер тапсырыстарды автоматты түрде жаңарта алмағанда және операторлар сәтсіз жұмысты қауіпсіз қайталай алғанда іске қосыңыз. Бұл қабылдау критерийлері API сұрауының сәтті орындалғанын ғана көрсетуден пайдалырақ.
Жиі қойылатын сұрақтар
Қадағалау нөмірлерін тікелей тапсырыстарға байланыстыра аламын ба?
Қатаң түрде бір сәлемдемелі жұмыс процесі үшін тікелей байланыс бастапқыда жеткілікті болуы мүмкін. Дегенмен тапсырыс пен қадағалауды тағайындау арасында ішкі жөнелту идентификаторын пайдаланыңыз. Ол тапсырыс жазбасының мағынасын өзгертпей, бөлінген жөнелтулерге, қайта жапсырмалауға және ауыстыруларға көшу жолын береді.
Интеграция вебхуктарды немесе сауалнаманы пайдалануы керек пе?
Провайдер қолдайтын және инфрақұрылымыңызға үйлесімді жеткізу механизмін пайдаланыңыз. Вебхуктар қайталап алуды азайта алады, ал сауалнама қолжетімді болған жерде алуға негізделген жұмыс процестері мен салыстырып тексеруді қолдай алады. Екі тәсіл де тұрақты сақтауға, қайталануды өңдеуге және қалпына келтіруге деген қажеттілікті жоймайды.
Қадағалау оқиғасының сәйкес тапсырысы болмаса не болуы керек?
Оны сәйкестендірілмеген оқиғалар кезегінде сақтап, тіркеу жазбасын, тенант контекстін, тасымалдаушы идентификациясын және жөнелтуді жасау уақытын зерттеңіз. Тапсырыс жасамаңыз және оқиғаны ықтимал клиентке автоматты түрде байланыстырмаңыз. Сәйкестік түзетілгеннен кейін оны қайта өңдеңіз.
Жеткізу хабарламалары OMS-тен немесе қадағалау жүйесінен келуі керек пе?
Әр хабарлама түрі мен триггері үшін бір иені таңдаңыз. Егер екі жүйе бірдей хабарлама жібере алса, бір жолды өшіріңіз немесе тұрақты хабарлама журналын ортақ пайдаланыңыз. Сондай-ақ хабарлама бір сәлемдемеге ме, әлде толық тапсырысқа ма қатысты екенін, әсіресе бөлінген орындау кезінде, шешіңіз.
Ерекше жағдай күйі тапсырыс орындалмады дегенді білдіре ме?
Жоқ. Ерекше жағдай — міндетті түрде тұрақты нәтиже емес, түсіндіруді қажет ететін бақылау. Себебін сақтаңыз, кейінгі оқиғаларды бақылаңыз және операциялар қашан араласуы керектігін шешу үшін эскалация саясатын пайдаланыңыз.
Дереккөздер
- 17TRACK Tracking API — API интеграциясының бастапқы нүктесіне арналған ресми өнім анықтамасы.
- 17TRACK API құжаттамасы — провайдерге тән келісімге арналған іске асыру анықтамасы; орналастырмас бұрын қолданылатын интерфейстер мен тіркелгі талаптарын тексеріңіз.
- RFC 9110, 9.2.2-бөлім: Идемпотентті әдістер — әдіс идемпотенттілігі мен қолданба деңгейіндегі қайталанудан қорғау арасындағы айырмашылықты қолдайтын HTTP семантикасы.


