Email Setup, Templates, and Placeholder

Objective

Seller Center is able to send different types of emails to either Sellers or administration users. These emails range from welcoming emails to password emails and order notifications.

  • To learn how email templates are created and how content can be changed, please contact the local CRM team.
  • The Seller Center team creates standard emails but customization is always possible.

Email Systems

Seller Center supports different systems to send out emails. One is the Experian MailSolution, which has sub-accounts for each Venture (country per Venture). The other is Responsys.

Email Setup

Step Description Image
1 Go to Administration > Settings
2 Switch to tab “Mail Setup” mail_setup
3 Either search for an email template or directly enter the template ID of the email in the textfield. mail_setup2
4 When the template is not available or not in the correct language, click “Add.” The following form will open. mail_setup3
5 Select the email type. mail_setup4
6 Select which language the triggered template should be in. mail_setup3
7 Add the template ID. mail_setup6
8 Click “Save”
Seller Center supports the delivery of emails in multiple languages (depending on the user’s selected language). Thus, multiple templates have to be configured if translated emails need to be sent out.

Email Templates

There are a number of emails that are sent out in Seller Center to inform Sellers about their accounts. Emails are also used by admins to inform Sellers regarding important topics (e.g., pending products in quality control). All of these emails use different placeholders to dynamically display customized content.

An overview of all templates and their example HTML codes can be found in the Wiki.

Please keep in mind that placeholders are case sensitive.

 

Email Name Description Possible Placeholders
Reset Password

This email allows the user to reset their password in case they have forgotten it.

Email Recipient:

  • User who requested email
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_reset_password_url##
  • ##Field_shop_url##
Seller Registration

Sent upon new Seller registration via the admin menu (Administration > Registration).

Email Recipient:

  • Email entered in form in Administration > Registration or during the signup process (which starts from the login screen).
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_seller_address##
  • ##Field_confirm_registration_url##
  • ##Field_shop_url##
New Order

Sent to Seller users upon receiving a new order.

Email Recipient:

  • All Seller full access users
  • All Seller order management users

Users need to have this type of email enabled under User > Notification

  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_order_number##
  • ##Field_order_item_list##
  • ##Field_order_management_url##
  • ##Field_shop_url##
Upload Report

This email contains a summary of the uploaded products, indicating successful uploads and/or failures.

Email Recipient:

  • User who uploaded the file
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_total_number_of_uploaded_products##
  • ##Field_import_type##
  • ##Field_total_of_success_products##
  • ##Field_total_of_failed_products##
  • ##Field_upload_summary_url##
  • ##Field_shop_url##
New User

This email is sent out to add new users (admin or Seller-related users) to Seller Center.

Email Recipient:

  • Email address provided from form or API call
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_user_name##
  • ##Field_new_user_url##
  • ##Field_shop_url##
Order Return Notification

This email is sent out when order (items) are updated to “Return” status.

Email Recipient:

  • All Seller full access users
  • All Seller order management users

User needs to have this type of email enabled under User > Notification

  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_order_number##
  • ##Field_order_item_list##
  • ##Field_seller_sku_list##
  • ##Field_order_management_url##
  • ##Field_shop_url##
  • ##Field_order_item_reason_list##

newly possible placeholder

Order Cancellation Notification

This email is sent out when order (items) are updated to cancellation status from outside of Seller Center.

Email Recipient:

  • All Seller full access users
  • All Seller order management users

User needs to have this type of email enabled under User > Notification

 

  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_order_number##
  • ##Field_order_item_list##
  • ##Field_seller_sku_list##
  • ##Field_order_management_url##
  • ##Field_shop_url##
Consignment Stock Alert

This email is only possible in combination with the consignment feature (“Fulfillment by …”). An email is sent to the Seller if low stock for warehouse products is detected.

Email Recipient:

  • All Seller full access users
  • All Seller product management

User needs to have this type of email enabled under User > Notification

  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_shop_url##
  • ##Field_product_management_url##
  • ##Field_seller_sku_list##
