Functies

Systeemintegraties & API

Vandaag levert Logistiq één machinekoppeling — de gate device API met sleutel en rate limit — plus een selfserviceportaal waarmee vervoerders hun gegevens aanleveren zonder bestandsuitwisseling; de API voor TMS-, WMS- en ERP-systemen staat op de roadmap, en deze pagina benoemt dat gewoon zo in plaats van het mooier te maken.

Demo aanvragen Prijzen

Vandaag één machine-API, een partner-API op de roadmap

Voordat u om een koppeling vraagt

De meeste yard-gegevens komen nog steeds binnen via e-mail, telefoon en overtypen

De portier werkt met een geprinte lijst en een telefoontje naar kantoor. De vervoerder mailt de dag ervoor een aankomstlijst in Excel, een dispatcher typt die over in een boeking, en het kenteken wordt bij de slagboom nog twee keer gecorrigeerd. Dat is geen technologieprobleem — het is een invoerprobleem, elke ochtend opnieuw, betaald in dispatcheruren en stilstaande trucks.

Logistiq pakt de gegevensinvoer bij de bron aan in plaats van uw systemen aan elkaar te knopen. Vervoerders registreren zich in hun eigen portaal en houden hun bedrijven, chauffeurs, trucks en trailers zelf actueel, zodat de gegevens één keer worden ingevoerd door de partij die ze echt kent. Chauffeurs doen de check-in via qrgo.ro of de QRGO Driver-app. Boekingen hebben een veld external_reference dat gemaakt is om het zendingsnummer uit uw eigen systeem vast te houden, zodat beide records vandaag met het oog te matchen zijn — en machineleesbaar op de dag dat er een API is die ze uitleest. En de poort is al machine-to-machine: een QRGOBox-apparaat roept de API aan met een sleutel die aan de organisatie gebonden is, en de slagboom gaat open bij een geldige check-in-code.

Zonder Logistiq

De vervoerder mailt de aankomsten van morgen als Excel-bestand
Een dispatcher typt chauffeur-, truck- en trailergegevens met de hand over
De portier belt kantoor om te bevestigen dat een truck verwacht wordt
Uw zendingsnummer staat op papier, ver van het yard-record

Met Logistiq vandaag

Vervoerders registreren zichzelf en beheren hun eigen chauffeurs, trucks en trailers
De chauffeur doet de check-in via qrgo.ro of de QRGO Driver-app
Een QRGOBox valideert de check-in-code via de API en opent de slagboom
bookings.external_reference bevat het zendingsnummer uit uw eigen systeem

De enige machinekoppeling die live is: de gate device API

Zes endpoints op logistiq.cloud, geauthenticeerd met één sleutel per organisatie. Dit is apparaatauthenticatie voor QRGOBox-slagboomhardware — het ontsluit poorten, heartbeat en validatie van check-in-codes, en niets over boekingen, check-ins, laadperrons of analytics.

Live endpoints: 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
Authenticatie: Eén sleutel per organisatie, in het formaat org_ gevolgd door 32 hexadecimale tekens. Meegestuurd als X-API-Key-header op /api/device/gates, als api_key in de JSON-body op de POST-routes, en als queryparameter ?api_key= op GET /api/gate/list.
De poortaanroep: POST /api/gate/validate met { gate_id, api_key, checkin_code }. De sleutel bepaalt zelf de tenant — er wordt geen organisatie-ID meegestuurd, en een sleutel kan nooit meer zien dan zijn eigen magazijn.
Opent voor: Check-ins met status confirmed, assigned of in_progress. Al het andere wordt bij de slagboom geweigerd en als gate_entry_denied in de tijdlijn vastgelegd.
Rate limit: 30 requests per 60 seconden op de vier device-bucket-routes, 60 per 60 seconden op heartbeat en gate list, geteld in gedeelde Redis zodat de limiet over elke serverless instance heen standhoudt.
Levenscyclus van de sleutel: Genereren, kopiëren en opnieuw genereren onder Settings → API Credentials (for QRGoBox). Eén sleutel per organisatie; opnieuw genereren betekent dat elk apparaat dat de oude sleutel gebruikt bijgewerkt moet worden.

