Na czym polega integracja z Elektronicznym Nadawcą Poczty Polskiej

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.