Enviar un documento por correo
https://api.afer.pro/api/v1/documents/send
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.
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.
documentoobjectobligatorio | {tipo, id} o {tipo, numero}. Tipos: factura, presupuesto, albaran, pedido. |
parastringopcional | Correo de destino. Por defecto, el del cliente. |
asuntostringopcional | Por defecto Su Factura: NÚMERO · obra. |
mensajestringopcional | El texto. Por defecto el de siempre, con la firma de la empresa. |
confirmarboolopcional | 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
{
"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."
}
}
Admite X-IDEMPOTENCY-KEY.