Requis : plugin Charitable Pro 1.8.16+
Plan Pro et supérieur

Avez-vous besoin de savoir quels donateurs ont gagné une récompense et ce qui doit encore être envoyé ? Chaque fois qu'un donateur gagne une récompense, Charitable Rewards crée une réclamation, qui enregistre qui a gagné quoi, sur quelle donation, et ce qui doit encore se passer.

Ce guide couvre l'onglet Réclamations, la signification de chaque statut de réclamation, comment traiter les réclamations une par une ou en masse, et les e-mails que les donateurs reçoivent en cours de route.

Avec une seule liste pour tout ce que vous devez, rien de ce qu'un donateur a gagné n'est oublié.

Charitable Rewards nécessite la version 1.8.16 ou supérieure du plugin Charitable Pro, sur le plan Pro et supérieur.

Ce que contient ce guide ?

Regarder la vidéo

Si vous préférez regarder plutôt que lire, cette vidéo montre une réclamation passant de confirmée à traitée.

Où trouver vos réclamations

Pour voir vos réclamations, rendez-vous sur Charitable » Récompenses » Réclamations.

Les 2 façons dont une réclamation se produit

La colonne Méthode vous indique comment le donateur a gagné chaque récompense.

Méthode	Signification
Déblocage par seuil	Le montant du donateur a dépassé le montant d'une récompense en mode automatique. Il n'a pas choisi la récompense
Sélectionné	Le donateur l'a choisi exprès, en choisissant un niveau de don

Cela aide lorsqu'un donateur demande pourquoi il a reçu quelque chose. Un déblocage par seuil s'est produit automatiquement.

Statuts des réclamations

Chaque réclamation a 1 des 6 statuts, et chaque statut vous indique si vous devez faire quelque chose.

Statut	Signification	Ce que vous faites
Réservé	La récompense est détenue pendant que le don est encore en cours de traitement	Rien. Cela se résout tout seul
Confirmé	Le don a été effectué et la récompense est due	Accomplissez-la, si elle doit être accomplie
Accompli	La récompense a été livrée ou envoyée	Rien. C'est fait
À examiner	Quelque chose nécessite une décision humaine	Examinez-le et résolvez-le
Révoqué	Vous avez annulé la demande	Rien
Remboursé	Le don a été remboursé	Décidez s'il faut récupérer l'article

Une récompense de reconnaissance passe de confirmée à complète sans que vous n'interveniez, car il n'y a rien à expédier. Les récompenses physiques sont celles qui s'accumulent dans la liste.

Traitement d'une réclamation

Lorsque vous ouvrez une demande, vous verrez le donateur, la récompense, le don d'origine et l'adresse de livraison s'il y en a une. Vous verrez également une action « Marquer comme accompli ».

Pour tout ce que vous avez expédié, enregistrez le transporteur et le numéro de suivi en même temps. Les récompenses les transforment en un lien de suivi sur la demande et les ajoutent à l'e-mail « récompense expédiée », afin que le donateur reçoive les détails sans que vous n'ayez à écrire de message.

La liste des transporteurs comprend par défaut USPS, UPS, FedEx, DHL et Autre. Un développeur peut ajouter d'autres transporteurs avec un filtre.

Traitement en masse

Pour accomplir plusieurs demandes à la fois, sélectionnez-les et appliquez « Marquer comme accompli » à toutes. C'est l'outil idéal après une séance d'emballage où vous avez expédié 30 sacs fourre-tout.

Remarque : L'accomplissement en masse ne demande pas de numéros de suivi. Lorsque le suivi est important, accomplissez chaque demande individuellement à la place.

Notes et journal d'activité

Chaque demande conserve un journal d'activité des changements de statut, des accomplissements, des e-mails envoyés et de toutes les notes que vous ajoutez vous-même. Les entrées système sont marquées, vous pouvez donc distinguer les événements automatiques des changements effectués par une personne.

Ajoutez une note chaque fois que quelque chose nécessitera une explication plus tard. « Le donateur nous a demandé de retarder l'expédition jusqu'en juin » peut éviter une conversation confuse 3 mois plus tard.

Filtrage, recherche et exportation

Vous pouvez filtrer la liste par statut, récompense, campagne et plage de dates, et la rechercher par donateur. Tout ce qui est affiché peut être exporté en CSV, y compris les colonnes fiscales lorsque la réception fiscale est activée.

L'exportation crée une liste d'emballage pratique. Filtrez les demandes physiques confirmées et exportez-les, et vous aurez les noms et adresses dans une feuille de calcul.

Ce que les donateurs reçoivent par e-mail

Les récompenses sont accompagnées de 3 e-mails, et vous pouvez modifier chacun d'eux dans les paramètres d'e-mail de Charitable.

E-mail	Envoyé quand	Remarques
Confirmation de récompense	Une réclamation est confirmée	Activé par récompense, pour que vous puissiez rester discret sur les avantages de reconnaissance
Livraison numérique de la récompense	Une récompense numérique est réclamée	Contient le lien de téléchargement protégé
Récompense expédiée	Vous marquez une réclamation physique comme satisfaite avec suivi	Inclut le transporteur et le numéro de suivi

Dons récurrents

