Obtención del Catálogo Comercial - commercialcatalog-v3-get

Información del Servicio

Endpoint: /api/commercialcatalog/v3/get
Método: POST
Versión: v3
Categoría: Catálogo Comercial

Documentación del Servicio

Descripción general

El servicio commercialcatalog-v3-get es un endpoint para obtener el catálogo comercial de planes y servicios adicionales FIJO y MÓVIL. Este servicio permite consultar los planes disponibles y servicios adicionales sugeridos basados en el servicio actual del cliente y filtros aplicados.

Categoría de negocio: Catálogo Comercial.

Casos de uso principales:

Consulta de planes disponibles para venta
Obtención de servicios adicionales sugeridos
Validación de compatibilidad entre servicios
Consulta de ofertas contratadas vs sugeridas

Especificación técnica

Endpoint completo: /api/commercialcatalog/v3/get
Método HTTP: POST
Capas involucradas:
- Controlador: CommercialCatalogController
- Lógica de negocio: CommercialCatalogBusiness
- Acceso a datos: CommercialCatalogUtil2, ServiceUtil2

Flujo de procesamiento:

Validación de entrada y auditoría
Conversión de datos de request
Obtención del origen y configuración
Consulta del servicio por número telefónico
Consulta de servicios incompatibles
Armado de filtros de catálogo
Consulta del catálogo comercial
Asociación de SVAs fijo-móvil
Generación de respuesta

Dependencias principales:

CommercialCatalogUtil2.GetInstance.GetOffer()
ServiceUtil2.GetInstance.GetByPhone()
ConfigurationUtil.GetInstance.Get_Origin()
AuditUtil.GetInstance.Save_Request_Async()

Consideraciones de seguridad:

Validación de headers de autenticación
Auditoría de todas las peticiones
Validación de origen del sistema
Control de acceso por configuración

Parámetros de entrada (Request)

Headers

Campo	Tipo	Obligatorio	Descripción
WSRequestHeader	object	Sí	Cabecera de la petición con información del sistema

Body

Campo	Tipo	Obligatorio	Descripción
Audit	object	No	Auditoría de la petición
Filter	object	No	Filtros aplicables para el catálogo
Phone	string	No	Número de conexión
Plan	string	No	Número de agrupación del plan a consultar
Profiling	object	No	Filtrado en base a las preferencias del cliente
SVA	string	No	Número de agrupación del SVA a consultar

Estructura de objetos anidados:

Estructura de WSRequestHeader

Campo	Tipo	Obligatorio	Descripción
System	object	No	Información asociada al sistema
Property	array	No	Propiedades asociadas al consumo del servicio web

Estructura de WSRequestHeader.System

Campo	Tipo	Obligatorio	Descripción
Name	string	Sí	Nombre del sistema
CorrelationID	string	Sí	Identificador de la petición
ProcessingServer	string	Sí	Servidor de procesamiento del sistema

Estructura de WSRequestHeader.Property

Campo	Tipo	Obligatorio	Descripción
Name	string	Sí	Nombre de la propiedad
Value	string	Sí	Valor de la propiedad

Estructura de Audit

Campo	Tipo	Obligatorio	Descripción
Browser	string	No	Navegador de la petición
Browser_Id	string	No	Id del navegador
Browser_InputType	string	No	Tipo de input
Browser_Platform	string	No	Plataforma del navegador
Browser_Version	string	No	Versión del navegador
Encoding	string	No	Encoding de la petición
IP	string	No	IP de la petición
IP_X	string	No	IP de las server variables
IPs	array	No	Listado de IPs
MiETB_User	string	No	Id del usuario de MiETB
URL	string	No	URL de la petición
URL_Referrer	string	No	URL de referencia
User_Agent	string	No	Agente de usuario
User_Name	string	No	Nombre del usuario

Estructura de Filter

Campo	Tipo	Obligatorio	Descripción
Bundle_Type	array	No	Tipo de bundle (SINGLE, DUO, TRIO, PREPAGO, POSPAGO)
Order_Type	string	No	Tipo de orden (Venta, Cambio de Plan, Cambio de Tecnologia, Traslado)
Stratum	int	No	Estrato
UEN	string	No	UEN (Hogares, MiPymes)
Technology	string	No	Tecnología (FTTH, FTTC, COBRE, LTE)
Zone	string	No	Zona (01, 02, 03, 04...)

