YMPULSE UserGuide Unit Price upload

The Userguide can only being viewed on this page.
To download the Userguide click on the following link for the instructions: Export page to PDF or Word

Table of contents

Introduction

The following guide has been made to explain the model price upload functionality available in YMPULSE-D. Users with the correct security authorizations will be able to maintain pricing information for units directly in YMPULSE-D uploading a .csv file or directly in the application.

This functionality is currently available for non-integrated distributors and for integrated distributors.

Security authorization

Security authorization setup for integrated distributors is done by Applications Support. To request access, a ticket must be raised at  https://support.yamnet.com.

For non-integrated distributors, security authorization is setup by the security user. 

Program functionality

After the user logs in to YMPULSE-D, he will have the menu option “Unit prices” available, if he has the proper security authorization.

 When selecting this menu option, the following screen will appear:

Filtering current pricing information

At the top of the page, under the menu options, there is a section in which the user will filter information in order to obtain current pricing information from the system.

• Model Year: all existing model years will be listed in this dropdown. The user can select as many years as he likes, and a checkmark will appear next to each selected option.

• Model code: the list of current models available will be displayed through this option. There is a text box at the top of the dropdown so that the user can type search criteria in order to make the model search easier. Selection of more than one model at a time is possible, a checkbox will appear next to each option.

• Language code: this list displays the languages available for the country of the user that is currently logged in. In this case, only one option can be selected.

•  Search: when this button is pressed, current pricing information will be displayed at the table at the bottom of the screen, according to the filters specified by the user.

Display search results

After using the search filters to select the model prices that will be updated, information will be displayed in the table located under the filters. This table will serve as a “work space” in which the user can make modifications without actually updating current pricing data. Changes made here can be saved and retrieved later. No final changes are made to current prices until they are published live.

 In this area, the user can enter pricing data typing directly in the fields available for this purpose. Not all information is available for editing, in fact, the only values that can be modified are: Model disclaimer, Price and Start date. Editable columns are highlighted in a different color.

There are search boxes at the top of the “Model code”, ”Model name”, “Model disclaimer”, “Price”, “Color code”, “MPL code” and “Start date” columns and dropdowns at the top of the “Model year” and “Status” to filter the results displayed on the table.

Every column in the table can be sorted by pressing the  sorting buttons.

Results are paginated, showing ten records at a time. In order to be able to navigate to different pages, the user can click on a page number or click the “Previous” and “Next” options located at the bottom right of the table.

 When doing a new search, two types of options will be displayed in the “Status” column:

• Success: for items that already have a saved price in the database for the country of the user.
• New: for items that do not have a saved price in the database for the country of the user.

Update pricing information manually

Users can edit pricing records available on the table by positioning the mouse on the available editable fields for the desired model.

For the column of “Model disclaimer”, a pop-up will open as soon as the user clicks on the field. In this screen, editions for the disclaimer can be made. After the information has been entered, the user can press the “Ok” button to save the changes and return to the previous screen. To exit the screen without making any changes, press the “Cancel” button.

Values entered by the user will be validated as soon as he presses the “Save” button.

Update pricing information by using the CSV export / import functionality

To make price updates easier for large numbers of records, there is an option to import a csv file into the system. This csv file can be generated automatically from the application by clicking on the  button. The information that will be exported will be the one available on the table at the moment the button is clicked. If the user has filtered the information on the table, the exported information will include these filters.

For example:

In the following screen, the current table contains 14 entries (as stated at the bottom left corner of the table) and no filters have been applied to the columns:

 When exporting the data, 14 records will be available in the csv file:

 In a second scenario, filters have been applied to the columns to restrict the number of results, obtaining three entries:

 Export in this case, results in a csv file with only three lines:

After exporting the results, modifications can be made in the file that will be imported back to the program using the   button and selecting the updated file.

It is important to point out that the imported csv must have a CSV UTF-8 format in order to avoid the incorrect import of special characters into the system.

 Notes about price file imports:

• If the record imported already existed in the table, what will happen is that it will be updated with the information from the csv file.
• Records that did not exist previously in the table will be added as a new line.
• All records that were imported, either new ones or already existing will have a status of “New” in the table.
• Validation of imported information will happen when the user presses the “Save” button.

Saving pricing information

The saving action has two purposes in this screen:

• Updating the pricing "work file" in Ympulse-D (changes are not published to production at this point).
• Validating that the information that was entered by the user is correct.

The pricing validations that are made by the tool are the following:

Model code exists

The application checks that the model code entered by the user exists in the model master. For non-existing models an error message appears in the Status column: RR02- Model code does not exist.

In the following example, incorrect model code YZF-XXX has been imported into the "work file". When the import is done, the status for this record is "New"

After pressing the "Save" button, the record is marked as "Invalid" and an error message is displayed:

Year exists for the model code entered

The system checks that the model year that the user entered is available for the model code for the record. If a combination cannot be found the following error appears: RR01: Combination of Model Code and Year does not exist.

