General Description of the Feature
A new feature to cover the update of the sales prices based on the DMS prices was needed.
Until now a user could create a sales offer, add, or remove items in the offer and save the offer. DSW holds the Model & Features Master Data as well as the prices. With the current integration approach OD DSW pushes only the Offer / Sales Order Data through ODIL to any external DMS application and the downstream applications must respect the configurations as well as the prices as provided by OD DSW.
Now there is a need for price update-correction on the offer based on the DMS (SAP VSS) sales pricing master data. (VSS will be the source of Vehicle & Feature master data as well as the Sales Price Maintenance.)
To do that, an DSW-DMS Integration was made to run a price simulation via DMS SAP VSS (Vehicle Sales Service) for price correction that works as a source of truth.
The whole logic is enabled or disabled with a Setup key: EnableVehicleOfferPriceSimulation (setup key must be set to true to be able to execute the “Get DMS Prices” inside the offer in DSW)
The price simulation will be mandatory for every offer.
If the user ignores the “Get DMS Prices” and try to save the offer by selecting the apply button, an error message will appear informing the user that he cannot proceed unless the price simulation is run.
Business Benefit
Considering the fact in the automotive industry the sales prices scenarios especially for Fleet & Wholesale could be complex, it has been decided to use DMS “SAP VSS”, Price Condition Program to support this process.
In the DSW-DMS (VSS) integration, “SAP VSS” will be the source of Vehicle & Feature master data as well as the Sales Price Maintenance. Before any offer submitted to customer or converted to an order for Retail & Wholesale leads, DSW needs to validate the sales price with VSS. This is because VSS will be serve as the source of truth of the sales pricing master data.
Configuration
Setup key: EnableVehicleOfferPriceSimulation
Setup key must be set to Entity Value true to be able to execute the “Get DMS Prices” inside the offer in DSW
Mocap/Display from the Offer after selecting “Select next action > ‘Create Offer’”
API Endpoint Information's
New Endpoint - mandatory fields:
No | Fields | Description |
Header | ||
1 | Document ID | Offer ID As currently exposed in the Sales Document API |
2 | Business Partner ID | Business Partner ID As currently exposed in the Sales Document API |
3 | Customer Group | |
4 | Fleet Type | Applicable only for Fleet (Wholesale Offers) from the Business Partner. |
5 | Document Date | Offer Creation Date As currently exposed in the Sales Document API |
6 | Sales Type | New Field Sales Type from the Offer (Pls Consider Look Up Reference) |
7 | Salesperson ID | Sales Person Id creates the offer from the user creates the document |
8 | Branch Code | Branch Code the offer is created As currently exposed in the Sales Document API |
9 | Company Code | Company Code the offer is created As currently exposed in the Sales Document API |
10 | Cost Center | From the Status of the Vehicle 2 applicable Values (New Vehicle , Used Vehicle) |
11 | Make | Make Code of the Vehicles As currently exposed in the Sales Document API |
Details (Vehicle Configuration, Document Items, Trade Ins) | ||
12 | Main Line No | As currently exposed in the Sales Document API |
13 | Line No | As currently exposed in the Sales Document API |
14 | Item Type | (Line Type) Vehicle, Dealer Package, Importer Package, Sales Incentives, Service Contracts As currently exposed in the Sales Document API |
15 | Item Group | As currently exposed in the Sales Document API |
16 | Vehicle ID | As currently exposed in the Sales Document API |
17 | VIN | As currently exposed in the Sales Document API |
18 | Item Code | Either the model Codes or Item Codes As currently exposed in the Sales Document API |
19 | External Configurator | As currently exposed in the Sales Document API |
20 | Model Configuration Options | As currently exposed in the Sales Document API |
20 | Unit Price | As currently exposed in the Sales Document API |
21 | Currency | As currently exposed in the Sales Document API |
22 | Discount % | As currently exposed in the Sales Document API |
23 | Discount Amount | As currently exposed in the Sales Document API |
20 | Unit Price | As currently exposed in the Sales Document API |
26 | VAT Code | As currently exposed in the Sales Document API |
27 | VAT % | As currently exposed in the Sales Document API |
28 | VAT Amount | As currently exposed in the Sales Document API |
29 | Total Amount (Nett) | As currently exposed in the Sales Document API |
30 | Total Amount (Gross) | As currently exposed in the Sales Document API |
New endpoint is described below (PRO-392 ODIL - New endpoint to request DMS Prices)
Description | ||
Method | POST (HTTP) |
|
Base URL |
| |
Endpoint | /api/integrations/odil/onedealer/validate-offer |
|
Request Header Params | AuthToken/SessionToken/Company/Branch/Location/Make? |
|
Request | DocumentPriceSimulationModel* | |
Response | DocumentPriceSimulationModel* | We respond the same model updated |
The DocumentPriceSimulation is an extension of DocumentOrder (Document Model in ODIL).
The additional fields on top of the Document Model are described below:
Property | Type | Description | Mandt. | Mapping |
FleetType | String | Type of Fleet Type | N | N |
SalesType | String | Type of Sales | Y | Y |
CostCenter | String | Cost center | Y | N |
<DocumentModel> | ||||
New Lookups - Mapping
Property | Type | Description | Static Mapping |
SalesType | String | Type of Sales Exemplar values could be (Service Lead, Small Fleet, Taxi, Retail etc…) | Y |
Rename "Get DMS Price" to "Simulate Price" / Related Feature: ODP-4345
| ResourceCode | LanguageCode | ResourceField | ResourceString as-is | ResourceString to-be |
| OD0009306 | en-US | StaticResource | Get DMS Prices | Simulate Price |
| OD0009307 | en-US | StaticResource | The Offer Prices have not been validated against the DMS. Please press the button 'Get DMS Prices' before you save and submit the offer to the Contact/Business Partner | The Offer Prices have not been validated against the DMS. Please press the button 'Simulate Price' before you save and submit the offer to the Contact/Business Partner |
| OD0009307 | de-DE | StaticResource | Die Angebotspreise wurden noch nicht mit dem DMS abgeglichen. Bitte klicken Sie auf die Schaltfläche "Get DMS Prices", bevor Sie das Angebot speichern und an den Ansprech/Geschäftspartner senden. | Die Angebotspreise wurden noch nicht mit dem DMS abgeglichen. Bitte klicken Sie auf die Schaltfläche "Simulate Price", bevor Sie das Angebot speichern und an den Ansprech/Geschäftspartner senden. |
Additional Information
Feature Number: PRO-49
Add Comment