Documentation Koda
Ce guide présente le fonctionnement de Koda pour vos équipes, vos sites et vos transporteurs.
Démarrer
Connectez-vous avec votre e-mail et votre mot de passe. L'administrateur crée les sites, invite les collaborateurs et les transporteurs, puis charge les premières commandes.
Rôles et droits
| Profil | Peut faire |
|---|---|
| Administrateur | Configurer, gérer les accès, les connecteurs ERP, les secrets et l'historique d'e-mails |
| Employé | Créer et suivre les transports, lancer une synchronisation ERP manuelle |
| Transporteur | Répondre aux appels d'offres, échanger des messages, déposer les preuves de livraison |
Modules
Transports (expéditions, réceptions, multi-arrêts, récurrents), quais, transporteurs et sites, appels d'offres, messagerie, documents, carte, affichage TV et application mobile (PWA).
Intégration ERP
Connecteurs SAP, JDE, CSV et REST. Les secrets sont stockés en écriture seule. Pour pousser des commandes :
POST /api/erp/{espace}/{connecteur}
Authorization: Bearer koda_erp_xxx
Content-Type: application/json5 000 lignes maximum par envoi, au format JSON ou CSV.
API et webhooks
Lecture des données pour votre reporting :
GET /api/v1/{espace}/{ressource}?format=csv
Authorization: Bearer koda_live_xxxLes webhooks sont signés en HMAC-SHA256 (en-têtes X-Koda-Signature et X-Koda-Event) et n'acceptent que des URL https publiques.
Notifications
E-mails automatiques pour les nouvelles offres, les ramassages du lendemain et les preuves de livraison manquantes, dans la langue du destinataire (8 langues). Aucune relance n'est répétée avant 24 h.
Koda Green
Dans le formulaire d'une expédition, choisissez la motorisation demandée : thermique (standard), faibles émissions (HVO100, bioGNV / bioGNL, B100) ou zéro émission (électrique, hydrogène), en « préférée » ou « exigée ». Options : énergie précise, prime verte acceptée (%), ramasse flexible ± 1 jour, livraison en zone à faibles émissions, contribution carbone. Le transporteur déclare l'énergie de son camion avec son offre (appel d'offres ou marché spot) ; une exigence « exigée » refuse les offres d'une classe inférieure.
| Indicateur | Calcul |
|---|---|
| CO₂e d'un transport | distance × facteur de l'énergie (kg CO₂e/km, du puits à la roue) |
| Koda Green Score | 60 % CO₂e par km comparé au diesel (900 g/km) + 25 % taux de remplissage + 15 % km zéro émission. A ≥ 70, B ≥ 50, C ≥ 35, D ≥ 20, E < 20 |
| CO₂e évité | CO₂e si tout avait roulé au diesel − CO₂e réel |
Menu Koda Green : report par période, export CSV, impression PDF, recommandations. Koda Green Advisory (conseil, option payante) se demande depuis ce menu ou Abonnement.
Rapport scellé et vérifiable. Bloc Rapports scellés et vérifiables (administrateur ou logistique) : choisissez une période terminée ; le serveur calcule le rapport avec les mêmes règles, le fige et le scelle (SHA-256). Il contient chaque transport (référence, date, ville, km, poids, énergie, facteur, CO₂e), la méthode et les facteurs, sans nom de client, adresse ni chauffeur. Le lien /green-report permet à quiconque de vérifier qu'il n'a pas été modifié. Le rapport du mois précédent peut être envoyé automatiquement chaque mois. La certification est délivrée par un vérificateur indépendant accrédité : son attestation s'enregistre sur le rapport et s'affiche à côté du sceau.
Flotte, tournées et groupage
Pour les transporteurs, gratuit. Ma flotte : véhicules ajoutés un par un ou importés d'un fichier (CSV, Excel), avec immatriculation, énergie, capacité, chauffeur, kilométrage et échéances (assurance, contrôle technique, chronotachygraphe, révision). Affecter un transport à un véhicule écrit l'immatriculation, le chauffeur et l'énergie sur le transport du chargeur. Tournées : transports du jour par véhicule, ordre de passage, taux de remplissage ; groupage : chargements du marché Spot et demandes de prix qui tiennent sur la route (même jour, place à bord, petit détour), avec les kilomètres et le CO₂e évités. Koda Green du transporteur : CO₂e par véhicule, part de kilomètres faibles ou zéro émission, export CSV.
Carnet d'adresses
Clients et fournisseurs de l'entreprise, visibles des administrateurs et responsables logistiques, dans leurs sites. Import CSV ou Excel (colonnes françaises, anglaises, allemandes ou SAP), ou poussée depuis l'ERP : POST /api/erp/{espace}/{connecteur}/customers. Dans un transport, tapez un nom ou un code client : adresse, contact, horaires et consignes se remplissent. Sinon, cochez « Enregistrer ce client pour les prochaines livraisons ». Chaque adresse affiche ses transports, sa ponctualité, ses kilomètres et son CO₂e.
Terrain et factures
Suivi GPS. Pour chaque transport, le chauffeur choisit : suivi en temps réel, déclaration ponctuelle de sa position ou aucun partage. Il est informé à chaque choix, un bandeau reste visible pendant le partage, il déclare ses pauses (plus rien n'est envoyé) et peut effacer ses positions. Le partage s'arrête à la livraison. La page doit rester ouverte en temps réel.
Suivi avancé (gratuit). Panneau Suivi d'un transport : heure d'arrivée estimée à partir de la dernière position partagée par le chauffeur, livraison prévue saisie par le chargeur et alerte par e-mail en cas de retard probable (plus de 30 minutes), lien de suivi pour votre client final (statut, étapes et heure d'arrivée, jamais la position du camion, la plaque ni le chauffeur).
eCMR. Onglet eCMR d'un transport attribué : créez la lettre, complétez les cases, faites signer l'expéditeur, le transporteur puis le destinataire, avec réserves. Le contenu est figé et scellé ; la page de vérification s'imprime avec un QR code. Vérifiez que l'eCMR est acceptée dans vos pays : ce n'est pas une signature qualifiée eIDAS.
Messagerie. Une conversation par transport entre chargeur et transporteur (onglet Messages, menu Communications).
Koda IA (abonnement, documents illimités). Onglet Koda IA d'un transport. Factures : l'IA lit la facture et Koda la compare au prix convenu et aux déclarations du camion (suppléments, TVA, doublons). Documents de livraison : l'IA lit la CMR signée, la preuve ou le bon de livraison, vérifie la signature du destinataire et les quantités, recopie les réserves et conseille une réclamation en cas de dommage ou de manquant. L'IA donne un avis : vous validez, contestez ou réclamez.
Marché spot et abonnements
Marché spot. Sur un transport sortant sans transporteur, « Envoyer au marché spot » le propose à tous les transporteurs vérifiés (offre ou réservation immédiate au prix affiché ; client et adresse révélés au seul gagnant). Gratuit pour les transporteurs. Pour le chargeur : 10 transports attribués gratuits par mois ; le suivant déclenche automatiquement l'abonnement Spot du mois (illimité jusqu'à la fin du mois), avec un e-mail d'information. Rien n'est jamais bloqué.
Abonnement. L'écran Abonnement affiche votre formule, le compteur Spot du mois et Koda IA. La demande de Koda IA peut inclure un code promo ; Koda confirme le prix et active l'abonnement.
Newsletter et RSS. Actualités et flux RSS.