VSS -DSW supports bidirectional integration of business partner and contact person. This means that business partner and contact person created or maintained in DSW, will also be created, and updated in VSS, and vice versa.
Prerequisites
Before sending business partner and contact person, you must ensure the following:
Technical connection has been established between VSS and DSW.
Common parameter and validation have been properly set up, in both application for example user settings, DSW setup keys and organizational structure.
Lookup values relevant to BP have been mapped between VSS and DSW for example
AcademicTitle, Profession, VatGroup, Gender, MaritalStatus, PriceList, PaymentTerms, Salutation and IndustrialSector (refers to Customer Group).
4. Reference business partner has been assigned in VSS in the following path: SAP Easy Access screen,
choose “Logistics > Logistics Execution > Vehicle Sales and Service > Master Data > Customer > Assign Reference Business Partner”
Description
In DSW, there 2 types of customers as follows:
...
No.
...
Type of Customers
...
Description
...
How it is created in DSW
...
1.
...
Private
...
Private customer i.e.: individual
...
To create a private customer, you must first create a contact person in DSW. A business partner will then be automatically created. Any business objects (for example lead or vehicle) that will be created later against the private customer will be linked to the business partner.
Create contact person > Business Partner > Assign vehicle to business partner.
It is possible that the private customer is created as a lead initially. In this case, the BP Type is “Lead”. Once the lead is converted to an offer and the customer agrees to buy the vehicle, the BP Type is updated to “Customer”. This information is crucial as it defines what VSS BP role to be assigned to the customer.
...
2.
...
Company
...
Company customer i.e.: corporation
...
To create a company customer, you must first create a business partner in DSW. Then you create a contact person and link it with the business partner. In case of company customer, linking multiple contact person is possible. Any business objects (for example lead or vehicle) that will be created later against the company customer will be linked to the business partner.
Possible business case
Create or update business partner in DSW and send to VSS
You can create or update either a private BP or a company BP in DSW. Upon saving, an API will be called to transmit the newly created or updated BP to VSS.
Activities
...
Login to DSW and enter credential.
...
From the left menu, select either “Contact Person” or “Business Partner”.
...
You should see a list of existing BPs. To create new CP or BP, click on the '+' button.
...
Maintain the CP or BP information and click ‘save’ button. Upon saving, an API will be called to transmit
the newly created or updated BP to VSS.
...
To view the BP information, click on the BP name.
...
To edit the BP information, click on the ‘arrow’ and select “Edit”.
...
Access transaction code BP in VSS to view the newly created or updated BP.
...
Create or update business partner in VSS and send to DSW
In VSS, creating a private BP or a Company BP is via the same transaction code. You can create or update either a private BP or a company BP in VSS. Upon saving, an API will be called to transmit the newly created or updated BP to DSW.
Activities
Login to VSS and enter credential.
Access transaction code BP to create or update business partners.
Maintain the business partner information and click “Save” button.
Access transaction code /DBE/ODL_BP_DISTRIBU to distribute the newly created or updated BP to DSW. This distribution can be setup to be executed immediately or as scheduled job on a pre-defined interval.
Login to DSW to view the newly created or updated BP.
In case of troubleshooting or monitoring, refer to section “MonitoringMonitoring and Tracingand Tracing” below.
Publish Vehicle
VSS is the source of vehicle inventory. New or Used vehicles will only be created or updated in VSS and sent to DSW to ensure consistent information in both applications. The salesperson
is ensured that he or she will have the latest list of inventories and would not require to access a different application to get the information. VSS will always send the latest information of a vehicle to DSW via event trigger or scheduled job. In this case, creation, or updates of vehicles in DSW is not expected.
Prerequisites
Before sending vehicle inventory to DSW, you must ensure the following:
Technical connection has been established between VSS and DSW.
Common parameter and validation have been properly set up, in both application for example user settings, DSW setup keys and organizational structure.
Lookup values relevant to vehicle has been mapped between VSS and DSW for example VehicleExteriorColorGroup, VehicleInteriorTypeGroup, OptionFamily, VehicleFuelType, VehicleType, VehicleBodyStyle, VehicleGearType, VehicleEmissionClass, VehicleEmissionSticker, VehicleAvailabilityStatus, VehicleStatus and VehicleFamily.
Model line assignment to Make has been created in VSS in the following path: SAP Easy Access screen, choose “Logistics > Logistics Execution > Vehicle Sales and Service > Master Data > Vehicle Model > Model Line Maintenance”
Vehicle Availability has been configured in VSS in the following path: Vehicle Management System (VMS) > Control Data > Define Availability
Vehicle Availability has been assigned to relevant actions in VSS in the following path: Vehicle Management System (VMS) > Control Data > Define Action Controls and Define Action Matrices
Description
VSS will always be the source of the vehicle inventory. There are no changes in the way that the vehicle is created in VSS. Inventory vehicles that are categorized as New or Used can be replicated to DSW.
...
No. | Business Transaction Type | Description | Fields |
|---|---|---|---|
NEC | New Vehicle | Vehicle GUID, VIN, Business Transaction Type, Plant, Company code, Vehicle Make Code, Model Sales Code, Model Line, Development Line, Year of Manufacture, Model Year, Passenger Capacity, Number of Doors, Object GUID, Features text, Features Class, Features Category, Features Key, Engine Performance Unit, Engine Performance, Number of Cylinders, Fuel Type, Vehicle Type, Body Type, Vehicle Sales Price, Feature Sales Price | |
2. | USC | Used Vehicle | Similar with New Vehicle with additional information as follows: Registration Date, License Plate Number, Warranty Start Date, Counter unit, Counter Reading, Next Service Date, Customer, Purchase Date |
Possible business case
Create or update vehicle information in VSS and send to DSW
Upon creation or update of vehicle information in VSS, an API will be called to transmit the newly created or updated vehicle to DSW.
...
Login to VSS and enter credential.
Access transaction code /DBE/VM to create vehicle.
Access transaction code /DBE/VSEARCH to update vehicle.
Maintain the vehicle information and click “Save” button.
Access transaction code /DBE/ODL_VEH_DISTRIB to distribute the newly created or updated vehicle to DSW. This distribution can be setup to be executed immediately or as scheduled job on a pre-defined interval.
Login to DSW to view the newly created or updated vehicle.
In case of troubleshooting or monitoring, refer to section “Monitoring and Tracing” below.
Vehicle Reservation
VSS-DSW supports bidirectional integration of vehicle reservation. This means that vehicle reservation created or cancelled in DSW, will also be replicated in VSS, and vice versa.
Prerequisites
Before sending vehicle reservation, you must ensure the following:
Technical connection has been established between VSS and DSW.
Common parameter and validation have been properly set up, in both application for example user settings, DSW setup keys and organizational structure.
Vehicle to be reserved must exist in both VSS and DSW. Therefore, before reserving a vehicle in DSW,
the vehicle must first be published from VSS.The VMS actions related to VSS vehicle reservation has been configured in VSS in the following path: Vehicle Management System (VMS) > Control Data > Define Action
The VMS actions related to VSS vehicle reservation has been assigned to the relevant action matrix in
the following path: Vehicle Management System (VMS) > Control Data > Define Action Controls and Define Action Matrices
Description
The vehicle reservation process in VSS can be used by importers or dealers. With this process, the sales
of a vehicle begin, which in common circumstances ends with a sales order. However, vehicle reservation
is not a mandatory process in the sales cycle. Its main purpose is to reserve or book a vehicle for a certain period against a customer, for a specific business purpose. By doing so, the vehicle is intentionally blocked from other customer or other usage.
...
| Info |
|---|
Note: There is also a standard SAP VMS action (RSVN) to manage vehicle reservation. However, this process is VMS specific, stores reservation information in VLCRESERVATION table and contains business and technical logic to serve specific SAP VMS business purposes. |
Possible business case
Create vehicle reservation in DSW and send to VSS
You can create vehicle reservation in DSW. Upon saving, an API will be called to transmit the created reservation to VSS.
...
Login to DSW and enter credential.
Select a vehicle from the inventory and select “Edit”.
Choose the function “Reserve Vehicle”.
Enter the required information and click “Save”.
Access transaction code /DBE/VSEARCH in VSS to verify if the vehicle reservation is replicated to VSS.
In case of troubleshooting or monitoring, refer to section “Monitoring and Tracing” below.
Cancel vehicle reservation in DSW and send to VSS
You can cancel vehicle reservation in DSW provided the vehicle has active reservation. Upon saving, an API will be called to transmit the cancelled reservation to VSS.
...
Login to DSW and enter credential.
Select a vehicle from the inventory and select “Edit”.
Go to the “Reservation” tab. In the Active reservation view and choose the function “Cancel Reservation”.
Access transaction code /DBE/VSEARCH in VSS to verify if the cancelled reservation is replicated to VSS.
In case of troubleshooting or monitoring, refer to section “Monitoring and Tracing” below.
Create vehicle reservation in VSS and send to DSW
You can create vehicle reservation in VSS. Upon saving, an API will be called to transmit the created reservation to VSS.
...
Login to VSS and enter credential.
Access transaction code /DBE/VSEARCH in VSS and select or enter the vehicle to be reserved.
In case of bulk reservation, access transaction code /DBE/MASSACTIONS.Go to the “Action” tab and choose action “Create Reservation”.
Enter the required information and press “Save”.
Access transaction code /DBE/ODL_VEH_RSV_DIS to distribute the newly reserved vehicle to DSW.
This distribution can be setup to be executed immediately or as scheduled job on a pre-defined interval.Login to DSW to view the newly reserved vehicle.
In case of troubleshooting or monitoring, refer to section “Monitoring and Tracing” below.
Cancel vehicle reservation in VSS and send to DSW
You can cancel vehicle reservation in VSS. Upon saving, an API will be called to transmit the created reservation to VSS.
...
Login to VSS and enter credential.
Access transaction code /DBE/VSEARCH in VSS and select or enter the vehicle to be cancelled. In case of bulk reservation cancellation, access transaction code /DBE/MASSACTIONS.
Go to the “Action” tab and choose action “Cancel Reservation”.
Press “Save”.
Access transaction code /DBE/ODL_VEH_RSV_DIS to distribute the cancelled reservation to DSW.
This distribution can be setup to be executed immediately or as scheduled job on a pre-defined interval.Login to DSW to view the cancelled reservation.
In case of troubleshooting or monitoring, refer to section “Monitoring and Tracing” below.
Lead, Offer and Order Management
DSW serves as the front-end tool for the salesperson to create lead and manage sales activities as well as capturing interaction with the customer. DSW supports both retail sales and wholesales transaction. VSS on the other hand, serves as the back end application for order processing where source of data for example model and prices are created and maintained. The sales transaction captured in DSW is transmitted to VSS where the subsequent sales processes for example delivery, vehicle preparation, goods movement, billing, and accounting entries are recorded.
The following are list of possible functionalities that can be executed:
...
Prerequisites
Before sending sales transactions from DSW to VSS, you must ensure the following:
Technical connection has been established between VSS and DSW.
Common parameter and validation have been properly set up, in both application for example user settings, DSW setup keys and organizational structure.
Lookup values relevant to order processing has been mapped between VSS and DSW for example PaymentMethod, ItemGroup, DocumentStatus, and SalesPerson.
Item Group has been configured in VSS in the following path: Customizing for Logistics Execution, choose “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order > Digital Sales Workplace (DSW) > Define Item Group
Mapping for Item Category has been configured in VSS in the following path: Customizing for Logistics Execution, choose “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order > Digital Sales Workplace (DSW) > Define Mapping for Item Category”
Control Value for Sales Order Type has been configured in VSS in the following path: Customizing for Logistics Execution, choose “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order
> Digital Sales Workplace (DSW) > Control Value for Sales Order Type” (Sales Order Type must have control code FO Fleet Order)Control Value for Sales Campaign has been configured in VSS in the following path: Customizing for Logistics Execution, choose “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order
> Digital Sales Workplace (DSW) > Control Value for Sales Campaign”
Description
DSW is the source of sales transactions. Both retail sales and wholesales scenario can be supported. In DSW, the salesperson creates the lead, sales offer and convert the offer to an order as well as manages the sales activities. The sales offer and sales order created in DSW will be transmitted to VSS. Creation of offer or order in VSS and sending it to DSW is not supported in this process (API not available).
...
No. | Process | Application | Description |
|---|---|---|---|
1. | Create Lead | DSW | Salespersons create lead or wholesales lead in DSW. In this process, the salesperson manages the sales activities and interaction with the customer. It is possible to setup a workflow in DSW to control the sequence of sales activities for example create test drive appointment, execute test drive, maintain test drive questionnaires, record trade-in vehicle, schedule follow up activities and create or cancel offer. A lead can be created for an inventory vehicle or via a car configurator. |
2. | Create Offer | DSW | In this process, the salesperson prepares the offer according to the customer requirement. The salesperson can perform the following:
In case of wholesales offer, the salesperson can indicate the quantity of vehicles and each vehicle will be represented as separate lines in the offer. |
3. | Initiate Price Simulation | DSW | Once the offer has been prepared, the salesperson can initiate a price simulation. This process ensures that the offer prepared for the customer always reflects the latest price from the source application. Once the “GetDMSPrice” button is triggered, DSW sends a request to VSS via the above-mentioned API and call the price simulation engine. |
4. | Simulate Price | VSS | Upon receiving the price simulation request from DSW, VSS response back to DSW with the latest price and updates the prices in the offer. In general, the sales price simulation engine in VSS is technically similar to creating a sales order in VSS, just not committing to create a document. Therefore, it is important that DSW sends to VSS the required fields in order for VSS to correctly simulate the price. In the event of error or missing fields, VSS will return an error message to DSW and prices in the DSW offer will not be updated. |
5. | Update Price in Offer | DSW | Salesperson verifies that the sales prices is updated correctly in the offer. |
6. | Save Offer | DSW | Upon verifying the prices, the salesperson saves the offer, and a message will be triggered to VSS to create a VSS sales quotation. The API used for sending sales offer or sales order from DSW to VSS is the same. There are also certain cases in a project implementation where creation of VSS retail sales quotation is not a mandatory process. This integration supports this scenario where the sending of retail sales offer to create a VSS sales quotation is deactivated/turned off. In this case, pressing the Save Offer button in DSW will not trigger any request to create a VSS sales quotation. |
7. | VSS Sales Quotation | VSS | Upon receiving the request to create a quotation from DSW, VSS will use the information in the API to create a sales quotation in VSS. It is important to ensure that the control value for order type has been correctly configured in VSS. Refer “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order > Digital Sales Workplace (DSW) > Control Value for Sales Order Type” in customizing. DSW structures the offer or order by item types. Examples of item types that are possible in DSW are Item, ItemWithoutTax, InventoryVehicle, ConfigurationVehicle, TradeIn, VehicleExtraOption, VehicleManualOption, VehicleStandardOption, DealerPackage, ImporterPackage, TaxOnly, Damages, VehicleEvaluation, Discount, ServiceContract, Charges, Accessories, TextLine, AutoItem, Other. This can be found in the API, under the “dealItems” section as follows:  On the other hand, VSS structures the quotation or order by item categories or condition types (in case of sales incentives). Therefore, it is important to ensure that the mapping between DSW item types and VSS item categories are correctly configured in VSS. Refer “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order > Digital Sales Workplace (DSW) > Define Mapping for Item Category” in customizing. Example as follows:  |
8. | Customer Accept Offer | DSW | After sending the offer to customer, the salesperson can utilize DSW functionalities to schedule follow up calls or other sales activities and subsequently turn the lead into opportunities. If the lead is successful, the salesperson can trigger the “Accept Offer” action in DSW to indicate that the customer accepts the offer and agrees to purchase the vehicle. |
9. | Convert Offer to Order | DSW | Upon securing the lead, the salesperson will then convert the offer to an order. This triggers a request to VSS to create VSS sales order. Once the order has been created, it can no longer be updated or changed. In case a change is required, the order needs to be cancelled and the process restarts where a new offer will be created for the customer. |
10. | VSS Sales Order | VSS | Upon receiving the request to create an order from DSW, VSS will use the information in the API to create a sales order in VSS. It is important to ensure that the control value for order type has been correctly configured in VSS. Refer “Vehicle Sales and Service (VSS) > Vehicle Sales > Integration with VSS Order > Digital Sales Workplace (DSW) > Control Value for Sales Order Type” in customizing. VSS will create the order with reference to quotation, the order will be created by copying it from the quotation (similar logic with transaction /DBE/ORDER05). If the quotation doesn’t exist (Retail Offer is not relevant for DSW integration: Parameter /DBE/QT_RETAIL_P = ‘ ‘), the sales order will be automatically created from scratch based on the information from the API. |
11. | Assign Vehicle to Sales Order | VSS | If the offer is created in DSW based on inventory vehicle and converted to order, then the same vehicle will be assigned automatically with the order creation in VSS. Usually, once the sales order has been created, the subsequent sales process will happen in VSS for example vehicle preparation. In general, the vehicle will be prepared by the logistic department. The vehicles that are ready for delivery will be assigned to the sales order in VSS. In some project implementation, it is common to have a custom logic (for example FIFO) to select which vehicles will be assigned to the sales order based on certain criteria for example by vehicle aging or by last goods receipt date. Vehicle assignment or un-assignment happens in VSS via the “MB_VEH_ASSIGN” and “MB_VEH_UNASSIGN” action triggered within the sales order. Upon triggering these actions, a request will be sent to DSW to send the vehicle assignment/un-assignment information. |
12. | Status Updates | DSW
| Upon receiving the vehicle assignment or document update status request from VSS, DSW will update the document status accordingly. It is important to ensure that the document statuses are correctly mapped between DSW and VSS. These statuses may vary according to project implementation and specific customer business requirement. In general, there are two statuses that will be updated from VSS to DSW:
|
VSS
| Upon receiving the document update status request from DSW, VSS will update the document status accordingly, i.e., order cancelled. | ||
13. | Delivery, Billing, etc | VSS | The subsequently sales process to complete the end-to-end vehicle sales cycle happens in VSS. These processes vary between brands or project implementation. Example of these processes are managing deliveries, handling goods movements, billing, and accounting entries. These processes are not executed by the salesperson and are normally or traditionally handled in the backend application, in this case VSS. |
Possible business case
Create lead or wholesale lead
Before creating the sales offer, the salesperson must first create a lead or a wholesale lead in DSW. A lead normally refers to individual customer (purchasing a single vehicle) while a wholesale lead refers to bulk
or fleet customers (purchasing more than one vehicle). DSW supports both retail sales and wholesales scenario. In both cases, it is possible to create an offer from the inventory vehicle or from a configurator.
...
In both type of configurators, the models and features information originate from VSS based on the model uploaded to DSW. Choosing between light configurator or advance configurator is a customer decision
in the project implementation.
Create sales offer
Once the lead or wholesales lead is created, the salesperson can use DSW to prepare offer to their potential customers. DSW supports both retail sales and wholesales scenario. The following describes on a high level, the possible functionalities within the sales offer.
...
Example of items within an offer:
...
Initiate sales price simulation
VSS is the source of master data which includes sales price information. You can initiate sales price simulation when creating an offer in DSW. In this case, an API will be called to transmit the sales price simulation to VSS.
...
“Get DMS Prices” button within the offer.
...
Convert sales offer to sales order
Upon acceptance of the offer by the customer, the salesperson can covert the sales offer to a sales order. Once this is executed in DSW, a call will be made to send the sales order to VSS.
The following then will be executed in VSS:
...
In case a sales quotation does not exists in VSS, a sales order with VSS order type 3500 will be created. The content of the sales order is based on the information received in the API.
Assign vehicle to sales order
During the creation of sales order in DSW, an actual vehicle or reference vehicle may have been assigned
to the sales order. This is considered a logical assignment as at this point, the salesperson may not be aware of the actual situation of the vehicle in the stockyard for example, is the vehicle ready for delivery or what
is the aging situation of the vehicle. In this case, the vehicle administrator or stock controller have better visibility of the situation and will have better understanding of which vehicle to be assigned to the sales order. Therefore, a valid vehicle assignment to sales order is commonly executed in the backend (VSS).
By standard VSS, the vehicle assignment is executed by the VSS action MB_VEH_ASSIGN while the vehicle un-assignment is executed by the VSS action MB_VEH_UNASSIGN. Once these processes are executed,
a call will be made to send the vehicle assignment/un-assignment information to DSW. This ensures that the information is synchronized between VSS and DSW and identical information is displayed on both applications.
Sales order status update
Sales order status updates in VSS should be sent to DSW to keep both systems synchronized and avoid any inconsistency. Order status is one of the mapping values, meaning, what order status
to be mapped between VSS and DSW can be defined in a customer implementation. Only relevant order status should be mapped. The following are some examples of a possible sales order status mapping:
...