{"openapi":"3.1.0","info":{"title":"RiverOLT — API externa","description":"\nAPI de RiverOLT para software de terceros.\n\n- **Autenticación:** `Authorization: Bearer rolt_…` con una clave de **Administración >\n  Integraciones**. Tocá **Authorize** y pegala. Cada clave ve solo los datos de su empresa.\n- **Consultas** (cualquier clave): lo último que RiverOLT guardó de las OLTs y ONUs. No\n  consultan los equipos en vivo.\n- **Gestión de ONUs** (clave de **Lectura y escritura**): autorizar con perfil y VLAN,\n  habilitar, deshabilitar, desautorizar, reemplazar y reiniciar. **Escriben en la OLT.** Los\n  valores se validan contra lo que admite cada OLT (`GET /olts/{olt_id}/service-options`). Cada\n  pedido queda en la auditoría de RiverOLT con el usuario de la clave.\n- **Clientes de facturación** (clave de Lectura y escritura): alta por id externo, asignación de\n  ONUs y suspensión o reactivación de todas las ONUs de un cliente.\n- **Límite:** consultas por minuto por clave (`X-RateLimit-Limit` / `X-RateLimit-Remaining`);\n  al superarlo responde 429 con `Retry-After`.\n- **Errores:** `{\"detail\": \"...\", \"code\": \"...\"}` y, según el caso, `allowed` (valores que admite\n  la OLT) o `errors` (campos inválidos).\n","version":"1.0.0"},"servers":[{"url":"/"}],"paths":{"/api/external/v1/me":{"get":{"tags":["API externa v1"],"summary":"Datos de la clave usada","operationId":"key_info_api_external_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalKeyInfo"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}},"security":[{"IntegrationKey":[]}]}},"/api/external/v1/summary":{"get":{"tags":["API externa v1"],"summary":"Resumen de OLTs, ONUs y alarmas","operationId":"summary_api_external_v1_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSummary"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}},"security":[{"IntegrationKey":[]}]}},"/api/external/v1/olts":{"get":{"tags":["API externa v1"],"summary":"OLTs","operationId":"list_olts_api_external_v1_olts_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filtra por estado (online, offline…).","title":"Status"},"description":"Filtra por estado (online, offline…)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Cantidad máxima de resultados (1 a 500).","default":100,"title":"Limit"},"description":"Cantidad máxima de resultados (1 a 500)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Resultados a saltear, para paginar.","default":0,"title":"Offset"},"description":"Resultados a saltear, para paginar."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ExternalOLT_"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/olts/{olt_id}":{"get":{"tags":["API externa v1"],"summary":"Una OLT","operationId":"get_olt_api_external_v1_olts__olt_id__get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"olt_id","in":"path","required":true,"schema":{"type":"string","title":"Olt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOLT"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/olts/{olt_id}/pons":{"get":{"tags":["API externa v1"],"summary":"Puertos PON de una OLT","operationId":"list_pons_api_external_v1_olts__olt_id__pons_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"olt_id","in":"path","required":true,"schema":{"type":"string","title":"Olt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExternalPON"},"title":"Response List Pons Api External V1 Olts  Olt Id  Pons Get"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/olts/{olt_id}/onus":{"get":{"tags":["API externa v1"],"summary":"ONUs de una OLT","operationId":"list_olt_onus_api_external_v1_olts__olt_id__onus_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"olt_id","in":"path","required":true,"schema":{"type":"string","title":"Olt Id"}},{"name":"pon","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Número de puerto PON.","title":"Pon"},"description":"Número de puerto PON."},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Cantidad máxima de resultados (1 a 500).","default":100,"title":"Limit"},"description":"Cantidad máxima de resultados (1 a 500)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Resultados a saltear, para paginar.","default":0,"title":"Offset"},"description":"Resultados a saltear, para paginar."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ExternalONU_"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/onus":{"get":{"tags":["API externa v1"],"summary":"ONUs, con filtros","operationId":"list_onus_api_external_v1_onus_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"olt_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Olt Id"}},{"name":"pon","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Pon"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"serial","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Parte del serial.","title":"Serial"},"description":"Parte del serial."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Cantidad máxima de resultados (1 a 500).","default":100,"title":"Limit"},"description":"Cantidad máxima de resultados (1 a 500)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Resultados a saltear, para paginar.","default":0,"title":"Offset"},"description":"Resultados a saltear, para paginar."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ExternalONU_"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/onus/{onu_id}":{"get":{"tags":["API externa v1"],"summary":"Una ONU","operationId":"get_onu_api_external_v1_onus__onu_id__get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalONU"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/onus/{onu_id}/history":{"get":{"tags":["API externa v1"],"summary":"Historial de una ONU","operationId":"onu_history_api_external_v1_onus__onu_id__history_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExternalONUEvent"},"title":"Response Onu History Api External V1 Onus  Onu Id  History Get"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/alarms":{"get":{"tags":["API externa v1"],"summary":"Alarmas de caídas por PON","operationId":"list_alarms_api_external_v1_alarms_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"active, acknowledged o resolved.","title":"Status"},"description":"active, acknowledged o resolved."},{"name":"olt_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Olt Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Cantidad máxima de resultados (1 a 500).","default":100,"title":"Limit"},"description":"Cantidad máxima de resultados (1 a 500)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Resultados a saltear, para paginar.","default":0,"title":"Offset"},"description":"Resultados a saltear, para paginar."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ExternalAlarm_"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/olts/{olt_id}/service-options":{"get":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Perfiles y VLANs que admite la OLT","operationId":"service_options_api_external_v1_olts__olt_id__service_options_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"olt_id","in":"path","required":true,"schema":{"type":"string","title":"Olt Id"}},{"name":"pon","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":128,"minimum":1},{"type":"null"}],"description":"Puerto PON (algunos servicios dependen del PON).","title":"Pon"},"description":"Puerto PON (algunos servicios dependen del PON)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalServiceCatalog"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/pending-onus":{"get":{"tags":["API externa v1 — gestión de ONUs"],"summary":"ONUs pendientes de autorización","operationId":"list_pending_onus_api_external_v1_pending_onus_get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"olt_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Olt Id"}},{"name":"pon","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Pon"}},{"name":"serial","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Parte del serial.","title":"Serial"},"description":"Parte del serial."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Cantidad máxima de resultados (1 a 500).","default":100,"title":"Limit"},"description":"Cantidad máxima de resultados (1 a 500)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Resultados a saltear, para paginar.","default":0,"title":"Offset"},"description":"Resultados a saltear, para paginar."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ExternalPendingONU_"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external/v1/pending-onus/{pending_id}/authorize":{"post":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Autorizar y habilitar una ONU pendiente, con perfil y VLAN","operationId":"authorize_onu_api_external_v1_pending_onus__pending_id__authorize_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"pending_id","in":"path","required":true,"schema":{"type":"string","title":"Pending Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizeRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"202":{"description":"La OLT todavía no la confirmó.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}}}}},"/api/external/v1/onus/{onu_id}/enable":{"post":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Habilitar una ONU","operationId":"enable_onu_api_external_v1_onus__onu_id__enable_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}}},"/api/external/v1/onus/{onu_id}/disable":{"post":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Deshabilitar una ONU (sigue autorizada)","operationId":"disable_onu_api_external_v1_onus__onu_id__disable_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}}},"/api/external/v1/onus/{onu_id}/reboot":{"post":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Reiniciar una ONU","operationId":"reboot_onu_api_external_v1_onus__onu_id__reboot_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}}},"/api/external/v1/onus/{onu_id}/deauthorize":{"post":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Desautorizar una ONU (se borra de la OLT; el inventario la conserva)","operationId":"deauthorize_onu_api_external_v1_onus__onu_id__deauthorize_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}}},"/api/external/v1/onus/{onu_id}/replace":{"post":{"tags":["API externa v1 — gestión de ONUs"],"summary":"Reemplazar una ONU por otra (cambio de equipo con otro serial)","operationId":"replace_onu_api_external_v1_onus__onu_id__replace_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalReplaceResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"202":{"description":"La ONU nueva aún no se confirmó; la anterior no se tocó.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalReplaceResult"}}}}}}},"/api/external/v1/clients/external/{source}/{external_id}":{"get":{"tags":["API externa v1 — clientes (facturación)"],"summary":"Un cliente por su id en facturación, con sus ONUs","operationId":"get_client_api_external_v1_clients_external__source___external_id__get","security":[{"IntegrationKey":[]}],"parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,39}$","description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado.","title":"Source"},"description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado."},{"name":"external_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Id del cliente en ese sistema.","title":"External Id"},"description":"Id del cliente en ese sistema."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClient"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["API externa v1 — clientes (facturación)"],"summary":"Crear o actualizar un cliente por su id en facturación","operationId":"upsert_client_api_external_v1_clients_external__source___external_id__put","security":[{"IntegrationKey":[]}],"parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,39}$","description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado.","title":"Source"},"description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado."},{"name":"external_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Id del cliente en ese sistema.","title":"External Id"},"description":"Id del cliente en ese sistema."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClientUpsert"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClient"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"201":{"description":"Cliente creado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClient"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}}},"/api/external/v1/onus/{onu_id}/client":{"put":{"tags":["API externa v1 — clientes (facturación)"],"summary":"Asignar una ONU a un cliente de facturación","operationId":"assign_client_api_external_v1_onus__onu_id__client_put","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientRef"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}},"delete":{"tags":["API externa v1 — clientes (facturación)"],"summary":"Quitar el cliente de una ONU","operationId":"unassign_client_api_external_v1_onus__onu_id__client_delete","security":[{"IntegrationKey":[]}],"parameters":[{"name":"onu_id","in":"path","required":true,"schema":{"type":"string","title":"Onu Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalOperationResult"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}}}}},"/api/external/v1/clients/external/{source}/{external_id}/suspend":{"post":{"tags":["API externa v1 — clientes (facturación)"],"summary":"Suspender un cliente: deshabilita todas sus ONUs (por ejemplo, falta de pago)","operationId":"suspend_client_api_external_v1_clients_external__source___external_id__suspend_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,39}$","description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado.","title":"Source"},"description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado."},{"name":"external_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Id del cliente en ese sistema.","title":"External Id"},"description":"Id del cliente en ese sistema."}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SuspendRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClientOperation"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"207":{"description":"Alguna ONU no se pudo deshabilitar.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClientOperation"}}}}}}},"/api/external/v1/clients/external/{source}/{external_id}/reactivate":{"post":{"tags":["API externa v1 — clientes (facturación)"],"summary":"Reactivar un cliente: habilita todas sus ONUs","operationId":"reactivate_client_api_external_v1_clients_external__source___external_id__reactivate_post","security":[{"IntegrationKey":[]}],"parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,39}$","description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado.","title":"Source"},"description":"Sistema dueño del id (por ejemplo `facturacion`). `local` está reservado."},{"name":"external_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Id del cliente en ese sistema.","title":"External Id"},"description":"Id del cliente en ese sistema."}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SuspendRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClientOperation"}}}},"401":{"description":"Falta la clave, no es válida, fue revocada o venció.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"403":{"description":"La clave es de solo lectura o la empresa no está activa.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"429":{"description":"Se superó el límite de consultas por minuto (ver `Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"404":{"description":"No existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"409":{"description":"La OLT o la ONU no permiten la operación ahora (ver `code`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"422":{"description":"Un valor no es válido o la OLT no lo admite (ver `allowed`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"502":{"description":"La OLT no respondió o rechazó el comando.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRead"}}}},"207":{"description":"Alguna ONU no se pudo habilitar.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalClientOperation"}}}}}}}},"components":{"schemas":{"AuthorizeRequest":{"properties":{"description":{"type":"string","maxLength":255,"minLength":1,"title":"Description","description":"Nombre de la ONU en la OLT (por ejemplo, el cliente)."},"service":{"$ref":"#/components/schemas/ServiceRequest"},"onu_number":{"anyOf":[{"type":"integer","maximum":128.0,"minimum":1.0},{"type":"null"}],"title":"Onu Number","description":"ONU ID; si falta, el menor libre."},"client_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Client Id","description":"Cliente de RiverOLT al que se asigna."},"client":{"anyOf":[{"$ref":"#/components/schemas/ClientRef"},{"type":"null"}],"description":"O el cliente por su id en facturación (en vez de `client_id`)."},"enabled":{"type":"boolean","title":"Enabled","description":"false: queda autorizada pero deshabilitada.","default":true}},"type":"object","required":["description","service"],"title":"AuthorizeRequest"},"ClientONUResult":{"properties":{"onu_id":{"type":"string","title":"Onu Id"},"serial_number":{"type":"string","title":"Serial Number"},"result":{"type":"string","title":"Result","description":"`done`, `unchanged` (ya estaba así) o `error`."},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["onu_id","serial_number","result"],"title":"ClientONUResult"},"ClientRef":{"properties":{"source":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,39}$","title":"Source","description":"Sistema dueño del id (por ejemplo `facturacion`)."},"external_id":{"type":"string","maxLength":120,"minLength":1,"title":"External Id","description":"Id del cliente en ese sistema."}},"type":"object","required":["source","external_id"],"title":"ClientRef"},"ErrorRead":{"properties":{"detail":{"type":"string","title":"Detail"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code","description":"Código estable del error (por ejemplo, `api_key_invalid`)."},"allowed":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Allowed","description":"Valores que sí admite la OLT, cuando el error es por un valor."},"errors":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Errors","description":"Campos inválidos (`validation_error`)."}},"type":"object","required":["detail"],"title":"ErrorRead"},"ExternalAlarm":{"properties":{"id":{"type":"string","title":"Id"},"alarm_type":{"type":"string","title":"Alarm Type"},"severity":{"type":"string","title":"Severity"},"status":{"type":"string","title":"Status"},"olt_id":{"type":"string","title":"Olt Id"},"pon_port":{"type":"integer","title":"Pon Port"},"total_onus":{"type":"integer","title":"Total Onus"},"offline_onus":{"type":"integer","title":"Offline Onus"},"offline_ratio":{"type":"number","title":"Offline Ratio"},"message":{"type":"string","title":"Message"},"cause":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cause"},"detected_at":{"type":"string","format":"date-time","title":"Detected At"},"acknowledged_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Acknowledged At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","alarm_type","severity","status","olt_id","pon_port","total_onus","offline_onus","offline_ratio","message","cause","detected_at","acknowledged_at","resolved_at"],"title":"ExternalAlarm"},"ExternalClient":{"properties":{"id":{"type":"string","title":"Id","description":"Id del cliente en RiverOLT."},"source":{"type":"string","title":"Source"},"external_id":{"type":"string","title":"External Id"},"name":{"type":"string","title":"Name"},"document":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"pppoe_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pppoe Username"},"service_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Plan"},"billing_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Status","description":"`active` o `suspended`, según la última suspensión o reactivación."},"status":{"type":"string","title":"Status"},"last_external_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last External Sync At"},"onus":{"items":{"$ref":"#/components/schemas/ExternalONU"},"type":"array","title":"Onus"}},"type":"object","required":["id","source","external_id","name","document","phone","email","address","pppoe_username","service_plan","billing_status","status","last_external_sync_at"],"title":"ExternalClient"},"ExternalClientOperation":{"properties":{"operation":{"type":"string","title":"Operation"},"state":{"type":"string","title":"State","description":"`done` si todas las ONUs quedaron como se pidió; `partial` si alguna falló."},"message":{"type":"string","title":"Message"},"client":{"$ref":"#/components/schemas/ExternalClient"},"onus":{"items":{"$ref":"#/components/schemas/ClientONUResult"},"type":"array","title":"Onus"}},"type":"object","required":["operation","state","message","client","onus"],"title":"ExternalClientOperation"},"ExternalClientUpsert":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"document":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Document"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"email":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Email"},"address":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Address"},"pppoe_username":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Pppoe Username"},"service_plan":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Service Plan","description":"Nombre del plan en facturación (informativo)."}},"type":"object","required":["name"],"title":"ExternalClientUpsert"},"ExternalKeyInfo":{"properties":{"name":{"type":"string","title":"Name","description":"Nombre del acceso en Integraciones."},"username":{"type":"string","title":"Username","description":"Usuario del acceso: firma la auditoría de lo que hace la clave."},"company_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Id"},"scope":{"type":"string","title":"Scope","description":"`read` (solo lectura) o `read_write`."},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At","description":"null: la clave no vence (solo se revoca)."},"rate_limit_per_minute":{"type":"integer","title":"Rate Limit Per Minute"}},"type":"object","required":["name","username","company_id","scope","expires_at","rate_limit_per_minute"],"title":"ExternalKeyInfo"},"ExternalOLT":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"vendor":{"type":"string","title":"Vendor"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"technology":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Technology"},"status":{"type":"string","title":"Status","description":"Último estado guardado (no se consulta la OLT en vivo)."},"is_active":{"type":"boolean","title":"Is Active"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"pon_port_count":{"type":"integer","title":"Pon Port Count"},"software_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Software Version"},"last_inventory_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Inventory Sync At"},"last_signal_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Signal Sync At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","vendor","model","technology","status","is_active","location","pon_port_count","software_version","last_inventory_sync_at","last_signal_sync_at","updated_at"],"title":"ExternalOLT"},"ExternalONU":{"properties":{"id":{"type":"string","title":"Id"},"olt_id":{"type":"string","title":"Olt Id"},"pon_port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pon Port","description":"Número de puerto PON."},"onu_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Onu Number"},"serial_number":{"type":"string","title":"Serial Number"},"mac_address":{"type":"string","title":"Mac Address"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"rx_power":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rx Power","description":"Potencia recibida en dBm, de la última lectura guardada."},"tx_power":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tx Power"},"signal_last_read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Signal Last Read At"},"distance_m":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Distance M"},"vlan":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vlan"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"last_disconnect_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Disconnect At"},"last_disconnect_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Disconnect Reason"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","olt_id","pon_port","onu_number","serial_number","mac_address","model","description","status","rx_power","tx_power","signal_last_read_at","distance_m","vlan","last_seen_at","last_disconnect_at","last_disconnect_reason","updated_at"],"title":"ExternalONU"},"ExternalONUEvent":{"properties":{"id":{"type":"string","title":"Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"rx_power":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rx Power"},"tx_power":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tx Power"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","event_type","status","message","rx_power","tx_power","created_at"],"title":"ExternalONUEvent"},"ExternalOperationResult":{"properties":{"operation":{"type":"string","title":"Operation"},"state":{"type":"string","title":"State","description":"`done` o `verification_pending` (la OLT aún no lo confirmó: consultá la ONU)."},"message":{"type":"string","title":"Message"},"onu":{"anyOf":[{"$ref":"#/components/schemas/ExternalONU"},{"type":"null"}]},"service":{"anyOf":[{"$ref":"#/components/schemas/ExternalService"},{"type":"null"}]}},"type":"object","required":["operation","state","message","onu"],"title":"ExternalOperationResult"},"ExternalPON":{"properties":{"id":{"type":"string","title":"Id"},"olt_id":{"type":"string","title":"Olt Id"},"slot":{"type":"integer","title":"Slot"},"port":{"type":"integer","title":"Port"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"onu_count":{"type":"integer","title":"Onu Count"},"last_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Sync At"}},"type":"object","required":["id","olt_id","slot","port","name","status","onu_count","last_sync_at"],"title":"ExternalPON"},"ExternalPendingONU":{"properties":{"id":{"type":"string","title":"Id"},"olt_id":{"type":"string","title":"Olt Id"},"pon_port":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pon Port"},"onu_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Onu Number"},"serial_number":{"type":"string","title":"Serial Number"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"rx_power":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rx Power"},"status":{"type":"string","title":"Status"},"detected_at":{"type":"string","format":"date-time","title":"Detected At"}},"type":"object","required":["id","olt_id","pon_port","onu_number","serial_number","model","rx_power","status","detected_at"],"title":"ExternalPendingONU"},"ExternalReplaceResult":{"properties":{"operation":{"type":"string","title":"Operation","default":"replace"},"state":{"type":"string","title":"State"},"message":{"type":"string","title":"Message"},"old_onu":{"$ref":"#/components/schemas/ExternalONU"},"new_onu":{"anyOf":[{"$ref":"#/components/schemas/ExternalONU"},{"type":"null"}]},"service":{"anyOf":[{"$ref":"#/components/schemas/ExternalService"},{"type":"null"}]}},"type":"object","required":["state","message","old_onu","new_onu"],"title":"ExternalReplaceResult"},"ExternalService":{"properties":{"profile":{"type":"string","title":"Profile"},"mode":{"type":"string","title":"Mode","description":"`profile` (perfil de la OLT) o `direct` (VLAN directa)."},"vlan":{"type":"integer","title":"Vlan"},"vlans":{"items":{"type":"integer"},"type":"array","title":"Vlans"},"speed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Speed"},"download_mbps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Download Mbps"},"upload_mbps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Upload Mbps"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["profile","mode","vlan","vlans","speed"],"title":"ExternalService"},"ExternalServiceCatalog":{"properties":{"olt_id":{"type":"string","title":"Olt Id"},"pon":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pon"},"source":{"type":"string","title":"Source","description":"`olt_catalog`: leído de la configuración de la OLT."},"status":{"type":"string","title":"Status","description":"`ready` si se puede escribir; si no, el motivo (`stale`, `unsupported`…)."},"message":{"type":"string","title":"Message"},"speed_selectable":{"type":"boolean","title":"Speed Selectable","description":"false: la velocidad la define el perfil de la OLT."},"services":{"items":{"$ref":"#/components/schemas/ExternalServiceOption"},"type":"array","title":"Services"},"speeds":{"additionalProperties":{"type":"object"},"type":"object","title":"Speeds","description":"Detalle de cada velocidad (Mbps de bajada y subida)."}},"type":"object","required":["olt_id","pon","source","status","message","speed_selectable","services","speeds"],"title":"ExternalServiceCatalog"},"ExternalServiceOption":{"properties":{"profile":{"type":"string","title":"Profile","description":"Valor para `service.profile`."},"label":{"type":"string","title":"Label"},"mode":{"type":"string","title":"Mode"},"vlans":{"items":{"type":"integer"},"type":"array","title":"Vlans","description":"VLANs que admite el perfil."},"speeds":{"items":{"type":"string"},"type":"array","title":"Speeds","description":"Velocidades que admite (vacío: la define la OLT)."}},"type":"object","required":["profile","label","mode","vlans","speeds"],"title":"ExternalServiceOption"},"ExternalSummary":{"properties":{"olts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Olts","description":"OLTs por estado, y `total`."},"onus":{"additionalProperties":{"type":"integer"},"type":"object","title":"Onus","description":"ONUs por estado, y `total`."},"active_alarms":{"type":"integer","title":"Active Alarms"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["olts","onus","active_alarms","generated_at"],"title":"ExternalSummary"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Page_ExternalAlarm_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ExternalAlarm"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Cantidad total con los filtros aplicados."},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"Page[ExternalAlarm]"},"Page_ExternalOLT_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ExternalOLT"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Cantidad total con los filtros aplicados."},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"Page[ExternalOLT]"},"Page_ExternalONU_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ExternalONU"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Cantidad total con los filtros aplicados."},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"Page[ExternalONU]"},"Page_ExternalPendingONU_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ExternalPendingONU"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Cantidad total con los filtros aplicados."},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"Page[ExternalPendingONU]"},"ReplaceRequest":{"properties":{"pending_id":{"type":"string","maxLength":160,"minLength":1,"title":"Pending Id","description":"ONU pendiente (equipo nuevo) que reemplaza a esta."},"description":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Description","description":"Si falta, la de la ONU anterior."},"service":{"anyOf":[{"$ref":"#/components/schemas/ServiceRequest"},{"type":"null"}],"description":"Si falta, el servicio de la ONU anterior."}},"type":"object","required":["pending_id"],"title":"ReplaceRequest"},"ServiceRequest":{"properties":{"profile":{"type":"string","maxLength":160,"minLength":1,"title":"Profile","description":"Perfil de servicio de la OLT (ver `service-options`)."},"vlan":{"anyOf":[{"type":"integer","maximum":4094.0,"minimum":1.0},{"type":"null"}],"title":"Vlan","description":"VLAN del perfil; si falta, la primera que admite."},"speed":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Speed","description":"Debe ir en null: en estas OLTs la velocidad la define el perfil de tráfico (DBA) del servicio."}},"type":"object","required":["profile"],"title":"ServiceRequest"},"SuspendRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Reason","description":"Motivo (por ejemplo, falta de pago). Queda en la auditoría."}},"type":"object","title":"SuspendRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"IntegrationKey":{"type":"http","description":"Clave de Integraciones (`rolt_…`), creada en Administración > Integraciones.","scheme":"bearer"}}}}