Discovery Template

Learn how to fill out your Discovery list to get started risk-managing your suppliers and own business units in Prewave!

You can download the new template here

You can download the guideline here

The changes:
  • collection_name has been split into three fields. In each field, the user can provide a semicolon-separated list of collections. All values of these fields will be joined together. Each of the collections can be mapped to a Prewave industry or commodity for scoring.

  • industry has been split into three fields. In each field, the user can provide a semicolon-separated list of industries. All values of these fields will be joined together. Each of the industries can be mapped to a Prewave industry or commodity for scoring. Similar as collection_name with the difference that no collection will be set up for these values.

  • connection_type does not support SUPPLIER_CUSTOMER and NONE any more. The field is now required.

  • external_reference_id and external_reference_type is not sufficient any more as sufficient input. Instead, it is an optional value which can be provided additionally to the other fields.

  • contact has been split into three fields. In each field, the user can provide a semicolon-separated list of contacts. All values of these fields will be joined together.

Multiple reference numbers (aka supplier IDs) (June 2024)

If multiple references shall be stored with one site, this is not possible to be done with one row only as there is no multi-value support for your_reference. Instead, a row can be duplicated in order to add additional references. If the name and address information is identical, the same site will be reused and information is added there. Please note that any impact data (spend_data and impact) will be stored per reference. Hence, if you do not want spends to be summed up, you need to remove them from either row.

 

Site-Data Upload to the Prewave Platform

Prewave assesses the risk of hundreds of thousands of sites around the world. A site refers to a physical location where members of an organization conduct their main operational activities (hereinafter referred to as “Site”). Sites may include (manufacturing) plants, distribution centers, retail stores, transportation hubs, warehouses and offices, where business operations, production or services are carried out. These Sites can be associated with your suppliers, your customers or yourself.
Our Platform allows you to monitor Sites you have subscribed to (i.e., follow and/or connect), in real time. The maximum number of Sites you can subscribe to is specified in your contract. You can connect or disconnect with/from Sites at any time via the Prewave Platform, provided that the maximum number of Sites in Peer Score has not been exceeded.  

Prewave lists hundreds of thousands of Sites, to which you can directly subscribe via the Prewave Platform. 

If the Site is not listed on the Prewave Platform, you are required to send us a correct and complete list of Sites to which you wish to subscribe, or alternatively you can use the Add-to-Directory function available on the Prewave Platform (said processes are hereinafter referred to as “Discovery”). For the purpose of Discovery, you must provide us with the data indicated in Appendix 1 (1. Parameters) hereto. The same applies if you wish for us to subscribe you to any Sites.

We cannot accept Site lists that are missing any of the mandatory parameters, as without said parameters we are not able to discover or identify the Sites to which you wish to subscribe on our Prewave Platform. See Appendix 1 (2. SiteDetailStatus) for reference information about possible response and error messages we use.

Should you provide us with a valid prewave_id, we will disregard the site_details provided. 

Please note that the Prewave Platform does not support Sites:

  • that are associated with a private/natural person (e.g., home office), or
  • whose essential details required for the provision of our services cannot be discovered, or
  • whose existence cannot be validated in the course of the Discovery.

Accordingly, Prewave retains the right to refuse the addition of Sites, and can delete Sites that subsequently exhibit any of the above characteristics.

Should you follow our instructions and adhere to the procedure established herein, we will use our best efforts to subscribe you to the Sites you specify.

The full list of parameters (Appendix 1):

 

Field

 

Mandatory

 

Comment

 

Example

 
 

Field

Mandatory 

Comment 

Example

connection_type

required

How the Site is associated with your organization. The allowed values are: SUPPLIER, CUSTOMER and OWN.

SUPPLIER

your_reference

required

A textual identifier that uniquely identifies a Site connected to your organization.

C12345

site_details_name

required

The human-readable name for the site, usually canonicalized.

Prewave GmbH

country_code

required

Alpha-2 ISO Code of the address. See https://www.iso.org/obp/ui for details.

AT

locality

required

Refers to the city/town portion of the address. In regions of the world where localities are not well defined or do not fit into this structure well, use closest locality instead.

Vienna

address_line

required

Unstructured address lines describing the lower levels of an address. Usually this is a street name and house number.

Rothschildplatz 4, Austria Campus 4/3rd Floor

postal_code

recommended

Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address.

1020

industry_1

required

The industry which is relevant for your Site. Multiple industries can be added separated by a semicolon (;). These values will be mapped to Prewave industries or commodities.

IT / Software

industry_2

optional

Additional field to industry_1. Values will be joined together.

 

industry_3

optional

Additional field to industry_1. Values will be joined together.

 

collection_name_1

optional

The collection in which you want to group your Site. Multiple collections can be added separated by a semicolon (;). These collections can be mapped to Prewave industries or commodities for scoring.

IT-Suppliers;Grouping-A;Austrian Suppliers

collection_name_2

optional

Additional field to collection_name_1. Values will be joined together.

Supplier of the Year

collection_name_3

optional

Additional field to collection_name_1. Values will be joined together.

 

impact

optional

Your estimated impact on the operation of the Site. The allowed values are: CRITICAL, HIGH, MID, LOW and NO. If empty, impact is CRITICAL for own Sites, MID for SUPPLIER and CUSTOMER and NONE for all others.

MID

spend_data

optional

The total value of the goods and/or services you purchased at that site in EUR per year.

100000

website

recommended

The authoritative website for this site, such as a business' homepage.

prewave.com

external_reference_id

optional

External unique site identifier number.

300533068

external_reference_type

optional

Required if external_reference_id is stated. Reference to the source of the unique site identifier.

DUNS

contact_1

optional

E-mail of the Site’s contact to complete self-assessments. Multiple contacts can be added separated by a semicolon (;).

customer-success@prewave.ai

contact_2

optional

Additional field to contact_1. Values will be joined together.

 

contact_3

optional

Additional field to contact_1. Values will be joined together.

 

prewave_id

optional

A positive number that uniquely identifies a Prewave Site. If set, site_details_name, country_code, locality and address_line can be skipped.

6640371