Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 62 miesięcy (ostatni commit: 2021-09-15, kaatarzyna). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Steps swapping

Przesyłanie informacji o kolejności stepów do SK API

Tworzenie transportu przez SK API

Aby utworzyć transport przez SK API, należy dodać wpisy do bazy swiss-krono-api - do tabel address oraz transport. Przykładowe sqle niżej:

INSERT INTO address (order_number, client_number, client_name, client_email,
                     recipient_name, street_address, city, postal, country_code,
                     delivery_date, list_of_documents,
                     volume, weight, company_group_identifier, skm_identifier)
VALUES (2021012000008, -- numer zlecenia transportowego
        1476724151, --numer klienta
        'Superhobby', -- nazwa klienta
        '[email protected]', --email klienta
        'General Super', --nazwa odbiorcy towaru
        'Sap 314', -- adres dostawy
        'Sapat', --miasto dostawy
        '99-999', --kod pocztowy dostawy
        'PL', --kraj dostawy
        '2019-07-06 12:00', --planowana data dostawy
        '5', --lista WZ
        24.5, --objętość
        21.3, --waga
        '12345', --erp klienta
        '5' -- identyfikator stepu, unikalny w ramach jednego transportu (order_number)
       );

INSERT INTO transport (order_number, transport_type, order_type, carrier_number, incoterms, container_number,
                       order_creation_date, notes, trader_email, order_of_unloading, biggest_pallet, total_volume, total_weight,
                       trailer_type, vehicle_departure_weight, vehicle_entry_weight)
VALUES (2021012000008, 'CONTAINER', 'wysyłka', 54321, 'FCA', 'PG125GA',
        now(), '2.0.61', '[email protected]', '21', '12', 24.5, 21.3,
        'platforma podkontenerowa', 12.8, 37.3);

Identyfikatorem stepu jest tutaj pole skm_identifier w tabeli address. Powinno być ono unikalne w ramach jednego transportu. Pole to jest przesyłane podczas tworzenia transportu i zapisywane po stronie Apollo.

Po zapisaniu transportu w Apollo, w bazie SK API jest dodawany wpis do tabeli priority_of_deliveries. Zawiera on informacje o początkowej kolejności stepów w polach:

  • address_ids - są to id obiektów address z bazy SK API rozdzielone przecinkami, w kolejności w jakiej występują w transporcie,
  • skm_identifiers - są to numery skm_identifier stepów rozdzielone przecinkami, w kolejności w jakiej występują w transporcie.

Edycja kolejności stepów

W aplikacji Apollo jest możliwość zmiany kolejności stepów. Jeśli taka sytuacja nastąpi, informacja o tym powinna zostać wysłana do SK API.

SK API co minutę pyta Apollo o zmiany w transportach. Jeśli pojawi się informacja o zmianie kolejności stepów (a więc kolejności skm_identifier, gdy posortujemy stepy po order_in_transport), to:

  • wszystkie wpisy w priority_of_deliveries w bazie SK API dla tego transportu zostaną dezaktywowane (active = false),
  • zostanie dodany nowy wpis w priority_of_deliveries, z aktualną kolejnością stepów rozładunkowych.

Ostatnia zmiana: 2021-09-15 · kaatarzyna
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e