ValwispDocs
API

Instalaciones

El paso técnico entre un registro aprobado y un cliente activo.

🟡 Próximamente.

Una instalación conecta un registro ya aprobado con el trabajo real en campo — y es lo único que, al completarse, hace que exista un cliente. No se crea con datos personales sueltos: se crea a partir de un registro que ya los tiene.

Crear una instalación

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

{ "registroId": "reg_7a1b2c" }

Falla con 409 Conflict si el registro todavía no está en estado aprobado.

{
  "success": true,
  "data": { "id": "inst_4d3c2b", "estado": "pendiente" },
  "timestamp": "2026-08-05T14:00:00.000Z"
}

Consultar el estado de una instalación

GET /instalaciones/{id}
{
  "success": true,
  "data": {
    "id": "inst_4d3c2b",
    "estado": "asignada",
    "brigada": "Brigada Este",
    "fechaEstimada": "2026-08-10",
    "clienteId": null
  },
  "timestamp": "2026-08-05T14:00:00.000Z"
}

estado avanza por pendiente → asignada → completada (o cancelada).

Qué pasa al completarse

Cuando la brigada marca la instalación como completada, Valwisp:

  1. Crea el cliente a partir de los datos del registro original.
  2. Activa su servicio de internet con el plan que solicitó.
  3. Puebla clienteId en la respuesta de este mismo endpoint.

Este es el único camino por el que llega a existir un cliente facturable en Valwisp — no hay, ni debe haber, un endpoint que cree un cliente directamente sin que haya pasado antes por un registro y una instalación real. Una vez clienteId está poblado, usa Clientes para consultarlo o gestionarlo.

On this page