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 ascollection_name
with the difference that no collection will be set up for these values. -
connection_type
does not supportSUPPLIER_CUSTOMER
andNONE
any more. The field is now required. -
external_reference_id
andexternal_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 |