Kielce, dnia 27.02.2012 roku HB Technology Hubert Szczukiewicz ul. Kujawska 26 / 39 25-344 Kielce Tytuł Projektu: Wdrożenie innowacyjnego systemu dystrybucji usług cyfrowych, poszerzenie kanałów sprzedaży i stworzenie usystematyzowanych protokołów wymiany danych w procesach biznesowych pomiędzy firmą HB TECHNOLOGY a jej Partnerami. Nr umowy: UDA-POIG.08.02.00-26-025/10-00 Załącznik nr 6 do Zapytania Ofertowego z dnia 27.02.2012 r. e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 1 z 8
1. Określenie możliwości integracyjnych Platformy Usługowej z systemami informatycznymi partnerów 1.1. Określenie komponentów platformy oraz procesów biznesowych związanych z wymianą danych z systemami informatycznymi partnerów Zgodnie z założeniami dotyczącymi zakresu integracji pomiędzy Platformą Usługową a systemami informatycznymi partnerów-resellerów, automatyczna wymiana danych powinna zachodzić w procesach: Rozliczeniowych wszelkie informacje związane z wykorzystaniem usług przez klientów partnera a także operacje finansowe przeprowadzane przez klientów powinny być automatycznie przesyłane do systemów informatycznych partnerów Administracyjnych automatyczna wymiana danych powinna zachodzić także w zakresie zmian w definicjach usług oferowanych przez HB Technology (np. dodanie nowej usługi na Platformie Usługowej, modyfikacja istniejącej usługi) Utrzymaniowych Platforma Usługowa powinna udostępniać automatyczną wymianę danych związaną z zapewnieniem bezproblemowej komunikacji pomiędzy klientami a pracownikami partnerów-resellerów. W związku z tak nakreślonymi wymaganiami, w proces wymiany danych pomiędzy Platformą Usługową a systemami informatycznymi partnerów będą zaangażowane następujące komponenty Platformy Usługowej: Aplikacja panelu klienta/rejestracji Aplikacja panelu resellera Aplikacja E-Invoice API Aplikacja panelu administratora Aplikacja powiadomienia e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 2 z 8
1.2. Określenie zakresu danych udostępnianych w poszczególnych procesach z systemami informatycznymi partnerów Interfejsy udostępniane przez Platformę Usługową będą udostępniały następujące dane: Interfejs WebServices: o Lista bieżących faktur (dla każdej pozycji na liście zwracane będą przynajmniej: data wystawienia faktury, numer faktury, identyfikator faktury, identyfikator faktury powiązanej dla faktur korygujących) o Lista faktur historycznych (dla każdej pozycji na liście zwracane będą przynajmniej: data wystawienia faktury, numer faktury, identyfikator faktury, status i data rozliczenia faktury, identyfikator faktury powiązanej dla faktur korygujących) o Faktura wystawiona dla partnera przez HB Technology zawierająca: identyfikator faktury, datę wystawienia, datę sprzedaży, dane wystawcy, dane odbiorcy, listę pozycji (każda pozycja zawierać będzie opis, jednostkę, cenę netto jednostki, wartość podatku VAT, cenę brutto, kod PKWiU), termin płatności, łączną kwotę netto, łączną kwotę brutto). Dla faktury korygującej będzie dodatkowo dostępny identyfikator faktury powiązanej. o Faktura wygenerowana przez Platformę Usługową po doładowaniu konta pre-paid klienta zawierająca: identyfikator faktury, datę wystawienia, datę sprzedaży, dane wystawcy, dane odbiorcy, pozycję faktury (opis, jednostka, cena netto jednostki, wartość podatku VAT, cena brutto, kod PKWiU), termin płatności, łączną kwotę netto, łączną kwotę brutto. Interfejs WWW: o Listę usług udostępnianych przez Platformę Usługową o Szczegółowe parametry definicji usług Platformy Usługowej o Szczegółowe informacje o modelu rozliczeniowym i opłatach skojarzonych z daną usługą o Regulamin usługi e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 3 z 8
o Dokument faktury w postaci HTML lub PDF za wybrany okres rozliczeniowy o Szczegółowe zestawienie kosztów połączeń dla wybranej faktury o Lista zgłoszeń helpdesk o Szczegóły zgłoszenia helpdesk Interfejs email: o Data wystąpienia zdarzenia o Identyfikator klienta powiązanego ze zdarzeniem o Identyfikator usług powiązanych ze zdarzeniem o Identyfikator dokumentu powiązanego ze zdarzeniem o Dane specyficzne zdarzenia zależne od typu zdarzenia 1.3. Wskazanie systemów (klas systemów), do których będą udostępniane interfejsy Platforma Usługowa będzie automatycznie udostępniać dane dla systemów informatycznych partnera za pośrednictwem 3 podstawowych interfejsów: WebServices jest to interfejs jaki eksponuje komponent E-Invoice API, poprzez który system informatyczny partnera będzie w sposób automatyczny mógł pobierać dane o: o Fakturach wystawionych przez HB Technology za usługi wykonane na rzecz partnera o Fakturach automatycznie wygenerowanych przez Platformę Usługową, każdorazowo po doładowaniu konta pre-paid przez klienta partnera Przewidywanym konsumentem tego interfejsu będzie system informatyczny partnera realizujący operacje finansowo-księgowe. System ten będzie pobierał dane udostępniane przez komponent E-Invoice API w formacie zgodnym ze standardem EDI, a następnie automatycznie konwertował i importował dokumenty do wewnętrznych struktur danych systemu celem uwzględnienia ich w procesach rozliczeniowych prowadzonych przez partnera. e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 4 z 8
WWW jest to interfejs jaki eksponuje komponent panelu resellera, poprzez który pracownik lub system informatyczny partnera będzie mógł pobierać dane o: o Zmianach w definicji usług udostępnianych przez Platformę Usługową o Zmianach w regulaminach usług udostępnianych przez Platformę Usługową o Fakturach wystawionych przez HB Technology dla Resellera w postaci dokumentu gotowego do wydruku o Szczegółowego zestawienia kosztów połączeń wykonanych przez klientów resellera za dany okres rozliczeniowy o Fakturach wygenerowanych dla klientów Resellera po doładowaniu konta w postaci dokumentu gotowego do wydruku o Zmianach w zgłoszeniach helpdesk klientów resellera Za pośrednictwem tego interfejsu pracownik lub system informatyczny partnera będzie mógł dodatkowo: o Zaakceptować zmiany w definicji usług udostępnianych na Platformie Usługowej o Zaakceptować zmiany w regulaminach usług Konsumentem interfejsu WWW będzie w pracownik resellera wykorzystujący przeglądarkę internetową lub dedykowana aplikacja, w której zaimplementowane zostaną mechanizmy parsowania i interakcji z dokumentami HTML. email za pomocą tego interfejsu będą automatycznie wysyłane powiadomienia o istotnych zdarzeniach związanych z kontem resellera na Platformie Usługowej. Zakres powiadomień będzie konfigurowany przez administratora HB Technology oraz resellera odpowiednio w aplikacjach administracyjnej oraz panelu resellera. Powiadomienia będą zawierały informacje o zdarzeniach: o Rejestracja nowego klienta o Zmiana konfiguracji usług klienta o Doładowanie konta pre-paid klienta i wystawienie faktury e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 5 z 8
o Wykonanie naliczenia na koncie rozliczeniowym resellera i wystawienie faktury za usługi o Zmiana definicji usług na Platformie Usługowej o Zmiana regulaminu usług na Platformie Usługowej o Nowe lub zaktualizowane przez klienta resellera zgłoszenie helpdesk Konsumentem interfejsu email może być pracownik resellera posługujący się wskazanym w konfiguracji adresem email bądź dedykowana aplikacja zintegrowana z serwerem pocztowym resellera. Przykładem takiej aplikacji może system obsługi zgłoszeń, który pobiera automatyczne informacje ze skrzynki pocztowej, analizuje treść wiadomości, tworzy nowe zgłoszenia w systemie a następnie powiadamia odpowiednich użytkowników należących do grup, do których zostało przypisane dane zgłoszenie. 1.4. Określenie mechanizmów zabezpieczeń Wszystkie interfejsy automatycznej wymiany danych zostaną zabezpieczone w sposób gwarantujący zapewnienie integralności i autentyczności komunikacji: Interfejs WebServices zabezpieczenie interfejsu poprzez ograniczenie komunikacji tylko do kanału szyfrowanego. Szyfrowanie kanału odbywać się będzie przy użyciu certyfikatu SSL HB Technology w oparciu o algorytmy wykorzystujące klucz szyfrujący o długości minimum 128 bitów. Ponadto, dla każdego klienta interfejsu (resellera) zostanie stworzony dedykowany użytkownik (posiadający unikalną nazwę użytkownika i hasło). Każda operacja wykonywana poprzez ten interfejs będzie autoryzowana po stronie Platformy Usługowej. Wszystkie nieautoryzowane żądania zostaną odrzucone. Dodatkowym zabezpieczeniem będzie umożliwienie określenia dla każdego resellera tzw. białej listy adresów IP, z których dozwolone będzie łączenie się z interfejsem WebServices. Jeżeli żądanie połączenie przyjdzie z adresu nie spełniającego kryteriów określonych na białej liście, zostanie ono automatycznie odrzucone. Interfejs WWW panelu resellera zostanie zabezpieczony w analogiczny sposób do interfejsu WebServices. Dostęp do aplikacji będzie ograniczony do kanału zaszyfrowanego wykorzystany zostanie ten sam certyfikat SSL HB Technology. Oprócz standardowej autoryzacji (nazwa użytkownika i hasło) będzie możliwe filtrowanie źródłowych adresów IP. e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 6 z 8
Interfejs email W celu minimalizacji wycieku istotnych informacji, dane przekazywane przez interfejs email będą domyślnie miały charakter informacyjny będą to powiadomienia, nie zawierające wszystkich szczegółów danej operacji. Platforma Usługowa będzie umożliwiać jednakże import publicznego klucza resellera, przy użyciu którego wszystkie wiadomości wysyłane do resellera będą zaszyfrowane. Ich odszyfrowanie będzie możliwe tylko przy użyciu klucza prywatnego posiadanego przez resellera co zapewni integralność przesyłanych danych. Dodatkowo wysyłane przez Platformę Usługową wiadomości email mogą być podpisane cyfrowo przy użyciu certyfikatu SSL w celu zagwarantowania autentyczności źródła wiadomości. 1.5. Aktualizacja i doszczegółowienie architektury systemu w obszarze komponentów integracyjnych Poniżej zaprezentowano szczegółową architekturę komponentów zaangażowanych w automatyczną wymianę danych z systemami informatycznymi partnerów: APLIKACJA E-INVOICE API Repozytorium dokumentów Moduł uwierzytelnienia Moduł obsługi żądań Kanał https Rys. 1. Architektura wewnętrzna aplikacji E-Invoice API Aplikacja E-Invoice będzie składać się z następujących elementów: Kanał https odpowiedzialny za zapewnienie szyfrowanego kanału https dla połączeń z aplikacją. Moduł powinien zostać skonfigurowany w taki sposób by wykorzystywał certyfikat SSL HB Technology e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 7 z 8
Moduł obsługi żądań właściwy komponent realizujący logikę biznesową. Każde żądanie kierowane do aplikacji jest analizowane przez ten moduł w celu ustalenia jak należy obsłużyć żądanie. W zależności od typu żądania (pobranie danych, potwierdzenie pobrania) moduł pobiera dane z repozytorium, lub aktualizuje właściwości dokumentów i przenosi je do z części bieżącej do części historycznej repozytorium. Moduł uwierzytelnienia każde żądanie odbierane przez aplikację E-Invoice API kierowane jest do modułu uwierzytelnienia. Moduł ma dostęp do danych konfiguracyjnych wszystkich resellerów zdefiniowanych na Platformie Usługowej w aplikacji administracyjnej. Zadaniem modułu jest sprawdzenie nazwy użytkownika i hasła oraz czy adres źródłowy żądania znajduje się na liście dozwolonych adresów IP Repozytorium dokumentów aplikacja przechowuje dokumenty w dedykowanych repozytoriach. Każdy reseller posiada w aplikacji swoje oddzielne repozytorium podzielone na część bieżącą oraz historyczną. W części bieżącej dostępne są dokumenty, których odebranie nie zostało potwierdzone przez system informatyczny partnera-resellera. Po potwierdzeniu odebrania dokumentu, system informatyczny partnera powinien zasygnalizować to do aplikacje E-Invoice co będzie skutkować przeniesieniem dokumentu do części historycznej. System informatyczny partnera ma dostęp zarówno do dokumentów w części bieżącej jak i historycznej. e-mail: biuro@hbtechnology.pl, www.hbtechnology.pl Strona 8 z 8