indicators¶

El comando indicators calcula los indicadores de adquisiciones y las señales de alerta.

Ejecute el comando help para leer su descripción, formato de salida y opciones:

$ ocdscardinal help indicators
Calculate procurement indicators from OCDS compiled releases in a line-delimited JSON file

The result is a JSON object, in which the keys are one of "OCID", "Buyer", "ProcuringEntity" or
"Tenderer". The values are JSON objects, in which the keys are identifiers (e.g. ocid) and values
are results (of any indicators that returned a result).

Unless --no-meta is set, the result has a "Meta" key, with information about the quartiles and
fences used to calculate the results.

If --map is set, the result has a "Maps" key, with mappings from contracting processes to
organizations.

Usage: ocdscardinal[EXE] indicators [OPTIONS] <FILE>

Arguments:
  <FILE>
          The path to the file (or "-" for standard input), in which each line is a contracting
          process as JSON text

Options:
  -s, --settings <SETTINGS>
          The path to the settings file

  -v, --verbose...
          Increase verbosity

  -c, --count
          Print the number of results per group to standard error

      --no-meta
          Exclude the "Meta" key from the results object

      --map
          Include the "Maps" key, mapping contracting processes to organizations

  -h, --help
          Print help (see a summary with '-h')

Flujo de trabajo¶

Atención

Antes de seguir el flujo de trabajo de este comando, siga los pasos anteriores en Flujo de trabajo general.

Seleccionar indicadores. Si ejecutó el comando init al preparar sus datos, ya tiene un Archivo de configuración que habilita todos los indicadores. Habilite o deshabilite indicadores como desee.
Ejecute el comando. Por ejemplo, si su configuración está en settings.ini y sus datos están en prepared.jsonl, este comando escribe la salida en results.json:
```
ocdscardinal indicators --settings settings.ini prepared.jsonl > results.json
```
Revisar los resultados. Lea la demostración para conocer el formato de salida.

Pendiente

Esta sección ampliará en la interpretación de los resultados. Consulte el issue de GitHub #40.
Edite la configuración. Ajuste la configuración de los indicadores en función de su revisión de los resultados, para reducir los falsos positivos.

Repita los últimos tres pasos hasta que esté satisfecho con los resultados.

Nota

¿Tiene preguntas, inquietudes o comentarios? Envíe un correo electrónico a James McKinney, director de tecnología de OCP.

Demostración¶

Un indicador o una bandera roja puede calcularse para un proceso de contratación, un comprador, una entidad contratante o un oferente Por ejemplo, un proceso de contratación puede tener una característica sospechosa, como que todas las ofertas excepto la del ganador sean descalificadas. O bien, un comprador podría exhibir un comportamiento sospechoso, como descalificar una gran cantidad de ofertas en sus procesos de contratación.

La salida JSON se organiza como un objeto en el que la clave es un grupo: «OCID» (el identificador único de un proceso de contratación), «Buyer», «ProcuringEntity» o «Tenderer». Por ejemplo:

{
  "OCID": {},
  "Buyer": {},
  "ProcuringEntity": {},
  "Tenderer": {}
}

Cada valor en el nivel superior es un objeto que representa los resultados dentro de ese grupo, en el que la clave es un identificador extraído de los datos de entrada:

Grupo	Identificador
OCID	`/ocid`
Buyer	`/buyer/id`
ProcuringEntity	`/tender/procuringEntity/id`
Tenderer	`/bids/details[]/tenderers[]/id`

Por ejemplo:

{
  "OCID": {
    "ocds-6550wx-JRFPFA-DAF-CM-2021-0012": {}
  },
  "Buyer": {
    "DO-RPE-55216": {}
  }
}

Cada valor en el segundo nivel es un objeto que representa los resultados relacionados con ese identificador, en el que la clave es el código de un indicador, y el valor es la salida de ese indicador. Por ejemplo:

{
  "OCID": {
    "ocds-6550wx-JRFPFA-DAF-CM-2021-0012": {
      "R036": 1.0
    }
  },
  "Buyer": {
    "DO-RPE-55216": {
      "R038": 0.8
    }
  }
}

La salida de un indicador es siempre un decimal. Si un indicador no produjo resultados (ya sea porque no se pudo calcular o porque no se activó ninguna señal de alerta), entonces su código no aparecerá.

Puede consultar los códigos de todos los indicadores, leer la descripción de sus resultados y ver una demostración de su cálculo.

La salida JSON también tiene una clave Meta en el nivel superior. Su valor es un objeto con información sobre los cuartiles y umbrales utilizados para calcular los resultados, redondeado a 4 decimales. Por ejemplo:

