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

Mandar un documento de compra al buzón

POST https://api.afer.pro/api/v1/purchases/inbox
Alias en castellano (v0, sigue operativo): 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.

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 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_base64string
obligatorio
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.
nombrestring
opcional
Cómo se verá en el buzón. La extensión la pone Afer según lo que es el fichero.
proyectoIdstring
opcional
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

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

Admite X-IDEMPOTENCY-KEY. Por MCP es subir_documento_compra.