Estructura de Profiling

Campo	Tipo	Obligatorio	Descripción
Floors_House	string	No	Cantidad de pisos que tiene el hogar
Hobbies	array	No	Intereses del cliente
Hours_Entertainment	string	No	Tiempo de uso de internet para el entretenimiento
Hours_Study	string	No	Tiempo de uso de internet para el estudio
Hours_Work	string	No	Tiempo de uso de internet para el trabajo
House_Size	string	No	Tamaño en metros cuadrados del hogar
Number_Of_Devices	string	No	Número de dispositivos conectados

Respuesta esperada (Response)

Headers

Campo	Tipo	Obligatorio	Descripción
WSResponseHeader	object	Sí	Cabecera de la respuesta con información del sistema

Body

Campo	Tipo	Obligatorio	Descripción
Contracted	object	No	Oferta actual del servicio
Suggested	object	No	Oferta sugerida en base al servicio y/o los filtros

Estructura de objetos anidados:

Estructura de WSResponseHeader

Campo	Tipo	Obligatorio	Descripción
System	object	No	Información asociada al sistema
Service	object	No	Información asociada a la ejecución del servicio
Property	array	No	Arreglo de propiedades asociado al servicio

Estructura de WSResponseHeader.System

Campo	Tipo	Obligatorio	Descripción
Name	string	No	Nombre del sistema
CorrelationID	string	No	Identificador de la petición
ProcessingServer	string	No	Servidor de procesamiento del sistema

Estructura de WSResponseHeader.Service

Campo	Tipo	Obligatorio	Descripción
Status	string	No	Estado de la ejecución del servicio web
ResponseDate	DateTime	No	Fecha de la respuesta
ProcessingServer	string	No	Servidor de procesamiento de la solicitud
StatusDetail	array	No	Detalle del procesamiento de la solicitud

Estructura de WSResponseHeader.Property

Campo	Tipo	Obligatorio	Descripción
Name	string	No	Nombre de la propiedad
Value	string	No	Valor de la propiedad

Estructura de Contracted

Campo	Tipo	Obligatorio	Descripción
Plan	object	No	Plan contratado
SVAs	array	No	SVAs contratados
Execution_Plan	array	No	Plan ejecución unificado

Estructura de Contracted.Plan

Campo	Tipo	Obligatorio	Descripción
Available	bool	No	Bandera que determina si el plan se puede adquirir o no
Contracted	bool	No	Bandera que determina si el plan está contratado o no
Description	array	No	Descripción del plan
Execution_Plan	array	No	Plan de ejecución del plan
Id	string	No	Identificador del plan (también conocido como número de agrupación)
Ids_Packaging	array	No	Lista de identificadores de los planes empaquetados
Installation_Charges	object	No	Costo de la cláusula de permanencia
Is_Packing	bool	No	Determina si el plan es empaquetado o no
Is_Zoned	bool	No	Es true si el plan es zonificado
Name	string	No	Nombre del plan
Name_Technical	string	No	Nombre del plan técnico
Outstanding	bool	No	Es true si el plan es destacado
Price	object	No	Precio del plan
Retencion	bool	No	Bandera que indica si es plan de Fidelización / Retención
Saving	double	No	El total de ahorro
Saving_Str	string	No	El total de ahorro en formato string
Stratum	string	No	Estrato asociado al plan
SubType	string	No	Subtipo de filtro : Internet, Telefonía y Television
SVAs_Featured	array	No	SVAs promocionados con el plan
SVAs_Included	array	No	SVAs incluidos con el plan
Technology	string	No	Tecnología asociada al plan
Type	string	No	Tipo de plan : DUO, SINGLE o TRIO
Value	double	No	Valor del plan
Value_Str	string	No	Valor del plan en formato string
Zoned	object	No	Localidades sobre el cuál aplica el plan (en caso de ser zonificado)
Home	object	No	Información del plan fijo (Hogar - Negocio)
Mobile	object	No	Información del plan LTE
Promotions	array	No	Promociones asociadas al plan

