Ostatni artykuł z naszej serii o API EasyCargo zawiera kompleksowy, krok po kroku przewodnik do planowania załadunku przy użyciu API. Przeprowadzimy Cię przez cały proces od początkowej konfiguracji do uzyskania raportów planów załadunku, demonstrując interakcje API i ich odpowiednie reprezentacje w interfejsie EasyCargo. Ten przewodnik opiera się na fundamentalnych koncepcjach, jednocześnie wprowadzając zaawansowane funkcjonalności do optymalizacji operacji planowania wysyłki ładunków.

Zanim zagłębisz się w szczegóły implementacji, zbuduj solidne podstawy, korzystając z następujących dwóch niezbędnych zasobów. Nasz kompleksowy przewodnik teoretyczny po API obejmuje wszystkie podstawy, które musisz wiedzieć o API, podczas gdy nasz praktyczny przewodnik do zapytań API i testowania z ReqBin przeprowadzi Cię przez konfigurację klienta API, a także testowanie punktów końcowych. Razem, te artykuły ustanawiają niezbędne podwaliny i dostarczają kluczowy kontekst dla tematów omawianych w tym artykule.

Proces planowania załadunku krok po kroku

Aby korzystać z poniższych żądań API, będziesz musiał dołączyć token uwierzytelniający w nagłówku żądania. Szczegółowe procedury uwierzytelniania znajdziesz w naszym poprzednim artykule. Aby uzyskać token uwierzytelniający, musisz posiadać klucz API powiązany z Twoim kontem użytkownika. Skontaktuj się z naszym zespołem wsparcia, aby poprosić o klucz API. Pamiętaj, że tokeny uwierzytelniające są ważne tylko przez 1.5 godziny i wygasają później ze względów bezpieczeństwa.

Konfiguracja dostępu użytkownika

Pierwszym i jednym z najważniejszych kroków w naszym procesie planowania załadunku jest utworzenie konta, na przykład dla personelu magazynowego. Korzystając z endpointu /api/v1/users, możesz tworzyć nowe konta użytkowników z określonymi uprawnieniami. Musisz podać określone dane użytkownika, jak pokazano w poniższym żądaniu API. Panel EasyCargo natychmiast odzwierciedla to dodanie, potwierdzając dostęp użytkownika do konta firmowego. Ten usprawniony proces właściwie zapewnia zarówno zarządzanie dostępem, jak i kontrolę bezpieczeństwa dla operacji planowania załadunku, utrzymując jednocześnie wydajność operacyjną.

W poniższym fragmencie kodu wyślemy żądanie do endpointu /api/v1/users z treścią zawierającą szczegóły o użytkowniku, dla którego chcemy utworzyć konto. Chcemy określić imię, nazwisko, adres e-mail do logowania i rolę użytkownika. Rola użytkownika może być albo administratorem (reprezentowanym przez 1 w treści żądania), albo zwykłym użytkownikiem (reprezentowanym przez 2).

Zobacz pełny szablon żądania API: https://reqbin.com/duacb1ye

Definiowanie przestrzeni ładunkowych

Przed rozpoczęciem jakichkolwiek operacji planowania załadunku, zdefiniowanie przestrzeni ładunkowych jest niezbędne. Endpoint /api/v1/cargospaces umożliwia określenie wymiarów kontenera, w którym zostaną umieszczone przedmioty. Każda definicja przestrzeni ładunkowej wymaga ważnych specyfikacji, w tym długości, szerokości, wysokości i maksymalnej nośności. Obecnie API obsługuje tylko przestrzenie ładunkowe typu kontenerowego do tworzenia przez użytkownika, z potencjałem do obsługi innych typów przestrzeni ładunkowych w przyszłych aktualizacjach. System sprawdza wszystkie specyfikacje, aby upewnić się, że spełniają wymagania operacyjne i standardy bezpieczeństwa. Po zdefiniowaniu, przestrzeń ładunkowa pojawia się w interfejsie EasyCargo, potwierdzając pomyślne utworzenie i umożliwiając natychmiastowe użycie do planowania załadunku.

