Artykuł ma za zadanie, po krótce opisać sposób integracji naszego produktu ProstaPaczka2 z aplikacją Poczty Polskiej – Elektroniczny Nadawca (e-nadawca).
Interfejs e-Nadawcy
WebApi Poczty Polskiej
Poczta Polska zbudowała „interfejsy” do swojej aplikacji pozwalające programistom na automatyzację zadań i wykonywanie czynności bez konieczności wchodzenia na stronę internetową Elektronicznego Nadawcy.
Jest to usługa Web Service (więcej na wikipedii) do której specyfikacja jest dostępna na stronie e-nadawcy (strona ze specyfikacją) o nazwie WebApi. Interfejs ten pozwala na wykonanie wielu czynności związanych z wysyłką.
W naszym produkcie używamy tylko tych, które są niezbędne z punktu widzenia naszego programu.
Możliwości WebApi
Wybrane możliwości web servisu Poczty Polskiej:
- utworzenie zbioru – aktualizacja danych zbioru
- zamknięcie zbioru (przekazania do wybranej placówki pocztowej)
- dodanie przesyłki do zbioru
- wydruk etykiet adresowych (nalepek) do pojedynczej przesyłki (przed zamknięciem zbioru)
- przygotowanie etykiet dla wszystkich przesyłek w zbiorze
- przygotowanie książki nadawczej
- przygotowanie zestawienia poczty firmowej
- przełączanie kart
Oczywiście nie wszystkie możliwości API e-nadawcy są wprowadzane do aplikacji, kierujemy się potrzebami klientów – jak nie ma potrzeb to nie wprowadzamy nadmiarowych funkcjonalności.
Przygotowanie do pracy
Aby można było przygotowywać etykiety dla przesyłek Poczty Polskiej musimy wpisać w aplikacji login i hasło do profilu Elektronicznego Nadawcy.
Dla firm, które używają wielu kont jest możliwość zdefiniowania kilu kont aby później wybierać z którego konta ma nastąpić wysyłka.
W E-Nadawcy dobrze jest oznaczyć opcję pokazywania przesyłek z WebApi – opcja dostępna jest w ustawieniach EN.
Jak to wygląda w praktyce?
W trakcie dnia
Po pobraniu dokumentów / paczek z programu magazynowo sprzedażowego wybieramy metodę przygotowania listu przewozowego.
Jeżeli będzie to metoda Poczty Polskiej, to w tym momencie następuje utworzenie listu przewozowego w elektronicznym nadawcy (już będzie tam widoczny).
Od razu po utworzeniu listu ProstaPaczka pobierze nalepkę adresową (przygotowaną przez WebApi) i wydrukuje na wskazanej w ustawieniach drukarce.
Przez cały dzień postępujemy dokładnie w ten sam sposób – zaznaczymy dokument i przygotowujemy dla niego list
Na koniec dnia
Na koniec dnia Poczta Polska wymaga przekazania książki adresowej (zestawienia przekazywanych przesyłek), aby ją przygotować przechodzimy do zakładki POCZTA POLSKA i wyświetlamy przesyłki ze zbioru który przygotowywaliśmy.
Uruchamiamy zamknięcie zbioru – w tym momencie ProstaPaczka przekazuje do Elektronicznego Nadawcy żądanie zamknięcia zbioru i przekazanie go do placówki pocztowej.
Od razu po zamknięciu pobierana jest książka adresowa lub zestawienie poczty firmowej (przygotowane przez E-Nadawcę).
… to tyle.
Programista, analityk IT i specjalista ds. projektów z wieloletnim doświadczeniem. Absolwent Politechniki Białostockiej i Politechniki Warszawskiej. Magister elektrotechniki z wieloletnim doświadczeniem w branży kurierskiej. Wykształcenie uzupełnione o studia podyplomowe oraz liczne szkolenia z zakresu zarządzania projektami IT, analizy IT oraz modelowania procesów biznesowych. Prywatnie miłośniki literatury fantasy i szczęśliwy ojciec.