Estructura de Contracted.SVAs

Campo	Tipo	Obligatorio	Descripción
Available	bool	No	Bandera que determina si el servicio adicional se puede adquirir o no
Description	string	No	Descripción del SVA
Characteristics	array	No	Características del SVA
Conflicting	array	No	SVAs incompatibles
Contracted	bool	No	Bandera que determina si el servicio ya se encuentra o no contratado
Execution_Plan	array	No	Plan de ejecución del servicio adicional
Execution_Plan_Differential	array	No	Plan de ejecución diferencial del servicio adicional
Icon	string	No	Icono asociado al servicio adicional
Id	string	No	Identificador del SVA
Mobile	object	No	Información del plan LTE asociado
Promotions	array	No	Promociones asociadas al servicio adicional
Sub_SVAs	array	No	Sub SVAs seleccionados asociados al SVA principal

Estructura de Suggested

Campo	Tipo	Obligatorio	Descripción
Plans	array	No	Planes sugeridos
SVAs	array	No	SVAs sugeridos

Estructura de Suggested.Plans

Campo	Tipo	Obligatorio	Descripción
Available	bool	No	Bandera que determina si el plan se puede adquirir o no
Contracted	bool	No	Bandera que determina si el plan está contratado o no
Description	array	No	Descripción del plan
Execution_Plan	array	No	Plan de ejecución del plan
Id	string	No	Identificador del plan (también conocido como número de agrupación)
Ids_Packaging	array	No	Lista de identificadores de los planes empaquetados
Installation_Charges	object	No	Costo de la cláusula de permanencia
Is_Packing	bool	No	Determina si el plan es empaquetado o no
Is_Zoned	bool	No	Es true si el plan es zonificado
Name	string	No	Nombre del plan
Name_Technical	string	No	Nombre del plan técnico
Outstanding	bool	No	Es true si el plan es destacado
Price	object	No	Precio del plan
Retencion	bool	No	Bandera que indica si es plan de Fidelización / Retención
Saving	double	No	El total de ahorro
Saving_Str	string	No	El total de ahorro en formato string
Stratum	string	No	Estrato asociado al plan
SubType	string	No	Subtipo de filtro : Internet, Telefonía y Television
SVAs_Featured	array	No	SVAs promocionados con el plan
SVAs_Included	array	No	SVAs incluidos con el plan
Technology	string	No	Tecnología asociada al plan
Type	string	No	Tipo de plan : DUO, SINGLE o TRIO
Value	double	No	Valor del plan
Value_Str	string	No	Valor del plan en formato string
Zoned	object	No	Localidades sobre el cuál aplica el plan (en caso de ser zonificado)
Home	object	No	Información del plan fijo (Hogar - Negocio)
Mobile	object	No	Información del plan LTE
Promotions	array	No	Promociones asociadas al plan

Estructura de Suggested.SVAs

Campo	Tipo	Obligatorio	Descripción
Available	bool	No	Bandera que determina si el servicio adicional se puede adquirir o no
Description	string	No	Descripción del SVA
Characteristics	array	No	Características del SVA
Conflicting	array	No	SVAs incompatibles
Contracted	bool	No	Bandera que determina si el servicio ya se encuentra o no contratado
Execution_Plan	array	No	Plan de ejecución del servicio adicional
Execution_Plan_Differential	array	No	Plan de ejecución diferencial del servicio adicional
Icon	string	No	Icono asociado al servicio adicional
Id	string	No	Identificador del SVA
Mobile	object	No	Información del plan LTE asociado
Promotions	array	No	Promociones asociadas al servicio adicional
Sub_SVAs	array	No	Sub SVAs seleccionados asociados al SVA principal

Manejo de errores

Código	Descripción	Ejemplo
ERROR_02	Error al obtener el origen de la petición	Configuración de origen no encontrada
ERROR_04	Error en la conversión de datos	Datos de entrada inválidos
ERROR_06	Servicio no encontrado	El número telefónico no existe
ERROR_11	Error en el armado del filtro	Filtros incompatibles

Análisis de Componentes

Modelos y componentes

Modelos base utilizados:

