Passer au contenu

Rappels

Comment les horaires de rappel fonctionnent et comment lire les tentatives de rappel faites pour une créance.

État public de l'API

L'API v1 utilise les clés porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte- porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte--porte-------porte------pere-pere.

Comment les rappels sont programmés

Chaque créance active suit le calendrier de rappel de l'entreprise. La valeur par défaut envoie 3 jours avant, on et **3 jours après la date d'échéance de **; les entreprises peuvent ajouter, supprimer ou Les rappels sont envoyés dans les heures autorisées de l'entreprise (par défaut 09:00–18:00 heure locale, week-ends hors) et passer à l'heure autorisée suivante au lieu d'être envoyé deux fois.

Les rappels s'arrêtent lorsqu'une créance est payée, suspendue, contestée ou annulée, et lorsque le client s'absente.

Liste des tentatives de rappel

GET /v1/reminder-attempts retourne les tentatives de livraison pour une créance, la plus récente en premier. Il nécessite la portée receivables:read.

Paramètres de requête Requis Désignation des marchandises
receivable_id Oui La créance à inspecter.
per_page Numéro 1–100, défaut 25.
BASH
curl "https://api.remindcash.com/v1/reminder-attempts?receivable_id=1" \
  --header "Authorization: Bearer $REMINDCASH_API_KEY"
JSON
{
    "data": [],
    "meta": { "current_page": 1, "per_page": 25, "total": 0 },
    "request_id": "8cfc4494-5a40-4bd9-aa9b-5d5716840140"
}

L'objet de la tentative

Champ Désignation des marchandises
id Une tentative d'identification.
attempt_no Numéro de tentative pour cette étape de rappel.
stage_key A quelle étape de l'agenda cette tentative appartient.
channel Chaîne de messages, par exemple email.
provider_state État d'expédition interne: prepared, claimed, sending, accepted, rejected, unknown ou cancelled.
delivery_status Statut des courriels normalisés : queued, sending, accepted, delivered, bounced, failed, unknown ou cancelled. null si non disponible.
submitted_at Lorsque le message a été remis au fournisseur (UTC), ou null.
resolved_at Lorsque le résultat est devenu final (UTC), ou null.

Lire les états de livraison honnêtement

  • accepted signifie que le fournisseur a accepté le message — not qu'il a été livré ou lu.
  • delivered n'est affiché que lorsque le fournisseur déclare la livraison.
  • unknown signifie que le fournisseur n'a pas répondu clairement (par exemple, un timeout). RemindCash fait une réessayer automatiquement not dans ce cas, pour éviter d'envoyer deux fois ; la tentative reste unknown jusqu'à ce qu'elle soit réconciliée.
  • Un rappel livré ne marque jamais une créance telle qu'elle est payée.