{
  // ...
  "Meta": {
    "R024": {
      "q1": 66.6667,
      "q3": 100.0,
      "lower_fence": 16.6667
    }
  }
}

Configuración¶

La página para cada indicador describe sus configuraciones individuales.

Toda la configuración es opcional. Cardinal proporciona buenos valores predeterminados.

Ver también

Una introducción a Archivo de configuración.

Habilitar un indicador¶

Para habilitar un indicador, inicie una sección con su código, por ejemplo:

[R024]

No es necesario establecer propiedades en esta sección. (¡Sólo si lo desea!)

Deshabilitar un indicador¶

Para desactivar un indicador, puede eliminar su sección y propiedades, o comentarlas, por ejemplo:

; [R024]
; threshold = 0.05

Ahora, el comando indicators no ejecutará este indicador.

Configuración global¶

Some indicators compares bid prices. However, for some procedures, it is inappropriate to compare bid prices; for example, if the buyer predetermines the price, then the indicator for prices close to the winning bid will return a false positive.

Procedures can be included or excluded based on the value of /tender/procurementMethodDetails.

To exclude procedures, add to the top of your settings file, as a pipe-separated list, for example:

no_price_comparison_procurement_methods = Random Selection|Sorteo de Obras

To include procedures, add to the top of your settings file, as a pipe-separated list, for example:

price_comparison_procurement_methods = Reverse Auction

Glosario¶

oferta¶: Una oferta realizada por un operador económico como parte de un proceso de contratación. También conocido como licitación.
licitador¶: Sinónimo de oferente.
comprador¶: La organización que tiene como objetivo celebrar un contrato con un operador económico o utilizar los bienes, servicios u obras resultantes del contrato, como parte de un proceso de contratación.
proceso de contratación¶: Todas las actuaciones encaminadas a la ejecución de uno o más contratos. Esto abarca la licitación, adjudicación, contratación y ejecución. También conocido como procedimiento.
operador económico¶: Una persona u organización –o grupo de personas u organizaciones– que ofrece bienes, servicios u obras. También conocido como negocio, contratista, proveedor de servicios, proveedor o emprendimiento.
entidad contratante¶: La organización que gestiona el proceso de contratación. Una organización puede ser a la vez un comprador y una entidad contratante (como en un proceso de contratación simple).
enviado¶: Una oferta se considera «enviada» si su estado es pendiente (es decir, aún no evaluada), válida (es decir, calificada) o descalificada. No se considera «enviada» si su estado es invitado o retirado.
oferente¶: Un operador económico que envió una o más ofertas como parte de un proceso de contratación.
ganador¶: Un oferente al que se le adjudica un contrato.

Indicadores¶

A los indicadores se les asignan códigos para facilitar su consulta: por ejemplo, «R001». La primera letra indica la categoría: Red flag (bandera roja) o Use case (caso de uso).

La página de cada indicador describe su metodología individual. Para todos los indicadores, se excluye un proceso de contratación si:

El «ocid» no es una cadena.
Se cancela el proceso de contratación (/tender/status).
Las referencias de organizaciones relevantes no establecen una «id».
Los valores monetarios, cuando sea relevante, no utilizan la moneda principal.

Para configurar la moneda principal, agregue en la parte superior de su archivo de configuración:
```
currency = USD
```
De lo contrario, la moneda principal se establece en la primera moneda observada.

Nota

¿Quieres eliminar esta exclusión? Contribuya al issue #11 de GitHub.

Banderas rojas¶

Código	Título	Descripción
R003	Short submission period	The submission period is too short.
R024	Precio cercano a la oferta ganadora	La diferencia porcentual entre la oferta ganadora y la segunda oferta válida más baja es un valor atípico bajo.
R025	Número excesivo de ofertas no exitosas	La relación entre las ofertas ganadoras y las presentadas por un oferente es un valor atípico bajo
R028	Precios de oferta idénticos	Dos ofertas presentadas por diferentes oferentes tienen el mismo precio
R030	Oferta tardía gana	La oferta ganadora se recibió después de la fecha límite de presentación.
R035	Todas las ofertas son descalificadas excepto la ganadora	Las ofertas presentadas son descalificadas excepto la ganadora.
R036	Oferta más baja descalificada	La oferta más baja es descalificada cuando el criterio de adjudicación es solo precio.
R038	Alto número de ofertas descalificadas	La relación de ofertas descalificadas y las presentadas es un valor atípico alto para un comprador o un oferente.
R048	Proveedor multipropósito	La variedad de artículos suministrados por un oferente es un valor atípico alto.
R058	Oferta con precio muy bajo	La diferencia porcentual entre la oferta ganadora y la segunda oferta válida más baja es un valor atípico alto