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

Enviar un documento por correo

POST https://api.afer.pro/api/v1/documents/send
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/api/v1/documents/send

El botón «Enviar» del panel: una factura, presupuesto, albarán o pedido, con su PDF, desde el correo de la empresa.

Envía un documento de venta con su PDF adjunto, desde el correo de la empresa (la cuenta genérica o el de quien envía, como esté configurado) y por su servidor de correo. Por defecto va al correo del cliente del documento, con el asunto y el texto de siempre. Después, el documento queda marcado como enviado y el envío queda en su historial.

En dos pasos. Sin confirmar, no envía nada: devuelve se_enviaria con el destinatario, el asunto, el texto y el adjunto. Con confirmar: true, lo envía. Pensado para asistentes: primero se enseña, luego se envía.

No se envían borradores sin número ni documentos de compra. El mismo documento a la misma dirección no se repite si se acaba de enviar.

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.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

documentoobject
obligatorio
{tipo, id} o {tipo, numero}. Tipos: factura, presupuesto, albaran, pedido.
parastring
opcional
Correo de destino. Por defecto, el del cliente.
asuntostring
opcional
Por defecto Su Factura: NÚMERO · obra.
mensajestring
opcional
El texto. Por defecto el de siempre, con la firma de la empresa.
confirmarbool
opcional
Con true, envía. Sin él, solo devuelve lo que se enviaría.

Ejemplo de petición

curl -X POST 'https://api.afer.pro/api/v1/documents/send' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "documento": {
        "tipo": "factura",
        "numero": "2026-0412"
    },
    "confirmar": true
}'
<?php

$data = [
  'documento' => [
    'tipo' => 'factura',
    'numero' => '2026-0412',
  ],
  'confirmar' => true,
];

$ch = curl_init('https://api.afer.pro/api/v1/documents/send');
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/documents/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  },
  body: JSON.stringify({
      "documento": {
          "tipo": "factura",
          "numero": "2026-0412"
      },
      "confirmar": true
  })
});

const resultado = await respuesta.json();

Respuesta

200 · application/json
{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "enviado": true,
        "documento": "Factura 2026-0412",
        "para": "administracion@cliente.com",
        "de": "facturacion@miempresa.com",
        "asunto": "Su Factura: 2026-0412",
        "con_pdf": true,
        "nota": "Enviado con el PDF. Queda en el historial de envíos del documento."
    }
}
Notas

Admite X-IDEMPOTENCY-KEY.