Adjuntar un fichero
https://api.afer.pro/api/v1/invoices/{id}/attachments
POST /api/v1/delivery-notes/{id}/attachments
POST /api/v1/orders/{id}/attachments
POST /api/v1/recurring-invoices/{id}/attachments
POST /api/v1/purchase-delivery-notes/{id}/attachments
POST /api/v1/purchase-orders/{id}/attachments
POST /api/v1/purchase-invoices/{id}/attachments
POST /api/v1/estimates/{id}/attachments
POST /api/v1/tasks/{id}/attachments
POST /api/v1/projects/{id}/attachments
POST /api/v1/work-orders/{id}/attachments
POST https://api.afer.pro/api/v1/invoices/{id}/attachments
Adjunta un PDF o una foto a un presupuesto, pedido, albarán, factura, recurrente, documento de compra, proyecto, parte de trabajo o tarea.
El fichero queda en la ficha del documento igual que si se subiera desde el panel, y sale después en Obtener adjuntos con su URL de descarga.
Cada tipo tiene su ruta REST: POST /estimates/{id}/attachments, /orders/{id}/attachments, /delivery-notes/{id}/attachments, /invoices/{id}/attachments, /recurring-invoices/{id}/attachments, /purchase-orders/{id}/attachments, /purchase-delivery-notes/{id}/attachments, /purchase-invoices/{id}/attachments, /projects/{id}/attachments, /work-orders/{id}/attachments y /tasks/{id}/attachments. La ruta fija el tipo; con el alias POST /adjuntarDocumento se indica con tipo.
El fichero va en base64 o como enlace público. Solo PDF o foto (JPG, PNG, WEBP), como en el panel, y hasta 10 MB. El tipo se mira por el contenido, no por el nombre.
Para un albarán o factura de un proveedor que aún no está en Afer, usa Mandar un documento de compra al buzón: esto solo cuelga ficheros de documentos que ya existen.
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. Si la conexión es de una persona, el adjunto queda a su nombre.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
documentoIdstringobligatorio | Identificador cifrado del documento. En la ruta REST va como {id}. |
tipostringopcional | presupuesto, pedido, albaran, factura, recurrente, pedidoCompra, albaranCompra, facturaCompra, proyecto, parte o tarea. En las rutas REST lo fija la propia ruta. |
fichero_base64stringopcional | El fichero en base64; también vale con el prefijo data:…;base64,. Este o url. |
urlstringopcional | Enlace público y directo al fichero (http o https). Se siguen hasta 3 redirecciones; no se admiten direcciones de redes internas. |
nombrestringopcional | Cómo se verá en la ficha. La extensión la pone Afer según lo que es el fichero. |
notastringopcional | Una nota corta sobre el fichero (hasta 500 caracteres). |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/invoices/aBc123XyZ/attachments' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://ejemplo.com/planos/planta-baja.pdf",
"nombre": "Plano planta baja",
"nota": "Versión revisada con el cliente"
}'
<?php
$data = [
'url' => 'https://ejemplo.com/planos/planta-baja.pdf',
'nombre' => 'Plano planta baja',
'nota' => 'Versión revisada con el cliente',
];
$ch = curl_init('https://api.afer.pro/api/v1/invoices/aBc123XyZ/attachments');
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/invoices/aBc123XyZ/attachments', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"url": "https://ejemplo.com/planos/planta-baja.pdf",
"nombre": "Plano planta baja",
"nota": "Versión revisada con el cliente"
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"ok": true,
"tipo": "proyecto",
"proyectoId": "aBc123XyZ…",
"adjunto": {
"adjuntoId": "dEf456…",
"fichero": "API-20261104-9f3a1c2b7d4e5f60.pdf",
"nombre": "Plano planta baja.pdf",
"url": "https://prosuite.aferapp.com/attachments/public/upload/customers/108/API-20261104-9f3a1c2b7d4e5f60.pdf",
"tipo_adjunto": "doc",
"clasificacion": null,
"nota": "Versión revisada con el cliente",
"de_linea": false,
"fecha_hora": "2026-11-04 10:24:00"
},
"mensaje": "Adjuntado al proyecto: ya se ve en su ficha de Afer."
}
}
Errores
| Caso | Resultado |
|---|---|
| Sin credenciales | errorCode 401. |
tipo no reconocido, sin fichero, fichero de más de 10 MB, que no es PDF ni foto, o url no pública o que no se puede descargar |
errorCode 400. |
| El documento no existe o no es de tu cuenta | errorCode 404. |
Admite X-IDEMPOTENCY-KEY: sin ella, cada llamada añade un adjunto nuevo. Por MCP es adjuntar_documento.