Walidacja kodów pocztowych - proste rozwiązanie na duże problemy - Ebmia

Moduł do walidacji kodów pocztowych rozwiązuje cały problem z błędami, które nieświadomie popełniali Klienci sklepu. Bazuje na ogólnodostępnym API, które zawiera pełną listę polskich kodów pocztowych i dopasowanych do nich miejscowości, łącznie z tymi najmniejszymi. System wyłapuje błędnie wprowadzone dane – w momencie uzupełniania danych w koszyku, czyli wpisywania kodu pocztowego i miejscowości, API jest odpytywane, czy te dane do siebie pasują. Na podstawie Informacji zwrotnej z API Klient jest przepuszczany dalej lub pojawia się komunikat o niezgodności danych i prośba o ich weryfikację..

Jakie API do walidacji kodów pocztowych braliśmy pod uwagę? Co oferuje rynek?

Research i analiza dostępnych na rynku opcji pokazała, że możemy skorzystać z kilku rozwiązań. 

• API Poczty Polskiej – usługa w pełni płatna; dane udostępniane są w pliku pdf; brak licencji na komercyjny użytek – nie ma prawnej możliwości, by tę bazę w jakikolwiek kopiować, czyli stworzyć własną bazę danych w oparciu o raz wyszukane rekordy, a na tym nam zależało;
• API GUS-u – to API z potężną bazą danych, niestety nieuwzględniającą kodów pocztowych; dane pozwalają sprawdzić poprawność wpisywanych adresów – korelacja ulicy i numeru budynku;
• API z darmową bazą kodów pocztowych – choć to rozwiązanie pod względem technicznym było ok, po głębszym rozpoznaniu tematu okazało się, że jego twórcy nielegalnie udostępniali dane; to jedna z pułapek, o której pisaliśmy. 

Jaką API wybraliśmy i dlaczego? Co jest kluczowe w ocenie rozwiązania?

Finalnie wybraliśmy Kody pocztowe API. To rozwiązanie spełniało nasze kluczowe założenia. Poza tym ma kilka innych zalet. 

• Posiada legalną w kontekście praw własności bazę danych, z zapewnieniem jej poprawności i aktualności.
• Dane można wykorzystać do tworzenia własnej bazy. 
• To darmowe rozwiązanie do poziomu 100 rekordów wyszukań dziennie. 
• Płatna wersja, abonamentowa, nie jest kosztowna; jeśli limit bezpłatnych rekordów nie wystarcza, można przejść na tę wersję.
• Łatwe do integracji – to API w stylu API REST, jest bardziej elastyczne podczas implementacji.  

• Wykorzystuje standardy PrestaShop – Presta w standardzie waliduje jedynie format kodu zgodny z krajem (np. XX-XXX dla Polski), ale na tę walidację możemy nałożyć kolejną warstwę; ułatwia to oddzielny hook do walidacji danych w formularzu z adresem – sprawia, że wpięcie tego API w silnik sklepu jest bardzo subtelne. 
• Przesyła dane w przyjaznym, standardowym formacie JSON. 

Jak z tego API wyciągnęliśmy jeszcze więcej? Co można zoptymalizować? 

Naszym znakiem rozpoznawczym jest to, że zawsze szukamy takich obszarów, które można zoptymalizować. To, co już działa dobrze, może działać jeszcze lepiej, generować oszczędności, być bardziej efektywne, łatwiejsze w użytkowaniu, obsłudze etc.

W tym przypadku priorytetem było tworzenie własnej bazy danych. 

Konkretne zapytanie do API – czyli weryfikacja zgodności kodu z miejscowością – jest zapisywane na stałe w bazie. To dedykowane rozwiązanie. Co daje?

• Oszczędzamy rekordy dostępne w abonamencie – wykorzystujemy zasoby API tylko wtedy, kiedy konkretne kod i miasto zostają wpisane po raz pierwszy, czyli tylko podczas pierwszej weryfikacji zgodności.
• Budujemy własną bazę i korzystamy z jej zasobów – jeśli w formularzu zamówienia ponownie pojawią się te same dane, nie ma potrzeby, by korzystać z  bazy API; kolejne weryfikacje realizowane są wewnątrz sklepu na podstawie własnej bazy. 
• To rozwiązanie w dużym stopniu umożliwia korzystanie z bezpłatnej wersji API, a z czasem uniezależnienie się od niej. 

Abonament czy wersja bezpłatna? 

Odpowiedź na to pytanie jest prosta, jeśli dobrze wiesz, ile zamówień dziennie spływa do Twojego sklepu. Jeśli nie przekracza ono 100, wersja bezpłatna w zupełności wystarczy. Jeśli zamówień jest znacznie więcej – skorzystaj z opcji abonamentowej. 

Możesz również pójść tropem rozwiązania, które my zastosowaliśmy – optymalizować wydatki abonamentowe i budować własną bazę danych. Ale tutaj sprawa robi się trochę bardziej skomplikowana. O czym musisz pamiętać? 

• Monitoruj sytuację na bieżąco – na początku własna baza pewnie nie będzie wystarczająca; każde dzienne przekroczenie limitu musi być zapisane, by znać skalę “zjawiska”.
• Reaguj – we właściwym momencie skorzystaj z wersji abonamentowej. 
• Zabezpiecz się – wprowadź dodatkowe zabezpieczenia, by brak weryfikacji kodu nie zablokował sprzedaży. 

Nie tylko kody pocztowe – inne źródła błędów

Podczas implementacji nowego narzędzia nie da się przewidzieć wszystkiego. Dlatego, szczególnie na początku, trzeba monitorować jego działanie i szybko reagować na ewentualne błędy. A takie pojawiły się na etapie wpisywania niektórych nazw miejscowości. Mowa o nazwach dwuczłonowych, które Klienci wpisywali uznaniowo – jedni ze spacją, inni z pauzą lub półpauzą. Mały błąd, ale system walidował całość jako niepoprawną (pomimo zgodności kodu i miasta). Efekt – nie można sfinalizować zamówienia. Ponieważ monitorowaliśmy sytuację na bieżąco, błąd został szybko naprawiony. 

Nie można było przewidzieć, w jakiej formie Klienci będą wpisywać dwuczłonowe nazwy, dlatego pozostawiliśmy im dowolność. To wymagało zmian w wersji porównawczej,  “bazowej” każdej z nazw. Znormalizowaliśmy je, czyli usunęliśmy wszystkie znaki specjalne (spacje, pauzy etc.) i wielkie litery. Dzięki temu, niezależnie od formy zapisu nazw miejscowych, system waliduje je jako poprawne.