Guides

Avoirs

Guide complet pour créer des avoirs (remboursements) avec FNE Client

Avoirs

Ce guide vous montre comment créer des avoirs (remboursements) pour vos factures certifiées avec FNE Client.

Vue d'ensemble

Un avoir est un document qui annule ou réduit le montant d'une facture précédemment certifiée. Pour créer un avoir, vous devez avoir l'UUID de la facture originale et les UUIDs des items à rembourser.

Important : Sauvegarder les UUIDs
Pour créer un avoir, vous devez avoir sauvegardé :
  • UUID de la facture (invoice.id) de la facture originale
  • UUIDs des items (item.id) des articles à rembourser
Ces UUIDs sont retournés dans la réponse lors de la certification de la facture originale.

Exemple de sauvegarde

Créer un avoir complet

Un avoir complet rembourse toute la facture :

Créer un avoir partiel

Un avoir partiel rembourse seulement certains items ou une quantité partielle :

Structure de la réponse

La réponse d'un avoir a une structure différente de celle d'une facture :

Vérifier si c'est un avoir

Intégration avec modèles

Utilisez le trait CertifiableRefund :

Gestion des erreurs

Bonnes pratiques

  1. Sauvegardez toujours les UUIDs : Lors de la certification d'une facture, sauvegardez toujours l'UUID de la facture et des items
  2. Vérifiez les quantités : Assurez-vous que la quantité remboursée ne dépasse pas la quantité originale
  3. Gérez les avoirs partiels : Vous pouvez créer plusieurs avoirs pour une même facture
  4. Stockez les références : Sauvegardez la référence de l'avoir (commence par "A") pour traçabilité

Exemple complet

Prochaines étapes

Besoin d'aide ? Consultez la documentation complète ou ouvrez une issue sur GitHub.