De objecten die uw systemen zouden uitwisselen, bestaan al

Een integratie is nooit beter dan de velden eronder, en die zitten al in het schema en zijn dagelijks in gebruik. Een boeking bevat booking_reference en external_reference voor het ID uit uw eigen systeem, booking_status, type (laden, lossen of beide), scheduled_date met een begin- en eindtijd, transport_company, driver_name en driver_phone, truck_number en trailer_number, een ladingcategorie, een afdeling, en extra_references als vrije JSON voor hoe uw locatie de dingen ook noemt. Een check-in bevat dezelfde referenties plus het toegewezen laadperron of de parkeerplaats en de volledige tijdstempelketen: checked_in_at, confirmed_at, assigned_at, started_at, completed_at. Elke statuswijziging wordt al weggeschreven naar een getypeerde tijdlijn — created, status_change, ramp_assigned, ramp_unassigned, parking_assigned, department_changed, gate_entry, gate_entry_denied, gate_exit en meer. De begrippen liggen vast en de events zijn gecatalogiseerd. Wat ontbreekt is het endpoint dat ze uitleest, en dat is precies het stuk dat we hardop benoemen.

roadmap

De API voor TMS, WMS en ERP is roadmap, geen release

Om precies te zijn: er is vandaag geen /api/v1, geen OpenAPI-specificatie, geen SDK of clientbibliotheek, geen uitgaande webhooks, en geen EDI of bestandsuitwisseling in welke vorm dan ook. Een publieke REST API voor boekingen — sleutels per organisatie, endpoints voor boekingen, slots en afdelingen, en event-webhooks — staat vastgelegd als geplande functie en is gemarkeerd als niet gestart. We plakken er geen kwartaal op, want een datum die we niet kunnen waarmaken is minder waard dan de poort die vanochtend gewoon werkt. Draait u een TMS, WMS of ERP waarmee Logistiq zou moeten praten? Laat weten welk systeem: dat antwoord bepaalt wat er als eerste gebouwd wordt.

Integratievragen, eerlijk beantwoord

Nee. De enige machine-to-machine-API in het product is de gate device API, en die bestaat om QRGOBox-slagboomhardware te authenticeren: poorten, heartbeat en validatie van check-in-codes. Hij ontsluit niets over boekingen, check-ins, laadperrons of analytics. Een publieke REST API voor boekingen is intern gespecificeerd en gemarkeerd als niet gestart. Dat zeggen we liever dan u een endpoint te verkopen dat geen antwoord geeft.

Nee, op alles. Er is geen EDIFACT, X12 of AS2, geen SFTP of file drop, geen batchfeed, en geen export van boekingen of check-ins naar Excel of CSV. De enige bestandsverwerking in het product is een mens die een .xlsx naar het Data-tabblad van één boeking sleept — een vrij opgemaakt spreadsheet dat aan dat ene record hangt. Gegevens van vervoerders komen in plaats daarvan binnen via het vervoerdersportaal.

Vervoerders voeren ze zelf in. Een transportbedrijf maakt een eigen account aan, u nodigt het één keer uit, en vanaf dat moment beheert het zijn eigen chauffeurs, trucks en trailers. De chauffeur doet de check-in via qrgo.ro of de QRGO Driver-app, in zijn eigen taal. De gegevens worden één keer ingevoerd door wie ze echt kent, en belanden nooit als spreadsheet in de inbox van een dispatcher.

Nee, zo factureren wij u. Stripe verzorgt het abonnement en SmartBill stelt de Roemeense factuur daarvoor op. Geen van beide raakt uw boekhouding, uw ERP of uw yard-gegevens, en geen van beide is beschikbaar om er iets op aan te sluiten. Zie ze als onze leveranciers, niet als koppelingen aan uw kant van het hek — dat onderscheid doet ertoe en we gaan het niet vervagen.

Alles wat u nodig heeft voor een efficient magazijn

Klaar om uw operaties te transformeren?

Sluit u aan bij honderden magazijnen die hun processen al hebben gedigitaliseerd met Logistiq.

Start nu