BaseRequestGet_v3
BaseResponseGet_v3
GetRequest_v3
GetResponse_v3

Utilidades y servicios comunes:

CommercialCatalogUtil2
ServiceUtil2
ConfigurationUtil
AuditUtil

Patrones de diseño implementados:

Singleton pattern para utilidades
Factory pattern para creación de filtros
Strategy pattern para diferentes tipos de consulta

Componentes reutilizados:

BotBaseRequestHeader
BotBaseResponseHeader
Audit
Filter

Referencias cruzadas:

ServiceUtil2 para consulta de servicios
CommercialCatalogUtil2 para catálogo
ConfigurationUtil para configuración

Ejemplos de Request/Response

Solicitud (request)

json

{
  "WSRequestHeader": {
    "System": {
      "name": "MAX",
      "correlationID": "LUZ-0.8647177104442874",
      "processingServer": null
    },
    "Property": []
  },
  "WSRequestBody": {
    "Filter": {
      "Bundle_Type": null,
      "Order_Type": "Cambio de plan",
      "Stratum": null,
      "UEN": null,
      "Technology": null,
      "Zone": null
    },
    "Phone": "6017123585",
    "Plan": null,
    "Profiling": null,
    "SVA": null,
    "Audit": {
      "Canal": null,
      "Date": "2025-07-31",
      "Hour": "20:06:37"
    }
  }
}

Respuesta exitosa

json

{
  "WSResponseHeader": {
    "System": {
      "name": "MAX",
      "correlationID": "LUZ-0.8647177104442874",
      "processingServer": null
    },
    "Service": {
      "status": "OK",
      "responseDate": "2025-07-31T20:06:38.0695959Z",
      "processingServer": null,
      "statusDetail": [
        {
          "errorCode": "OK_01",
          "errorDetailCode": "Se consultaron disponibles en el catalogo comercial",
          "errorMessage": "La solicitud LUZ-0.8647177104442874 fue exitosa",
          "errorMessageUser": null
        }
      ]
    },
    "Property": []
  },
  "WSResponseBody": {
    "Suggested": {
      "Plans": [
        {
          "Home": {
            "Internet": {
              "Capacity": null,
              "Descent_Speed": {
                "Description": "910M",
                "Unity": "M",
                "Value": "910"
              },
              "Is_Twin": true,
              "Secundary": [
                {
                  "Count": null,
                  "Desc": "IP Dinámica",
                  "Description": "IP Dinámica",
                  "Icon": "",
                  "Name": "IP DINÁMICA",
                  "Type": "Secundario"
                }
              ],
              "Shared_Capacity": null,
              "Upload_Speed": {
                "Description": "910M",
                "Unity": "M",
                "Value": "910"
              }
            },
            "TV": {
              "Channels": null,
              "Number_Of_Channels": 117,
              "Plan_Type": "PLUS",
              "Secundary": [
                {
                  "Count": null,
                  "Desc": "Decodificador incluido con tu plan",
                  "Description": "Decodificador incluido con tu plan",
                  "Icon": "https://strmietb.blob.core.windows.net/imagenes/flujocomercial/DECO/img-logo-deco.svg",
                  "Name": "DECODIFICADOR 1",
                  "Type": "SVA"
                }
              ]
            },
            "Voice": null
          },
          "Mobile": null,
          "Promotions": [],
          "Available": false,
          "Contracted": false,
          "Description": [
            "Con el internet de ETB tu podrás tener:",
            "Mejor velocidad y más seguridad",
            "Conexión estable para que navegues con tranquilidad",
            "Además tendrás telefonía local ilimitada, Transferencia de llamada incondicional, ocupado y de no contestación – Llamada en espera – identificador de llamadas – identificador de segunda llamada –conexión sin marcar –marcación abreviada – conferencia entre tres – llamada de recordación"
          ],
          "Execution_Plan": [
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 1,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 2,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 3,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 4,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 5,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 6,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 7,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 8,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 9,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 10,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 11,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            },
            {
              "Features": [
                {
                  "Description": "Paga el valor original de tu plan DUO 910M TV PLUS $ 249,899",
                  "Differential": false,
                  "Discount": false,
                  "Outstanding": false,
                  "Type": "Plan"
                }
              ],
              "Month": 12,
              "Saving": null,
              "Saving_Str": null,
              "State": null,
              "Value": 249899,
              "Value_Str": "$ 249.899"
            }
          ],
          "Id": "6783",
          "Ids_Packaging": null,
          "Installation_Charges": {
            "Accept_Permanence_Clause": null,
            "Installation_Charges_Internet": 750000,
            "Installation_Charges_Tv": 0,
            "Installation_Charges_Voice": null,
            "Total": 1500000
          },
          "Is_Packing": false,
          "Is_Zoned": false,
          "Name": "DUO 910M TV PLUS",
          "Name_Technical": "DUO 910M TV PLUS HOG V2",
          "Outstanding": false,
          "Price": {
            "Anticipated_Payment": false,
            "IVA": 0,
            "Value": 249899,
            "Value_Str": "$ 249.899",
            "Value_Without_IVA": 249899,
            "Value_Without_IVA_Str": "$ 249.899",
            "Validity": "Cargo fijo mensual"
          },
          "Retencion": false,
          "Saving": 0,
          "Saving_Str": "$ 0",
          "Stratum": null,
          "SubType": "Internet + Televisión",
          "SVAs_Featured": null,
          "SVAs_Included": [
            {
              "Id": "4496",
              "Mandatory": false
            }
          ],
          "Technology": "FTTH",
          "Type": "DUO",
          "Value": 249899,
          "Value_Str": "$ 249.899",
          "Zoned": null
        }
      ]
    }
  }
}

