Mandar un documento de compra al buzón
https://api.afer.pro/api/v1/purchases/inbox
POST https://api.afer.pro/api/v1/purchases/inbox
Un albarán, ticket o factura de un proveedor (PDF o foto) al buzón de compras, «Por escanear». Lo lee el escáner del buzón, no esta llamada.
Pone el fichero en el buzón de compras, igual que la subida del panel, WhatsApp o el correo, a nombre de quien llama. Queda en «Por escanear»: al escanearlo, Afer lo lee (proveedor, líneas, IVA, duplicados, obra) y una persona lo revisa antes de que sea un albarán o una factura de compra.
No crea la compra ni interpreta el documento. Con proyectoId, el documento lleva la obra y el escáner la propone en sus líneas.
El mismo fichero dos veces no entra dos veces: se devuelve el que ya estaba, con ya_estaba: true.
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 de la cuenta. La empresa tiene que tener la facturación de Afer.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
fichero_base64stringobligatorio | El PDF o la foto (JPG, PNG, WEBP) en base64; también vale con el prefijo data:…;base64,. Hasta 10 MB. El tipo se mira por el contenido. |
nombrestringopcional | Cómo se verá en el buzón. La extensión la pone Afer según lo que es el fichero. |
proyectoIdstringopcional | La obra (de buscar_obra). |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/purchases/inbox' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"fichero_base64": "/9j/4AAQSkZJRgABAQ…",
"nombre": "Albarán · Casa Bel, punto 1 · Pere",
"proyectoId": "a1b2c3"
}'
<?php
$data = [
'fichero_base64' => '/9j/4AAQSkZJRgABAQ…',
'nombre' => 'Albarán · Casa Bel, punto 1 · Pere',
'proyectoId' => 'a1b2c3',
];
$ch = curl_init('https://api.afer.pro/api/v1/purchases/inbox');
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/purchases/inbox', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"fichero_base64": "/9j/4AAQSkZJRgABAQ…",
"nombre": "Albarán · Casa Bel, punto 1 · Pere",
"proyectoId": "a1b2c3"
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"ok": true,
"ya_estaba": false,
"documentoId": "d4e5f6",
"nombre": "Albarán · Casa Bel, punto 1 · Pere.jpg",
"obra": "OB-12 Casa Bel",
"estado": "por_escanear",
"mensaje": "En el buzón de compras de Afer, «Por escanear». Al escanearlo, Afer lo lee y se revisa antes de que sea una compra."
}
}
Admite X-IDEMPOTENCY-KEY. Por MCP es subir_documento_compra.