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

Adjuntar un fichero

POST https://api.afer.pro/api/v1/invoices/{id}/attachments
También disponible en: 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
Alias en castellano (v0, sigue operativo): 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.

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. 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.

documentoIdstring
obligatorio
Identificador cifrado del documento. En la ruta REST va como {id}.
tipostring
opcional
presupuesto, pedido, albaran, factura, recurrente, pedidoCompra, albaranCompra, facturaCompra, proyecto, parte o tarea. En las rutas REST lo fija la propia ruta.
fichero_base64string
opcional
El fichero en base64; también vale con el prefijo data:…;base64,. Este o url.
urlstring
opcional
Enlace público y directo al fichero (http o https). Se siguen hasta 3 redirecciones; no se admiten direcciones de redes internas.
nombrestring
opcional
Cómo se verá en la ficha. La extensión la pone Afer según lo que es el fichero.
notastring
opcional
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

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

CasoResultado
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.
Notas

Admite X-IDEMPOTENCY-KEY: sin ella, cada llamada añade un adjunto nuevo. Por MCP es adjuntar_documento.