Respuesta de error

json

{
  "WSResponseHeader": {
    "System": {
      "name": "MiETB",
      "correlationID": "123456789",
      "processingServer": "SRV-001"
    },
    "Service": {
      "status": "ERROR",
      "responseDate": "2024-12-19T10:30:00Z",
      "processingServer": "SRV-001",
      "statusDetail": [
        {
          "errorCode": "ERROR_06",
          "errorMessage": "Servicio no encontrado",
          "errorMessageUser": "El número telefónico no existe en nuestros registros"
        }
      ]
    }
  },
  "WSResponseBody": null
}

Diagramas Técnicos

3.1 Flujo de datos

mermaid

graph TD
  A[Recepción de la solicitud] --> B[CommercialCatalogController]
  B --> C[CommercialCatalogBusiness]
  C --> D[Validación y Auditoría]
  D --> E[Conversión de datos]
  E --> F[Obtención del origen]
  F --> G[Consulta del servicio]
  G --> H[Consulta de incompatibles]
  H --> I[Armado del filtro]
  I --> J[Consulta del catálogo]
  J --> K[Asociación SVAs]
  K --> L[Generación de respuesta]

3.2 Arquitectura de clases

mermaid

classDiagram
  class CommercialCatalogController {
    +Get_v3(BaseRequestGet_v3)
  }
  class CommercialCatalogBusiness {
    +Get_v3(BaseRequest, string)
  }
  class CommercialCatalogUtil2 {
    +GetOffer(Origin, Service, Filter)
    +FillFilter(Origin, Service, Services)
  }
  class ServiceUtil2 {
    +GetByPhone(Origin, Phone, Filter)
    +GetByCustomer(Origin, DocType, DocNumber, Filter)
  }
  CommercialCatalogController --> CommercialCatalogBusiness
  CommercialCatalogBusiness --> CommercialCatalogUtil2
  CommercialCatalogBusiness --> ServiceUtil2

3.3 Secuencia de ejecución

mermaid

sequenceDiagram
  participant Cliente
  participant Controller
  participant Business
  participant ServiceUtil
  participant CatalogUtil
  participant ConfigUtil
  participant AuditUtil
  
  Cliente->>Controller: POST /api/commercialcatalog/v3/get
  Controller->>Business: Get_v3(request)
  Business->>AuditUtil: Save_Request_Async()
  Business->>ConfigUtil: Get_Origin()
  Business->>ServiceUtil: GetByPhone()
  Business->>ServiceUtil: GetByCustomer()
  Business->>CatalogUtil: FillFilter()
  Business->>CatalogUtil: GetOffer()
  Business-->>Controller: BaseResponseGet_v3
  Controller-->>Cliente: Response

