docs: Add docs for R044

open-contracting · Jun 17, 2024 · 1891189 · 1891189
1 parent 53628d0
commit 1891189
Show file tree

Hide file tree

Showing 4 changed files with 18 additions and 25 deletions.
diff --git a/docs/changelog.md b/docs/changelog.md
@@ -15,6 +15,7 @@
   - [R018](cli/indicators/R/018): (*Single bid received*).
   - [R028](cli/indicators/R/028): (*Identical bid prices*).
   - [R030](cli/indicators/R/030): (*Late bid won*).
+  - [R044](cli/indicators/R/048): (*Business similarities between suppliers*).
   - [R048](cli/indicators/R/048): (*Heterogeneous supplier*).
   - [R058](cli/indicators/R/058): (*Heavily discounted bid*).
   - Add `no_price_comparison_procurement_methods` configuration.

diff --git a/docs/cli/indicators/R/044.md b/docs/cli/indicators/R/044.md
@@ -1,47 +1,33 @@
-# TODO The title of the indicator (R044)
+# Business similarities between suppliers (R044)
 
-TODO A one-sentence description of the indicator.
+Different tenderers bidding for the same contracting process have similar information.
 
 ## Methodology
 
-TODO
+A contracting process is flagged if different tenderers have either the exact same address or any contact point fields.
+These tenderers are also flagged.
 
 :::{admonition} Example
 :class: seealso
 
-TODO
+BribeCorp and AnotherBribeCorp submit bids to the same procurement process. Both companies use "Collusion Street 1" as their street address in the Atlantis country.
 :::
 
 :::{admonition} Why is this a red flag?
 :class: hint
 
-TODO
+Similarities between suppliers may indicate that the companies are connected.  
 :::
 
-<small>Based on "TODO" in [*TODO*](TODO).</small>
+<small>Based on "Connections between bidders undermines competition" in [*Corruption in Public Procurement: Finding the Right Indicators*](https://www.researchgate.net/publication/303359108_Corruption_in_Public_Procurement_Finding_the_Right_Indicators), and "Similarity in Bids; Apparent Connections Between Bidders" in [*Guide to Combating Corruption & Fraud in Infrastructure Development Projects*](https://guide.iacrc.org/red-flag-similar-bids-apparent-connections-between-bidders/).</small>
 
 ## Output
 
-The indicator's value is TODO.
+The indicator’s value is always 1.0.
 
 ## Configuration
 
-All configuration is optional. To override the default TODO:
-
-```ini
-[R044]
-TODO
-```
-
-## Exclusions
-
-A contracting process is excluded if:
-
-- TODO
-
-## Assumptions
-
-TODO
+The indicator is not configurable.
 
 ## Demonstration
 
@@ -55,6 +41,6 @@ TODO
 
 ```console
 $ ocdscardinal indicators --settings docs/examples/settings.ini --no-meta docs/examples/R/044.jsonl
-{}
+{"OCID":{"F1":{"R044":1.0},"F2":{"R044":1.0},"F3":{"R044":1.0},"F4":{"R044":1.0}},"Tenderer":{"GB-COH-09506232":{"R044":1.0},"GB-COH-09506234":{"R044":1.0}}}
 
 ```
diff --git a/docs/cli/indicators/index.md b/docs/cli/indicators/index.md
@@ -320,6 +320,9 @@ R/index
 * - [R038](R/038)
   - [Excessive disqualified bids](R/038)
   - The ratio of disqualified bids to submitted bids is a high outlier per buyer, procuring entity or tenderer.
+* - [R044](R/044)
+  - [Business similarities between suppliers](R/044)
+  - Different tenderers bidding for the same contracting process have similar information.
 * - [R048](R/048)
   - [Heterogeneous supplier](R/048)
   - The variety of items supplied by a tenderer is a high outlier.

diff --git a/docs/examples/R/044.jsonl b/docs/examples/R/044.jsonl
@@ -1 +1,4 @@
-{}
+{"ocid":"F1","parties":[{"address":{"streetAddress":"Street ABC","locality":"Atlantis City","region":"Moorland","postalCode":"1234","countryName":"Atlantis"},"roles":["tenderer"],"id":"GB-COH-09506232"},{"address":{"streetAddress":"Street ABC","locality":"Atlantis City","region":"Moorland","postalCode":"1234","countryName":"Atlantis"},"roles":["tenderer"],"id":"GB-COH-09506234"}]}
+{"ocid":"F2","parties":[{"address":{"streetAddress":"Street ABC"},"roles":["tenderer"],"id":"GB-COH-09506232"},{"address":{"streetAddress":"Street ABC"},"roles":["tenderer"],"id":"GB-COH-09506234"}]}
+{"ocid":"F3","parties":[{"contactPoint":{"name":"Person","email":"[email protected]","telephone":"+123456","faxNumber":"+123456","url":"http://example.com"},"roles":["tenderer"],"id":"GB-COH-09506232"},{"contactPoint":{"name":"Person","email":"[email protected]","telephone":"+123456","faxNumber":"+123456","url":"http://example.com"},"roles":["tenderer"],"id":"GB-COH-09506234"}]}
+{"ocid":"F4","parties":[{"contactPoint":{"name":"Person"},"roles":["tenderer"],"id":"GB-COH-09506232"},{"contactPoint":{"name":"Person"},"roles":["tenderer"],"id":"GB-COH-09506234"}]}