3.15.3 - Integration with Softly

General Description of the Feature

This feature deals with the redesign of a Publish Marketplace functionality and direct integration with API produced by Softly and used in all of their Marketplace web apps. Vehicles from within the DSW Inventory can be prepared and published in the relevant marketplace.

Data Preparation

In order for a publication to be successful, the different data that are related with the vehicle and are involved in the publication process, should be prepared and mapped with the respective values from the Softly application. 

These are the following:

• Make
• VehicleFamily
• VehicleType
• VehicleBodyStyle
• Branch
• VehicleExteriorColorGroup
• VehicleInteriorColorGroup
• VehicleInteriorTypeGroup
• VehicleGearType
• VehicleFuelType
• VehicleFlag
• DriveTrain

In addition, the Vehicle Statuses, Engine Types and Pricelists should be prepared based on the business process that will be used.

Vehicle Preparation

All the vehicles included in the vehicle inventory can potentially be published in the marketplace. The fields, included in the vehicle card page and that are crucial for a successful publication are the following:

Mandatory:

• Make
• Family
• Model as a Comment
• Vehicle Type
• Body Style
• Mileage
• Power (HP)
• Exterior Color
• Interior Color
• Gear type
• Fuel Type
• Engine Displacement

Other fields of the vehicle entity integrated with the Softly API can be found in the table below:

Publish/Republish Vehicle in the Marketplace

As soon as a vehicle is prepared with all the mandatory and optional data, the responsible User can select from the "Actions → Softly (description set in the relevant Setup key) → Publish" to publish the vehicle. The system will perform a validation and check if all the data selected are properly mapped and if all the mandatory fields in the vehicle card page are filled. In case of something missing, the publication will not be successful and the user will be notified with a message informing him/her about the missing vehicle data. On a successful try, the user will be informed respectively.

In the tab called "Marketplace" the users can find a full history of all the publication attempts (successful or not) a user has made. The list includes the exact date/time of each publication attempt, as well as the Publication results with the relevant message, the username of the user that performed the publication attempt and the Publication ID as given from the target system, in the case of a successful publication.

After a successful publication the user can make changes in the vehicle data, if needed, and select to republish again the vehicle "Actions → Softly (description set in the relevant Setup key) → Republish". In this case, the attempt will be recorded again the Marketplace tab and the information of the vehicle in the marketplace publication page will be updated.

Certain field upon update can trigger an auto-republish, if the respective functionality is enabled:

• Panoramic View (360) → Details tab → Marketplace section
• Video Link → Details tab → Marketplace section
• Branch → Details tab → Main Information section
• Add or remove a photo → Photo tab & Action button → Upload Photo
• Update any price from the prices list (via the Pricelists action menu) → Pricing tab & Action button → Pricelist → Actions button → Set price

Relevant Documentation: https://wiki.onedealer.com/x/LAJbAg

Remove publication from Marketplace

Sold Vehicles

An action via a Workflow transition can be performed that triggers a relevant External Function and marks the related VOI and thus Inventory vehicle as sold in the Softly Marketplace.

Business Benefit 

Integration with Marketplace web applications developed by Softly and possibility to publish directly vehicles in these marketplaces.

Configuration 

Administration and Process pages

• ~/Marketplace/MarketplaceList 
  • Configure the Marketplaces that the system will be integrated with. The codes of these marketplaces should be configured in the relevant setup keys.
  • Configured in each created marketplace:
    • The image that each marketplaces should be represented
    • The pricelists that should be activated by default for publication

Setup Keys

• SoftlyMainUrl = Softly integration service base URL
• SoftlyApiKey = Softly authentication token
• SoftlyMarketplaceCode = Softly marketplace code from DSW ~/Marketplace/MarketplaceList
• SoftlyDisplayText = Marketplace name to be displayed in OneDealer UI

Mapping

• Relation: OneDealer To Softly
• Object Types:
  • Make
  • VehicleFamily
  • VehicleType
  • VehicleBodyStyle
  • Branch
  • VehicleExteriorColorGroup
  • VehicleInteriorColorGroup
  • VehicleInteriorTypeGroup
  • VehicleGearType
  • VehicleFuelType
  • VehicleFlag
  • DriveTrain

Workflow

External Functions

• 8DBFA54EA2CC746 - Mark Vehicle as Sold to Softly
  • Marks the vehicle on Softly side, as sold and marks vehicle publication status as Removed on DSW side.

Additional Information