API Partenaires IKtracker

Vérifie la validité de votre clé et retourne le quota restant.

{ "ok": true, "partner": "dictadevi", "quota_remaining": 99873 }

Recherche un véhicule par sa plaque d'immatriculation française. Retourne marque, modèle, CV fiscaux, motorisation.

POST https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/vehicle/lookup
x-api-key: ikt_live_xxx...
Content-Type: application/json

{ "plate": "AB-123-CD" }

{
  "success": true,
  "make": "Renault",
  "model": "Clio",
  "year": 2020,
  "fiscalPower": 5,
  "isElectric": false
}

Calcule l'indemnité kilométrique d'un trajet selon le barème officiel français (bonus 20% véhicules 100% électriques inclus).

POST https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/ik/calculate
x-api-key: ikt_live_xxx...

{
  "fiscal_power": 5,
  "is_electric": false,
  "annual_km": 12000,
  "trip_km": 45
}

{
  "success": true,
  "fiscalPower": 5,
  "bracket": "mid",
  "bracketLabel": "5 001 – 20 000 km",
  "tripIkAmount": 21.30,
  "annualIkAmount": 5679.00
}

Crée un trajet pour un utilisateur. L'IK est calculée automatiquement à partir de vehicle_id. Si vehicle_id n'est pas fourni, IKtracker assigne automatiquement le véhicule par défaut de l'utilisateur (le plus ancien) — garde-fou pour éviter les trajets orphelins. Recommandation : passez toujours vehicle_id explicitement pour un contrôle précis du barème. L'utilisateur est provisionné automatiquement au premier appel.

POST https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/trips
x-api-key: ikt_live_xxx...
x-external-user-id: user-12345

{
  "external_email": "marie@cabinet.fr",
  "date": "2026-04-23",
  "start_location": "12 rue de la Paix, 75002 Paris",
  "end_location": "Cabinet client, 92100 Boulogne",
  "distance": 12.5,
  "vehicle_id": "uuid-optionnel",
  "purpose": "RDV client",
  "round_trip": true,
  "calendar_event_id": "dictadevi-evt-99"
}

{
  "success": true,
  "trip_id": "uuid",
  "ik_amount": 7.95,
  "iktracker_user_id": "uuid"
}

Retourne les totaux de l'année en cours pour un utilisateur (km, IK, nombre de trajets, palier fiscal en cours).

GET https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/stats
x-api-key: ikt_live_xxx...
x-external-user-id: user-12345

{
  "success": true,
  "year": 2026,
  "total_km": 4521.3,
  "total_ik": 2876.45,
  "trips_count": 87,
  "current_bracket": "low",
  "bracket_label": "≤ 5 000 km"
}

Retourne les préférences d'import calendrier de l'utilisateur lié. calendar_import_mode vaut individual (chaque événement = un aller-retour depuis la Maison) ou tour(tous les rendez-vous d'une même journée sont regroupés en une tournée Maison → étapes → Maison).

GET https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/preferences
x-api-key: ikt_live_xxx...
x-external-user-id: user-12345

{
  "calendar_import_mode": "tour",
  "ik_rate_override": "auto",
  "ik_rate_override_options": ["auto", "tier1", "tier2", "tier3"],
  "default_vehicle_id": "a1b2c3d4-…",
  "has_home_address": true,
  "note": null
}

ik_rate_override fige le taux IK appliqué à chaque km (tier1 ≤ 5 000 km, tier2 5 001–20 000 km, tier3 > 20 000 km) ; auto suit le barème officiel. default_vehicle_id est le véhicule présélectionné à l'ouverture d'un nouveau trajet (null si aucun).

note: "home_address_missing" signale que le mode tour est actif mais qu'aucune adresse « Maison » n'est définie côté IKtracker : les imports retombent alors en trajets individuels tant que la Maison n'est pas renseignée.

Met à jour les préférences de l'utilisateur lié : mode d'import calendrier, taux IK forcé et/ou véhicule par défaut (un ou plusieurs champs par requête). Renvoie 409 home_address_requiredsi l'utilisateur active tour sans avoir défini d'adresse Maison, et 400 si default_vehicle_id n'appartient pas à l'utilisateur.

PUT https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/preferences
x-api-key: ikt_live_xxx...
x-external-user-id: user-12345
Content-Type: application/json

{ "calendar_import_mode": "tour", "ik_rate_override": "tier2", "default_vehicle_id": "a1b2c3d4-…" }

{
  "success": true,
  "calendar_import_mode": "tour",
  "ik_rate_override": "tier2",
  "default_vehicle_id": "a1b2c3d4-…"
}

Passer default_vehicle_id: null efface le véhicule par défaut. Le véhicule doit appartenir à l'utilisateur lié (récupérez les identifiants via GET /vehicles).

Déclenche le webhook preferences.updated si votre plateforme y est abonnée.

Liste les véhicules de l'utilisateur lié.

GET https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/vehicles
x-api-key: ikt_live_xxx...
x-external-user-id: user-12345

Met à jour un véhicule. Le paramètre update_past_trips (booléen, défaut false) contrôle la rétroactivité : si true et que fiscal_power ou is_electric change, toutes les indemnités des trajets passés liés à ce véhicule sont immédiatement recalculées avec le nouveau barème. Si false, seuls les trajets créés après la modification en bénéficient.

PATCH https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/vehicles/{vehicle_id}
x-api-key: ikt_live_xxx...
x-external-user-id: user-12345
Content-Type: application/json

{
  "fiscal_power": 6,
  "is_electric": true,
  "update_past_trips": true
}

{
  "success": true,
  "vehicle_id": "uuid",
  "changed": ["fiscal_power", "is_electric"],
  "update_past_trips": true,
  "recalculated_trips": 127
}

Déclenche le webhook vehicle.updated avec le champ recalculated_trips.

Génère une URL de connexion à usage unique (5 min) pour rediriger l'utilisateur vers son espace IKtracker, déjà authentifié.

POST https://yarjaudctshlxkatqgeb.supabase.co/functions/v1/partner-api/sso/magic-link
x-api-key: ikt_live_xxx...

{
  "external_user_id": "user-12345",
  "external_email": "marie@cabinet.fr",
  "redirect_to": "/app/mestrajets"
}

{
  "success": true,
  "sso_url": "https://iktracker.fr/sso?token=...&partner=dictadevi&redirect=/app/mestrajets",
  "expires_in": 300,
  "iktracker_user_id": "uuid"
}

Côté votre plateforme : un simple window.location.href = sso_url suffit.