Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Programar un recordatorio interno

POST https://api.afer.pro/api/v1/reminders
Alias en castellano (v0, sigue operativo): 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.

Autenticación

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.

asuntostring
obligatorio
Qué hay que recordar, corto.
mensajestring
opcional
El detalle.
parastring
opcional
A quién: vacío para ti; un usuarioId de consultarEmpleados; o su nombre o correo (tiene que dar una sola persona).
cuandostring
opcional
YYYY-MM-DD HH:MM en hora de la empresa, YYYY-MM-DD (a las 10:00) o ahora. Por defecto, ahora.
documentoobject
opcional
{tipo, id} o {tipo, numero}. Tipos: factura, albaran, presupuesto, pedido, factura_compra, albaran_compra, pedido_compra, recurrente.
por_emailbool
opcional
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

200 · application/json
{
    "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."
    }
}
Notas