Políticas y Consideraciones

Políticas de seguridad

Mecanismos de autenticación y autorización:

Validación de headers de autenticación (Authorization)
Control de acceso por sistema de origen
Validación de IP y canal de acceso

Validaciones de seguridad implementadas:

Auditoría completa de todas las peticiones
Validación de datos de entrada
Control de acceso por configuración de API

Límites de tasa (rate limits):

Control por sistema de origen
Límites configurados por endpoint
Monitoreo de uso por CorrelationID

SLAs aplicables:

Tiempo de respuesta: < 2 segundos
Disponibilidad: 99.9%
Tolerancia a fallos: Circuit breaker implementado

Recomendaciones y mejores prácticas

Puntos de mejora específicos en el código:

Implementar cache para consultas frecuentes del catálogo
Optimizar consultas de servicios incompatibles
Agregar validación de filtros más robusta
Implementar paginación para grandes volúmenes de datos

Optimizaciones posibles:

Cache de catálogo comercial en Redis
Consultas paralelas para servicios incompatibles
Compresión de respuesta para grandes catálogos
Implementación de streaming para respuestas grandes

Consideraciones de mantenimiento importantes:

Monitoreo de performance del catálogo
Actualización automática de filtros
Backup de configuración de catálogo
Versionado de cambios en catálogo

Sugerencias de seguridad aplicables:

Implementar rate limiting más granular
Agregar validación de entrada más estricta
Implementar logging de auditoría más detallado
Agregar monitoreo de anomalías en consultas

Obtención del Catálogo Comercial - commercialcatalog-v3-get ​

Documentación del Servicio ​

Descripción general ​

Especificación técnica ​

Parámetros de entrada (Request) ​

Headers ​

Body ​

Estructura de WSRequestHeader ​

Estructura de WSRequestHeader.System ​

Estructura de WSRequestHeader.Property ​

Estructura de Audit ​

Estructura de Filter ​

Estructura de Profiling ​

Respuesta esperada (Response) ​

Headers ​

Body ​

Estructura de WSResponseHeader ​

Estructura de WSResponseHeader.System ​

Estructura de WSResponseHeader.Service ​

Estructura de WSResponseHeader.Property ​

Estructura de Contracted ​

Estructura de Contracted.Plan ​

Estructura de Contracted.SVAs ​

Estructura de Suggested ​

Estructura de Suggested.Plans ​

Estructura de Suggested.SVAs ​

Manejo de errores ​

Análisis de Componentes ​

Modelos y componentes ​

Ejemplos de Request/Response ​

Solicitud (request) ​

Respuesta exitosa ​

Respuesta de error ​

Diagramas Técnicos ​

3.1 Flujo de datos ​

3.2 Arquitectura de clases ​

3.3 Secuencia de ejecución ​

Políticas y Consideraciones ​

Políticas de seguridad ​

Recomendaciones y mejores prácticas ​

Obtención del Catálogo Comercial - commercialcatalog-v3-get

Documentación del Servicio

Descripción general

Especificación técnica

Parámetros de entrada (Request)

Headers

Body

Estructura de WSRequestHeader

Estructura de WSRequestHeader.System

Estructura de WSRequestHeader.Property

Estructura de Audit

Estructura de Filter

Estructura de Profiling

Respuesta esperada (Response)

Headers

Body

Estructura de WSResponseHeader

Estructura de WSResponseHeader.System

Estructura de WSResponseHeader.Service

Estructura de WSResponseHeader.Property

Estructura de Contracted

Estructura de Contracted.Plan

Estructura de Contracted.SVAs

Estructura de Suggested

Estructura de Suggested.Plans

Estructura de Suggested.SVAs

Manejo de errores

Análisis de Componentes

Modelos y componentes

Ejemplos de Request/Response

Solicitud (request)

Respuesta exitosa

Respuesta de error

Diagramas Técnicos

3.1 Flujo de datos

3.2 Arquitectura de clases

3.3 Secuencia de ejecución

Políticas y Consideraciones

Políticas de seguridad

Recomendaciones y mejores prácticas