Consumer Identification
Sets
Your self-service portals are organized by sales channels or brands, not by country or language. The initial step in utilizing the self-service portal is to locate the appropriate sales order. You can customize each portal to have different required attributes. These attribute sets are specific combinations needed to advance. If there are multiple sets configured, you can easily switch between them using a text brick.
Your self-service portal is equipped with multiple sales channels, each gathering data from different sources. By default, customers are asked for their "order number" and "email address." However, if a customer's email address is not available (common with certain marketplaces that assign email addresses for consumer accounts), the portal can instead request the "order number" and "zip code" of the sales order address. Customers can easily switch between these options by clicking on the text brick and proceed with their transaction.
Security recommendation
When selecting fields for consumer identification, choose information that cannot be easily guessed or accessed by third parties. A postal code has a limited number of possible values, and the order number should not be displayed together with the postal code on the shipping parcel. A more secure combination would be the order number and the customer’s email address. Adding a third, independent field can further increase security.
Prefilled service portal URL
Depending on your Integration & Embedding of your portal your self service portal will be available with a specific link. You can provide the attributes within that URL as GET parameters.
Behavior
If all of the required Consumer Identification search terms are passed via GET parameters, the module will initiate search of the Sales Order and will automatically create a corresponding Service Order.
If only part of the Consumer Identification search terms are passed via GET parameters, the module will only prefill fields of the Sales Order search form without initiating search and creation of a Service Order.
Supported GET parameters
| Parameter | Description |
|---|---|
lang | UI locale to force to the user (ignoring the browser locale) |
SalesOrder.number | Number of the Sales Order |
SalesOrder.externalId | External ID of the Sales Order |
SalesOrder.orderDate | Date of the Sales Order |
SalesOrder.total | Total of the Sales Order |
SalesOrder.shippingAddress.postalCode | Postal code of the Sales Order’s shipping address |
SalesOrder.shippingAddress.city | City of the Sales Order’s shipping address |
SalesOrder.shippingEntity.firstName | First name of the Consumer |
SalesOrder.shippingEntity.lastName | Last name of the Consumer |
SalesOrder.shippingEntity.email | E-mail address of the Consumer |
Consumer.externalId | External ID of the Consumer |
SalesOrderParcel.reference | Reference number of the Sales Order Parcel |
SalesOrderParcel.externalId | External ID of the Sales Order Parcel |
IMPORTANT:
Supported Languages
In order for the languages on the Service Portal to be shown, they must first be enabled in the settings. If they are not enabled, the customer will see the default language (which can be changed from English). This can be configured in the Service Portal Settings.
| Language | ISO 639-1 |
|---|---|
| English | en |
| Bulgarian | bg |
| Croatian | hr |
| Czech | cz |
| Danish | dk |
| Dutch | nl |
| Finnish | fi |
| French | fr |
| German | de |
| Greek | gr |
| Hungarian | hu |
| Italian | it |
| Lithuanian | lt |
| Norwegian | no |
| Polish | pl |
| Portuguese | pt |
| Romanian | ro |
| Slovenian | sl |
| Spanish | es |
| Swedish | sv |
Examples
https://return.yourcompany.returns.cloud/?lang=frhttps://return.yourcompany.returns.cloud/#/?SalesOrder.number=86374826&SalesOrder.shippingAddress.city=Rome&SalesOrder.shippingEntity.firstName=Roberto&[email protected]