Programar un recordatorio interno
https://api.afer.pro/api/v1/reminders
POST https://api.afer.pro/api/v1/reminders
Un aviso para ti o para un compañero, a la hora que digas, enlazado si quieres a un documento.
Es el «Recordar a un compañero» del widget IA de los documentos de compra y venta. A su hora, el destinatario lo recibe por Slack (con mención) si la empresa lo tiene conectado, y si no por correo. Se ve y se gestiona en Tareas IA del panel.
Va a nombre de la persona de la conexión (OAuth o clave de una persona). Recordatorios para uno mismo, cualquiera; para otro compañero, solo un administrador, como en el panel.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación, a nombre de una persona: sin ella responde 401 o 403.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
asuntostringobligatorio | Qué hay que recordar, corto. |
mensajestringopcional | El detalle. |
parastringopcional | A quién: vacío para ti; un usuarioId de consultarEmpleados; o su nombre o correo (tiene que dar una sola persona). |
cuandostringopcional | YYYY-MM-DD HH:MM en hora de la empresa, YYYY-MM-DD (a las 10:00) o ahora. Por defecto, ahora. |
documentoobjectopcional | {tipo, id} o {tipo, numero}. Tipos: factura, albaran, presupuesto, pedido, factura_compra, albaran_compra, pedido_compra, recurrente. |
por_emailboolopcional | Con true, por correo aunque haya Slack. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/reminders' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"para": "Oriana",
"asunto": "Añadir la compra de Bongrup al albarán",
"mensaje": "10 sacos de sal Vacuum, albarán del proveedor 237065.",
"cuando": "2026-10-22 09:00",
"documento": {
"tipo": "albaran",
"numero": "1927"
}
}'
<?php
$data = [
'para' => 'Oriana',
'asunto' => 'Añadir la compra de Bongrup al albarán',
'mensaje' => '10 sacos de sal Vacuum, albarán del proveedor 237065.',
'cuando' => '2026-10-22 09:00',
'documento' => [
'tipo' => 'albaran',
'numero' => '1927',
],
];
$ch = curl_init('https://api.afer.pro/api/v1/reminders');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
'Content-Type: application/json',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/reminders', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"para": "Oriana",
"asunto": "Añadir la compra de Bongrup al albarán",
"mensaje": "10 sacos de sal Vacuum, albarán del proveedor 237065.",
"cuando": "2026-10-22 09:00",
"documento": {
"tipo": "albaran",
"numero": "1927"
}
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"recordatorioId": "aBc123…",
"para": "Oriana Ferrer",
"asunto": "Añadir la compra de Bongrup al albarán",
"cuando": "2026-10-22 09:00",
"documento": {
"tipo": "albaran",
"id": "dEf456…",
"numero": "ALB2026-00001927"
},
"como_llega": "Por Slack (con mención) si la empresa lo tiene conectado; si no, por correo. Se ve en Tareas IA del panel."
}
}
- Admite
X-IDEMPOTENCY-KEY: un reintento con la misma clave no programa dos. - Para verlos, consultarRecordatoriosInternos; para anular uno, anularRecordatorioInterno.