Система управления производством
Система управления производством
System do zarządzania produkcją
System do zarządzania produkcją

Integracja Optimes i Baselinker – pierwsze kroki

  1. 1. Jak uzyskać pomoc przy integracji z Baselinkerem?

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

  1. 2. Jakie parametry są niezbędne do uruchomienia integracji?

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

Z systemu Baselinker potrzebujemy: 

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

Z systemu OptiMES 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 OptiMES : 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 OptiMES dot. loginu Klienta: optimesCustomerAttributeLogin
    • Dodatkowo z systemu OptiMES potrzebujemy wszystkie zdefiniowane waluty oraz stawki VAT wraz z ich identyfikatorami. 

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

System OptiMES

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

OPTIMES_API_KEY – klucz ten znajdziemy logując się do systemu OptiMES 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. 

 

Obraz zawierający tekst Opis wygenerowany automatycznie  

 

 

OPTIMES_WEBHOOKTOKEN – ten znajdziemy logując się do instancji systemu OptiMES 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 OptiMES 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