Configuración inicial e importación

Antes de comenzar

Orden recomendado

Completa los catálogos antes de importar. Así cada cliente podrá quedar asociado al router, plan, red, ciclo de cobro y zona correctos desde el primer momento.

1
VPN, si se necesitaConectividad privada hacia el MikroTik y sus redes internas.
2
Nodo MikroTikVinculación mediante RouterOS REST.
3
Planes de InternetPrecios y velocidades comerciales.
4
Redes IPSegmentos y gateways administrados por IPAM.
5
Ciclos de cobroGeneración, pago, gracia, corte y reconexión.
6
ZonasColonias, barrios, comunidades o sectores.
7
ImportaciónDescarga, revisión y carga del Excel por MikroTik.

La VPN es opcional. Si la VPS ya puede alcanzar una IP pública o dominio del MikroTik, vincula el nodo directamente y continúa con los planes.

Preparación

Requisitos previos

FdezPay instalado y una cuenta con permisos administrativos.
MikroTik con RouterOS v7 o superior.
Usuario dedicado del router con permisos suficientes para REST.
Conectividad mediante WireGuard o una dirección pública accesible.
Método de gestión definido: PPPoE o IP estática.

Seguridad: evita usar la cuenta administrativa principal. Crea una cuenta dedicada, limita su origen y nunca publiques contraseñas, llaves privadas ni tokens.

Punto de partida

Abre las herramientas administrativas

Desde el Dashboard despliega Configuración. En la pantalla General encontrarás Túneles VPN, Plantillas de Facturación, Gestión de Zonas e Importar Clientes.

Menú principal del Dashboard de FdezPay — 1. Abre el Dashboard.

Menú Configuración desplegado — 2. Despliega Configuración.

Panel de herramientas administrativas de FdezPay — 3. Selecciona la herramienta que vas a configurar.

Paso 1

Crea un túnel VPN hacia el MikroTik

Utiliza WireGuard cuando el router no tenga una dirección pública alcanzable desde la VPS. En Configuración → Túneles VPN, pulsa Nuevo túnel y selecciona Nodo / Router.

Pantalla Infraestructura VPN con el botón Nuevo túnel — Abre Infraestructura VPN y pulsa Nuevo túnel.

Datos del acceso

Campo	Qué debes indicar
Tipo	Nodo / Router para conectar un MikroTik.
Identificador	Un nombre reconocible, por ejemplo Torre Principal o Router Zona Norte.
Subredes detrás del MikroTik	Redes internas que también deberán alcanzarse: ONUs, antenas, APs u otros equipos.

Formulario para crear un acceso VPN de tipo Nodo o Router — Selecciona Nodo / Router y escribe un identificador.

Ejemplo de subredes CIDR detrás de un MikroTik — Agrega una o varias redes en formato CIDR.

Formato correcto: usa redes como 192.168.2.0/24, no una dirección de equipo como 192.168.2.1/24. Puedes separar varias redes con coma o salto de línea; FdezPay las normaliza al crear el túnel.

Genera las llaves y aplica el script

Pulsa Generar llaves.
En la tarjeta creada, abre Script MikroTik y pulsa Copiar.
Abre una terminal del router mediante WinBox, WebFig o SSH.
Pega y ejecuta el script completo.
Conserva la IP privada asignada; la usarás al vincular el nodo.

Tarjeta de un túnel VPN creado — La tarjeta muestra la IP VPN y las subredes anunciadas.

Script WireGuard generado para MikroTik — Copia el script completo en la terminal del MikroTik.

Paso 2

Vincula el MikroTik como nodo

Abre Infraestructura → Nodos / Routers y pulsa Vincular Nodo.

Acceso al menú Infraestructura — Abre Infraestructura.

Opción Nodos y Routers en el menú — Selecciona Nodos / Routers.

Pantalla de Nodos MikroTik — Pulsa Vincular Nodo.

Campo	Uso
Nombre	Identificador interno del router.
Dirección IP	IP privada asignada por la VPN o IP/dominio público accesible.
Usuario y contraseña	Credenciales dedicadas para la integración REST.
Puerto	Puerto WWW/HTTP de RouterOS REST; normalmente 80.
Modo	PPPoE para PPP Secrets o IP estática según el diseño de red.

No uses 8728 por costumbre. Ese puerto corresponde al API tradicional. La integración de FdezPay con RouterOS v7 usa REST sobre el servicio WWW/HTTP, normalmente puerto 80 o el puerto personalizado de ese servicio.

Formulario para vincular un nodo MikroTik — Completa conectividad, credenciales y modo de tráfico.

Ejemplo de datos de un nodo conectado por VPN — Ejemplo con IP VPN y puerto WWW 80.

Después de vincularlo, utiliza Ping en la tarjeta. Si no responde, revisa IP, puerto WWW, credenciales, VPN y firewall antes de continuar.

Tarjeta de un nodo MikroTik vinculado — Nodo vinculado y listo para probar conectividad.

