Fonctionnalites
Intégrations de Systèmes & API
Aujourd'hui, Logistiq propose une seule surface machine — l'API des équipements de portail, protégée par clé et limitée en débit — ainsi qu'un portail transporteurs en libre-service qui fait entrer les données sans échange de fichiers ; l'API destinée aux systèmes TMS, WMS et ERP est à la feuille de route, et cette page l'indique comme telle plutôt que de l'enjoliver.
Une seule API machine aujourd'hui, une API partenaires à la feuille de route
Aujourd'hui, Logistiq propose une seule surface machine — l'API des équipements de portail, protégée par clé et limitée en débit — ainsi qu'un portail transporteurs en libre-service qui fait entrer les données sans échange de fichiers ; l'API destinée aux systèmes TMS, WMS et ERP est à la feuille de route, et cette page l'indique comme telle plutôt que de l'enjoliver.
La plupart des données de cour arrivent encore par e-mail, par téléphone et par ressaisie
Le poste de garde fonctionne avec une liste imprimée et un coup de fil au bureau. Le transporteur envoie la veille un tableur des arrivées, un dispatcheur le ressaisit dans une réservation, et le numéro de plaque est encore corrigé deux fois à la barrière. Rien de tout cela n'est un problème technologique — c'est un problème de saisie, répété chaque matin, payé en heures de dispatcheur et en camions au ralenti.
Logistiq s'attaque à la saisie à la source plutôt que de câbler vos systèmes entre eux. Les transporteurs s'inscrivent dans leur propre portail et y tiennent à jour eux-mêmes leurs sociétés, chauffeurs, camions et remorques : la donnée est saisie une fois, par celui qui la connaît vraiment. Les chauffeurs déposent le check-in depuis qrgo.ro ou l'application QRGO Driver. Les réservations disposent d'un champ external_reference conçu pour accueillir l'identifiant d'expédition de votre propre système : les deux enregistrements restent aujourd'hui rapprochables à l'œil — et lisibles par machine le jour où une API existera pour les exposer. Et le portail est déjà en machine-à-machine : un boîtier QRGOBox appelle l'API avec une clé propre à l'organisation, et la barrière se lève sur un code de check-in valide.
Sans Logistiq
- Le transporteur envoie les arrivées du lendemain dans un tableur
- Un dispatcheur ressaisit à la main chauffeur, camion et remorque
- Le poste de garde téléphone au bureau pour confirmer qu'un camion est attendu
- Votre identifiant d'expédition vit sur papier, loin de l'enregistrement de la cour
Avec Logistiq aujourd'hui
- Les transporteurs s'inscrivent seuls et gèrent leurs chauffeurs, camions et remorques
- Le chauffeur dépose le check-in depuis qrgo.ro ou l'application QRGO Driver
- Un boîtier QRGOBox valide le code de check-in via l'API et ouvre la barrière
- bookings.external_reference porte l'identifiant d'expédition de votre système
La seule surface machine en production : l'API des équipements de portail
Six endpoints sur logistiq.cloud, authentifiés par une clé unique par organisation. Il s'agit de l'authentification des équipements pour le matériel de barrière QRGOBox — elle expose les portails, le heartbeat et la validation du code de check-in, et rien sur les réservations, les check-in, les rampes ou l'analytique.
- Endpoints en production
- 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
- Authentification
- Une clé par organisation, au format org_ suivi de 32 caractères hexadécimaux. Transmise dans l'en-tête X-API-Key sur /api/device/gates, comme api_key dans le corps JSON sur les routes POST, et en paramètre de requête ?api_key= sur GET /api/gate/list.
- L'appel du portail
- POST /api/gate/validate avec { gate_id, api_key, checkin_code }. La clé elle-même résout le tenant — aucun identifiant d'organisation n'est envoyé, et une clé ne peut jamais voir que son propre entrepôt.
- Ouvre pour
- Les check-in en statut confirmed, assigned ou in_progress. Tout le reste est refusé à la barrière et inscrit dans la chronologie comme gate_entry_denied.
- Limite de débit
- 30 requêtes par 60 secondes sur les quatre routes du bucket device, 60 par 60 secondes sur le heartbeat et la liste des portails, comptées dans un Redis partagé afin que la limite tienne sur chaque instance serverless.
- Cycle de vie de la clé
- Génération, copie et régénération dans Paramètres → Identifiants API (pour QRGoBox). Une clé par organisation ; la régénérer implique de mettre à jour chaque équipement qui utilise l'ancienne.
Les objets que vos systèmes échangeraient existent déjà
Une intégration ne vaut jamais mieux que les champs qui la portent, et ceux-ci sont déjà dans le schéma et utilisés au quotidien. Une réservation porte booking_reference et external_reference pour l'identifiant de votre propre système, booking_status, type (chargement, déchargement ou les deux), scheduled_date avec une heure de début et de fin, transport_company, driver_name et driver_phone, truck_number et trailer_number, une catégorie de marchandise, un département, et extra_references en JSON libre pour tout ce que votre site nomme à sa façon. Un check-in porte les mêmes références, plus la rampe ou la place de parking attribuée et toute la chaîne d'horodatages : checked_in_at, confirmed_at, assigned_at, started_at, completed_at. Chaque changement d'état est déjà écrit dans une chronologie typée — created, status_change, ramp_assigned, ramp_unassigned, parking_assigned, department_changed, gate_entry, gate_entry_denied, gate_exit et d'autres. Les noms sont arrêtés et les événements catalogués. Ce qui manque, c'est l'endpoint qui les expose, et c'est précisément la partie que nous disons à voix haute.
roadmap
L'API TMS, WMS et ERP est à la feuille de route, pas en production
Pour être précis : il n'existe aujourd'hui aucun /api/v1, aucune spécification OpenAPI, aucun SDK ni bibliothèque client, aucun webhook sortant, et aucun EDI ni échange de fichiers d'aucune sorte. Une API REST publique pour les réservations — clés par organisation, endpoints pour les réservations, les créneaux et les départements, et webhooks d'événements — est consignée comme fonctionnalité planifiée et marquée non démarrée. Nous n'y mettons pas de trimestre, parce qu'une date que nous ne pouvons pas tenir vaut moins que le portail qui fonctionne ce matin. Si vous exploitez un TMS, un WMS ou un ERP avec lequel vous voulez que Logistiq dialogue, dites-nous lequel : c'est cette réponse qui décidera de ce qui sera construit en premier.
Questions d'intégration, réponses sans détour
Non. La seule API machine-à-machine du produit est l'API des équipements de portail, et elle existe pour authentifier le matériel de barrière QRGOBox : portails, heartbeat et validation du code de check-in. Elle n'expose rien sur les réservations, les check-in, les rampes ou l'analytique. Une API REST publique pour les réservations est spécifiée en interne et marquée non démarrée. Nous préférons le dire plutôt que de vous vendre un endpoint qui ne répond pas.
Non, à tout cela. Pas d'EDIFACT, X12 ni AS2, pas de SFTP ni de dépôt de fichiers, pas de flux par lots, et aucun export des réservations ou des check-in vers Excel ou CSV. Le seul traitement de fichier dans le produit, c'est une personne qui glisse un .xlsx dans l'onglet Data d'une réservation — un tableur libre attaché à cet unique enregistrement. Les données transporteur entrent par le portail transporteurs à la place.
Ce sont les transporteurs qui les saisissent. Une société de transport crée son propre compte, vous l'invitez une fois, et elle gère ensuite ses chauffeurs, camions et remorques. Le chauffeur dépose le check-in depuis qrgo.ro ou l'application QRGO Driver, dans sa propre langue. La donnée est saisie une fois par celui qui la connaît vraiment, et n'atterrit jamais sous forme de tableur dans la boîte mail d'un dispatcheur.
Non, c'est ainsi que nous vous facturons. Stripe gère l'abonnement et SmartBill émet la facture roumaine correspondante. Ni l'un ni l'autre ne touche à votre comptabilité, à votre ERP ou à vos données de cour, et aucun des deux n'est exposé pour que vous y branchiez quoi que ce soit. Voyez-les comme nos prestataires, pas comme des connecteurs de votre côté de la barrière — la distinction compte et nous n'allons pas l'estomper.
Tout ce dont vous avez besoin pour un entrepot efficace
Check-in numérique
À l'arrivée, le chauffeur scanne le code QR ou accède à l'entrepôt dans l'application QRGO Driver. Remplit les données et reçoit une confirmation. Sans papier, sans files d'attente.
Gestion des quais
Les opérateurs attribuent, libèrent et optimisent le flux de camions depuis un seul tableau de bord.
Chat & notifications en temps reel
Chat instantané entre opérateur et chauffeur, notifications push sur téléphone et options SMS. Communication claire, quelle que soit la plateforme utilisée par le chauffeur.
Pret a transformer vos operations?
Rejoignez des centaines d'entrepots qui ont deja digitalise leurs processus avec Logistiq.