Après l'émission

Le déroulé

flowchart TD
  subgraph systeme["Système"]
    p["Police active"]:::status
    i1["Stripe encaisse chaque échéance"]:::external
    r0["Demande de déclaration de renouvellement<br/>30 jours avant la fin<br/>tâche non planifiée, lancée à la main"]:::problem
    r1["Tâche de renouvellement<br/>à la fin de la période, non planifiée"]:::problem
    n["Nouvelle période d'un an, prime recalculée<br/>sans déclaration validée : valeurs reportées et alerte Slack"]:::status
    x1["Prix Stripe non mis à jour<br/>l'ancien montant continue d'être facturé"]:::problem
    x2["Annulation : seulement après un litige perdu<br/>aucun bouton d'annulation"]:::problem
  end
  subgraph equipe["Équipe Inqase"]
    e1["Avenant<br/>déclare le nouveau chiffre d'affaires et la date d'effet"]:::action
    e2["Prime recalculée au prorata<br/>écart positif prélevé, négatif remboursé"]:::action
    v["Valide ou corrige la déclaration"]:::action
  end
  subgraph client["Client"]
    m1["EMAIL : Paiement réussi<br/>À : contacts de la police<br/>Type : transactionnel, échéances après la première"]:::email
    m2["EMAIL : Avenant enregistré<br/>À : contact de l'offre<br/>Type : transactionnel"]:::email
    m3["EMAIL : Déclaration de renouvellement à remplir<br/>À : utilisateur client<br/>Type : relance, lien de connexion jusqu'à la fin du terme"]:::email
    d["Déclare son chiffre d'affaires<br/>ou le courtier ou l'équipe à sa place"]:::action
    m5["EMAIL : Police renouvelée<br/>À : contact de l'offre<br/>Type : transactionnel"]:::email
  end
  subgraph courtier["Courtier"]
    m4["PORTAIL : Déclaration reçue<br/>À : utilisateurs du cabinet<br/>Type : notification portail, si le client déclare lui-même"]:::email
  end
  p -->|chaque échéance| i1
  i1 -->|paiement enregistré| m1
  p -->|changement de situation| e1
  e1 --> e2
  e2 -->|envoie après l'avenant| m2
  p -->|30 jours avant la fin| r0
  r0 -->|envoie le lien| m3
  m3 --> d
  d -->|prévient, alerte Slack| m4
  d --> v
  v --> r1
  p -->|fin de période atteinte| r1
  r1 --> n
  n -->|envoie au renouvellement| m5
  n -.-> x1
  p -.-> 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 email fill:#b8acfb,stroke:#8a7be0,color:#231266
  classDef external fill:#e5e7eb,stroke:#9ca3af,color:#374151

Trois branches partent de la police active : les échéances, les avenants et le renouvellement, dont les deux déclencheurs en orange ne sont pas planifiés.

Étapes

Chaque échéance suivante est encaissée par Stripe : les contacts de la police reçoivent un email de paiement réussi.
Avenant : l’équipe saisit le nouveau chiffre d’affaires et la date d’effet. La prime est recalculée au prorata, l’écart positif est prélevé sur le moyen de paiement, l’écart négatif est remboursé, et le contact de l’offre reçoit un email.
Renouvellement, demande : 30 jours avant la fin, le client reçoit un lien pour déclarer son chiffre d’affaires. Le client, le courtier ou l’équipe déclare, puis l’équipe valide ou corrige.
Renouvellement, traitement : à la fin de la période, une nouvelle période d’un an démarre avec la prime recalculée, et le contact de l’offre reçoit un email.

À valider en équipe

Les deux tâches de renouvellement ne sont pas planifiées : qui les lance, quand les planifie-t-on ?
Le prix Stripe n’est pas mis à jour au renouvellement : l’abonnement facture l’ancien montant. La validation de l’assureur est-elle attendue avant de planifier ?
Sans déclaration validée, le renouvellement reporte les valeurs précédentes avec une alerte Slack seulement. Le courtier est-il informé ? Sans utilisateur client, la demande n’est pas envoyée et rien ne le signale hormis les journaux.
L’ancien schéma prévoyait une annulation par l’équipe ou le courtier : le code n’en offre aucune, seul un litige perdu annule. Est-ce voulu ?
L’avenant est créé par l’équipe seule et seul le contact de l’offre est prévenu, pas le courtier. Le courtier doit-il l’être ? Même question pour le renouvellement.

Règles et détails

Avenants, prélèvements et remboursements : Échecs, avenants et remboursements. Périodes, déclarations tardives et renouvellement : Polices et renouvellements. Lignes de bordereau : Commissions et bordereau.

Où dans le code

app/Services/EndorsementService.php, RenewalService.php, RenewalDeclarationService.php
app/Console/Commands/RequestRenewalDeclarations.php, ProcessDueRenewals.php
app/Listeners/SendPaymentNotification.php, SendPolicyEndorsedNotification.php, SendPolicyRenewedNotification.php
routes/console.php