{"id":4287,"date":"2022-09-29T13:14:05","date_gmt":"2022-09-29T11:14:05","guid":{"rendered":"https:\/\/raks.pl\/pomoc\/?p=4287"},"modified":"2025-03-25T16:16:57","modified_gmt":"2025-03-25T15:16:57","slug":"uruchomienie-integracji-krok-po-kroku","status":"publish","type":"post","link":"https:\/\/raks.pl\/pomoc\/uruchomienie-integracji-krok-po-kroku\/","title":{"rendered":"Uruchomienie integracji (krok po kroku)"},"content":{"rendered":"\n<p><strong>Przygotowanie RaksSQL<\/strong><\/p>\n\n\n\n<p>Aktualna wersja Integratora przygotowana jest do pracy z <strong>jedn\u0105 firm\u0105 i jednym magazynem<\/strong> jednocze\u015bnie. Specjali\u015bci od integracji z BaseLinker sugeruj\u0105 <strong>wydzielenie osobnego magazynu tylko i wy\u0142\u0105cznie na sprzeda\u017c on-line<\/strong>. Chodzi o to, by nie wykonywa\u0107 z poziomu programu sprzeda\u017cowo-magazynowego (RaksSQL) ruch\u00f3w na magazynie (dokument\u00f3w sprzeda\u017cy) niezwi\u0105zanych ze sprzeda\u017c\u0105 w sieci.<\/p>\n\n\n\n<p>Z punktu widzenia wsp\u00f3\u0142pracy z naszym Integratorem w wybranej firmie i magazynie nale\u017cy:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Doda\u0107 nowy magazyn<\/strong> (lub u\u017cy\u0107 istniej\u0105cego) do wsp\u00f3\u0142pracy z BaseLinker.<\/li>\n\n\n\n<li><strong>W kartotece towar\u00f3w zdefiniowa\u0107 grup\u0119 podstawow\u0105 lub grup\u0119 dowoln\u0105<\/strong>, kt\u00f3ra b\u0119dzie zawiera\u0142a towary sprzedawane on-line. Mo\u017ce ona oczywi\u015bcie zawiera\u0107 dowoln\u0105 struktur\u0119 podgrup zdefiniowan\u0105 w wygodny dla u\u017cytkownika spos\u00f3b. Zostanie ona potem wys\u0142ana do BaseLinker jako kategoria produkt\u00f3w wraz z podkategoriami.<\/li>\n\n\n\n<li><strong>Do dodanej grupy oraz jej podgrup przenie\u015b\u0107 wszystkie towary<\/strong>, kt\u00f3re maj\u0105 zosta\u0107 wys\u0142ane do BaseLinker, a kt\u00f3rymi u\u017cytkownik chce handlowa\u0107 on-line.<\/li>\n\n\n\n<li><strong>Zdefiniowa\u0107<\/strong> <strong>rodzaj cen<\/strong> dla BaseLinker (S\u0142owniki \u2013 Rodzaje cen).<\/li>\n\n\n\n<li><strong>Zdefiniowa\u0107<\/strong> <strong>spos\u00f3b zap\u0142aty<\/strong>, kt\u00f3ry b\u0119dzie u\u017cywany w zam\u00f3wieniach importowanych BaseLinker (S\u0142owniki \u2013 Sposoby zap\u0142aty). Nazwa sposobu musi by\u0107 zgodna z tym, co wpisywane b\u0119dzie w zam\u00f3wieniu BaseLinker w polu \u201eSpos\u00f3b p\u0142atno\u015bci\u201d. Je\u017celi w RaksSQL nie b\u0119dzie sposoby zap\u0142aty zgodnego z tekstem wpisany w zam\u00f3wieniu BaseLinker, import takiego zam\u00f3wienia si\u0119 nie powiedzie.<\/li>\n\n\n\n<li><strong>Zdefiniowa\u0107 ceny dla BaseLinker<\/strong>, czyli doda\u0107 na przyk\u0142ad dokument zmian cen sprzeda\u017cy i ustawi\u0107 ceny sprzeda\u017cy dla towar\u00f3w z przygotowanej grupy. Ceny musz\u0105 by\u0107 oczywi\u015bcie zdefiniowane dla dodanego wcze\u015bniej rodzaj ceny dedykowanego do wsp\u00f3\u0142pracy z BaseLinker.<\/li>\n\n\n\n<li>\u00a0<strong>Doda\u0107 kod dokumentu<\/strong> (S\u0142owniki \u2013 Kody dokument\u00f3w) dla \u201eZam\u00f3wie\u0144 od odbiorc\u00f3w\u201d przeznaczony wy\u0142\u0105cznie dla zam\u00f3wie\u0144 przychodz\u0105cych z BaseLinker (mo\u017ce mie\u0107 na przyk\u0142ad specjaln\u0105 mask\u0119 numeracji itp.).<\/li>\n\n\n\n<li>.<strong>Doda\u0107 spos\u00f3b dostawy<\/strong> (S\u0142owniku \u2013 Sposoby dostawy), kt\u00f3ry b\u0119dzie u\u017cywany w zam\u00f3wieniu w BaseLinker. \u00a0Musi on by\u0107 zgodny w sensie nazwy z tym, co znajdzie si\u0119 potem w zam\u00f3wieniu BaseLinker w polu \u201eSpos\u00f3b wysy\u0142ki\u201d. Je\u017celi w RaksSQL nie b\u0119dzie takiego sposobu dostawy, zostanie on dodany w trakcie importu danego zam\u00f3wienia.<\/li>\n\n\n\n<li>\u00a0<strong>Zdefiniowa\u0107 statusy dokument\u00f3w sprzeda\u017cy<\/strong> (S\u0142owniki \u2013 Statusy dokument\u00f3w sprzeda\u017cy), kt\u00f3rych b\u0119dziemy u\u017cywa\u0107 do oznaczania faktur\/paragon\u00f3w przeznaczonych do wysy\u0142ki do BaseLinker oraz po wys\u0142aniu do BaseLinker. Na przyk\u0142ad mo\u017ce to by\u0107 status \u201eBaseLinker \u2013 do wys\u0142ania\u201d oraz \u201eBaseLinker \u2013 wys\u0142ano\u201d.<\/li>\n<\/ul>\n\n\n\n<p><strong>Przygotowanie BaseLinker<\/strong><\/p>\n\n\n\n<p>Kolejnym krokiem jest zalogowanie si\u0119 do swojego konta na BaseLinker (lub za\u0142o\u017cenie konta je\u015bli jeszcze go nie macie): <a href=\"https:\/\/login.baselinker.com\/\">https:\/\/login.baselinker.com\/<\/a><\/p>\n\n\n\n<p>Tutaj nale\u017cy:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Wygenerowa\u0107 token dost\u0119powy<\/strong> do API serwisu w zak\u0142adce \u201eMoje konto \u2013 API\u201d.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Zdefiniowa\u0107 seri\u0119 numeracyjn\u0105<\/strong> dla dokument\u00f3w sprzeda\u017cy w zak\u0142adce (generowanych zawsze przez serwis BaseLinker) \u201eZam\u00f3wienia \u2013 Faktury \u2013 Ustawienia\u201d.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Zdefiniowa\u0107 odpowiednie statusy<\/strong> w zak\u0142adce \u201eZam\u00f3wienia \u2013 Statusy zam\u00f3wie\u0144\u201d. Szczeg\u00f3\u0142y zosta\u0142y opisane w poprzednich rozdzia\u0142ach. Mo\u017cna tam tak\u017ce zdefiniowa\u0107 sobie grupy zam\u00f3wie\u0144 (na przyk\u0142ad \u201eRAKSSQL\u201d).<\/li>\n<\/ul>\n\n\n\n<p><strong>Instalacja Integratora<\/strong><\/p>\n\n\n\n<p>Zalecam przed instalacj\u0105 Integratora zainstalowanie pakietu <strong>SDK<\/strong> firmy Microsoft dla <strong>.NET Core 3.1<\/strong>. Jest on niezb\u0119dny do dzia\u0142ania naszego serwisu. Instalator Integratora sam b\u0119dzie wymusza\u0142 wzbogacenie systemu o te biblioteki, ale sugeruj\u0119, by zrobi\u0107 to samemu wcze\u015bniej.<\/p>\n\n\n\n<p>Odpowiedni pakiet instalacyjny mo\u017cna \u015bci\u0105gn\u0105\u0107 ze strony:<\/p>\n\n\n\n<figure class=\"wp-block-embed\"><div class=\"wp-block-embed__wrapper\">\nhttps:\/\/dotnet.microsoft.com\/download\/dotnet\/3.1\n<\/div><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"936\" height=\"1024\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.1-936x1024.png\" alt=\"\" class=\"wp-image-4473\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.1-936x1024.png 936w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.1-274x300.png 274w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.1-768x840.png 768w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.1.png 951w\" sizes=\"auto, (max-width: 936px) 100vw, 936px\" \/><\/figure>\n\n\n\n<p>Po instalacji pakietu SDK nale\u017cy zainstalowa\u0107 Integrator uruchamiaj\u0105c <strong>setup.exe<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"618\" height=\"90\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.2.png\" alt=\"\" class=\"wp-image-4475\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.2.png 618w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.2-300x44.png 300w\" sizes=\"auto, (max-width: 618px) 100vw, 618px\" \/><\/figure>\n\n\n\n<p>Wystarczy wskaza\u0107 lokalizacj\u0119 i zatwierdzi\u0107 wszelkie pytania.<\/p>\n\n\n\n<p><strong>Konfiguracja Integratora<\/strong><\/p>\n\n\n\n<p>Po zainstalowaniu Integratora, nale\u017cy uruchomi\u0107 program <strong>Raks.SQL.Integrator.Service.exe<\/strong> z katalogu instalacji. Powinna pojawi\u0107 si\u0119 konsola:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"178\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.3-1024x178.png\" alt=\"\" class=\"wp-image-4476\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.3-1024x178.png 1024w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.3-300x52.png 300w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.3-768x133.png 768w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.3.png 1117w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Kolejnym krokiem jest uruchomienia Konfiguratora poprzez wej\u015bcie na adres <a href=\"http:\/\/localhost:5000\/\">http:\/\/localhost:5000\/<\/a> w dowolnej przegl\u0105darce (Firefox, Chrome etc.). Powinna uruchomi\u0107 si\u0119 strona logowania:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"983\" height=\"707\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.4.png\" alt=\"\" class=\"wp-image-4477\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.4.png 983w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.4-300x216.png 300w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.4-768x552.png 768w\" sizes=\"auto, (max-width: 983px) 100vw, 983px\" \/><\/figure>\n\n\n\n<p>Has\u0142o domy\u015blnie nadawane przy instalacji to <strong>admin<\/strong>.<\/p>\n\n\n\n<p>Po zalogowaniu si\u0119 nale\u017cy zdefiniowa\u0107 po\u0142\u0105czenie do baz danych RaksSQL w zak\u0142adce \u201eRAKSSQL API \u2013 Ustawienia\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"401\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.5-1024x401.png\" alt=\"\" class=\"wp-image-4478\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.5-1024x401.png 1024w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.5-300x117.png 300w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.5-768x300.png 768w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.5-1536x601.png 1536w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.5.png 1718w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Po zapisaniu poprawnej (testuj po\u0142\u0105czenie) konfiguracji po\u0142\u0105czenia z baz\u0105 danych powinna od\u015bwie\u017cy\u0107 si\u0119 lista firm na dole strony. Poka\u017c\u0105 si\u0119 na niej tylko te firmy, kt\u00f3re w definicji maj\u0105 zaznaczony przycisk \u201eIntegracja z modu\u0142em Sprzeda\u017c\u201d na zak\u0142adce \u201eIntegracje\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"496\" height=\"553\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.6.png\" alt=\"\" class=\"wp-image-4479\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.6.png 496w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.6-269x300.png 269w\" sizes=\"auto, (max-width: 496px) 100vw, 496px\" \/><\/figure>\n\n\n\n<p>Nale\u017cy wtedy nada\u0107 tokeny firmie (firmom), do kt\u00f3rych ma by\u0107 umo\u017cliwiony dost\u0119p przez nasze API. BaseLinker mo\u017ce dzia\u0142a\u0107 jednak tylko na jednej z nich jedocze\u015bnie, ale mog\u0105 pojawi\u0107 si\u0119 w przysz\u0142o\u015bci inne rozwi\u0105zania, kt\u00f3re b\u0119d\u0105 \u0142\u0105czy\u0107 si\u0119 do innych firm, wi\u0119c jest tutaj mo\u017cliwo\u015b\u0107 wygenerowania token\u00f3w dost\u0119powych dla wszystkich odpowiednio oznaczonych w definicji firm.<\/p>\n\n\n\n<p>Nast\u0119pnie nale\u017cy przej\u015b\u0107 na zak\u0142adk\u0119 \u201eBaseLinker \u2013 Ustawienia\u201d i z u\u017cyciem zdefiniowanych do tej pory danych w RaksSQL oraz tokenu dost\u0119powego do serwisu BaseLinker skonfigurowa\u0107 integracj\u0119. Nast\u0119pnie zatwierdzi\u0107 ustawienia przyciskiem \u201eZapisz\u201d znajduj\u0105cym si\u0119 na dole strony.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"433\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.7-1024x433.png\" alt=\"\" class=\"wp-image-4480\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.7-1024x433.png 1024w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.7-300x127.png 300w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.7-768x325.png 768w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.7-1536x649.png 1536w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/11.7.png 1644w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Kolejnym krokiem jest ju\u017c uruchomienie kasji wys\u0142ania grup towar\u00f3w, towar\u00f3w i cennik\u00f3w na zak\u0142adce \u201eBaseLinker \u2013 Akcje\u201d oraz definiowanie testowych zam\u00f3wie\u0144, umieszczanie ich we w\u0142a\u015bciwym statusie i pr\u00f3by importowania do RaksSQL.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"643\" height=\"292\" src=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/image.png\" alt=\"\" class=\"wp-image-4288\" srcset=\"https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/image.png 643w, https:\/\/raks.pl\/pomoc\/wp-content\/uploads\/2022\/09\/image-300x136.png 300w\" sizes=\"auto, (max-width: 643px) 100vw, 643px\" \/><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Przygotowanie RaksSQL Aktualna wersja Integratora przygotowana jest do pracy z jedn\u0105 firm\u0105 i jednym magazynem jednocze\u015bnie. Specjali\u015bci od integracji z BaseLinker sugeruj\u0105 wydzielenie osobnego magazynu tylko i wy\u0142\u0105cznie na sprzeda\u017c on-line. Chodzi o to, by nie wykonywa\u0107 z poziomu programu sprzeda\u017cowo-magazynowego (RaksSQL) ruch\u00f3w na magazynie (dokument\u00f3w sprzeda\u017cy) niezwi\u0105zanych ze sprzeda\u017c\u0105 w sieci. Z punktu widzenia [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-4287","post","type-post","status-publish","format-standard","hentry","category-samouczek"],"acf":[],"_links":{"self":[{"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/posts\/4287","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/comments?post=4287"}],"version-history":[{"count":3,"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/posts\/4287\/revisions"}],"predecessor-version":[{"id":6935,"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/posts\/4287\/revisions\/6935"}],"wp:attachment":[{"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/media?parent=4287"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/categories?post=4287"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/raks.pl\/pomoc\/wp-json\/wp\/v2\/tags?post=4287"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}