Proveedores

Tu maestro de proveedores y subcontratas, con sus contactos. Y, para cada obra o presupuesto, quién trabaja en ella y por qué.

Listar proveedores

GET/api/v1/providersread:providers

Por nombre, de la A a la Z.

Parámetros (query)

Parámetro	Tipo	Descripción
type string	string	material, subcontrata, servicios o maquinaria.
active boolean	boolean	true: solo activos; false: solo dados de baja.
q string	string	Busca en el nombre y en el NIF.
updated_since datetime	datetime	Solo los creados o cambiados desde ese momento (incluidos cambios en sus contactos), del más antiguo al más reciente.
limit / cursor —	—	Paginación: de 1 a 200 por página (50 por defecto).

curl "https://app.buildnexion.com/api/v1/providers?type=subcontrata&active=true" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Respuesta

{
  "data": [
    {
      "id": "4a9d1e73-6c2b-4d8f-90e5-b17a3c6d2e08",
      "name": "Materiales del Sur SL",
      "nif": "B00000001",
      "phone": "924 000 000",
      "email": "pedidos@ejemplo.es",
      "address": "Polígono Ejemplo, nave 4, Mérida",
      "notes": null,
      "active": true,
      "categories": [
        "Albañilería",
        "Áridos"
      ],
      "service_types": [],
      "contact_person": "Ana López",
      "type": "material",
      "contacts": [
        {
          "id": "81f0b6c4-2e7d-4a95-8c13-d6e9a4b7f210",
          "name": "Ana López",
          "role": "Comercial",
          "email": "pedidos@ejemplo.es",
          "phone": "600 000 002",
          "is_primary": true
        },
        {
          "id": "c2e8a4f1-7b3d-4e69-9a05-d1f6b8c3e724",
          "name": "Luis Martín",
          "role": "Administración",
          "email": "administracion@ejemplo.es",
          "phone": null,
          "is_primary": false
        }
      ],
      "created_at": "2025-11-03T12:00:41.117+00:00",
      "updated_at": "2026-09-18T10:22:05.580+00:00"
    }
  ],
  "pagination": {
    "limit": 50,
    "next_cursor": null
  }
}

Campos

Parámetro	Tipo	Descripción
name / nif string	string	Razón social y NIF/CIF.
type string \| null	string \| null	material, subcontrata, servicios o maquinaria.
phone, email, address string \| null	string \| null	Datos generales de la empresa.
contacts array	array	Personas de contacto: id, name, role (cargo), email, phone e is_primary. El principal es el de las peticiones de oferta.
contact_person string \| null	string \| null	Nombre del contacto principal (se mantiene por compatibilidad: usa contacts).
categories / service_types string[]	string[]	Familias de material y tipos de servicio.
active boolean	boolean	false si está dado de baja.
created_at / updated_at datetime	datetime	Alta y último cambio.

Leer un proveedor

GET/api/v1/providers/{id}read:providers

curl "https://app.buildnexion.com/api/v1/providers/4a9d1e73-6c2b-4d8f-90e5-b17a3c6d2e08" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Proveedores de una obra o de un presupuesto

GET/api/v1/projects/{id}/providersread:providers

GET/api/v1/estimates/{id}/providersread:providers

Quién trabaja en la obra (o a quién se ha pedido precio en el presupuesto), con el motivo y su última actividad, de la más reciente a la más antigua. Sin paginación.

relations: por qué aparece

Parámetro	Tipo	Descripción
rfq —	—	Se le ha pedido oferta (o se le adjudicó la petición).
budget_item —	—	Tiene asignada alguna partida (suministro o servicio).
purchase_order —	—	Tiene pedidos de la obra.
contract —	—	Tiene contrato de subcontrata en la obra.
compliance —	—	Tiene expediente CAE en la obra.
delivery_note / invoice —	—	Tiene albaranes o facturas de la obra.

En un presupuesto solo pueden salir rfq y budget_item; la obra incluye también los de su presupuesto.

Respuesta

{
  "data": [
    {
      "provider_id": "4a9d1e73-6c2b-4d8f-90e5-b17a3c6d2e08",
      "name": "Materiales del Sur SL",
      "type": "material",
      "relations": [
        "delivery_note",
        "invoice",
        "purchase_order"
      ],
      "last_activity_at": "2026-10-01T07:52:18.640+00:00"
    },
    {
      "provider_id": "9c4a7e2d-1f8b-4d36-b5e0-3a6c9d2f8e17",
      "name": "Instalaciones Ejemplo SL",
      "type": "subcontrata",
      "relations": [
        "rfq",
        "contract",
        "compliance"
      ],
      "last_activity_at": "2026-09-22T09:14:50.302+00:00"
    }
  ]
}

La documentación CAE de las subcontratas de cada obra está en Cumplimiento. Webhooks: provider.created y provider.updated; los proveedores borrados, en /deleted.