Proveedores

Los proveedores son las empresas o autónomos que emiten facturas y albaranes a tu organización. Su NIF actúa como identificador único para evitar duplicados.

El objeto proveedor

json

{
  "id":         "prov_4kqRpBn",
  "name":       "Materiales García SL",
  "nif":        "B98765432",
  "email":      "facturacion@materialesgarcia.es",
  "phone":      "+34 938 12 34 56",
  "address":    "Pol. Ind. Can Roca, 22 — Sabadell",
  "category":   "materiales",
  "invoices_count":       58,
  "delivery_notes_count": 142,
  "total_billed_amount":  18450200,
  "created_at": "2025-11-04T08:30:00.000Z"
}

Listar proveedores

GET/v1/providers

Query parameters

Parámetro	Tipo	Descripción
q	string	Búsqueda libre en nombre/NIF/email.
category	string	materiales · subcontrata · maquinaria · servicios · otros
cursor	string	Paginación.
limit	integer	Entre 1 y 100. Default 25.

Obtener un proveedor

GET/v1/providers/{id}

Crear un proveedor

POST/v1/providers

Body

Parámetro	Tipo	Descripción
name*	string	Razón social.
nif*	string	NIF/CIF. Único por organización.
email	string	Email de contacto.
phone	string	Teléfono.
address	string	Dirección.
category	string	materiales · subcontrata · maquinaria · servicios · otros

curl -X POST https://api.buildnexion.com/v1/providers \
  -H "Authorization: Bearer bn_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name":     "Materiales García SL",
    "nif":      "B98765432",
    "email":    "facturacion@materialesgarcia.es",
    "phone":    "+34 938 12 34 56",
    "address":  "Pol. Ind. Can Roca, 22 — Sabadell",
    "category": "materiales"
  }'

Si ya existe un proveedor con el mismo nif, recibirás 409 duplicate_resource con el ID existente en details.existing_id. Usa PATCH para actualizarlo.

Actualizar un proveedor

PATCH/v1/providers/{id}

Eliminar un proveedor

DELETE/v1/providers/{id}

Sólo puedes eliminar proveedores sin facturas ni albaranes asociados. Si tiene documentos, devolverá 409 con el conteo en details.