Funkciok

Rendszerintegrációk & API

A Logistiq ma egyetlen gépi felületet kínál — a kulcsos, rate-limitelt kapueszköz-API-t —, valamint egy fuvarozói önkiszolgáló portált, amely fájlcsere nélkül juttatja be a fuvarozói adatokat; a TMS-, WMS- és ERP-rendszerekhez készülő API az útitervben szerepel, és ez az oldal így is jelöli, ahelyett hogy többnek mutatná.

Demo keres Arak

Ma egy gépi API, partner API az útitervben

Mielőtt konnektort kérne

A telepadatok többsége ma is e-mailben, telefonon és újragépeléssel érkezik

A porta nyomtatott listával és az irodának küldött telefonhívással működik. A fuvarozó előző nap e-mailben átküld egy érkezési táblázatot, egy diszpécser begépeli foglalásnak, a rendszámot pedig még kétszer javítják a sorompónál. Ez nem technológiai probléma — ez adatrögzítési probléma, minden reggel megismételve, diszpécserórákban és kamionállásban kifizetve.

A Logistiq nem a rendszerek összedrótozásával, hanem a forrásnál kezeli az adatrögzítést. A fuvarozók saját portálon regisztrálnak, és maguk tartják naprakészen a cégeiket, sofőrjeiket, kamionjaikat és pótkocsijaikat — így az adatot az gépeli be egyszer, aki valóban ismeri. A sofőr a qrgo.ro oldalról vagy a QRGO Driver appból adja le a check-int. A foglalások external_reference mezője kifejezetten az Ön saját rendszerének szállítmányazonosítóját hivatott tárolni, így a két rekord ma szemre összevethető marad — és géppel olvashatóvá válik azon a napon, amikor lesz API, ami kiolvassa. A kapu pedig már ma gép-gép kapcsolatban működik: a QRGOBox eszköz szervezetre szóló kulccsal hívja az API-t, és a sorompó érvényes check-in kódra nyílik.

Logistiq nélkül

A fuvarozó táblázatban e-mailezi a másnapi érkezéseket
A diszpécser kézzel gépeli be a sofőr, kamion és pótkocsi adatait
A porta telefonon érdeklődik az irodánál, hogy várt-e a kamion
A szállítmányazonosító papíron él, a telepi rekordtól távol

A Logistiq-kel ma

A fuvarozók maguk regisztrálnak, és karbantartják saját sofőrjeiket, kamionjaikat, pótkocsijaikat
A sofőr a qrgo.ro oldalról vagy a QRGO Driver appból adja le a check-int
A QRGOBox eszköz az API-n ellenőrzi a check-in kódot, és nyitja a sorompót
A bookings.external_reference tárolja az Ön rendszerének szállítmányazonosítóját

Az egyetlen élő gépi felület: a kapueszköz-API

Hat végpont a logistiq.cloud-on, egyetlen szervezetenkénti kulccsal hitelesítve. Ez a QRGOBox sorompóhardver eszközhitelesítése — kapukat, heartbeatet és check-in kód ellenőrzést tesz elérhetővé, foglalásokról, check-inekről, rámpákról vagy analitikáról semmit.

Élő végpontok: 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
Hitelesítés: Szervezetenként egy kulcs, formátuma org_ és utána 32 hexadecimális karakter. A /api/device/gates hívásnál X-API-Key fejlécként, a POST útvonalakon api_key mezőként a JSON törzsben, a GET /api/gate/list hívásnál pedig ?api_key= query paraméterként küldve.
A kapuhívás: POST /api/gate/validate a { gate_id, api_key, checkin_code } törzzsel. Maga a kulcs azonosítja a bérlőt — szervezetazonosítót nem küldünk, és egy kulcs soha nem láthat mást, mint a saját raktárát.
Ezekre nyílik: A confirmed, assigned vagy in_progress állapotú check-inekre. Minden más elutasításra kerül a sorompónál, és gate_entry_denied eseményként rögzül az idővonalon.
Rate limit: 30 kérés / 60 másodperc a négy eszköz-bucket útvonalon, 60 / 60 másodperc a heartbeat és a kapulista esetén, közös Redisben számolva, így a limit minden serverless példányon átível.
Kulcs életciklusa: Generálás, másolás és újragenerálás a Beállítások → API Credentials (for QRGoBox) menüpontban. Szervezetenként egy kulcs; újragenerálása azt jelenti, hogy minden régi kulcsot használó eszközt frissíteni kell.

Az objektumok, amelyeket a rendszerei cserélnének, már léteznek

