Как доставчиците на услуги след покупка използват данните за проследяване, за да обслужват множество марки с един API
Доставчиците на услуги след покупка могат да обслужват множество марки чрез една интеграция с API за проследяване, като събират актуализациите за пратките централизирано, свързват всяка пратка с правилната марка и поръчка и предоставят специфично за марката изживяване чрез собствените канали на всеки клиент. Споделената връзка опростява събирането на данни за проследяване; тя не премахва необходимостта от отделни клиентски данни, правила за съобщения, разрешения и работни процеси за обслужване за всяка марка.
Този модел е полезен за агенции, платформи за клиентска поддръжка, партньори по изпълнение на поръчки и други доставчици, които управляват комуникациите за доставките от името на няколко търговци. Практическият въпрос не е просто дали едно API може да върне статус на проследяване. Въпросът е дали доставчикът може да превърне този статус в надеждно, подходящо брандирано действие, без да показва данните на един клиент на друг.
Какво всъщност прави споделеното API
API за проследяване предоставя на доставчика на услуги програмен начин да изпраща или проверява идентификатори на пратки и да получава информация за проследяването. Вместо да изгражда отделна интеграция с превозвач за всеки търговец, доставчикът може да предостави данните за проследяване на собственото си приложение чрез обща връзка нагоре по веригата. След това приложението на доставчика определя коя марка притежава пратката и какво да направи с информацията.
Това разграничение е важно. Едно API за проследяване не е същото като един споделен клиентски акаунт, една страница за проследяване или един шаблон за известия. Интеграцията нагоре по веригата се занимава със събирането на данни. Доставчикът на услуги остава отговорен за своя продукт надолу по веригата: въвеждането на търговци, съпоставянето на поръчки, езика, насочен към клиентите, контрола на достъпа, инструментите за поддръжка и записите за това какво е било комуникирано.
Работещата архитектура има три слоя. Първо, слой за приемане получава референция към пратка и извлича актуализации за проследяването. Второ, вътрешен запис за пратката свързва тези актуализации с правилния търговец, поръчка, превозвач и получател. Трето, слой за представяне използва правилата на търговеца, за да реши дали да актуализира страницата на поръчката, да извести служител по поддръжката или да изпрати съобщение до клиент. Разделянето на тези слоеве улеснява добавянето на друга марка, без да се преработва връзката за проследяване.
Проследете една пратка от регистрацията до действието на клиента
Нека разгледаме доставчик, който управлява актуализациите за доставки за два несвързани онлайн магазина. И двата магазина изпращат данни за пратките до доставчика, но всеки запис трябва да включва идентификатор на клиентския профил: недвусмисления вътрешен ключ на доставчика за марката, която го притежава. Доставчикът се нуждае и от достатъчно информация, за да свърже пратката с поръчка. Самият номер за проследяване може да не е безопасен глобален ключ, тъй като пратките могат да включват различни превозвачи, повторно използвани идентификатори или корекции на първоначалните данни за поръчката.
- Регистрирайте пратката. Получете идентификатора на марката, референцията на поръчката, номера за проследяване и всички други разрешени данни, необходими за съпоставянето. Валидирайте входа, преди да заявите данни за проследяване. Съхранявайте идентификационните данни и информацията за контакт с клиента отделно от общите записи на събитията за проследяване, когато това е практично.
- Съберете и запазете актуализацията от източника. Извличайте информацията за проследяване чрез upstream API, като използвате документираните му методи. Запазвайте статуса от източника, описанието на събитието, времевия печат и местоположението, когато са предоставени. Не заменяйте първоначалното събитие само с опростен етикет; екипите по поддръжката може да се нуждаят от оригиналната формулировка, за да разследват изключение.
- Нормализирайте внимателно. Съпоставяйте събитията от източника с малък вътрешен набор от състояния, като „в транзит“, „подготовка за доставка“, „доставено“ или „изключение“. Запазвайте оригиналното събитие заедно със съпоставянето. Общото състояние е полезно за автоматизация, но може да скрие различия, които са важни за клиента или служителя по поддръжката.
- Прилагайте правилата на марката. Един търговец може да иска имейл „подготовка за доставка“, а друг да предпочита само актуализация на страницата на поръчката. Определяйте допустимостта според конфигурацията на марката, предпочитанията на клиента за комуникация, актуалността на събитието и историята на вече изпратените съобщения.
- Записвайте резултата. Съхранявайте кое събитие е задействало кое действие, коя политика на марката е била приложена и дали доставката до канала надолу по веригата е била успешна. Това осигурява проследимост при отстраняване на проблеми с дублирани известия и клиентски оплаквания.
Следователно един и същ статус от upstream системата може да доведе до различни действия за различните марки. Това е смисълът на модела със споделена услуга: централизиране на събирането и оперативната поддръжка, като същевременно се запазва взаимоотношението на всеки търговец с неговите клиенти.
Проектните решения, които определят дали системата ще се мащабира
Направете собствеността на клиентския профил явна
Всяка пратка, събитие, съпоставяне с поръчка, правило за известия и връзка, насочена към клиента, трябва да се отнася до конкретен клиентски профил. Проверявайте собствеността на профила при въвеждането на данните в системата и отново, когато приложение или потребител от поддръжката ги прочете. Страница, брандирана за търговец, не трябва да разчита само на номера за проследяване, за да определи кой клиентски запис да покаже. Достъпът трябва да бъде ограничен според удостоверения търговец или подходящо ограничена клиентска връзка.
Разделяйте идентификационните данни и разрешенията според реалния модел на акаунта, предлаган от upstream доставчика, и договорните отношения с всеки търговец. Една техническа интеграция не предоставя автоматично разрешение за обединяване на всички данни на търговците или за предоставяне на еднаква видимост на всеки клиент. Документирайте кой може да регистрира пратки, да извлича събития, да експортира записи и да променя настройките за известия.
Третирайте събитията за проследяване като актуализации, а не като гарантирани команди
Информацията за проследяване може да пристигне със закъснение, да се появи извън ред или да съдържа корекция. Система, която изпраща ново съобщение всеки път, когато прочете събитие, рискува да изпраща дублирани или подвеждащи имейли. Използвайте стабилен ключ на събитието, когато източникът предоставя такъв; в противен случай определете документирано правило за премахване на дубликати с наличните полета за пратката и събитието. Съхранявайте отделно момента, в който доставчикът е забелязал актуализацията, и времето на събитието, съобщено от източника.
Не приемайте, че всяка пратка следва една и съща последователност от състояния. Изключение може по-късно да бъде разрешено, а събитие с по-късен момент на пристигане може да описва по-ранно физическо сканиране. Преди да използвате статус за задействане на обещание или ескалация, решете как приложението ще обработва остаряла, противоречива или липсваща информация. При твърдение, насочено към клиента, например за доставка, показвайте подкрепящото събитие, вместо да внушавате, че вътрешен етикет доказва повече, отколкото казва записът от източника.
Планирайте извличане чрез заявки, обратни извиквания и повреди
Стратегията на доставчика за актуализации трябва да следва действителната документация на upstream API. Ако са налични обратни извиквания за съответния акаунт и тип събитие, приложението все пак трябва да удостоверява входящите заявки, да обработва повторни опити и безопасно да обработва дублирани доставки. Ако използва периодични заявки, то се нуждае от график, който спазва документираните ограничения и избягва ненужни повтарящи се заявки. Нито един от двата подхода не премахва необходимостта от възстановяване, когато дадена актуализация е пропусната или известие надолу по веригата е неуспешно.
HTTP отговорите също трябва да се интерпретират правилно. Приета заявка например не трябва да се третира като доказателство, че пратката вече е получила ново събитие за проследяване. Спецификацията HTTP Semantics определя значенията на кодовете за отговор; собствената документация на доставчика на проследяването трябва да установи какво означава конкретният отговор на API за регистрацията или извличането на пратка. Изградете мониторинг както за технически повреди, така и за бизнес повреди, например валиден отговор, който не може да бъде свързан с поръчка.
Какво да проверите, преди да изберете API за проследяване
За доставчик, работещ с множество марки, най-добрата интеграция е тази, която пасва на целия оперативен модел, а не просто тази, която връща примерен резултат от проследяване. Поискайте от потенциалните доставчици да покажат как документираното им API поддържа пратките и работните процеси, с които действително работите. Краткото доказателство за концепция трябва да включва множество търговци, превозвачите, които те използват, и поне един непълен или проблемен запис на пратка.
- Приемане на пратки: Какви идентификатори и данни за превозвача са задължителни? Как се съобщава за невалидни или дублирани подавания? Може ли приложението да свърже собствената си референция за поръчка или клиентски профил със заявката, или това свързване трябва да остане изцяло в неговата база данни?
- Доставка на актуализации: Актуализациите се извличат, изпращат или и двете за съответния план? Какви са документираните ограничения на заявките, очакванията за повторен опит, методите за удостоверяване и отговорите при грешка? Проверете това спрямо актуалната документация, вместо да приемате, че функция, описана на високо ниво, е налична във всяка конфигурация.
- Качество на събитията: Кои оригинални полета се връщат и как трябва да се тълкуват времевите печати, имената на превозвачите, местоположенията и събитията, свързани с доставката? Тествайте с реални примери за пратки от търговците, които въвеждате.
- Операции с клиентски профили: Може ли доставчикът да разделя достъпа, отчитането на използването и разследванията от поддръжката по клиенти в собствената си система? Ако се нуждае от разделяне на upstream акаунти, потвърдете дали и как това се поддържа, преди да се ангажирате с архитектурата.
- Обработка на данни: Каква информация за клиента или пратката трябва да бъде изпратена нагоре по веригата? Прегледайте изискванията за съхранение, изтриване, сигурност и договорни отношения със страните, отговорни за тези данни. Насоките за сигурност на API, включително OWASP API Security Project, предоставят полезна основа за разглеждане на рисковете, свързани с оторизацията и достъпа.
Страницата на 17TRACK за Tracking API и документацията за разработчици са подходящи начални точки за доставчик, който оценява споделена интеграция за проследяване. Приемайте документацията като авторитетен източник за детайлите по внедряването и потвърдете необходимите методи, поддържаните сценарии за пратки, условията за достъп и търговските договорености за предвидената употреба, преди да изградите услуга за множество клиенти около тях. Публичната страница за API сама по себе си не доказва, че всеки желан работен процес на търговеца се поддържа.
Къде доставчикът трябва да запази контрола
Данните за проследяване могат да информират изживяването след покупката, но не трябва да диктуват цялото изживяване. Доставчикът трябва да управлява съпоставянето на пратката с търговеца, правилата за контакт с клиента и използвания език, когато дадена актуализация е несигурна. Ако дадено събитие казва само, че пратката е достигнала съоръжение, брандираното съобщение не трябва да обещава дата на доставка. Ако проследяването спре да се актуализира, системата трябва да разграничава липсата на нова информация от доказателство, че пратката е изгубена.
Работните процеси за поддръжка заслужават същото внимание. Дайте на оторизираните служители оригиналното събитие за проследяване, нормализирания статус, времето на записване на всеки от тях и историята на известията. Този изглед помага на служителя да обясни защо клиентът е видял конкретно съобщение и да реши дали проблемът се нуждае от допълнително разследване. Той също така улеснява одитирането на операциите с множество марки: проблемът може да бъде проследен до upstream актуализация, грешка при съпоставянето, правило на търговеца или неуспешно съобщение, вместо неопределено да бъде приписван на API.
Започнете с ограничен пилотен проект. Свържете един или двама търговци, регистрирайте представителни пратки и тествайте обичайни събития за доставка заедно с изключения, липсващи данни за превозвача, дублирани актуализации и коригирани поръчки. Потвърдете, че всяка марка вижда само собствените си пратки и че неуспешно известие може да бъде изпратено повторно, без да се създава второ съобщение до клиента. Добавяйте още търговци едва след като това поведение стане предвидимо. Едно API може да намали работата по интеграцията, но надеждната услуга за различни марки се осигурява от изградените около него контроли.
Често задавани въпроси
Означава ли едно API за проследяване, че всяка марка използва една и съща страница за проследяване?
Не. API може да предоставя информация за проследяване на приложението на доставчика, докато всяка марка запазва собствен дизайн на страницата, настройки на домейна, език към клиентите и правила за известия. Тези брандирани изживявания трябва да бъдат внедрявани и поддържани отделно.
Може ли номерът за проследяване сам по себе си да идентифицира правилната марка?
Той не трябва да бъде единственият идентификатор на клиентския профил. Запазете изричен ключ на марката или клиентския профил, когато пратката влиза в системата, след което свържете номера за проследяване със записа на поръчката на тази марка. Проверете връзката отново, преди да покажете информация за пратката или да изпратите съобщение.
Трябва ли доставчикът да изпраща известие за всяко ново събитие за проследяване?
Обикновено не. Някои събития се повтарят, закъснели са или са прекалено технически, за да бъдат полезни за клиента. Определете кои типове събития отговарят на условията, потискайте дубликатите, проверявайте предпочитанията за комуникация и запазвайте оригиналната актуализация за преглед от поддръжката.
Какво трябва да се тества, преди да бъде добавен още един търговец?
Тествайте действителните входни данни за пратките на търговеца, комбинацията от превозвачи, съпоставянето на поръчките, разрешенията за достъп, правилата за известия и обработката на изключения. Включете случай, при който данните за проследяване липсват или закъсняват, и проверете дали информация за пратка или клиент не може да премине към акаунта на друг търговец.


