Skip to content
RemindCash

Recordadores

Cómo funcionan los calendarios de recordatorios y cómo leer los intentos de recordatorio hechos para un crédito por cobrar.

Situación de la API pública

La API v1 utiliza las teclas de portador con un sistema operativo y requiere un período de plan activo. Los puntos finales de facturación y borrado no envían mensajes de clientes. Ejemplos usan los marcadores de posición — nunca pegan una clave real en código compartido.

Cómo se programan los recordatorios

Cada crédito activo sigue el horario de recordatorio de la empresa. El valor predeterminado envía 3 días antes de, on y 3 días después de la fecha prevista; las empresas pueden añadir, eliminar o Los recordatorios se envían dentro de las horas permitidas de la compañía (por defecto 09:00–18:00 hora local, fines de semana apagado) y se mueven al siguiente tiempo permitido en lugar de ser enviados dos veces.

Los recordatorios se detienen cuando un crédito se paga, se pausa, se disputa o se cancela, y cuando el cliente opta por ello.

Lista de intentos de recordatorio

GET /v1/reminder-attempts devuelve los intentos de entrega de un crédito, el más reciente primero. Requiere el alcance receivables:read.

Parámetro de consultas Necesidades Descripción
receivable_id Sí. El crédito para inspeccionar.
per_page No. 1–100, por defecto 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"
}

El objeto de intento

Campo Descripción
id Intento de identificación.
attempt_no Intento de número para ese paso del recordatorio.
stage_key A qué paso de la agenda pertenece este intento.
channel Canal de mensaje, por ejemplo email.
provider_state Estado de despacho interno: prepared, claimed, sending, accepted, rejected, unknown o cancelled.
delivery_status Estado de correo electrónico normalizado: queued, sending, accepted, delivered, bounced, failed, unknown o cancelled. null cuando no esté disponible.
submitted_at Cuando el mensaje fue entregado al proveedor (UTC), o null.
resolved_at Cuando el resultado se convirtió en final (UTC), o null.

Leyendo los estados de entrega honestamente

  • accepted significa que el proveedor aceptó el mensaje — not que fue entregado o leído.
  • delivered se muestra sólo cuando el proveedor informa de la entrega.
  • unknown significa que el proveedor no respondió claramente (por ejemplo un tiempo de salida). RemindCash hace not retry automáticamente en ese caso, para evitar el envío dos veces; el intento permanece unknown hasta que se reconcilia.
  • Un recordatorio entregado nunca marca un crédito pagado.