> ## Documentation Index
> Fetch the complete documentation index at: https://docs.colismove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble — API Web Agence

> Référence des endpoints destinés au portail web des agences professionnelles de transport

# 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

<CardGroup cols={3}>
  <Card title="Particuliers" icon="user" href="/api-reference/overview">
    Mobile + Web particuliers — expéditeurs / transporteurs
  </Card>

  <Card title="Web Agence" icon="building" href="/api-reference/overview-web-agency">
    Portail web pour agences professionnelles de transport
  </Card>

  <Card title="Web SuperAdmin" icon="shield" href="/api-reference/overview-superadmin">
    Console d'administration plateforme
  </Card>
</CardGroup>

## Modules API Web Agence

<CardGroup cols={2}>
  <Card title="Mon agence" icon="building" href="/api-reference/agencies/get-my-agency">
    Inscription, consultation et mise à jour de l'agence
  </Card>

  <Card title="Branches" icon="sitemap" href="/api-reference/agencies/list-branches">
    CRUD des branches et activation/désactivation
  </Card>

  <Card title="Employés" icon="users" href="/api-reference/agencies/list-employees">
    Gestion des agents (ajout, suppression, listing)
  </Card>

  <Card title="Annonces de l'agence" icon="bullhorn" href="/api-reference/announcements/list-by-agency">
    Liste des annonces publiées par l'agence
  </Card>

  <Card title="Finances" icon="money-bill-transfer" href="/api-reference/agencies/get-wallet">
    Portefeuille consolidé, retrait, onboarding Stripe
  </Card>

  <Card title="KYC Agence" icon="id-card" href="/api-reference/agencies/upload-kyc-document">
    Documents légaux (KBIS, registre du commerce, etc.)
  </Card>
</CardGroup>

## 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