{"id":12608,"date":"2024-12-27T14:28:01","date_gmt":"2024-12-27T13:28:01","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&#038;p=12608"},"modified":"2024-12-27T14:28:35","modified_gmt":"2024-12-27T13:28:35","slug":"wprowadzenie-ecovium","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/","title":{"rendered":"Wprowadzenie: Ecovium"},"content":{"rendered":"<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_82_2 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Spis tre\u015bci<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Prze\u0142\u0105cznik Spisu Tre\u015bci\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#API_Ecovium\" >API Ecovium<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#Konfiguracja\" >Konfiguracja<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#Dane_dostepu\" >Dane dost\u0119pu<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#Przewoznik\" >Przewo\u017anik<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#Profile_wysylkowe\" >Profile wysy\u0142kowe<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#Procesy\" >Procesy<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-ecovium\/#Eksport_danych_listu_przewozowego_do_interfejsu_wysylki\" >Eksport danych listu przewozowego do interfejsu wysy\u0142ki<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h1 id=\"_\" ><\/h1>\n<p>Rozszerzenie <em>Ecovium<\/em> s\u0142u\u017cy do po\u0142\u0105czenia systemu Comarch ERP Enterprise z pakietem e-commerce Ecovium. Za pomoc\u0105 API mo\u017cliwe jest przesy\u0142anie danych wysy\u0142kowych do Ecovium, przesy\u0142anie numer\u00f3w przesy\u0142ek do Comarch ERP Enterprise oraz pobieranie etykiet wysy\u0142kowych.<\/p>\n<h3 id=\"api-ecovium\" ><span class=\"ez-toc-section\" id=\"API_Ecovium\"><\/span>API Ecovium<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Pakiet e-commerce firmy Ecovium umo\u017cliwia zarz\u0105dzanie przesy\u0142kami, drukowanie etykiet wysy\u0142kowych i innych us\u0142ug zwi\u0105zanych z wysy\u0142k\u0105 i jest zwykle skierowany do spedytor\u00f3w o wolumenie do 150 000 przesy\u0142ek dziennie. ECommerce Suite jest nast\u0119pc\u0105 V-LOG i zast\u0105pi ten interfejs w perspektywie \u015brednioterminowej.<\/p>\n<p>API Ecovium przejmuje:<\/p>\n<ul>\n<li>Przygotowywanie dowod\u00f3w przewozowych dla transportu krajowego i mi\u0119dzynarodowego<\/li>\n<li>Tworzenie dokument\u00f3w eksportowych<\/li>\n<li>Rezerwacja lub anulowanie zlecenia odbioru przesy\u0142ki z wybranej lokalizacji pocz\u0105tkowej i dostawy do wybranej lokalizacji docelowej.<\/li>\n<li>Pobieranie etykiet<\/li>\n<\/ul>\n<p>Aplikacja tworzy zlecenie Ecovium i obs\u0142uguje pakowanie w Ecovium HandlingUnits, kt\u00f3re odpowiadaj\u0105 jednostkom \u0142adunkowym w Comarch ERP Enterprise.<\/p>\n<p>Je\u015bli dane zlecenia s\u0105 prawid\u0142owe, tj. je\u015bli u\u017cytkownik posiada odpowiednie uprawnienia, us\u0142uga zwraca numer przesy\u0142ki i dane przesy\u0142ki dla ka\u017cdego zlecenia przesy\u0142ki w wywo\u0142aniu. Adresy URL odnosz\u0105 si\u0119 do gotowych do druku etykiet w formacie pdf. Wraz z odpowiedzi\u0105 z API, wszystkie \u017c\u0105dane etykiety paczek s\u0105 pobierane do KStore.<\/p>\n<h3 id=\"konfiguracja\" ><span class=\"ez-toc-section\" id=\"Konfiguracja\"><\/span>Konfiguracja<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Aplikacja <em>Konfiguracja,<\/em> funkcja <em>Oprogramowanie do obs\u0142ugi wysy\u0142ki<\/em> <em>Ecovium,<\/em> s\u0142u\u017cy do zarz\u0105dzania danymi dost\u0119pu do interfejsu API.<\/p>\n<h4 id=\"dane-dostepu\" ><span class=\"ez-toc-section\" id=\"Dane_dostepu\"><\/span>Dane dost\u0119pu<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>Aby korzysta\u0107 z pakietu e-commerce, potrzebny jest Client-ID i Client-Secret w celu zapewnienia dost\u0119pu do interfejsu API. Ponadto wymagane jest konto Ecovium (zwykle identyfikowane przez adres e-mail) i odpowiednie has\u0142o.<\/p>\n<table style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\">\n<tbody>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: center;\" scope=\"rowgroup\" width=\"196\"><strong>Ustawianie parametr\u00f3w<\/strong><\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: center;\" scope=\"rowgroup\" width=\"352\"><strong>Warto\u015b\u0107<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">Numer klienta (najemcy)<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">Numer klienta przypisany przez <em>Ecovium<\/em> (okre\u015blany r\u00f3wnie\u017c jako <em>najemca<\/em> w Ecovium)<\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">URL ECom-Suite<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">Adres URL interfejsu API <em>Ecovium.<\/em> Jest wst\u0119pnie ustawiony z warto\u015bci\u0105 domy\u015bln\u0105 https:\/\/ecommerce-storage-server.cp.mhp-solution-group.com podczas zapisywania.<\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">Konto Ecovium<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">Adres e-mail konta <em>Ecovium<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">Has\u0142o Ecovium<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">Has\u0142o do konta <em>Ecovium<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">Client-ID<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">Client-ID umo\u017cliwiaj\u0105cy dost\u0119p do interfejsu API <em>Ecovium<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">Client-Secret<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">Client-Secret do uwierzytelniania w interfejsie API <em>Ecovium<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"196\">Folder archiwizacji etykiet paczki<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\" scope=\"rowgroup\" width=\"352\">[\u015acie\u017cka w kstore]Nie jest to pole obowi\u0105zkowe. Je\u015bli w tym polu nie zostanie podany prawid\u0142owy folder, etykieta paczki nie zostanie pobrana i zapisana.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>U\u017cytkownik mo\u017ce przegl\u0105da\u0107 przesy\u0142ki i paczki utworzone w tym portalu:<\/p>\n<p><a href=\"https:\/\/portal.cp.mhp-solution-group.com\/\">https:\/\/portal.cp.mhp-solution-group.com\/<\/a><\/p>\n<p>Nale\u017cy zalogowa\u0107 si\u0119 za pomoc\u0105 konta <em>Ecovium<\/em> i has\u0142a <em>Ecovium.<\/em><\/p>\n<h4 id=\"przewoznik\" ><span class=\"ez-toc-section\" id=\"Przewoznik\"><\/span>Przewo\u017anik<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>Za po\u015brednictwem interfejsu API <em>Ecovium<\/em> przesy\u0142ane s\u0105 tylko te zlecenia dostawy, dla kt\u00f3rych w polu przewo\u017anika w warunkach wysy\u0142ki wprowadzono warto\u015b\u0107 <em>Ecovium.<\/em><\/p>\n<h4 id=\"profile-wysylkowe\" ><span class=\"ez-toc-section\" id=\"Profile_wysylkowe\"><\/span>Profile wysy\u0142kowe<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>Profil wysy\u0142ki musi zosta\u0107 utworzony w <em>Ecovium<\/em> dla ka\u017cdej kombinacji przewo\u017anika i produktu. Nie odbywa si\u0119 to w Comarch ERP Enterprise, ale bezpo\u015brednio w konfiguracji pakietu e-commerce.<\/p>\n<p>W przypadku profilu wysy\u0142ki, <em>Ecovium<\/em> zapewnia identyfikator, kt\u00f3ry jest u\u017cywany w interfejsie API do identyfikacji przewo\u017anika lub produktu. U\u017cytkownik wprowadza identyfikator profilu wysy\u0142ki w polu <em>Kod produktu<\/em> warunku wysy\u0142ki.<\/p>\n<h3 id=\"procesy\" ><span class=\"ez-toc-section\" id=\"Procesy\"><\/span>Procesy<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Dane wysy\u0142kowe przesy\u0142ane do <em>Ecovium<\/em> pochodz\u0105 ze zlecenia dostawy. S\u0105 one przesy\u0142ane automatycznie po utworzeniu dowod\u00f3w dostawy. Mo\u017cliwe jest r\u00f3wnie\u017c r\u0119czne zainicjowanie transferu.<\/p>\n<p>Poni\u017csza tabela zawiera przegl\u0105d danych dotycz\u0105cych wysy\u0142ki i zarz\u0105dzania nimi w Comarch ERP Enterprise:<\/p>\n<table style=\"border-color: #000000; background-color: #ffffff; border-style: outset;\">\n<tbody>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"165\"><strong>Nadawca<\/strong><\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"382\"><strong>Organizacja logistyki magazynowej w zleceniu dostawy, odpowiada partnerowi dostawy w zam\u00f3wieniu sprzeda\u017cy.<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"165\">Odbiorca<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"382\">Partner w zleceniu dostawy, odpowiada stronie wysy\u0142ki w zam\u00f3wieniu sprzeda\u017cy.<\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"165\">Artyku\u0142<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"382\">Pozycje w zleceniu dostawy, ilo\u015b\u0107 odpowiada liczbie w kolumnie <em>Dostarczona\/potwierdzona ilo\u015b\u0107.<\/em><\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"165\">Waga paczki<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"382\">Waga zlecenia dostawy; w przypadku przesy\u0142ek zapakowanych, przekazywane s\u0105 wagi jednostek \u0142adunkowych.<\/td>\n<\/tr>\n<tr>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"165\">Shipping-Profile<\/td>\n<td style=\"border-color: #000000; background-color: #ffffff; border-style: outset; text-align: left;\" scope=\"rowgroup\" width=\"382\">W zak\u0142adce <em>Opcje wysy\u0142ki w zam\u00f3wieniu sprzeda\u017cy.<\/em> W tym miejscu nale\u017cy wprowadzi\u0107 identyfikator <em>Shipping-Profile,<\/em> otrzymanego od Ecovium<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4 id=\"eksport-danych-listu-przewozowego-do-interfejsu-wysylki\" ><span class=\"ez-toc-section\" id=\"Eksport_danych_listu_przewozowego_do_interfejsu_wysylki\"><\/span>Eksport danych listu przewozowego do interfejsu wysy\u0142ki<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>Istniej\u0105 trzy miejsca w Comarch ERP Enterprise, z kt\u00f3rych dane wysy\u0142kowe s\u0105 przesy\u0142ane do interfejsu API <em>Ecovium.<\/em><\/p>\n<ol>\n<li>Automatycznie podczas tworzenia dowodu dostawy dla zlecenia dostawy<\/li>\n<li>Poprzez akcj\u0119 [<strong>Eksportuj dane dokumentu dostawy wed\u0142ug interfejsu wysy\u0142ki<\/strong>] w aplikacji <em>Zlecenia dostawy<\/em><\/li>\n<li>Poprzez akcj\u0119 [<strong>Eksportuj dane dokumentu dostawy wed\u0142ug interfejsu wysy\u0142ki<\/strong>] w aplikacji <em>Lista: Interfejsy wysy\u0142ki<\/em><\/li>\n<\/ol>\n<p>Je\u015bli eksport zosta\u0142 przeprowadzony bez b\u0142\u0119d\u00f3w, dane dostawy s\u0105 wy\u015bwietlane w zak\u0142adce <em>Dane wysy\u0142ki.<\/em><\/p>\n<p>Etykieta wysy\u0142kowa jest r\u00f3wnie\u017c automatycznie pobierana i zapisywana w KStore. Jest tam dost\u0119pna do wydrukowania. Dzieje si\u0119 tak jednak tylko wtedy, gdy prawid\u0142owa \u015bcie\u017cka KStore zosta\u0142a zapisana w folderze przechowywania etykiety pakietu w konfiguracji <em>Ecovium<\/em>.<\/p>\n<p>Alternatywnie, u\u017cytkownik mo\u017ce r\u00f3wnie\u017c wydrukowa\u0107 etykiet\u0119 paczki bezpo\u015brednio za po\u015brednictwem pakietu e-commerce.<\/p>\n<p>Je\u015bli eksport nie powi\u00f3d\u0142 si\u0119, wy\u015bwietlany jest komunikat o b\u0142\u0119dzie zawieraj\u0105cy komunikat zwr\u00f3cony przez interfejs API <em>Ecovium.<\/em><\/p>\n","protected":false},"author":28,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-12608","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-ecovium"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12608","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/users\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/comments?post=12608"}],"version-history":[{"count":2,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12608\/revisions"}],"predecessor-version":[{"id":22733,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12608\/revisions\/22733"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/media?parent=12608"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}