W poniższym fragmencie kodu wyślemy żądanie do endpointu /api/v1/cargospaces z treścią zawierającą szczegóły dotyczące kontenera, z celem utworzenia nowej przestrzeni ładunkowej. Określamy nazwę, szerokość, wysokość, długość i maksymalną wagę załadunku. Wskażemy również system miar używany do definiowania wartości (1 dla systemu metrycznego i 2 dla systemu imperialnego) oraz typ przestrzeni ładunkowej, który jest ustawiony na 1, reprezentujący kontener. Jak wspomniano wcześniej, tylko ten typ przestrzeni ładunkowej jest obsługiwany.

Zobacz pełny szablon żądania API: https://reqbin.com/8ieqp8ey

Zarządzanie towarami do załadunku

Po zdefiniowaniu przestrzeni ładunkowych, kolejnym krokiem jest utworzenie nowej przesyłki poprzez endpoint /api/v1/shipment-inputs. Proces ten obejmuje określenie zarówno szczegółów przesyłki, jak i poszczególnych przedmiotów do załadunku. Każdy przedmiot wymaga kompleksowych atrybutów, w tym dokładnych wymiarów, specyfikacji wagi, wymagań dotyczących obsługi i ograniczeń dotyczących układania. Interfejs EasyCargo zapewnia wizualne potwierdzenie pomyślnego utworzenia przesyłki, wyświetlając wszystkie przedmioty i ich specyfikacje. To szczegółowe wprowadzenie zapewnia dokładne planowanie załadunku i optymalne wykorzystanie przestrzeni w kolejnych krokach, przy jednoczesnym zachowaniu zgodności z przepisami bezpieczeństwa i protokołami obsługi.

W poniższym fragmencie kodu utworzymy nową przesyłkę z 82 sztukami jednego typu przedmiotu, używając endpointu /api/v1/shipment-inputs. W treści żądania określimy nazwę przesyłki, system miar i przechowywane przedmioty. Dla przedmiotów możemy określić ich szczegóły, takie jak wymiary i ograniczenia pakowania. W tym przykładzie zachowamy towary w grupie priorytetowej o nazwie Berlin, ponieważ tam chcemy dostarczyć lodówki. Pozwolimy im być obracalnymi i układalnymi podczas pakowania ich w przestrzeni ładunkowej. Pamiętaj, że obecnie nie jest możliwe wybranie koloru lub kontrolowanie, czy etykieta przedmiotu jest wyświetlana czy nie poprzez API.

Zobacz pełny szablon żądania API:https://reqbin.com/ozixloob

Proces optymalizacji planu załadunku

Po ustaleniu szczegółów przesyłki, silnik optymalizacji EasyCargo przejmuje kontrolę, aby generować efektywne plany załadunku. Chociaż uruchamianie procesu optymalizacji bezpośrednio przez API jest obecnie w fazie rozwoju, użytkownicy mogą uzyskać dostęp do tej funkcjonalności poprzez interfejs EasyCargo, klikając przycisk Załaduj. EasyCargo uwzględnia wiele czynników, w tym rozkład wagi, sekwencję załadunku i wymagania dotyczące dostawy, aby stworzyć optymalne układy. Po wstępnej optymalizacji, użytkownicy zachowują elastyczność w dokonywaniu ręcznych korekt lub modyfikowaniu wyboru przestrzeni ładunkowej, zapewniając, że ostateczny plan spełnia określone wymagania operacyjne i ograniczenia, maksymalizując jednocześnie efektywność.

Generowanie raportów planu załadunku

