Albaranes

Los albaranes de entrega de tus proveedores, leídos por la app e imputados a una obra. Mientras no se facturan cuentan como coste provisional; al facturarse, quedan enlazados a su factura.

Listar albaranes

GET/api/v1/delivery-notesread:delivery_notes

Por fecha de entrega, del más reciente al más antiguo (los que no tienen fecha, al final).

Parámetros (query)

Parámetro	Tipo	Descripción
status string	string	digitalizando (la app lo está leyendo), pending_review (pendiente de revisar), pendiente_aprobacion (pendiente de aprobar) o approved (aprobado).
billing_status string	string	pendiente_factura o facturado.
project_id uuid	uuid	Albaranes de una obra.
provider_id uuid	uuid	Albaranes de un proveedor (también vale proveedor_id).
q string	string	Busca en el nombre del proveedor.
from / to date	date	Fecha de entrega desde / hasta (YYYY-MM-DD).
limit / cursor —	—	Paginación: de 1 a 200 por página (50 por defecto).

curl "https://app.buildnexion.com/api/v1/delivery-notes?project_id=6f1c2a9e-3b7d-4c1e-9a52-1d0e8b7c4a21&billing_status=pendiente_factura" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Respuesta

{
  "data": [
    {
      "id": "e7a2c5d8-91b4-4f60-b3d7-28c6e1a09f53",
      "project_id": "6f1c2a9e-3b7d-4c1e-9a52-1d0e8b7c4a21",
      "supplier": "Materiales del Sur SL",
      "provider_id": "4a9d1e73-6c2b-4d8f-90e5-b17a3c6d2e08",
      "delivery_date": "2026-09-12",
      "total_amount": 1815,
      "lines": [
        {
          "description": "Saco de cemento CEM II 25 kg",
          "quantity": 60,
          "unit": "ud",
          "unit_price": 6.5,
          "total": 390
        },
        {
          "description": "Ladrillo hueco doble 24x11,5x8",
          "quantity": 4440,
          "unit": "ud",
          "unit_price": 0.25,
          "total": 1110
        }
      ],
      "status": "approved",
      "estado": "facturado",
      "factura_id": "c41e7b92-0d5a-4a3f-9e68-7b2d1c0f5a84",
      "image_url": "https://…supabase.co/storage/v1/object/sign/delivery-notes/…?token=…",
      "created_at": "2026-09-12T15:31:07.215+00:00"
    }
  ],
  "pagination": {
    "limit": 50,
    "next_cursor": null
  }
}

Campos

Parámetro	Tipo	Descripción
supplier / provider_id string / uuid \| null	string / uuid \| null	Proveedor tal como figura en el albarán y, si está identificado, su id.
delivery_date date \| null	date \| null	Fecha de entrega.
total_amount number \| null	number \| null	Importe total leído del albarán, en euros.
lines array	array	Líneas: description, quantity, unit, unit_price y total.
status string	string	Estado de revisión (ver el filtro status).
estado string	string	Facturación: pendiente_factura o facturado (es el filtro billing_status).
factura_id uuid \| null	uuid \| null	Factura con la que se facturó (ver Facturas de compra).
image_url string \| null	string \| null	Enlace al archivo original. Caduca en 1 hora.

Leer un albarán

GET/api/v1/delivery-notes/{id}read:delivery_notes

curl "https://app.buildnexion.com/api/v1/delivery-notes/e7a2c5d8-91b4-4f60-b3d7-28c6e1a09f53" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Webhooks: delivery_note.created y delivery_note.updated (ver eventos).