From 57dfb9c248f66ae83e35f1cf3add30891b873a50 Mon Sep 17 00:00:00 2001
From: odscjen <jen.harris@opendataservices.coop>
Date: Thu, 30 Nov 2023 17:20:21 +0000
Subject: [PATCH] add relativeValue and monetaryValue.csv

---
 README.md                   | 27 +++++++++++++++++++++++++++
 codelists/monetaryValue.csv |  3 +++
 extension.json              |  3 ++-
 release-schema.json         | 37 +++++++++++++++++++++++++++++++++++++
 4 files changed, 69 insertions(+), 1 deletion(-)
 create mode 100644 codelists/monetaryValue.csv

diff --git a/README.md b/README.md
index 698fe79..66ebb25 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,32 @@ The following JSON snippet models a contracting process where fees are applied t
 }
 ```
 
+The following JSON snippet models a contracting process where fees are calculated as a percentage of the awarded contract value.
+
+```json
+{
+  "tender": {
+    "participationFees": [
+      {
+        "id": "1",
+        "type": [
+          "win"
+        ],
+        "relativeValue": {
+          "percentage": 0.05,
+          "monetaryValue": "award"
+        },
+        "description": "Fee payable on acceptance of award.",
+        "methodOfPayment": [
+          "wireTransfer",
+          "cheque"
+        ]
+      }
+    ]
+  }
+}
+```
+
 ## Issues
 
 Report issues for this extension in the [ocds-extensions repository](https://github.com/open-contracting/ocds-extensions/issues), putting the extension's name in the issue's title.
@@ -61,6 +87,7 @@ Report issues for this extension in the [ocds-extensions repository](https://git
 ### Unreleased
 
 * Make `ParticipationFee.id` required so that participation fees are merged by identifier
+* Add `relativeValue` field
 
 ### v1.1.5
 
diff --git a/codelists/monetaryValue.csv b/codelists/monetaryValue.csv
new file mode 100644
index 0000000..03b312a
--- /dev/null
+++ b/codelists/monetaryValue.csv
@@ -0,0 +1,3 @@
+Code,Title,Description
+tender,Tender,"The estimated value of the procurement, as estimated when publishing the tender information."
+award,Award,"The value of the award. Typically, this is the value of the bid being awarded."
diff --git a/extension.json b/extension.json
index 225905e..bee2543 100644
--- a/extension.json
+++ b/extension.json
@@ -13,7 +13,8 @@
   ],
   "codelists": [
     "participationFeeType.csv",
-    "methodOfPayment.csv"
+    "methodOfPayment.csv",
+    "monetaryValue.csv"
   ],
   "schemas": [
     "release-schema.json"
diff --git a/release-schema.json b/release-schema.json
index 93f12e1..9eb7057 100644
--- a/release-schema.json
+++ b/release-schema.json
@@ -37,6 +37,11 @@
           "description": "The monetary value of this fee.",
           "$ref": "#/definitions/Value"
         },
+        "relativeValue": {
+          "title": "Relative value",
+          "description": "The value of the participation fee, as a percentage of the monetary value.",
+          "$ref": "#/definitions/RelativeValue"
+        },
         "description": {
           "title": "Description",
           "description": "Additional information about this fee, for example: the specific cases in which the fee is applicable (e.g. hard copies of documents only), the way in which the fee is levied, or the exact nature of the fee.",
@@ -73,6 +78,38 @@
           "uniqueItems": true
         }
       }
+    },
+    "RelativeValue": {
+      "title": "Relative value",
+      "description": "The value of the participation fee, as a percentage of a monetary value.",
+      "type": "object",
+      "required": [
+        "percentage",
+        "monetaryValue"
+      ],
+      "properties": {
+        "percentage": {
+          "title": "Percentage",
+          "description": "The percentage of the monetary value.",
+          "type": [
+            "number"
+          ],
+          "maximum": 1,
+          "minimum": 0,
+          "exclusiveMinimum": true
+        },
+        "monetaryValue": {
+          "title": "Monetary value",
+          "description": "The name of the monetary value.",
+          "type": "string",
+          "enum": [
+            "tender",
+            "award"
+          ],
+          "codelist": "monetaryValue.csv",
+          "openCodelist": false
+        }
+      }
     }
   }
 }