In the following example, an incorrect year has been entered for the YZF-R125 model:

When the record is created in the "work file" its status is "New". When pressing the "Save" button, an error message is displayed for the incorrect entry:

Disclaimer field is not empty

The "Model disclaimer" is mandatory in order for the entry to be considered correct. When this value is empty for the record the following message appears: RR09: A price disclaimer description is mandatory.

In the following example a record has been entered into the table without a disclaimer. Initially, it has a status of "New":

After saving, an "Invalid" status appears for the record:

Price field must have a numeric value

The application validates that the value entered for the "Price" field is a number. When it find a non-numeric value the following error message is displayed: RR10: Price must have a numeric value.

In the following example, an incorrect value has been entered for the "Price" column for a record:

When saving the record, an error message appears in the "Status" column for the record:

Price field cannot be empty

The application checks if a price has been entered for the item. If a value is not found for this field the following error message will appear: RR10: Price must have a numeric value.

In the following example, an empty price has been entered for a record:

After saving, an error message appears next to the item in the "Status" column:

Price value must not have more than two decimal places

For prices, the system only allows up to two decimal places. If a price has more than two decimals, the following error is displayed: RR10: Price must have a numeric value.

In the following example, a price has been entered with three decimal values:

When saving the record, an error message appears in the status column for the record:

Color must not be empty / Color must exist for combination of model code, year and MPL code

When importing information using a csv file, the color code for each record must be filled. Also, the color entered must be valid for the combination of model code, year and MPL code. When empty or invalid, the following error message will appear: RR05: Color not found in YMPACT.

In the following example, an item has been uploaded without a value for the "Color code" column:

When saving, an error appears in the "Status" column:

Color code must be valid

When the color code entered does not exist the following error message will appear: RR08: Color is not valid.

In the following example, a record has been imported with an invalid color code:

When saving, an error appears in the "Status" column:

Country must not be empty / Country code entered must exist

When importing information using a csv file, the country code for each record must be filled. When empty or not existing, the following error message will appear: RR06: Country code does not exist

In the following example, a record has been left with the country field empty:

The record shows as "New" after being imported into YMPULSE-D:

After saving, an error message is displayed:

Language must not be empty

For records that are imported through a csv file, the application checks that the language field is not empty. If this value is empty, the following error message appears: RR04: A language has not been specified.

In the following example, a record has been imported into YMPULSE-D without a language code:

The record has a status of "New":

When saving, an error message appears in the "Status" column:

Language entered must be supported

For records that are imported through a csv file, the application checks that the uploaded combination of country and language is valid. For invalid entries the error message that will appear will be: RR03: Language is not supported.

In the following example, an unsupported language has been entered for a record:

When the file is uploaded to YMPULSE-D, it has a status of "New":

When saving, an error message appears for the record in the "Status" column:

Date must have a valid value

When the date entered does not have a correct format (DD-MM-YYYY), an "Invalid date" message will appear in the "Start date" column for the incorrect entry.

Pricing changes will not be able to be saved for the entry and an error message will appear at the top of the page.

Prices entered can have start dates in the future, as long as the entered date is no further than three months from the current date.

In the following example, an incorrect value has been entered for a date field:

Immediately after leaving the field the "Invalid date" message appears. The same will happen if an incorrect date is imported through a csv:

If the user tries to save the changes and a date in the "work file" is invalid, an error message appears at the top of the page and changes are not saved:

After correcting the wrong entries, the user can press "Save" again and update the records.

Publish prices to production

To make the changes to pricing information final, they need to be published. This is done by clicking on the  button. All of the records present in the table must have been previously validated, so the user will not be allowed to publish if he has not saved the records first in the "work file". If a user tries to publish without saving first, he will get the following error message:

Only the records with the status "Success" will be published.

Updated price or disclaimer is not appearing in Commerce Tools or on website

In some cases disclaimers or prices have been updated but after more than one day it still is not appearing on the website, in this case the model variant need to be repushed.
To trigger disclaimer and price to be send to Commerce Tools and the website following action should be taken in Ympulse-D.

1. Search model year and specific model code
2. Change start day to today (format need to be DD-MM-YYYY)
3. Add or remove a dot (.) from the price disclaimer.
4. Use Save button to save the updated records and to check if status is Successful
5. Use Publish Live button to send Successful records to database and Commerce Tools and website

       Change disclaimer to old setting: only follow below steps if needed. If Price disclaimer fine then the above steps are sufficient.

1. Search model year and specific model code
2. Add or remove a dot (.) from the price disclaimer.
3. Use Save button to save the updated records and to check if status is Successful
4. Use Publish Live button to send Successful records to database and Commerce Tools and website

Reset price work table

Press the  button to clear all of the results displayed on the screen:

Retrieve current prices for user's country

The   button is used to retrieve the list of models that currently have a price for the user's country. The difference between using this button and the "Search" button is that in the case of the "Search" button all records are retrieved regardless of it they have a price or not; and when the "Refresh" button is clicked, only models that currently have a price will be retrieved.