Rozszerzenie Ecovium służy do połączenia systemu Comarch ERP Enterprise z pakietem e-commerce Ecovium. Za pomocą API możliwe jest przesyłanie danych wysyłkowych do Ecovium, przesyłanie numerów przesyłek do Comarch ERP Enterprise oraz pobieranie etykiet wysyłkowych.
API Ecovium
Pakiet e-commerce firmy Ecovium umożliwia zarządzanie przesyłkami, drukowanie etykiet wysyłkowych i innych usług związanych z wysyłką i jest zwykle skierowany do spedytorów o wolumenie do 150 000 przesyłek dziennie. ECommerce Suite jest następcą V-LOG i zastąpi ten interfejs w perspektywie średnioterminowej.
API Ecovium przejmuje:
- Przygotowywanie dowodów przewozowych dla transportu krajowego i międzynarodowego
- Tworzenie dokumentów eksportowych
- Rezerwacja lub anulowanie zlecenia odbioru przesyłki z wybranej lokalizacji początkowej i dostawy do wybranej lokalizacji docelowej.
- Pobieranie etykiet
Aplikacja tworzy zlecenie Ecovium i obsługuje pakowanie w Ecovium HandlingUnits, które odpowiadają jednostkom ładunkowym w Comarch ERP Enterprise.
Jeśli dane zlecenia są prawidłowe, tj. jeśli użytkownik posiada odpowiednie uprawnienia, usługa zwraca numer przesyłki i dane przesyłki dla każdego zlecenia przesyłki w wywołaniu. Adresy URL odnoszą się do gotowych do druku etykiet w formacie pdf. Wraz z odpowiedzią z API, wszystkie żądane etykiety paczek są pobierane do KStore.
Konfiguracja
Aplikacja Konfiguracja, funkcja Oprogramowanie do obsługi wysyłki Ecovium, służy do zarządzania danymi dostępu do interfejsu API.
Dane dostępu
Aby korzystać z pakietu e-commerce, potrzebny jest Client-ID i Client-Secret w celu zapewnienia dostępu do interfejsu API. Ponadto wymagane jest konto Ecovium (zwykle identyfikowane przez adres e-mail) i odpowiednie hasło.
| Ustawianie parametrów | Wartość |
| Numer klienta (najemcy) | Numer klienta przypisany przez Ecovium (określany również jako najemca w Ecovium) |
| URL ECom-Suite | Adres URL interfejsu API Ecovium. Jest wstępnie ustawiony z wartością domyślną https://ecommerce-storage-server.cp.mhp-solution-group.com podczas zapisywania. |
| Konto Ecovium | Adres e-mail konta Ecovium |
| Hasło Ecovium | Hasło do konta Ecovium |
| Client-ID | Client-ID umożliwiający dostęp do interfejsu API Ecovium |
| Client-Secret | Client-Secret do uwierzytelniania w interfejsie API Ecovium |
| Folder archiwizacji etykiet paczki | [Ścieżka w kstore]Nie jest to pole obowiązkowe. Jeśli w tym polu nie zostanie podany prawidłowy folder, etykieta paczki nie zostanie pobrana i zapisana. |
Użytkownik może przeglądać przesyłki i paczki utworzone w tym portalu:
https://portal.cp.mhp-solution-group.com/
Należy zalogować się za pomocą konta Ecovium i hasła Ecovium.
Przewoźnik
Za pośrednictwem interfejsu API Ecovium przesyłane są tylko te zlecenia dostawy, dla których w polu przewoźnika w warunkach wysyłki wprowadzono wartość Ecovium.
Profile wysyłkowe
Profil wysyłki musi zostać utworzony w Ecovium dla każdej kombinacji przewoźnika i produktu. Nie odbywa się to w Comarch ERP Enterprise, ale bezpośrednio w konfiguracji pakietu e-commerce.
W przypadku profilu wysyłki, Ecovium zapewnia identyfikator, który jest używany w interfejsie API do identyfikacji przewoźnika lub produktu. Użytkownik wprowadza identyfikator profilu wysyłki w polu Kod produktu warunku wysyłki.
Procesy
Dane wysyłkowe przesyłane do Ecovium pochodzą ze zlecenia dostawy. Są one przesyłane automatycznie po utworzeniu dowodów dostawy. Możliwe jest również ręczne zainicjowanie transferu.
Poniższa tabela zawiera przegląd danych dotyczących wysyłki i zarządzania nimi w Comarch ERP Enterprise:
| Nadawca | Organizacja logistyki magazynowej w zleceniu dostawy, odpowiada partnerowi dostawy w zamówieniu sprzedaży. |
| Odbiorca | Partner w zleceniu dostawy, odpowiada stronie wysyłki w zamówieniu sprzedaży. |
| Artykuł | Pozycje w zleceniu dostawy, ilość odpowiada liczbie w kolumnie Dostarczona/potwierdzona ilość. |
| Waga paczki | Waga zlecenia dostawy; w przypadku przesyłek zapakowanych, przekazywane są wagi jednostek ładunkowych. |
| Shipping-Profile | W zakładce Opcje wysyłki w zamówieniu sprzedaży. W tym miejscu należy wprowadzić identyfikator Shipping-Profile, otrzymanego od Ecovium |
Eksport danych listu przewozowego do interfejsu wysyłki
Istnieją trzy miejsca w Comarch ERP Enterprise, z których dane wysyłkowe są przesyłane do interfejsu API Ecovium.
- Automatycznie podczas tworzenia dowodu dostawy dla zlecenia dostawy
- Poprzez akcję [Eksportuj dane dokumentu dostawy według interfejsu wysyłki] w aplikacji Zlecenia dostawy
- Poprzez akcję [Eksportuj dane dokumentu dostawy według interfejsu wysyłki] w aplikacji Lista: Interfejsy wysyłki
Jeśli eksport został przeprowadzony bez błędów, dane dostawy są wyświetlane w zakładce Dane wysyłki.
Etykieta wysyłkowa jest również automatycznie pobierana i zapisywana w KStore. Jest tam dostępna do wydrukowania. Dzieje się tak jednak tylko wtedy, gdy prawidłowa ścieżka KStore została zapisana w folderze przechowywania etykiety pakietu w konfiguracji Ecovium.
Alternatywnie, użytkownik może również wydrukować etykietę paczki bezpośrednio za pośrednictwem pakietu e-commerce.
Jeśli eksport nie powiódł się, wyświetlany jest komunikat o błędzie zawierający komunikat zwrócony przez interfejs API Ecovium.
