Aller au contenu

Property Payment Schedule — Management Fees

Contrôleur HTTP des frais de gestion (management fees) par échéance d'une property : consultation par période, transfert manuel à Bricks, et marquage manuel comme exécuté. Source : property-payment-schedule.management-fees.controller.ts.

Tous les endpoints requièrent une session admin BetterAuth valide (AdminAuthGuard). Les endpoints muteurs sont tracés via CreateAdminActionInterceptor.

Préfixe de routes : /administration/property.

GET /payment-schedule/management-fees/:period

Liste les frais de gestion pour un mois donné, à travers toutes les properties.

Path param

  • period — au format YYYY-MM (validé via yearMonthDate)

Response

Tableau de frais de gestion via PropertyPaymentScheduleRepository.getManagementFeesForMonth.

GET /payment-schedule/management-fees/past/not-executed

Liste les frais de gestion passés non exécutés. La période butoir d'inclusion est calculée selon le jour du mois courant et businessRules.primaryObligation.couponPayoutDayOfMonth :

  • Si le jour courant ≤ couponPayoutDayOfMonth → on ignore les fees après M-2
  • Sinon → on ignore les fees après M-1

Response

Tableau de frais de gestion impayés via PropertyPaymentScheduleRepository.getManagementFeesInPastNotExecuted.

POST /payment-schedule/management-fees/transfer-one

Déclenche le transfert P2P Lemonway des frais de gestion d'une échéance vers le compte Bricks. Trace une PROPERTY_PAYMENT_SCHEDULE_TRANSFER_ONE_MANAGEMENT_FEES.

Request body

{ "echeanceId": "uuid-v4" }

Effet

Appelle propertyPaymentScheduleManagementFeesService.transferOneManagementFees qui exécute un P2P Lemonway depuis le SPV de la property vers le compte Bricks.

Erreurs

Code Statut Cause
management-fees-must-be-not-executed 400 Frais déjà exécutés
payment-not-found 400 Échéance/paiement introuvable
Internal Server Error 500 Échec côté Lemonway (discriminant interne failed-at-provider, non exposé dans la réponse)

POST /payment-schedule/management-fees/mark-as-executed

Marque manuellement les frais de gestion d'une échéance comme exécutés (cas où le transfert a été effectué hors plateforme). Trace une PROPERTY_PAYMENT_SCHEDULE_MARK_MANAGEMENT_FEES_AS_EXECUTED.

Request body

{
  "propertyId": "uuid",
  "paymentId": "uuid-v4",
  "comment": "raison du marquage manuel"
}

paymentId correspond à l'echeanceId.

Erreurs

Code Statut Cause
management-fees-must-be-not-executed 400 Frais déjà exécutés
payment-not-found 400 Échéance/paiement introuvable

Liens