Stock Alert

This email sends a reminder to the Seller that they have products that are low on stock.

Currently not sent/implemented.
  • ##Field_mail_image_url##
  • ##Field_shop_name###
  • ##Field_seller_name##
  • ##Field_product_management_url##
  • ##Field_seller_sku_list##
Weekly Sales Summary

This email sends a summary of the past sales to the Seller, containing data of the top Sellers.

Currently not sent/implemented.
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_revenue_period1##
  • ##Field_revenue_period2##
  • ##Field_total_revenue1##
  • ##Field_total_revenue2##
  • ##Field_percentage_revenue1##
  • ##Field_percentage_revenue2##
  • ##Field_account_statement_period1_url##
  • ##Field_account_statement_period2_url##
Retarget Email

This email is sent out when a Seller has started filling out the registration form but has not completed it.

Email Recipient:

  • Only sent to the email that was used during the registration process.
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_shop_url##
Verification Email

This email is sent out after a Seller has started the registration form in order to to verify that a real email has been used.

Email Recipient:

  • Only sent to the email that was used during the registration process.
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_confirm_registration_url##
Confirmation Email

This email is sent out after the registration form has been completely filled out in order to welcome the new Seller to Seller Center.

Email Recipient:

  • Only sent to the email that was used during the registration process.
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_sellercenter_url##
Seller Profile QC Rejected Email

This email is sent to inform the Seller what parts of their profile were rejected after quality control has been completed on it.

Email Recipient:

  • All Seller full access users
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_sellercenter_url##
  • ##Field_rejection_reasons##
  • ##Field_qa_comment##
Product QC Email Results

This email is sent out to inform the Seller of the status of their products after quality control has been completed. It informs whether products were approved or rejected. This email contains the results of the last hour. Further information can be found here.

Email Recipient:

  • All Seller full access users
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_sellercenter_url##
  • ##Field_country_name##
  • ##Field_rejection_reasons##
  • ##Field_total_number_of_qc_products##
  • ##Field_total_of_approved_products##
  • ##Field_total_of_rejected_products##
  • ##Field_approved_products_table## *
  • ##Field_approved_products_table_full## **
  • ##Field_rejected_products_table##
  • ##Field_rejected_products_table_full## *
  • ##Field_manage_product_url##

* newly possible placeholder

contains the fields seller sku and product name

*** contains the fields seller sku, product name, reject reason, comment

QC Email Notification for Admins

This email is sent out to remind admin (can be set to user-specific or group email) that there are products pending for approval. Further information can be found here.

Email Recipient:

  • The defined email (group)
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_sellercenter_url##
  • ##Field_number_pending_products##
  • ##Field_pending_overview_table##
  • ##Field_pending_quality_control_url##
Pending Order Limit Reached Email

This email is sent out to notify the Seller that their account is temporarily inactive because there are too many new orders in “Pending” status. Further information can be found here.

Email Recipient:

  • All Seller full access users
  • ##Field_shop_name##
  • ##Field_seller_name##
  • ##Field_pending_order_limit##
  • ##Field_order_management_url##
Order Summary report

This email is intended to send a summary of order items.  Time of the email and its frequency can be configured. By default the email will be sent daily at 9AM.

If you want to configure the frequency of the email and time of the day it is sent, please, create a TMLSD ticket. The parameter needs to be configured is seller_order_summary_report.

Email Recipient:

  • Seller Full Access
  • Seller Catalog Access
  • Seller Order Access
  • Seller Stock Update
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_seller_name##
  • ##Field_report_start##
  • ##Field_report_end##
  • ##Field_count_new_orders##
  • ##Field_count_ready_to_ship_orders##
  • ##Field_count_new_delivered_orders##
  • ##Field_count_new_cancelled_orders##
  • ##Field_count_new_delivered_failed_orders##
  • ##Field_count_new_returned_orders##
  • ##Field_order_management_url##
  • ##Field_shop_url##