Po sfinalizowaniu planu załadunku, kompleksowa dokumentacja staje się dostępna poprzez endpoint /api/v1/shipment-reports/{id}. Te szczegółowe raporty planu załadunku obejmują układy załadunku, wizualizacje 3D i precyzyjne instrukcje załadunku. Każdy raport dostarcza krytyczne metryki, w tym wykorzystanie przestrzeni, dane o rozkładzie wagi i szczegółowe wytyczne dotyczące obsługi dla personelu załadunkowego. System generuje zarówno interaktywne modele 3D, jak i możliwe do pobrania instrukcje PDF, zapewniając dostępność dla wszystkich zainteresowanych, takich jak pracownicy magazynu i Twoi klienci. Te raporty służą jako istotne odniesienia podczas fizycznego procesu załadunku, pomagając utrzymać spójność między planowanymi i rzeczywistymi układami załadunku. Sprawdź raport wysyłki, aby uzyskać pełne szczegóły.

W poniższym fragmencie kodu pobierzemy wszystkie szczegóły raportu przesyłki, używając endpointu /api/v1/shipment-report/{id}. Najpierw musimy uzyskać ID raportu przesyłki, wysyłając żądanie GET do /api/v1/shipments. Weź ID raportu przesyłki z tej odpowiedzi i dołącz go do ścieżki URL Twojego następnego żądania (/api/v1/shipment-report/{id}). Odpowiedź będzie zawierać wszystkie szczegóły, które widzisz na poniższym obrazku w raporcie PDF do wydruku.

Zobacz pełny szablon żądania API: https://reqbin.com/ust8mrq2

Udostępnianie i współpraca

Ostatnia faza obejmuje dystrybucję informacji o planie załadunku do odpowiednich interesariuszy poprzez endpoint /api/v1/shipments. Ta funkcjonalność zapewnia dostęp do kompleksowych szczegółów przesyłki i powiązanych raportów, w tym interaktywnych reprezentacji 3D planu załadunku. Interesariusze mogą uzyskać dostęp do planu poprzez publiczny URL, umożliwiając wizualizację i weryfikację układu załadunku w czasie rzeczywistym. To podejście oparte na współpracy zapewnia, że wszyscy uczestnicy procesu załadunku mają natychmiastowy dostęp do niezbędnych informacji, ułatwiając efektywną koordynację i dokładną implementację planu załadunku. Możesz uzyskać dostęp do publicznego URL planu załadunku w EasyCargo, aby samemu zobaczyć rozmieszczenie towarów.

W poniższym fragmencie kodu pobierzemy wszystkie szczegóły dla naszej wcześniej utworzonej przesyłki, używając endpointu /api/v1/shipments/{id}. Aby uzyskać ID przesyłki, najpierw wyślij żądanie GET do /api/v1/shipments. Po zidentyfikowaniu ID przesyłki, wykonaj żądanie GET do /api/v1/shipments/{id}, aby otrzymać kompleksowe szczegóły przesyłki, w tym publiczny link, link do raportu przesyłki i inne informacje pokazane poniżej.

Zobacz pełny szablon żądania API: https://reqbin.com/y5p3zysj

Podsumowując, wpływ API na branżę IT nie może być przeceniony – stały się one fundamentalnymi elementami nowoczesnej architektury oprogramowania i operacji biznesowych. API EasyCargo jest przykładem tego, jak dobrze zaprojektowane interfejsy mogą usprawnić złożone operacje logistyczne, zachowując jednocześnie precyzję i efektywność. Mamy nadzieję, że ta kompleksowa seria dostarczyła wartościowych informacji na temat korzystania z API EasyCargo dla Twoich potrzeb logistycznych. Niezależnie od tego, czy jesteś nowy w API, czy doświadczonym programistą, możliwości integracji są obszerne. Aby uzyskać spersonalizowaną konsultację dotyczącą implementacji EasyCargo w Twoich operacjach, skontaktuj się z nami poprzez nasz formularz kontaktowy. Nasz zespół jest gotowy pomóc Ci w poznaniu naszego rozwiązania, aby dopasować je do Twoich konkretnych wymagań.