> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ámbito y resultados vacíos

> Cómo «scope» y «result_filter» restringen las consultas de la API de Credit Benchmark Analytics, y por qué una solicitud satisfactoria puede seguir devolviendo un conjunto de resultados vacío.

Analytics separa **la selección de entradas** de **la configuración de salidas**.

* «**`scope`**» define las entidades que se incluyen en el análisis.
* «**`result_filter`**» determina las filas devueltas tras la ejecución del análisis.

Para la selección de rutas, consulte [Elección de una ruta](/api-reference/analytics-endpoints). Para `metric` y `rating_scale`, consulte [Métricas y escalas](/api-reference/metrics-and-rating-scales).

## Ámbito

`scope` se evalúa antes de que el punto final calcule su resultado.

<Tabs>
  <Tab title="Ámbito de la cartera">
    Utilice `scope.portfolio` cuando ya conozca las entidades.

    ```json theme={null}
    {
      "scope": {
        "portfolio": {
          "CB_ID": ["CB0000022706", "CB0000022177"]
        }
      }
    }
    ```

    Las columnas de cartera personalizadas pueden utilizarse como `facet_column` valores cuando el punto final admita facetas.
  </Tab>

  <Tab title="Ámbito del filtro">
    Utilice `scope.filters` cuando la API deba construir el universo a partir de condiciones de campo.

    ```json theme={null}
    {
      "scope": {
        "filters": [
          {
            "key": "CB_Country",
            "operator": "==",
            "values": "United States"
          },
          {
            "key": "CB_CCR_21_Notch",
            "operator": ">=",
            "values": 8
          }
        ]
      }
    }
    ```

    Si `filters_join` Si se omite, los filtros múltiples se combinan con «AND».
  </Tab>

  <Tab title="Cartera y filtros">
    Cuando se proporcionan ambos, la ruta utiliza la **intersección**.

    ```json theme={null}
    {
      "scope": {
        "portfolio": {
          "CB_ID": ["CB0000022706", "CB0000022177"]
        },
        "filters": [
          {
            "key": "CB_Sector",
            "operator": "==",
            "values": "Banks"
          }
        ]
      }
    }
    ```

    Esto se refiere a las entidades de su cartera que son bancos, no a su cartera más todos los bancos.
  </Tab>

  <Tab title="Sintaxis de unión de filtros">
    Utilícelo `filters_join` solo cuando necesite una lógica explícita «O» o «NO». Es posicional y tiene un elemento más que `filters`.

    ```json theme={null}
    {
      "scope": {
        "filters": [
          {
            "key": "CB_Country",
            "operator": "==",
            "values": "United States"
          },
          {
            "key": "CB_Sector",
            "operator": "==",
            "values": "Banks"
          }
        ],
        "filters_join": ["", "|", ""]
      }
    }
    ```
  </Tab>
</Tabs>

## Filtro de resultados

`result_filter` no modifica el universo de entrada. Solo filtra, ordena o limita las filas de salida calculadas.

| Mecanismo               | Aplicable a                                   |
| ----------------------- | --------------------------------------------- |
| `scope.filters`         | Entidades antes de que se ejecute el análisis |
| `result_filter.filters` | Filas tras la ejecución del análisis          |
| `result_filter.sort`    | Orden de las filas en la respuesta            |
| `result_filter.limit`   | Número máximo de filas devueltas              |

Utilice `scope` para decidir qué se incluye. Utilice `result_filter` para decidir qué se devuelve.

## Cobertura de MyRating

Con `metric: "CCR"`, el análisis utiliza entidades del ámbito que cuentan con datos consensuados.

Con `metric: "MyRating"`, el análisis utiliza únicamente la parte de su ámbito en la que su banco ha enviado calificaciones para el intervalo de fechas solicitado.

En otras palabras, al seleccionar `MyRating` puede reducir el universo de «todo lo solicitado» a «las entidades solicitadas **que su banco ha calificado**». Si su banco no ha calificado ninguna entidad en el ámbito solicitado, la API devuelve una respuesta de éxito vacía en lugar de un error.

| Ámbito solicitado | Cobertura de su banco   | MyRating utiliza         |
| ----------------- | ----------------------- | ------------------------ |
| 3 entidades       | 3 entidades calificadas | 3 entidades              |
| 3 entidades       | 2 entidades calificadas | 2 entidades              |
| 3 entidades       | 0 entidades calificadas | Respuesta de éxito vacía |

En las rutas MyRating de tipo agregado, los campos «ex-me» se calculan para ese mismo subconjunto cubierto. No constituyen un punto de referencia de alcance completo para las entidades que su banco no califica.

No comparar `AGG_EntityCount` las respuestas «from». `CCR` respuestas con `AGG_ClientEntityCount` las `MyRating` respuestas como si compartieran el mismo denominador.

## Respuesta vacía por ruta

| Ruta                                          | Respuesta de éxito vacía           |
| --------------------------------------------- | ---------------------------------- |
| `getdata`                                     | `{}` o matrices de columnas vacías |
| `aggregatetrend`                              | `{}`                               |
| `creditbreakdown`                             | `{}`                               |
| `entityratingchange`                          | `{}`                               |
| `ratingdistribution` con `metric: "CCR"`      | `{"ccr": {}}`                      |
| `ratingdistribution` con `metric: "MyRating"` | `{"my_bank": {}, "ex_me": {}}`     |