Przegląd Przypadków Użycia

Duża firma logistyczna wymaga widoczności w czasie rzeczywistym dla operacji ładunkowych. Widoczność umożliwia nadawcom i interesariuszom śledzenie dostaw na różnych poziomach, zapewniając przejrzystość w ruchach logistycznych.

Uwaga: OneRail wspiera śledzenie widoczności, ale nie świadczy usług routingowych.

W tej strukturze:

• shipmentId → Reprezentuje oznaczenie klienta dla całego ładunku.
• orderId → Reprezentuje zamówienie klienta w ładunku.

Kroki Implementacji

Konfiguracja Widoczności za pomocą API OneRail

Tworzenie Dostawy z Widocznością

Użyj końcówki /visibility/create, aby zainicjować śledzenie widoczności dla ładunku.

Minimalne wymagane pola:

• orderId → Unikalny identyfikator zamówienia klienta
• SCAC → Standardowy Kod Alfabetyczny Przewoźnika identyfikujący przewoźnika

Jeśli wymagana jest widoczność na poziomie ładunku, należy również dołączyć shipmentId.

Aby uzyskać więcej informacji na temat tego końca punktu, zapoznaj się z referencją Swagger pod adresem: Utwórz Widoczność.

Dodaj Indywidualne Dostawy

Każdą dostawę w ładunku można również dodać indywidualnie za pomocą /visibility/{orderId}/add-deliveries.

Aby uzyskać więcej informacji na temat tego końca punktu, zapoznaj się z referencją Swagger pod adresem: Dodaj Dostawy do Widoczności.

Śledzenie Wydarzeń w Czasie Rzeczywistym

Wykorzystaj wydarzenia widoczności, aby na bieżąco informować interesariuszy.

• PICKED_UP → Ładunek załadowany na miejscu początkowym.
• EN_ROUTE_TO_DELIVERY → Ciężarówka w drodze do miejsca docelowego.
• DELIVERED → Zamówienie zostało z powodzeniem dostarczone.
• GEO → Wysyła aktualizacje lokalizacji GPS w czasie rzeczywistym, gdy jest to obsługiwane.

Przykład Aktualizacji Wydarzenia (POST /visibility/{orderId}/event):

  {
  "eventType": "PICKED_UP",
  "orderId": "MasterBOL123",
  "eventOn": "2025-02-01T08:00:00Z"
}