Providers

Overview

The Proveedores module lets you register and maintain the upstream ISP providers (carriers) that sell bandwidth to your organization. Every bandwidth service (ServicioProveedor) and every network connection (EnlaceRed) traces back to a provider record. Keeping provider data accurate ensures that capacity reports, SLA tracking, and support escalations all have a valid reference.

Data Model

type Proveedor = {
  proveedor_id:      number;          // auto-increment primary key
  nombre:            string;          // legal name or trade name, e.g. "BITEL S.A.C."
  ruc:               string | null;   // Peruvian tax ID (RUC), 11 digits
  contacto_soporte:  string | null;   // support contact (email, phone, or NOC name)
  sla_soporte:       number | null;   // agreed support SLA in hours
};

Providers List Page

When you navigate to Proveedores, you see a paginated table of all providers. The page loads 10 providers per page by default.

Filters

Búsqueda — free-text search by nombre or contacto_soporte. Press Enter or click Buscar to apply. Updates are debounced.
Estado — filter by active (is_active = 1), inactive (is_active = 0), or all. Defaults to active.

Table columns

Column	Field
Nombre / Razon social	`nombre`
Contacto	`contacto_soporte`
RUC	`ruc`
Acciones	Edit button + Crear Servicio shortcut

Row actions

Each row has three actions:

Visibility icon — expands an inline sub-table showing all services (ServicioProveedor) linked to this provider. The sub-table columns are: CID, Tipo de enlace, Capacidad Comprada, Capacidad Vendida, Capacidad Utilizada, Capacidad Disponible, and Condición.
Crear Servicio — navigates to /servicios/crear with proveedor_id pre-filled in router state.
Edit icon — opens the edit modal for this provider.

Create Provider

Click Nuevo proveedor in the top-right corner to navigate to the provider creation form.

Fill in the provider details

Complete the form fields:

Field	Required	Notes
`nombre`	Yes	Legal or commercial name. Cannot be empty.
`ruc`	No	11-character Peruvian tax ID. Leave blank if not applicable.
`contacto_soporte`	No	Email address, phone number, or NOC team name.
`sla_soporte`	No	SLA commitment in hours (must be a number ≥ 0 or left blank).

Save

Click Guardar. The form validates that nombre is non-empty and that sla_soporte, if provided, is a finite number ≥ 0. On success, the providers list is invalidated and refreshed.

Create API call

POST /v1/proveedores/crear
Content-Type: application/json

{
  "nombre": "BITEL S.A.C.",
  "ruc": "20600227461",
  "contacto_soporte": "noc@bitel.com.pe",
  "sla_soporte": 4
}

{
  "ok": true,
  "message": "Proveedor creado correctamente.",
  "proveedor_id": 42
}

Edit Provider

Click the edit icon on any row to open the edit modal. The same four fields are available: nombre, ruc, contacto_soporte, and sla_soporte.

The edit form detects when no fields have changed and shows a “No hay cambios para guardar” warning instead of making an unnecessary API call.

Edit API call

PUT /v1/proveedores/editar
Content-Type: application/json

{
  "proveedor_id": 42,
  "nombre": "BITEL S.A.C.",
  "ruc": "20600227461",
  "contacto_soporte": "noc-escalation@bitel.com.pe",
  "sla_soporte": 2,
  "is_active": 1
}

Soft Delete

Providers are never permanently deleted. Clicking delete on a provider (via eliminarProveedor) calls:

DELETE /v1/proveedores/eliminar/{proveedor_id}

This marks the provider as inactive (is_active = 0). The provider will no longer appear in the default list (which filters by estado = 1) but remains in the database and can be retrieved by setting the Estado filter to Inactivos or Todos.

You cannot deactivate a provider that still has active services linked to it. The API returns HTTP 400 or 409 with a message containing “no se puede desactivar”, and the form displays the warning inline without closing.

Select Endpoint (for Dropdowns)

When creating a service or connection, other modules use a lightweight endpoint to populate provider dropdowns. This endpoint returns each provider together with a summary of its services:

GET /v1/proveedores/listar/select

type ProveedorSelect = {
  proveedor_id: number;
  nombre:       string;
  servicios: {
    servicio_id:        number | null;
    ubicacion_servicio: string | null;
    condicion:          string | null;
  }[];
};

API Reference

Method	Endpoint	Description
`GET`	`/v1/proveedores/listar`	Paginated list with optional `busqueda`, `estado`, `limit`, `offset`.
`GET`	`/v1/proveedores/{proveedor_id}`	Single provider by ID.
`POST`	`/v1/proveedores/crear`	Create a new provider.
`PUT`	`/v1/proveedores/editar`	Update an existing provider.
`DELETE`	`/v1/proveedores/eliminar/{proveedor_id}`	Soft-delete (set `is_active = 0`).
`GET`	`/v1/proveedores/listar/select`	Lightweight list for dropdown use, includes nested services.

Provider Services

Create and manage bandwidth contracts purchased from providers.

Capacity Dashboard

View contracted vs. assigned capacity and risk levels per connection.

MANUAL DE USUARIO

Get Started

Core Features

Administration

Deployment

Overview

Data Model

Providers List Page

Filters

Table columns

Row actions

Create Provider

Create API call

Edit Provider

Edit API call

Soft Delete

Select Endpoint (for Dropdowns)

API Reference

Provider Services

Capacity Dashboard

​Overview

​Data Model

​Providers List Page

​Filters

​Table columns

​Row actions

​Create Provider

​Create API call

​Edit Provider

​Edit API call

​Soft Delete

​Select Endpoint (for Dropdowns)

​API Reference

​Related Features

Provider Services

Capacity Dashboard

Overview

Data Model

Providers List Page

Filters

Table columns

Row actions

Create Provider

Create API call

Edit Provider

Edit API call

Soft Delete

Select Endpoint (for Dropdowns)

API Reference

Related Features