Du paiement au bordereau

Le déroulé

flowchart TD
  subgraph SY["Système"]
    a["Paiement encaissé"]
    b["Ligne de commission<br/>base nette x taux, figée"]
    c["Remboursement ou litige perdu<br/>ligne de reprise négative"]
    f["Mouvement de police<br/>création, renouvellement, avenant, annulation"]
    g["Ligne de bordereau<br/>photo à la date de l'événement"]
  end
  subgraph EQ["Équipe Inqase"]
    d["Relevé courtier<br/>brouillon, un par courtier et par mois"]
    e["Approuvé, puis payé<br/>référence de virement"]
    h["Rapport de bordereau<br/>brouillon, puis verrouillé"]
    i["Export Excel<br/>modèle maître Hiscox"]
  end
  subgraph CO["Courtier"]
    v["Relevés approuvés et payés<br/>visibles dans le portail"]
  end
  subgraph HI["Hiscox"]
    z["Fichier reçu<br/>envoyé à la main"]
  end
  x1["TROU : aucun email ni notification<br/>au courtier à l'approbation ou au paiement"]
  x2["TROU : aucun email à Hiscox<br/>le fichier part à la main"]
  a -->|enregistre| b
  a -->|rembourse| c
  b -->|regroupe par mois| d
  c -->|regroupe par mois| d
  d -->|approuve, paie| e
  e --> v
  e -.-> x1
  f -->|enregistre| g
  g -->|selon le mois de l'événement| h
  h -->|verrouille, télécharge| i
  i -->|transmet| z
  i -.-> x2
  classDef action fill:#ffe86d,stroke:#a28e26,color:#574900
  classDef status fill:#9ce6ff,stroke:#2c97bb,color:#1c4657
  classDef problem fill:#ffb575,stroke:#b8742f,color:#5a2d00
  classDef done fill:#b3e65f,stroke:#6f9a24,color:#2c4300
  classDef external fill:#e5e7eb,stroke:#9ca3af,color:#374151
  class a,f action
  class b,d,g,h status
  class c,x1,x2 problem
  class e,i,v done
  class z external

Les deux lignes du haut sont indépendantes : la commission suit l’encaissement, le bordereau suit les mouvements de police. Les deux boîtes orange sont des trous : personne n’est prévenu automatiquement.

Étapes

Un paiement encaissé crée une ligne de commission (base nette fois taux, figée) ; un remboursement ou un litige perdu ajoute une ligne de reprise négative.
Un administrateur construit les relevés du mois (bouton admin ou tâche manuelle) : un brouillon par courtier et par mois.
L’administrateur approuve le relevé (il est figé), puis le marque payé avec une référence de virement, si le cabinet a accepté sa convention.
Le courtier voit seulement les relevés approuvés et payés, dans son portail.
Chaque mouvement de police (création, renouvellement, avenant, annulation) écrit une ligne de bordereau.
L’administrateur crée le rapport du mois, le verrouille, télécharge l’export Excel et l’envoie à Hiscox, puis marque l’accusé de réception.

À valider en équipe

Les relevés ne sont pas construits automatiquement : qui les lance, et à quelle date chaque mois ?
Le courtier n’est pas prévenu quand un relevé est approuvé ou payé : faut-il un email ?
Hiscox n’a pas validé visuellement un bordereau contenant une ligne d’avenant : à confirmer avant le prochain envoi.
Le secteur d’activité est toujours vide dans l’export : quelle colonne du modèle doit l’accueillir ?
Une police signée par DocuSign ne déclenche pas sa première commission avant un rattrapage : faut-il corriger ou rattraper chaque mois ?

Règles et détails

Les règles de calcul, de gel, de reprise et la convention d’avenant sont dans Commissions et bordereau. Les emails du système sont listés dans Emails.

Où dans le code

app/Actions/Commission/RecordBrokerCommission.php
app/Services/BrokerCommissionStatementService.php
app/Services/BordereauLineService.php, app/Services/BordereauExporter.php
app/Http/Controllers/Admin/CommissionStatementsController.php, app/Http/Controllers/Admin/BordereauController.php