Funkcje

Integracje Systemów & API

Dziś Logistiq udostępnia jedną powierzchnię maszynową — zabezpieczone kluczem API urządzenia bramowego z limitem zapytań — oraz portal samoobsługowy dla przewoźników, dzięki któremu dane przewoźnika trafiają do systemu bez wymiany plików. API dla systemów TMS, WMS i ERP jest na mapie drogowej i tak właśnie jest tu oznaczone, bez upiększania.

Dziś jedno API maszynowe, API partnerskie w planach rozwoju

Dziś Logistiq udostępnia jedną powierzchnię maszynową — zabezpieczone kluczem API urządzenia bramowego z limitem zapytań — oraz portal samoobsługowy dla przewoźników, dzięki któremu dane przewoźnika trafiają do systemu bez wymiany plików. API dla systemów TMS, WMS i ERP jest na mapie drogowej i tak właśnie jest tu oznaczone, bez upiększania.

Zanim poprosisz o konektor

Większość danych z placu wciąż przychodzi mailem, telefonem i przez przepisywanie

Portiernia pracuje na wydrukowanej liście i telefonie do biura. Przewoźnik dzień wcześniej wysyła mailem arkusz z awizacjami, dyspozytor przepisuje go do rezerwacji, a numer rejestracyjny poprawiany jest jeszcze dwa razy na szlabanie. To nie jest problem technologiczny — to problem wprowadzania danych, powtarzany każdego ranka i opłacany godzinami dyspozytorów oraz postojem ciężarówek.

Logistiq atakuje wprowadzanie danych u źródła, zamiast spinać ze sobą Twoje systemy. Przewoźnicy rejestrują się we własnym portalu i sami utrzymują aktualne firmy, kierowców, ciągniki i naczepy, więc dane wpisuje raz ten, kto naprawdę je zna. Kierowcy składają check-in z qrgo.ro lub z aplikacji QRGO Driver. Rezerwacje mają pole external_reference zaprojektowane pod identyfikator wysyłki z Twojego systemu, więc oba rekordy już dziś da się uzgodnić wzrokiem — a staną się czytelne maszynowo w dniu, w którym powstanie API, które je odczyta. Sama brama działa już maszyna–maszyna: urządzenie QRGOBox wywołuje API kluczem przypisanym do organizacji, a szlaban podnosi się przy prawidłowym kodzie check-in.

Bez Logistiq

  • Przewoźnik wysyła mailem arkusz z jutrzejszymi awizacjami
  • Dyspozytor ręcznie przepisuje dane kierowcy, ciągnika i naczepy
  • Portiernia dzwoni do biura, by potwierdzić, że ciężarówka jest oczekiwana
  • Twój identyfikator wysyłki żyje na papierze, z dala od rekordu z placu

Z Logistiq dzisiaj

  • Przewoźnicy rejestrują się sami i utrzymują własnych kierowców, ciągniki i naczepy
  • Kierowca składa check-in z qrgo.ro lub z aplikacji QRGO Driver
  • Urządzenie QRGOBox weryfikuje kod check-in przez API i otwiera szlaban
  • bookings.external_reference przechowuje identyfikator wysyłki z Twojego systemu

Jedyna działająca powierzchnia maszynowa: API urządzenia bramowego

Sześć endpointów na logistiq.cloud, uwierzytelnianych jednym kluczem na organizację. To uwierzytelnianie urządzeń dla sprzętu szlabanowego QRGOBox — udostępnia bramy, heartbeat i walidację kodu check-in, i nic poza tym: żadnych rezerwacji, check-inów, ramp ani analityki.

Działające endpointy
GET /api/device/gates · POST /api/device/heartbeat · POST /api/device/validate-api-key · POST /api/device/validate-key · POST /api/gate/validate · GET /api/gate/list
Uwierzytelnianie
Jeden klucz na organizację, w formacie org_ i 32 znaki szesnastkowe. Wysyłany jako nagłówek X-API-Key w /api/device/gates, jako api_key w treści JSON na trasach POST oraz jako parametr zapytania ?api_key= w GET /api/gate/list.
Wywołanie bramy
POST /api/gate/validate z { gate_id, api_key, checkin_code }. Sam klucz rozstrzyga, o którego najemcę chodzi — nie przesyła się identyfikatora organizacji, a klucz nigdy nie zobaczy innego magazynu niż własny.
Otwiera dla
Check-inów w statusie confirmed, assigned lub in_progress. Wszystko inne zostaje odrzucone na szlabanie i zapisane na osi czasu jako gate_entry_denied.
Limit zapytań
30 zapytań na 60 sekund na czterech trasach z puli urządzeń, 60 na 60 sekund dla heartbeat i listy bram, zliczane we współdzielonym Redisie, dzięki czemu limit obowiązuje we wszystkich instancjach serverless.
Cykl życia klucza
Generowanie, kopiowanie i ponowne generowanie w Ustawienia → API Credentials (for QRGoBox). Jeden klucz na organizację; jego regeneracja oznacza aktualizację każdego urządzenia, które używa starego.

