Funcționalități

Integrări de Sisteme & API

Astăzi Logistiq oferă o singură interfață pentru echipamente — API-ul dispozitivului de poartă, cu cheie și limită de rată — plus un portal de self-service pentru transportatori care aduce datele lor înăuntru fără schimb de fișiere; API-ul pentru sisteme TMS, WMS și ERP este pe roadmap, iar pagina asta îl marchează ca atare, fără să-l îmbrace în altceva.

Solicită Demo Prețuri

Un singur API pentru echipamente astăzi, un API pentru parteneri pe roadmap

Înainte să ceri un conector

Cele mai multe date din curte ajung tot prin e-mail, telefon și retastare

Poarta funcționează pe o listă printată și un telefon la birou. Transportatorul trimite cu o zi înainte un tabel cu sosirile, un dispecer îl retastează într-o programare, iar numărul de înmatriculare mai este corectat de două ori la barieră. Nimic din toate astea nu e o problemă de tehnologie — e o problemă de introducere a datelor, repetată în fiecare dimineață și plătită în ore de dispecerat și camioane care stau.

Logistiq atacă introducerea datelor la sursă, în loc să lege sistemele între ele. Transportatorii se înregistrează în propriul portal și își țin la zi singuri firmele, șoferii, camioanele și remorcile, așa că datele sunt tastate o singură dată, de cine le știe cu adevărat. Șoferii fac check-in de pe qrgo.ro sau din aplicația QRGO Driver. Programările au un câmp external_reference gândit să conțină ID-ul de transport din sistemul tău, așa că cele două înregistrări rămân reconciliabile vizual astăzi — și citibile de mașină în ziua în care va exista un API care să le scoată afară. Iar poarta este deja machine-to-machine: un dispozitiv QRGOBox apelează API-ul cu o cheie legată de organizație, iar bariera se ridică la un cod de check-in valid.

Fără Logistiq

Transportatorul trimite pe e-mail sosirile de mâine, într-un tabel
Un dispecer retastează manual datele de șofer, camion și remorcă
Poarta sună la birou ca să confirme că un camion este așteptat
ID-ul tău de transport stă pe hârtie, departe de înregistrarea din curte

Cu Logistiq, astăzi

Transportatorii se înregistrează singuri și își întrețin șoferii, camioanele și remorcile
Șoferul face check-in de pe qrgo.ro sau din aplicația QRGO Driver
Un dispozitiv QRGOBox validează codul de check-in prin API și deschide bariera
bookings.external_reference păstrează ID-ul de transport din sistemul tău

Singura interfață pentru echipamente care este live: API-ul dispozitivului de poartă

Șase endpoint-uri pe logistiq.cloud, autentificate cu o singură cheie per organizație. Este autentificare de dispozitiv pentru hardware-ul de barieră QRGOBox — expune porți, heartbeat și validarea codului de check-in, și nimic despre programări, check-in-uri, rampe sau analize.

Endpoint-uri live: 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
Autentificare: O cheie per organizație, în formatul org_ urmat de 32 de caractere hexazecimale. Se trimite ca header X-API-Key pe /api/device/gates, ca api_key în corpul JSON pe rutele POST și ca parametru de query ?api_key= pe GET /api/gate/list.
Apelul de poartă: POST /api/gate/validate cu { gate_id, api_key, checkin_code }. Cheia în sine determină tenantul — nu se trimite niciun ID de organizație, iar o cheie nu poate vedea niciodată decât propriul depozit.
Deschide pentru: Check-in-uri în status confirmed, assigned sau in_progress. Orice altceva este refuzat la barieră și scris în cronologie ca gate_entry_denied.
Limită de rată: 30 de cereri la 60 de secunde pe cele patru rute din bucket-ul de dispozitiv, 60 la 60 de secunde pe heartbeat și pe lista de porți, numărate într-un Redis comun, ca limita să țină pe toate instanțele serverless.
Ciclul de viață al cheii: Generare, copiere și regenerare din Setări → Credențiale API (pentru QRGoBox). O cheie per organizație; regenerarea înseamnă actualizarea fiecărui dispozitiv care o folosea pe cea veche.

