Połącz dostawców usług fulfillmentu

Uwaga: interfejs aplikacji jest obecnie dostępny po angielsku, niemiecku i włosku. W tej instrukcji pogrubione nazwy przycisków i menu podajemy po angielsku.

Dostawcy usług fulfillmentu, nazywani też 3PL, otrzymują przesyłki i przekazują zwrotnie informacje o śledzeniu przesyłek, produktach i zapasach. Te konta dodajesz w Settings → Connections, gdzie pojawiają się w sekcji Fulfillment providers.

Połączenie konta nigdy nie uruchamia przekazywania przesyłek. Dzieje się to osobno dla każdej lokalizacji w Fulfillment → Setup i tylko w procesach, które przełączysz na Active.

Dostawca	Co podajesz	Instrukcja
JTL FFN	Własna aplikacja JTL, a następnie logowanie w JTL	Połącz JTL z hubem
Magware	Adres URL API, kod właściciela i klucz API	Magware
Mintsoft	Klucz API	Mintsoft
Logisoft (Asendia)	Numer klienta i token API; opcjonalnie SFTP drop do przesyłania faktur	Logisoft (Asendia)

Zanim zaczniesz

• Przygotuj dane połączenia operatora. W razie potrzeby poproś o nie operatora.
• Klucze API, tokeny i klucze prywatne wpisuj wyłącznie w formularzu hubu. Balta Labs przechowuje je w postaci zaszyfrowanej i nigdy nie wyświetla ich ponownie. Nigdy nie wysyłaj ich e-mailem ani na czacie.
• Potrzebujesz uprawnienia Connections w obszarze roboczym.

Dodaj konto

1. Otwórz Settings → Connections. W sekcji Fulfillment providers wybierz Add provider. Add account u góry strony pokazuje tych samych dostawców.
2. Wybierz dostawcę.
3. Opcjonalnie wpisz nazwę w polu Connection name, a następnie wypełnij pola opisane poniżej.
4. Wybierz Save account.
5. Wybierz Test na karcie konta. Poprawiaj wartości, aż karta pokaże Working.
6. Wybierz Details, aby zobaczyć sekcje Account, What the hub can do i Reference lists, z których korzystasz przy konfiguracji lokalizacji.

Aby później zmienić konto, wybierz Edit na jego karcie. Pozostaw pole sekretu puste, aby zachować zapisaną wartość. Zmiana danych dostępowych lub adresów przywraca stan Not checked do czasu następnego testu.

Magware

• API URL: adres API Magware podany przez magazyn, np. https://wms.example.com/api/. Musi to być publiczny adres bez nazw użytkowników, parametrów zapytania i fragmentów z #. http:// zadziała, jeśli serwer Magware nie oferuje niczego innego, ale w miarę możliwości używaj https://.
• Owner code: kod klienta w Magware.
• API key: klucz dla tego kodu właściciela.

Test odczytuje listę zapasów i niczego nie zmienia w Magware. Jeśli adres nie odpowiada tak jak API Magware, test o tym poinformuje. Lokalizacje Magware nie wymagają ustawień dostawcy.

Magware zwraca każdą aktualizację przesyłki tylko raz. Hub odczytuje ten strumień wyłącznie przy aktywnym śledzeniu; w trybie Shadow nie jest on odpytywany.

Mintsoft

• API key: klucz API Mintsoft dla konta klienta.

Test pobiera listę magazynów i usług kurierskich widocznych dla tego klucza, a Details wyświetla je wraz z identyfikatorami. Podczas dodawania lokalizacji wpisz Mintsoft warehouse ID, Courier service ID oraz Prime courier service ID, używany dla zamówień Amazon Prime.

Logisoft (Asendia)

• Customer reference: numer klienta w Logisoft.
• API token: token API Logisoft.
• Advanced settings (opcjonalnie): Core service WSDL URL (domyślnie https://soap.myasendia.it/LogisticService.svc?wsdl), Logistics service WSDL URL (domyślnie https://soap.myasendia.it/Service.svc?wsdl) i Timeout (seconds) (domyślnie 120). Zmieniaj je tylko wtedy, gdy otrzymasz od Logisoft inne adresy usług lub prośbę o dłuższy limit czasu. Adresy WSDL muszą używać https://, a limit czasu może wynosić od 10 do 300 sekund.

Aby przesyłać faktury, wypełnij też sekcję SFTP drop (optional): SFTP host (tylko nazwa hosta, bez sftp://), SFTP port (domyślnie 22), SFTP username i SFTP private key (cały klucz razem z wierszami BEGIN i END, w formacie OpenSSH, PEM lub PuTTY). SFTP drop wymaga hosta, nazwy użytkownika i klucza prywatnego albo żadnej z tych wartości.

Test sprawdza token, pobiera listę sklepów i łączy się z usługą logistyczną. Jeśli skonfigurowano SFTP drop, test loguje się też na serwerze i sprawdza folder faktur. Przy pierwszym udanym teście hub przypina klucz serwera SFTP. Karta pokazuje wtedy SFTP host key pinned, a hub komunikuje się tylko z serwerem, który ma ten klucz. Jeśli zmienisz host, następny udany test przypnie klucz nowego serwera. Jeśli późniejszy test zgłosi inny klucz dla tego samego hosta, potwierdź w firmie Asendia, że ta zmiana jest oczekiwana, a następnie skontaktuj się z zespołem wsparcia.

Podczas dodawania lokalizacji pola Carrier code i Store code mają domyślne wartości ASENDIA_IT i CUSTOM.

Co oznacza stan połączenia

Stan	Znaczenie	Co zrobić
Working	Ostatni test lub żądanie do dostawcy zakończyło się powodzeniem.	Nic nie trzeba robić.
Check failed	Ostatni test lub żądanie zakończyło się błędem. Karta pokazuje komunikat dostawcy.	Usuń przyczynę, np. błąd w adresie, sieci lub ustawieniach, a następnie wybierz Test.
Reconnect needed	Dostawca odrzucił dane dostępowe lub autoryzację.	Wybierz Edit i wpisz nowe dane dostępowe albo użyj Reconnect dla konta JTL, a następnie wybierz Test.
Not checked	Konto jest nowe albo zmieniły się jego dane dostępowe lub adresy.	Wybierz Test.

Karta pokazuje też czas ostatniego sprawdzenia konta. Stan zmienia się, gdy wybierzesz Test oraz gdy hub korzysta z konta. Dotyczy konta, a nie poszczególnych przesyłek: te sprawdzisz w Fulfillment → Operations.

Włączanie procesów magazynowych

W Fulfillment → Setup dodaj konto źródłowe i lokalizację łączącą jego magazyn z operatorem. Harmonogramy i zadania ręczne znajdują się w Sync. Reguły zamówień i tryb automatyzacji konta są w Automations.

Sprawdź decyzje w trybie Shadow, a następnie przełącz potrzebne procesy na Active. Zmiana na Active lub z Active wymaga potwierdzenia i jest zapisywana w historii. Wyniki są w Operations, różnice stanów i mapowania produktów w Inventory. Aby wstrzymać proces, wybierz Off lub Shadow i sprawdź zadania już w toku w Operations.

Aby zmienić kilka lokalizacji, zaznacz wiersze, wybierz proces i tryb, a następnie Review changes. Wynik wskazuje lokalizacje, których nie udało się zmienić. Każde konto źródłowe ma własne reguły, zapisane wersje robocze i historię aktywacji.