Obiekty, które wymieniałyby Twoje systemy, już istnieją

Integracja jest tyle warta, ile pola pod nią — a te są już w schemacie i w codziennym użyciu. Rezerwacja niesie booking_reference i external_reference na identyfikator z Twojego systemu, booking_status, type (loading, unloading lub both), scheduled_date z godziną początku i końca, transport_company, driver_name i driver_phone, truck_number i trailer_number, kategorię ładunku, dział oraz extra_references jako dowolny JSON na to, jak nazywacie rzeczy u siebie. Check-in niesie te same referencje plus przypisaną rampę lub miejsce postojowe i pełny łańcuch znaczników czasu: checked_in_at, confirmed_at, assigned_at, started_at, completed_at. Każda zmiana stanu jest już zapisywana na typowanej osi czasu — created, status_change, ramp_assigned, ramp_unassigned, parking_assigned, department_changed, gate_entry, gate_entry_denied, gate_exit i inne. Rzeczowniki są ustalone, zdarzenia skatalogowane. Brakuje endpointu, który je odczyta — i to mówimy wprost.

roadmap

API dla TMS, WMS i ERP to plan, nie wydanie

Ściśle rzecz biorąc: dziś nie ma /api/v1, nie ma specyfikacji OpenAPI, nie ma SDK ani biblioteki klienckiej, nie ma webhooków wychodzących, nie ma też EDI ani jakiejkolwiek wymiany plików. Publiczne REST API do rezerwacji — klucze per organizacja, endpointy dla rezerwacji, slotów i działów oraz webhooki zdarzeń — jest spisane jako funkcja planowana i oznaczone jako nierozpoczęte. Nie podajemy kwartału, bo data, której nie umiemy dotrzymać, jest warta mniej niż brama, która działa dziś rano. Jeśli używasz TMS, WMS lub ERP, z którym Logistiq ma rozmawiać, powiedz nam którego: ta odpowiedź decyduje, co powstanie najpierw.

Pytania o integracje, odpowiedzi bez owijania

Nie. Jedynym API maszyna–maszyna w produkcie jest API urządzenia bramowego i służy ono do uwierzytelniania sprzętu szlabanowego QRGOBox: bramy, heartbeat i walidacja kodu check-in. Nie udostępnia niczego na temat rezerwacji, check-inów, ramp ani analityki. Publiczne REST API do rezerwacji jest opisane wewnętrznie i oznaczone jako nierozpoczęte. Wolimy to powiedzieć, niż sprzedać Ci endpoint, który nie odpowiada.

Nie, żadnej z tych rzeczy. Nie ma EDIFACT, X12 ani AS2, nie ma SFTP ani file dropu, nie ma wsadowego zasilania, nie ma eksportu rezerwacji ani check-inów do Excela czy CSV. Jedyna obsługa plików w produkcie to człowiek przeciągający plik .xlsx do zakładki Data w jednej rezerwacji — dowolny arkusz załączony do tego jednego rekordu. Dane przewoźników wpływają zamiast tego przez portal przewoźnika.

Przewoźnicy wprowadzają je sami. Firma transportowa zakłada własne konto, Ty zapraszasz ją raz, a od tej pory sama utrzymuje swoich kierowców, ciągniki i naczepy. Kierowca składa check-in z qrgo.ro lub z aplikacji QRGO Driver, we własnym języku. Dane wpisuje raz ten, kto naprawdę je zna, i nigdy nie lądują jako arkusz w skrzynce dyspozytora.

Nie, tak wystawiamy Ci rachunki. Stripe obsługuje subskrypcję, a SmartBill wystawia do niej rumuńską fakturę. Żadne z nich nie dotyka Twojej księgowości, Twojego ERP ani danych z placu i żadne nie jest udostępnione do podłączania czegokolwiek. To nasi dostawcy, a nie konektory po Twojej stronie płotu — ta różnica ma znaczenie i nie zamierzamy jej zacierać.

Gotowy do transformacji operacji magazynowych?

Dolacz do setek magazynow, ktore wybraly wydajnosc. Darmowe demo, szybka konfiguracja, bez zobowiazan.