Integracja systemu Optimakers i Baselinker – pierwsze kroki

Oprogramowanie od Optimakers do 21 możliwych integracji z innymi, zewnętrznymi systemami. W tym przykładzie dowiesz się jak zintegrować system od Optimakers z Baselinker. A wszystko to w kilku prostych krokach. Integrujesz raz i działa już cały czas.

Spis treści:

  1. Jak uzyskać pomoc przy integracji z Baselinkerem?
  2. Jakie parametry są niezbędne do uruchomienia integracji?
  3. Gdzie znaleźć potrzebne dane i jak skonfigurować systemy?
  4. W jaki sposób sprawdzić, czy integracja działa prawidłowo?

Jak uzyskać pomoc przy integracji z Baselinkerem?

Należy skontaktować się Firmą RC Cloud drogą elektroniczną na adres email: kontakt@rccloud.pl

Jakie parametry są niezbędne do uruchomienia integracji?

Do uruchomienia integracji niezbędne są dane, które można pobrać zarówno z systemu Optimakers jak i z Baselinkera.

Z systemu Baselinker potrzebujemy: 

  1. Klucz API do systemu Baselinkera: baselinkerApiKey
  2. Id statusu zamówienia z baselinkera, które mają być przesłane do systemu Optimakers : : baselinkerOrderStatusToImport 
  3. Id statusu zamówienia z baselinkera, który ma być ustawiony podczas aktualizacji zamówienia w Optimakers : baselinkerOrderStatusToSend

Z systemu Optimakers potrzebujemy: 

  • Klucz API z systemu: optimesApiKey 
  • Token bezpieczeństwa: optimesApiToken
  • Id statusu zamówienia, który ma być ustawiony w zamówieniu, które zostało zaimportowane do Optimakers : optimesOrderStatus 
  • Identyfikatory atrybutów, które będą dodane do zamówienia. Potrzebujemy identyfikatory dla następujących atrybutów: 
    • Id atrybutu dot. metody dostawy: optimesOrderAttributeDeliveryMethod
    • Id atrybutu dot. ceny dostawy: optimesOrderAttributeDeliveryPrice
    • Id atrybutu dot. metody płatności: optimesOrderAttributePaymentMethod
    • Id atrybutu dot. dodatkowe pole 1: optimesOrderAttributeAdditionalField1
    • Id atrybutu dot. dodatkowe pole 2: optimesOrderAttributeAdditionalField2
    • Id atrybutu dot. uwag: optimesOrderAttributeNote
    • Id atrybutu w Optimakers dot. loginu Klienta: optimesCustomerAttributeLogin
  • Dodatkowo z systemu Optimakers potrzebujemy wszystkie zdefiniowane waluty oraz stawki VAT wraz z ich identyfikatorami. 

Gdzie znaleźć potrzebne dane i jak skonfigurować systemy?

System od Optimakers:

OPTIMES_URL – jest to adres instancji systemu Optimakers gdzie zawsze się logujemy np.: https://test.syneo.pl

OPTIMES_API_KEY – klucz ten znajdziemy logując się do systemu Optimakers na następnie wchodząc w lewym menu w zakładkę Pracownicy. 

Aby przy danym pracowniku można było wygenerować API KEY rola, którą posiada musi mieć włączone w ustawieniach: Nadawanie kluczy API: 

Następnie musimy wejść w edycję pracownika, za pomocą którego chcemy się łączyć z Baselinker.pl lub utworzyć nowego.

W edycji wybranego pracownika wchodzimy w zakładkę Dodatkowe informacje po lewej stronie.

Kopiujemy wartość z pola Klucz API lub generujemy nowy. 

OPTIMES_WEBHOOKTOKEN – ten znajdziemy logując się do instancji systemu Optimakers na następnie wchodząc w lewym menu w zakładkę Ustawienia a następnie w menu Webhooki.

W tym miejscu musimy wygenerować nowy webhook:

Nazwa – dowolna nazwa pozwalająca ocenić do czego służy dany webhook

Token bezpieczeństwa – tutaj wpisujemy ciąg znaków który stanowił będzie token bezpieczeństwa. Token należy wysłać nam, abyśmy mogli prawidłowo przygotować integrację.

Adres wywołania – tutaj należy wpisać adres internetowy który otrzymacie Państwo od nas jak już przygotujemy integrację. 

Źródło zdarzenia – tutaj generujemy zdarzenia dla: 

  • Produkt – Usunięcie 
  • Produkt – Aktualizacja 
  • Produkt – Utworzenie 
  • Zamówienie – Aktualizacja 

Zapisujemy zmiany 

optimesOrderStatus– statusy zamówień w systemie Optimakers można sprawdzić w widoku: Ustawienia => Statusy encji. W tym widoku wybieramy ID z listy dla encji: Zamówienie

Parametry do zamówienia definiujemy w widoku: Ustawienia => Atrybuty 

Parametry te nie są domyślnie zdefiniowane i trzeba je dodać do systemu. Jako Encja wybieramy Zamówienie 

Do uruchomienia integracji niezbędne są stawki VAT, które można zobaczyć w widoku: Ustawienia => Handel => Stawki VAT 

Id stawki VAT możemy zobaczyć tylko z linku do edycji. 

Do prawidłowego działania niezbędne są również waluty, które można zobaczyć w widoku: Ustawienia => Handel => Waluty 

Id waluty możemy zobaczyć tylko z linku do edycji. 

System Baselinker.pl: 

baselinkerApiKey – jest to klucz API, który możemy pobrać z widoku Moje konto zakładka API 
 

 
Statusy zamówień: baselinkerOrderStatusToImport oraz baselinkerOrderStatusToSend możemy pobrać z widoku: Zamówienia => Statusy zamówień. Identyfikatory nie są jawnie pokazane na stronie, trzeba sprawdzić link, który jest odpowiedzialny za edycję statusu. 

W jaki sposób sprawdzić, czy integracja działa prawidłowo?

Po uruchomieniu integratora, zamówienia o podanym statusie powinny pojawić się w systemie Optimakers. Czas, w jakim pojawi się zamówienie, uzależniony jest od tego, ile zamówień musimy pobrać do systemu. Ten czas powinien wahać się w granicy 5-30min.

Jak zamówienie zostanie przesłane do Optimakers należy sprawdzić, czy integracja działa w drugą stronę. Jeśli zamówienie zostanie zrealizowane, (ustawienie w edycji zamówienia Zrealizowane: Tak) wówczas w systemie Baselinker powinien zostań zmieniony status, zamówienia na ten podany w parametrach. 

Ze względu na strukturę organizacyjną, osoba zajmująca się Zamówieniami nadzorowała również proces realizacji poszczególnych zleceń – tak aby informować klientów o postępach pracy.

Jeżeli uważasz, że w Twojej produkcji przyda się usprawnienie funkcjonowania, wypróbuj nasze bezpłatne 14-dniowe demo i sprawdź jaką wartość możemy Ci zaoferować. Chętnie pomożemy!

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany. Wymagane pola są oznaczone *