Egy integráció mindig csak annyit ér, amennyit a mögötte lévő mezők — ezek pedig már benne vannak a sémában, és napi használatban állnak. Egy foglalás tartalmazza a booking_reference és az external_reference mezőt az Ön saját rendszerének azonosítójához, a booking_status értéket, a type mezőt (rakodás, lerakodás vagy mindkettő), a scheduled_date dátumot kezdő és záró időponttal, a transport_company, driver_name és driver_phone, truck_number és trailer_number adatokat, egy rakománykategóriát, egy részleget, valamint az extra_references mezőt szabad formátumú JSON-ként arra, amit az Ön telephelye a maga nevén hív. Egy check-in ugyanezeket a hivatkozásokat viszi tovább, plusz a kiosztott rámpát vagy parkolóhelyet és a teljes időbélyeg-láncot: checked_in_at, confirmed_at, assigned_at, started_at, completed_at. Minden állapotváltozás már ma tipizált idővonalra kerül — created, status_change, ramp_assigned, ramp_unassigned, parking_assigned, department_changed, gate_entry, gate_entry_denied, gate_exit és további események. A fogalmak letisztázva, az események katalogizálva. Ami hiányzik, az a végpont, ami kiolvassa őket — és ezt kimondjuk.

roadmap

A TMS-, WMS- és ERP-API útiterv, nem kiadás

Hogy pontosak legyünk: ma nincs /api/v1, nincs OpenAPI-specifikáció, nincs SDK vagy kliens könyvtár, nincsenek kimenő webhookok, és nincs semmilyen EDI vagy fájlcsere. A foglalásokhoz készülő nyilvános REST API — szervezetenkénti kulcsok, végpontok a foglalásokhoz, idősávokhoz és részlegekhez, valamint eseménywebhookok — tervezett funkcióként van rögzítve, és el nem kezdett státuszban áll. Negyedévet nem írunk mellé, mert egy olyan dátum, amit nem tudunk állni, kevesebbet ér, mint a kapu, ami ma reggel is működik. Ha van TMS, WMS vagy ERP rendszere, amellyel szeretné, hogy a Logistiq beszéljen, mondja meg, melyik: ez a válasz dönti el, mi épül meg először.

Integrációs kérdések, kertelés nélkül

Nincs. A termék egyetlen gép-gép API-ja a kapueszköz-API, és az a QRGOBox sorompóhardver hitelesítésére szolgál: kapuk, heartbeat és check-in kód ellenőrzés. Foglalásokról, check-inekről, rámpákról vagy analitikáról semmit nem tesz elérhetővé. A foglalásokhoz készülő nyilvános REST API belsőleg specifikálva van, és el nem kezdett státuszban áll. Inkább ezt mondjuk el, mint hogy olyan végpontot adjunk el, ami nem válaszol.

Nem, egyiket sem. Nincs EDIFACT, X12 vagy AS2, nincs SFTP vagy fájlbedobás, nincs kötegelt feed, és nincs foglalás- vagy check-in-export Excelbe vagy CSV-be. A termékben az egyetlen fájlkezelés az, hogy valaki behúz egy .xlsx-et egyetlen foglalás Data fülére — egy szabad formátumú táblázat, amely ahhoz az egy rekordhoz csatolódik. A fuvarozói adatok helyette a fuvarozói portálon át érkeznek.

A fuvarozók viszik be maguk. A fuvarozó cég saját fiókot hoz létre, Ön egyszer meghívja, és onnantól maga tartja karban a sofőrjeit, kamionjait és pótkocsijait. A sofőr a qrgo.ro oldalról vagy a QRGO Driver appból adja le a check-int, a saját nyelvén. Az adatot egyszer gépeli be az, aki valóban ismeri, és soha nem táblázatként landol egy diszpécser postafiókjában.

Nem, ezeken keresztül számlázunk Önnek. A Stripe futtatja az előfizetést, a SmartBill pedig kiállítja hozzá a román számlát. Egyik sem nyúl az Ön könyveléséhez, ERP-jéhez vagy telepi adataihoz, és egyik sincs kitéve arra, hogy Ön bármit hozzákössön. Ezek a mi beszállítóink, nem konnektorok az Ön oldalán — a különbség számít, és nem fogjuk elmosni.

Kesz atalakitani a raktari muveleteket?

Csatlakozzon szazakhoz raktarakhoz, akik a hatekonysagot valasztottak. Ingyenes demo, gyors beallitas, kotelezettseg nelkul.

Ingyenes demo keres