Skip to main content

​
API Web Agence

Cette section regroupe les endpoints utilisés par le portail web des agences professionnelles : sociétés de transport disposant de plusieurs branches et employés. Ces endpoints sont consommés par le portail web agences (agency.colismove.com).

​
URL de base

https://api.colismove.com/v1/api

​
Périmètre fonctionnel

Une agence dans ColisMove est une entreprise de transport qui :
  • Possède un compte central (le propriétaire de l’agence — ROLE_AGENCY_OWNER)
  • Gère plusieurs branches (agences physiques sur différents pays / villes)
  • Emploie des agents (ROLE_AGENCY_EMPLOYEE) qui peuvent gérer les annonces de leur branche
  • Reçoit des paiements consolidés via un compte Stripe Connect dédié à l’agence
  • Effectue des retraits agrégés vers son compte bancaire

​
Audiences distinctes

Particuliers

Mobile + Web particuliers — expéditeurs / transporteurs

Web Agence

Portail web pour agences professionnelles de transport

Web SuperAdmin

Console d’administration plateforme

​
Modules API Web Agence

Mon agence

Inscription, consultation et mise à jour de l’agence

Branches

CRUD des branches et activation/désactivation

Employés

Gestion des agents (ajout, suppression, listing)

Annonces de l'agence

Liste des annonces publiées par l’agence

Finances

Portefeuille consolidé, retrait, onboarding Stripe

KYC Agence

Documents légaux (KBIS, registre du commerce, etc.)

​
Sécurité

Tous les endpoints du portail web agence requièrent :
  • Un token JWT valide (header Authorization: Bearer <token>)
  • Le rôle ROLE_AGENCY_OWNER ou ROLE_AGENCY_EMPLOYEE selon l’opération
  • Le respect du scope agence : un agent d’une branche ne peut pas voir les données d’une autre branche