Paso 3

Crea los planes de Internet

En Infraestructura → Planes de Internet, pulsa Nuevo Plan. Crea todos los planes comerciales que utilizarás antes de descargar el Excel de importación.

Opción Planes de Internet en Infraestructura — Abre Planes de Internet.

Listado de planes con el botón Nuevo Plan — Pulsa Nuevo Plan.

Indica nombre comercial, precio, router destino, bajada y subida. Las ráfagas son opcionales; si no las utilizas, conserva sus valores en cero.

Formulario de un perfil QoS de Internet — Ejemplo de un perfil QoS de 10 Mbps sin ráfagas.

Paso 4

Registra las redes IP de clientes

IPAM permite controlar qué segmentos pertenecen a cada router y reduce el riesgo de reutilizar una dirección ya ocupada. Abre Infraestructura → Redes IP (Pools) y pulsa Nueva Red.

Opción Redes IP en Infraestructura — Abre Redes IP (Pools).

Pantalla de Gestión de Redes IPAM — Pulsa Nueva Red.

Selecciona el router, escribe un nombre, el segmento CIDR y su gateway. Para una red /24 con gateway 192.168.2.1, el segmento normalmente será 192.168.2.0/24.

Formulario para registrar una red IP — Registra la red completa, no una IP de host.

Paso 5

Configura los ciclos de cobro

En Configuración → Plantillas de Facturación, crea una política por cada calendario utilizado. Por ejemplo, puedes tener clientes con pago el día 1 y otros con pago el día 15.

Pantalla de Plantillas de Cobro — Pulsa Nuevo ciclo.

Campo	Significado
Anticipación	Días antes del pago en los que se genera la factura.
Día de pago	Fecha principal de vencimiento mensual.
Gracia	Días posteriores al pago antes del corte.
IVA	Porcentaje aplicable; utiliza 0 cuando no corresponda.
Reconexión	Cargo después de reactivar; utiliza 0 si no se cobra.
WhatsApp	Activa los avisos automáticos del ciclo.

Formulario para crear un ciclo de cobro — La simulación muestra generación, pago y corte.

Ejemplo de ciclo de cobro configurado — Ejemplo: pago día 1 y corte día 11.

Paso 6

Crea las zonas geográficas

Las zonas organizan clientes por colonia, barrio, comunidad o sector. Un mismo MikroTik puede atender varias; durante la preparación del Excel podrás asignar la zona correcta a cada cliente.

Escribe el nombre de la zona.
Pulsa Crear Zona.
Repite el proceso hasta completar tu cobertura.

Pantalla para crear y listar zonas geográficas — Crea las zonas antes de preparar la importación.

Paso 7

Importa los clientes desde MikroTik

Con los catálogos listos, abre Configuración → Importar Datos. Realiza un lote por MikroTik para que la revisión y la corrección de errores sean manejables.

Pantalla inicial de Importación Masiva — Primero configura los valores base del lote.

Configura y descarga el lote

Selecciona router, red IP, zona, plantilla de facturación y plan. Estos valores sirven como base; si el router contiene clientes distintos, podrás corregir cada fila en el Excel.

Lote de importación con router, red, zona, ciclo y plan seleccionados — Revisa los cinco valores y pulsa Descargar Plantilla.

Revisa el archivo Excel

Guarda la plantilla y revisa cada cliente. Corrige plan, zona, ciclo de cobro y red cuando el valor inicial no corresponda.

Los catálogos empiezan en 0. En las columnas de plan, zona y plantilla: el primer elemento es 0, el segundo 1, el tercero 2 y así sucesivamente.

Ventana para guardar la plantilla Excel de clientes — Conserva el formato .xlsx al guardar las correcciones.

Sube e inicia la importación

Selecciona o arrastra el Excel corregido.
Comprueba que aparezca el nombre del archivo.
Pulsa Iniciar Importación.
Revisa clientes creados, registros con error y estado final.
Corrige los errores antes de continuar con el siguiente router.

Archivo Excel listo para iniciar la importación — Archivo seleccionado y listo para importar.

Finalización

Comprueba la configuración

La VPN se creó sólo cuando fue necesaria y el peer tiene handshake.
El nodo responde a Ping y usa RouterOS REST por el puerto WWW correcto.
Todos los planes comerciales están asociados al router correspondiente.
Los segmentos y gateways están registrados en IPAM.
Las fechas de generación, pago, gracia y corte son correctas.
Las zonas necesarias existen antes de importar.
El Excel fue revisado fila por fila y conserva el formato .xlsx.
Los registros rechazados se corrigieron antes de cerrar el lote.

Flujo completo: VPN, si aplica → Nodo MikroTik → Planes → Redes IP → Ciclos de cobro → Zonas → Descargar y corregir Excel → Importar clientes.

Siguiente paso: registra tus OLT, cajas NAP y equipos en la guía 02.

Configura la red e importa tus clientes