Returned and Failed Summary Report

This email is intended to send a summary of rejected and failed delivered orders.  Time of the email and its frequency can be configured. By default the email will be sent daily at 9AM.

If you want to configure the frequency of the email and time of the day it is sent, please, create a TMLSD ticket. The parameter needs to be configured is seller_returned_and_failed_order_summary_report.

Email Recipient:

  • Seller Full Access
  • Seller Catalog Access
  • Seller Order Access
  • Seller Stock Update
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_seller_name##
  • ##Field_report_start##
  • ##Field_report_end##
  • ##Field_new_returned_orders_list##
  • ##Field_count_new_returned_orders##
  • ##Field_returned_order_management_url##
  • ##Field_new_delivered_failed_list##
  • ##Field_count_new_delivered_failed_orders##
  • ##Field_failed_to_be_delivered_order_management_url##
  • ##Field_shop_url##
Best Selling Low Stock Products Report

This email’s goal is stock replenishment. Time of the email and its frequency can be configured. By default the email will be sent daily at 9AM.

If you want to configure the frequency of the email and time of the day it is sent, please, create a TMLSD ticket. The parameter needs to be configured is seller_best_selling_low_stock_product_report.

Email Recipient:

  • Seller Full Access
  • Seller Catalog Access
  • Seller Order Access
  • Seller Stock Update
  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_user_name##
  • ##Field_seller_name##
  • ##Field_report_end##
  • ##Field_best_selling_low_stock_item_list##
  • ##Field_best_selling_product_management_url##
  • ##Field_shop_url##
Late Fulfillment Preventive Report  This email is a warning for Sellers who will be affected by penalties due to Late Fulfillment the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Late Fulfillment Post-trigger Report  This email is a report for Sellers who were affected by penalties due to Late Fulfillment the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Product Quality Volume Limitation Preventive Report  This email is a warning for Sellers who will be affected by penalties due to Out of Stock limitations the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Product Quality Volume Limitation Post-trigger Report  This email is a report for Sellers who were affected by penalties due to Out of Stock limitations the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Cancellation Rate Volume Limitation Preventive Report This email is a warning for Sellers who will be affected by penalties due to Cancellation Rate the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Cancellation Rate Volume Limitation Post-trigger Report This email is a report for Sellers who were affected by penalties due to Cancellation Rate the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Advantage Programme Update E-mail This email is a report for Sellers who achieved an upgraded Seller Tier the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Customer Compensation for Cancellations Preventive Report This email is a warning for Sellers who will be affected by Customer Compensation penalties due to Cancellation Rate the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Customer Compensation for Cancellations Post-trigger Report This email is a report for Sellers who were affected by Customer Compensation penalties due to Cancellation Rate the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Customer Compensation for Counterfeit Preventive Report This email is a warning for Sellers who will be affected by Customer Compensation penalties due to Counterfeit Products the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Customer Compensation for Counterfeit Post-trigger Report  This email is a report for Sellers who were affected by Customer Compensation penalties due to Counterfeit Products the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Customer Compensation for Returns Preventive Report  This email is a warning for Sellers who will be affected by Customer Compensation penalties due to certain Return Reasons the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.
Customer Compensation for Returns Post-trigger Report  This email is a report for Sellers who were affected by Customer Compensation penalties due tocertain Return Reasons the trigger for the e-Mail is linked to Smart Seller Manager Actions and can not be used without the feature. Smart Seller Manager is currently in the pilot phase upon release this e-Mail type will be updated as well.

 

Expiration Date for Password-Related Emails

Whenever a Seller is created or an additional user is added to Seller Center, an email is sent that contains a link to set the user’s password. Per default, this password is valid for one day (24 hours). Sometimes, this time period is not long enough and the password URL has already expired by the time the Seller receives the email.

In order to increase the time before the password URL expires, please create a  TMLSD ticket in JIRA and state for how many days the URL should be valid.

For Rocket Labs Service Desk: to set this up, the configuration for “signup/set_password_key/validity_days” needs to be set.

