Proyectos
El proyecto es la unidad raíz de BuildNexion. Todo lo demás (presupuestos, facturas, albaranes, certificaciones) cuelga de él.
El objeto proyecto
json
{
"id": "prj_8GcyLwT4mPq",
"name": "Reforma Av. Diagonal 412",
"status": "in_progress",
"address": "Av. Diagonal 412, Barcelona",
"start_date": "2026-03-15",
"end_date": "2026-09-30",
"client_name": "Inmobiliaria Sant Martí SL",
"client_nif": "B12345678",
"client_email": "facturacion@santmarti.com",
"client_phone": "+34 600 123 456",
"client_address": "C/ Pelai 12, Barcelona",
"created_at": "2026-03-12T09:14:22.000Z",
"updated_at": "2026-05-14T16:01:08.000Z"
}Listar proyectos
GET/v1/projects
Query parameters
| Parámetro | Tipo | Descripción |
|---|---|---|
| status | string | draft · in_progress · finished · archived |
| q | string | Búsqueda libre en nombre/dirección/cliente. |
| cursor | string | Paginación. |
| limit | integer | Entre 1 y 100. Default 25. |
curl "https://api.buildnexion.com/v1/projects?status=in_progress" \
-H "Authorization: Bearer bn_live_xxxxxxxxxxxxxxxxxxxx"Obtener un proyecto
GET/v1/projects/{id}
Crear un proyecto
POST/v1/projects
Body
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | Nombre interno del proyecto. |
| address | string | Dirección de la obra. |
| start_date | date | Fecha prevista de inicio. |
| end_date | date | Fecha prevista de fin. |
| client_name | string | Razón social del cliente. |
| client_nif | string | NIF/CIF del cliente. |
| client_email | string | Email del cliente. |
| client_phone | string | Teléfono del cliente. |
| client_address | string | Dirección fiscal del cliente. |
bash
curl -X POST https://api.buildnexion.com/v1/projects \
-H "Authorization: Bearer bn_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"name": "Reforma piso C/ Aragó 88",
"address": "C/ Aragó 88, Barcelona",
"client_name": "Pere Casals Vidal",
"client_nif": "12345678X",
"client_email": "pere@example.com"
}'Actualizar un proyecto
PATCH/v1/projects/{id}
Archivar un proyecto
DELETE/v1/projects/{id}
El proyecto pasa a status: "archived". Recuperable durante 90 días.