BuildNexion

Introducción

La API REST de BuildNexion te permite leer y escribir datos de tus obras: proyectos, presupuestos, facturas, albaranes y proveedores. Todo lo que ves en la app, expuesto en JSON.

Casos de uso

  • Sincronizar facturación con tu ERP (Holded, Quipu, Sage, A3…).
  • Importar facturas en masa desde correo o un drive.
  • Cuadros de mando propios conectando tu BI a los proyectos.
  • Automatizar avisos al recibir nuevas facturas u ofertas.

Prerequisitos

  1. Una cuenta activa de BuildNexion (cualquier plan).
  2. Rol de Administrador en tu organización (necesario para crear API keys).
  3. Una API key generada desde settings/integraciones/api.
Empieza siempre con una key de pruebas (bn_test_…) apuntando a un proyecto demo. Cuando todo funcione, sustitúyela por una key de producción (bn_live_…).

Tu primera llamada

Lista tus proyectos. Es el endpoint más simple y el mejor para confirmar que tu key funciona:

curl https://api.buildnexion.com/v1/projects \
  -H "Authorization: Bearer bn_live_xxxxxxxxxxxxxxxxxxxx"

Una respuesta correcta tiene este aspecto:

{
  "data": [
    {
      "id": "prj_8GcyLwT4mPq",
      "name": "Reforma Av. Diagonal 412",
      "status": "in_progress",
      "client_name": "Inmobiliaria Sant Martí SL",
      "created_at": "2026-03-12T09:14:22.000Z"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "limit": 25
  }
}

Convenciones

  • URL base: https://api.buildnexion.com/v1
  • Formato: JSON. Todos los POST/PATCH esperan Content-Type: application/json.
  • Fechas: ISO-8601 UTC (2026-05-25T10:30:00.000Z).
  • Importes: en céntimos de euro (enteros). 1234,56 € = 123456.
  • IDs: strings con prefijo (prj_, inv_, alb_, bud_, prov_).
  • Paginación: cursor-based vía ?cursor=…&limit=25.

Cuando tengas tu primera llamada funcionando, sigue con Autenticación, Errores y los endpoints.