Period Configuration for Quality Control (QC) Result Email

Currently, Seller Center sends emails to the Seller every hour. Through these emails, the Seller is updated on quality control results for their products. The Sellers often prefer the email summary to be delivered less frequently.

It is now possible to set up the period (1, 2, 3, 4, 6, 8, 12, 24 hours) and the time when the emails will be sent out. Setup needs to be done under Administration  > Settings on global-level for all Sellers.

qc_period_settings

Per default, the start time is set to 9:00 am each day. If the period is less than 24 hours, this means that an email will be sent out every “x” hours from this specific time onward (when changes detected regarding whether the Seller’s products are approved or rejected).

The email will be received by the Seller shortly after the defined time.

 

Approved Product List in Quality Control Result Email

Currently, when Seller Center sends emails with product quality control results, the email only includes the number of failed products. It is also possible to add the amount of approved products.

In order to include this number in the transactional emails, please create a TMLSD ticket in JIRA to enable the functionality. Furthermore, the template in your email system needs to include the placeholder ##Field_approved_products_table##.

To learn how to add this to the HTML of the email, please refer to the example template in the wiki.

 

For GET Service Desk: to set this up, the configuration for “quality_control/approved_skus/enabled” needs to be turned on.

 

Return Reason Included in Return Order Notification

Since Sellers also want to know why products are returned in the order return notification, this information can also be added to the template.

The template in your email system needs to include the placeholder ##Field_order_item_reason_list##.

To learn where to add this to the HTML of the email, please refer to the example template in the wiki.

 

Custom Email Template

This functionality only works in combination with Smart Seller Management. With this feature enabled it is possible for Ventures to send out customized emails to Seller. But only specified Seller will receive the emails, based on certain rules (from SSM).

Setup

Critical KnowledgeIf you want to use custom email template within Seller Center, please create a TMLSD ticket. The configuration that needs to be enabled is custom_mail_template_type/enabled.
Step Description Image
1 Go to Administration > Settings > Settings > Mail Setup
2 The add-Button has now a dropdown option to either create a new Email entry or Email type
3

Click on “Add a new Type” to create a new email.

Please add a name for the new type in the form, that opens and save it.

4

Once a new type is created the according entry can be setup.

Please click on “Add new Entry”.

In the form that opens, please select the newly created email type and provide the accoriding template id from the connected UMS system. Furthermore it is possible to select the language.

It is important that the email template content gets created in the UMS system. Otherwise Seller Center would only placeholders there, which are not filled into a proper template.
5 Seller Center sends by default the following placeholders to the UMS system:

  • email
  • shop_name
  • shop_url
  • seller_center_url
  • mail_image_url
 Syntax in UMS:

  • ##Field_mail_image_url##
  • ##Field_shop_name##
  • ##Field_email##
  • ##Field_shop_name##
  • ##Field_shop_url##
6 Within the Smart Seller Management Rule setup it is possible to add as an action that emails get triggered.
7 Once this option is selected, the email type can be selected. The overview shows all available email types, whether they are active or inactive. If an inactive email type gets selected it needs to be ensured, that the email entry gets actually enabled. Otherwise no email can be triggered.
8

In the last field new values can be added, which get used as placeholders within the template. The syntax of these placeholders should look like this:

 

{

"your_placeholder":"your placeholder value", 
"your_placeholder_2":"your placeholder value 2",

}

Depending on the selected context during rule creation a multitude of values is selectable, such as Seller-Rating KPI.

 

9 In the UMS system, when setting up there the html-email templates, it is important that the customized email placeholders get correctly used. The placeholders need to follow this syntax: ##Field_your_placeholer##

Example:

Seller Center configuration:

{ “link_to_watchlist”:”sellercenter-url/product/watchlist/on-watchlist”, “your_rating”:sellerRating.hasRating}

 

UMS Template configuration / content:

##Field_link_to_watchlist##

##Field_your_rating##