integracja z ERP powoduje błędne dane w e-mailu

Sytuacja, w której integracja z ERP powoduje błędne dane w e-mailu, to usterka mapowania pól między systemami.

Jak integracja ERP zmienia dane przed wysłaniem wiadomości

Integracja systemu ERP z modułem poczty elektronicznej polega na przekazywaniu danych między różnymi aplikacjami. System ERP może dostarczać informacje o kontrahencie, numerze dokumentu, terminie płatności, kwocie, statusie zamówienia albo osobie odpowiedzialnej za obsługę sprawy. Moduł odpowiedzialny za wysyłkę e-maila wykorzystuje te dane do utworzenia adresata, tematu oraz treści wiadomości. Jeżeli dane w e-mailu są nieprawidłowe, przyczyną często jest błędne mapowanie pól, czyli przypisanie wartości z jednego systemu do niewłaściwego pola w drugim systemie.

Problem może dotyczyć zarówno prostych wartości tekstowych, jak i pól o określonym typie. Przykładowo numer dokumentu może zostać pobrany zamiast numeru zamówienia, nazwa płatnika może trafić do pola odbiorcy, a data zapisana w jednym formacie może zostać wyświetlona jako inny dzień lub miesiąc. Błąd może także wystąpić wtedy, gdy ERP przechowuje kilka adresów e-mail dla jednego kontrahenta, natomiast integracja pobiera pierwszy znaleziony adres bez uwzględnienia jego przeznaczenia. W efekcie wiadomość może mieć poprawną składnię, lecz zawierać dane niezgodne z dokumentem źródłowym.

Mapowanie pól, typy danych i reguły budowania wiadomości

Mapowanie pól powinno określać, z którego pola źródłowego ERP pobierana jest każda wartość używana w wiadomości. Dotyczy to między innymi adresu e-mail, nazwy odbiorcy, numeru faktury, numeru zamówienia, waluty, sumy dokumentu i terminu płatności. Jeżeli konfiguracja odwołuje się do podobnie nazwanych pól, pomyłka może pozostać niewidoczna podczas zwykłego testu. Pola „odbiorca”, „płatnik” i „osoba kontaktowa” mogą zawierać różne dane, mimo że wszystkie są związane z tym samym dokumentem.

Znaczenie ma również typ danych oraz sposób jego konwersji. Kwota zapisana jako liczba może zostać przekształcona do tekstu z nieprawidłowym separatorem dziesiętnym. Data może zostać odczytana bez informacji o strefie czasowej albo sformatowana według ustawień innego systemu. Wartości puste, wartości domyślne i pola wielowartościowe wymagają osobnych reguł. Jeżeli integracja nie rozróżnia braku danych od pustego tekstu, może wygenerować wiadomość z niepełnym adresatem, pustym numerem dokumentu lub zastępczą wartością, która wygląda jak prawidłowa informacja.

Ślad diagnostyczny od rekordu ERP do gotowego e-maila

Sprawdzenie błędu powinno obejmować pełny przepływ danych, a nie tylko wygląd odebranej wiadomości. Najpierw porównuje się wartości zapisane w konkretnym rekordzie ERP z wartościami przekazanymi przez mechanizm integracyjny. Następnie należy sprawdzić wynik transformacji, dane wejściowe szablonu oraz końcowy komunikat przekazany do usługi pocztowej. Takie porównanie pozwala ustalić, czy pomyłka powstała już przy odczycie rekordu, podczas mapowania, przy formatowaniu danych, czy dopiero w szablonie e-maila.

Pomocne są identyfikatory korelacyjne, identyfikator dokumentu oraz znaczniki czasu operacji. Jeżeli integracja zapisuje logi, można zestawić wywołanie dotyczące konkretnego dokumentu z wersją szablonu i zestawem przekazanych pól. Należy zwrócić uwagę na sytuacje, w których dane są pobierane ponownie po zmianie dokumentu. Wiadomość może zawierać starszą wersję kwoty lub adresu, jeśli kolejka integracyjna używa wcześniej utworzonego komunikatu albo przetwarza zdarzenia w innej kolejności. Osobnego sprawdzenia wymaga także mechanizm ponawiania, ponieważ ponowne przetworzenie tego samego zdarzenia nie powinno nadpisywać danych wartościami z innego dokumentu.

Naprawa konfiguracji i kontrola poprawności po zmianie

Usunięcie problemu zwykle wymaga skorygowania źródła pola, reguły transformacji albo szablonu wiadomości. Zmiana powinna być wykonana dla konkretnego przepływu, na przykład dla powiadomień o fakturach, potwierdzeń zamówień lub informacji o zmianie statusu. Nie należy zakładać, że poprawka jednego szablonu naprawi wszystkie wiadomości, ponieważ różne procesy mogą korzystać z odrębnych mapowań. Trzeba również sprawdzić, czy dane są pobierane z właściwej firmy, oddziału, magazynu lub kontekstu dokumentu, jeżeli system ERP rozróżnia takie obszary.

Po zmianie należy przetestować co najmniej rekord z kompletem danych, rekord z pustym polem opcjonalnym, dokument z kilkoma adresami kontaktowymi oraz wartości zawierające polskie znaki, liczby dziesiętne i daty. Wynik należy porównać z rekordem źródłowym, a nie tylko z oczekiwanym tekstem szablonu. W przypadku środowiska produkcyjnego ważne jest także potwierdzenie, że poprawiona konfiguracja została wdrożona do właściwego procesu i nie została zastąpiona starszą wersją podczas publikowania ustawień. Diagnostyka może obejmować komputer używany do obsługi integracji, jego aplikacje klienckie, pliki konfiguracyjne oraz lokalne logi potrzebne do odtworzenia przebiegu błędnej operacji.