Skip to main content
The Nodes module (/nodos) lets you register, search, and inspect every network node in your infrastructure. A node represents a physical or logical site — a rack room, a mast, a mini-node, or a customer premises — that anchors one or both ends of a connection.

​
Data model

Each node is described by the following fields. 
type Nodo = {
  nodo_id: number;

  nombre: string | null;       // human-readable node name
  tipo_nodo: string | null;    // "NODO" | "MININODO" | "CLIENTE"

  direccion: string | null;    // street address
  departamento: string | null; // region / department
  provincia: string | null;    // province
  distrito: string | null;     // district

  latitud: string | null;      // GPS latitude (decimal degrees)
  longitud: string | null;     // GPS longitude (decimal degrees)

  estado: number | null;       // 1 = active, 0 = inactive
  created_at: string | null;   // ISO 8601 creation timestamp
};
When you fetch a node by ID, the response also includes the richer NodoDetalle type, which adds: 
type NodoDetalle = Nodo & {
  equipos_ids: number[];    // IDs of equipment assigned to this node
  servicios: ServicioNodo[]; // provider services available at this node
};

type ServicioNodo = {
  servicio_id: number;
  modalidad: string | null;                // e.g. "Fibra Óptica", "GPON"
  capacidad_disponible: number | null;     // remaining Mbps on this service
  ubicacion_servicio: string | null;       // service location description
  condicion: string | null;                // "Activo", "Pendiente", etc.
  nombre_proveedor: string | null;         // provider name
};

​
Node types

The system recognises three node types, selected during creation:
ValueLabelDescription
NODONodoA full network node (aggregation or distribution point)
MININODOMininodoA smaller distribution site
CLIENTEClienteA customer-premises node, linked to a specific connection
When you choose the Cliente type, an additional Servicio de cliente selector appears in the form. You must pick an existing connection (enlace) to associate with this node.

​
Node list page

Navigate to Nodos in the sidebar to open the node catalog.
1

Search

Type in the search box to filter nodes by name, type, address, or ubigeo (geographic code). Press Enter or click Buscar to apply the filter.
2

Browse results

The table displays each node’s ID, geographic location (department / province / district and street address), and node type. Results are paginated — 10 per page by default. Use Anterior / Siguiente to move between pages.
3

Open a node

Click Ver info on any row to open the node detail page, or Editar to jump directly to the edit form.

​
Creating a node

Click Nuevo nodo at the top-right of the list. The creation form contains the following fields:
  • Tipo de nodo (required) — choose NODO, MININODO, or CLIENTE.
  • Servicio de cliente — visible only when the type is CLIENTE. Select the connection this node represents from the dropdown.
  • Departamento — select from a built-in list of Peruvian departments.
  • Provincia — unlocked once a department is selected.
  • Distrito — free-text district name.
  • Dirección — full street address.
  • Latitud — decimal-degree latitude (e.g. -12.04318).
  • Longitud — decimal-degree longitude (e.g. -77.02824).
Click + Equipo to attach an existing piece of equipment to the node at creation time. Select the equipment from the dropdown showing tipo | marca | modelo | SN: serial. Click Quitar equipo to remove the selection.
Click Guardar to submit. On success, the system redirects you to the node list.

​
Node detail page

Reach a node’s detail page at /nodos/ver/:nodo_id. The page is divided into sections:

Node details

Displays nodo_id, node type, full address, and GPS coordinates (latitud / longitud).

Provider services

Lists every ServicioNodo associated with this node: service ID, modality, available capacity (Mbps), location description, condition, and provider name.

Associated equipment

Shows the list of equipos_ids — the IDs of all equipment registered at this node.

​
API endpoints

MethodPathDescription
GET/v1/nodos/listarPaginated list — accepts search, limit, offset
GET/v1/nodos/:idFetch a single node with services and equipment
POST/v1/nodos/crearCreate a new node
PATCH/v1/nodos/:idUpdate an existing node
GET/v1/nodos/listar/selectLightweight list for dropdowns

​
Example: list request

GET /v1/nodos/listar?search=Lima&limit=10&offset=0

​
Example: create payload

{
  "tipo_nodo": "NODO",
  "direccion": "Av. Javier Prado Este 1234",
  "departamento": "Lima",
  "provincia": "Lima",
  "distrito": "San Isidro",
  "latitud": "-12.09330",
  "longitud": "-77.03560",
  "estado": 1
}
Always populate latitud and longitud when registering nodes. These coordinates are used for geographic capacity reports and network-coverage mapping. Nodes without GPS data will appear as unlocated in any map-based views.