Documentation

La ampliación de los requisitos se basa en el modelo de la UE Vocabulario de Criterios Fundamentales y Evidencia Básica (CCCEV) para comunicar criterios y respuestas.

La extensión está diseñada para permitir que las entidades compradoras o los compradores expresen criterios, relacionados con los artículos adquiridos o sobre los propios licitadores, como datos estructurados.

Los criterios pueden ser respondidos por los licitadores, compradores o entidades compradoras, por ejemplo un comprador puede responder con información sobre un artículo, mientras que una entidad licitadora puede responder con información sobre si un licitador está inhabilitado.

Modelo CCCEV

El modelo CCCEV define los siguientes conceptos:

Criterio Un criterio representa una regla o principio usado para juzgar, evaluar o calificar un artículo o un licitador. Un criterio se satisface cuando uno o más de sus grupos están satisfechos.

Grupo de requisitos Un grupo de requisitos es una serie de uno o más requisitos individuales. Un grupo de requisito se satisface cuando todos sus requerimientos están satisfechos.

Requisito Un requisito atómico que puede expresarse como un valor esperado o un rango de valores aceptados.

Respuesta de requisito Una respuesta de requisitos es una afirmación que responde a un requisito específico.

Por lo tanto, el modelo CCCEV puede usarse para expresar las condiciones AND, donde un grupo de requisitos debe cumplirse para satisfacer un criterio, así como las condiciones OR, donde existen requisitos alternativos que pueden satisfacer un criterio.

Esquema

La extensión introduce un nuevo bloque para cada uno de los conceptos descritos anteriormente, estos se agregan a las siguientes ubicaciones en el esquema de OCDS:

  • tender.criteria - una lista de criterios
  • tender.criteria.requirementGroups - una lista de grupos de requisitos
  • tender.criteria.requirementGroups.requirements - una lista de requisitos
  • bids.requirementResponses - una lista de respuestas de requerimientos (Nota: depende de la extensión bid)
  • awards.requirementResponses - una lista de respuestas de requisitos
  • contracts.requirementResponses - una lista de respuestas a los requisitos

Example

A continuación se muestra un ejemplo de requisitos especificados tanto en un artículo como en un licitador que demuestra las condiciones AND y OR:

{
  "tender": {
    "criteria": [
      {
        "id": "0001",
        "title": "Air intake",
        "description": "The vacuum cleaner air intake must be at least 100W",
        "source": "tenderer",
        "code": "OCDS-123454-AIR",
        "featureOf": "item",
        "relatedItem": "0001",
        "requirementGroups": [
          {
            "id": "0001-001",
            "description": "The vacuum cleaner air intake must be at least 100W",
            "requirements": [
              {
                "id": "0001-001-01",
                "title": "Air intake",
                "description": "Power of vacuum cleaner air intake in W",
                "dataType": "integer",
                "pattern": "[0-9]*",
                "minValue": 100
              }
            ]
          }
        ]
      },
      {
        "id": "0002",
        "title": "Warranty",
        "description": "The vacuum cleaner must have warranty support options for at least 36 months",
        "source": "tenderer",
        "code": "OCDS-123454-WARRANTY",
        "featureOf": "item",
        "relatedItem": "0001",
        "requirementGroups": [
          {
            "id": "0002-001",
            "description": "The standard warranty period for the vacuum cleaner must be at least 36 months",
            "requirements": [
              {
                "id": "0002-001-01",
                "title": "Standard warranty period",
                "description": "Length of the vacuum cleaner standard warranty period in months",
                "dataType": "integer",
                "pattern": "[0-9]*",
                "minValue": 36
              }
            ]
          },
          {
            "id": "0002-002",
            "description": "The standard warranty period for the vacuum cleaner must be at least 12 months with an option to extend to 36 months",
            "requirements": [
              {
                "id": "0002-002-01",
                "title": "Standard warranty period",
                "description": "Length of the vacuum cleaner standard warranty period in months",
                "dataType": "integer",
                "pattern": "[0-9]*",
                "minValue": 12
              },
              {
                "id": "0002-002-02",
                "title": "Extended warranty option",
                "description": "There is an extended warranty option for at least 36 months",
                "dataType": "boolean",
                "expectedValue": true
              }
            ]
          }
        ]
      },
      {
        "id": "0003",
        "title": "Years trading",
        "description": "Number of years the bidder has been trading",
        "source": "tenderer",
        "code": "OCDS-123454-YEARS",
        "featureOf": "tenderer",
        "requirementGroups": [
          {
            "id": "0003-001",
            "description": "Number of years the bidder has been trading",
            "requirements": [
              {
                "id": "0003-001-01",
                "title": "Years trading",
                "description": "Number of years the bidder has been trading",
                "dataType": "integer",
                "pattern": "[0-9]*",
                "minValue": 3
              }
            ]
          }
        ]
      }
    ]
  }
}

A continuación se muestra un ejemplo de respuestas que cumplen los requisitos anteriores:

{
  "bids": [
    {
      "requirementResponses": [
        {
          "id": "air",
          "value": 125,
          "requirement": "0001-001-01",
          "relatedItem": "0001"
        },
        {
          "id": "warranty",
          "value": 36,
          "requirement": "0002-001-01",
          "relatedItem": "0001"
        },
        {
          "id": "years",
          "value": 10,
          "requirement": "0003-001-01"
        }
      ]
    }
  ]
}

Otras extensiones

El modelo CCCEV también define una serie de conceptos adicionales, incluyendo formalFrameworks, utilizado para especificar los instrumentos jurídicos de los que se derivan los criterios, evidence, utilizado para especificar y proporcionar la evidencia necesaria para respaldar una respuesta de requisito, y propiedades adicionales de requirements como certificationLevel que actualmente no están implementadas en esta extensión.

Issues

Reporte issues para esta extensión en el repositorio de extensiones ocds, poniendo el nombre de la extensión en el título del issue.

Registro de cambios

This extension was originally discussed in https://github.com/open-contracting/standard/issues/223.

2019-03-20

  • Set "uniqueItems": true on array fields, and add "minLength": 1 on required string fields.

2018-12-18

  • Requirement.expectedValue y RequirementResponse.value permiten valores boolean.