ValwispDocs
API

Registro

El punto de entrada real de un suscriptor nuevo — antes de instalación, antes de ser cliente.

🟡 Próximamente.

Una persona que pide servicio no es un cliente todavía. Es un registro: alguien que manifestó interés, cuyos datos hay que validar (cobertura, crédito) antes de mandar una brigada y, eventualmente, antes de que exista un cliente facturable. Esta API refleja ese orden explícitamente — no existe (ni debe existir) un endpoint para crear un cliente directamente. El único camino hacia un cliente es:

Registro  →  Instalación  →  Cliente

Crear un registro

POST /registros
Authorization: Bearer vw_live_...
Content-Type: application/json

{
  "nombre": "Ana Gómez",
  "cedula": "40298765432",
  "telefono": "8095559876",
  "direccion": "Calle Duarte 45, San Pedro de Macorís",
  "planInteres": "plan_100mb",
  "sucursalId": "suc_1a2b3c"
}
{
  "success": true,
  "data": { "id": "reg_7a1b2c", "estado": "nuevo" },
  "timestamp": "2026-08-05T14:00:00.000Z"
}

Esto no crea un cliente ni genera ninguna factura — solo dice "esta persona quiere servicio". Tu integración (un formulario en tu web, un bot, un partner comercial) solo necesita este endpoint para captar el interés; el resto del proceso lo hace el equipo del ISP desde el dashboard.

Consultar el estado de un registro

GET /registros/{id}
{
  "success": true,
  "data": { "id": "reg_7a1b2c", "estado": "aprobado", "instalacionId": "inst_4d3c2b" },
  "timestamp": "2026-08-05T14:00:00.000Z"
}

estado avanza por:

EstadoSignifica
nuevoRecién creado, sin revisar
en_evaluacionEl ISP está validando cobertura y/o crédito
aprobadoListo para generar una instalación — ver Instalaciones
rechazadoNo procede (sin cobertura, crédito rechazado, etc.)

Cuando el registro se aprueba y se agenda la visita técnica, instalacionId queda poblado — a partir de ahí, sigue el estado en Instalaciones.

La aprobación/rechazo de un registro la hace el equipo del ISP desde el dashboard, no tu integración — este endpoint es de solo consulta para que sepas en qué punto va.

On this page