Une récompense sur un don récurrent doit savoir ce que signifie un renouvellement. Chaque récompense a son propre paramètre pour cela.

Comportement	À chaque renouvellement
Satisfaire une fois (par défaut)	Rien de nouveau ne se passe. Le donateur conserve ce qu'il a obtenu
Réclamer à chaque renouvellement	Une nouvelle réclamation est créée

« Satisfaire une fois » convient à un objet unique comme une affiche dédicacée. « Réclamer à chaque renouvellement » convient à quelque chose qui se répète vraiment, comme un magazine trimestriel.

Important : Faites attention avec « Réclamer à chaque renouvellement » pour une récompense physique avec une limite de stock. Une année de renouvellements mensuels signifie 12 réclamations sur votre stock.

Conseils à garder à l'esprit

Ces habitudes maintiennent votre liste de réclamations courte et vos donateurs informés.

• Filtrez la liste sur Confirmé et le type physique. C'est votre vraie liste de tâches.
• Enregistrez les numéros de suivi au fur et à mesure plutôt qu'après. L'e-mail d'expédition ne les inclut que s'ils sont présents lorsque vous marquez la réclamation comme satisfaite.
• Si une réclamation est dans À vérifier, résolvez-la plutôt que de la laisser. Le tableau de bord Aperçu la compte comme nécessitant une attention et vous le rappellera.
• Avant une session d'emballage, exportez la liste filtrée. C'est plus facile qu'en travaillant depuis l'écran.

Référence développeur

Actions

Action	S'exécute quand
charitable_rewards_claim_confirmed	Une réclamation passe à confirmé
charitable_rewards_claim_fulfilled	Une réclamation est marquée comme satisfaite
charitable_rewards_claim_revoked	Une réclamation est révoquée

Ce sont les points d'intégration pour synchroniser les réclamations avec un service de traitement ou votre CRM.

Filtres

Filtre	Défaut	Objectif
charitable_rewards_carriers	La Poste, UPS, FedEx, DHL, Autre	La liste des transporteurs proposée lors de l'enregistrement du suivi
charitable_rewards_backers_statuses	confirmé, réalisé	Quels statuts comptent pour les totaux de réclamations publiques
charitable_rewards_log_renewal_to_donor	défaut du plugin	Si une réclamation de renouvellement est enregistrée auprès du donateur
charitable_email_reward_confirmation_recipient	le donateur	À qui l'e-mail de confirmation est envoyé
charitable_email_reward_shipped_recipient	le donateur	À qui l'e-mail d'expédition est envoyé
charitable_email_reward_digital_delivery_recipient	le donateur	À qui l'e-mail de livraison est envoyé

Chacun des 3 e-mails expose également les filtres _default_subject, _default_headline et _default_body sous le même préfixe.

Objet de valeur de réclamation

Charitable_Rewards_Claim expose les statuts sous forme de constantes, qui sont STATUS_RESERVED, STATUS_CONFIRMED, STATUS_FULFILLED, STATUS_REVOKED, STATUS_REFUNDED et STATUS_NEEDS_REVIEW. Les types de réclamations sont TYPE_SELECTED et TYPE_THRESHOLD.

Chaque réclamation porte une idempotency_key, de sorte que le même couple don et récompense ne peut pas produire de réclamations dupliquées si un webhook de paiement arrive deux fois.

Stockage de suivi

Le transporteur et le numéro de suivi sont stockés comme métadonnées de don par récompense, plutôt que sur la ligne de réclamation, via Charitable_Rewards_Tracking::save(). Lisez-les avec parts_for_donation_reward().

Capacités

Travailler sur la liste des réclamations nécessite charitable_fulfill_rewards. Voir les noms et adresses des donateurs nécessite charitable_view_reward_pii. Voir Permissions.

Exemples de personnalisation

Envoyer les réclamations réalisées à un service externe.

add_action( 'charitable_rewards_claim_fulfilled', function ( $claim_id ) {
    // Send $claim_id to your warehouse API.
} );

Ajouter un transporteur régional.

add_filter( 'charitable_rewards_carriers', function ( $carriers ) {
    $carriers['canada-post'] = __( 'Canada Post', 'your-textdomain' );
    return $carriers;
} );

Compter uniquement les réclamations réalisées dans les totaux de réclamations publiques.

add_filter( 'charitable_rewards_backers_statuses', function () {
    return array( 'fulfilled' );
} );

En résumé

Vous savez maintenant comment lire chaque statut de réclamation, réaliser des réclamations une par une ou en masse, et exporter une liste d'emballage.

Ensuite, vous pouvez vérifier comment les récompenses numériques et physiques parviennent à vos donateurs. Si vous êtes bloqué à une étape, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ces guides couvrent ce qui se passe avant et après la création d'une réclamation.

• Livraison des récompenses. Découvrez comment les fichiers numériques et les articles physiques parviennent aux donateurs.
• Création des récompenses. Apprenez-en davantage sur les limites de stock et la réserve de maintien derrière les réclamations réservées.
• Rapports. Utilisez le tableau de bord qui montre ce qui nécessite votre attention.
• Reçus fiscaux et juste valeur marchande. Comprenez les colonnes fiscales dans l'exportation des réclamations.