Obiectele pe care sistemele tale le-ar schimba există deja

O integrare nu e niciodată mai bună decât câmpurile de dedesubt, iar acelea sunt deja în schemă și în uz zilnic. O programare are booking_reference și external_reference pentru ID-ul din sistemul tău, booking_status, type (încărcare, descărcare sau ambele), scheduled_date cu oră de început și de sfârșit, transport_company, driver_name și driver_phone, truck_number și trailer_number, o categorie de marfă, un departament și extra_references ca JSON liber, pentru cum le spune locul tău lucrurilor. Un check-in are aceleași referințe, plus rampa sau locul de parcare alocat și tot lanțul de marcaje de timp: checked_in_at, confirmed_at, assigned_at, started_at, completed_at. Fiecare schimbare de stare este deja scrisă într-o cronologie tipizată — created, status_change, ramp_assigned, ramp_unassigned, parking_assigned, department_changed, gate_entry, gate_entry_denied, gate_exit și altele. Substantivele sunt așezate, evenimentele sunt catalogate. Lipsește endpoint-ul care le scoate afară, iar partea asta o spunem cu voce tare.

roadmap

API-ul pentru TMS, WMS și ERP este roadmap, nu release

Ca să fim exacți: astăzi nu există /api/v1, nu există specificație OpenAPI, nu există SDK sau bibliotecă client, nu există webhook-uri de ieșire și nu există EDI sau schimb de fișiere de niciun fel. Un API REST public pentru programări — chei per organizație, endpoint-uri pentru programări, sloturi și departamente, plus webhook-uri de evenimente — este scris ca funcționalitate planificată și marcat neînceput. Nu îi punem un trimestru, pentru că o dată pe care nu o putem susține valorează mai puțin decât poarta care funcționează în dimineața asta. Dacă ai un TMS, WMS sau ERP cu care vrei ca Logistiq să vorbească, spune-ne care: răspunsul ăsta decide ce se construiește primul.

Întrebări despre integrare, pe șleau

Nu. Singurul API machine-to-machine din produs este API-ul dispozitivului de poartă, iar el există ca să autentifice hardware-ul de barieră QRGOBox: porți, heartbeat și validarea codului de check-in. Nu expune nimic despre programări, check-in-uri, rampe sau analize. Un API REST public pentru programări este specificat intern și marcat neînceput. Preferăm să spunem asta decât să-ți vindem un endpoint care nu răspunde.

Nu, la niciuna. Nu există EDIFACT, X12 sau AS2, nu există SFTP sau file drop, nu există feed pe loturi și nu există export al programărilor sau al check-in-urilor în Excel sau CSV. Singura manipulare de fișiere din produs este un om care trage un .xlsx în tab-ul Date al unei programări — un tabel liber, atașat acelei singure înregistrări. Datele transportatorilor intră, în schimb, prin portalul de transportatori.

Le pun transportatorii înșiși. O firmă de transport își creează propriul cont, o inviți o dată, iar de atunci încolo își întreține singură șoferii, camioanele și remorcile. Șoferul face check-in de pe qrgo.ro sau din aplicația QRGO Driver, în limba lui. Datele sunt tastate o singură dată, de cine le știe cu adevărat, și nu mai ajung ca tabel în inbox-ul unui dispecer.

Nu, acelea sunt felul în care îți facturăm. Stripe rulează abonamentul, iar SmartBill emite factura românească pentru el. Niciunul nu atinge contabilitatea ta, ERP-ul tău sau datele tale din curte și niciunul nu este expus ca să conectezi tu ceva la el. Citește-le ca furnizorii noștri, nu ca niște conectori de partea ta a gardului — distincția contează și nu o vom estompa.

Gata să transformi operațiunile din depozit?

Alătură-te sutelor de depozite care au ales eficiența. Demo gratuit, configurare rapidă, fără obligații.

Solicită Demo Gratuit