Sales

Cognos API

This API provides different information methods to provide information to a BI system or similar. It was developed for the Cognos system but can be used for other BI tools.

Use cases

There are many methods to provide information at different knowledge levels; some examples are shown below.

• Vehicle information by VIN or Plate
• Showroom vehicles
• New vehicle invoices
• Active Orders and Vehicles delivered to customers
• New vehicles and Used vehicles sales report
• Used vehicles stock report

Availability

Available for all markets, but we must keep the current Portuguese definition.

eCommerce

This API allows the user to retrieve the stock of vehicles, both new and used, their images, and also to book vehicles in the SIMA stock.

Use cases

Its main use is for new and used car eCommerce, but can also be used for other types of external tools that want to get the stock, prices, and images.

Availability

Available for all markets. It is important to note that Sima does not provide a tool for images, but the system can use a repository from the importer or a service provided by the factory.

Price Importer Sales

This API provides price information related to new vehicles.

Use cases

We can use this API to get prices for a VIN. The system returns prices with and without tax for the model, colour, total equipment, and total amount of the vehicle.

Availability

Must be clarified for different markets according to specific taxation rules and currencies.

SalesLogistics API

This interface will cover main logistics processes which are currently provided by other APIs.

Use cases

• Receive vehicle location.

Availability

It is available for the DAG market, although additional specifications may be required for other markets.

SalesAssistantApi

This API facilitates the creation of leads in the market's sales system, such as Diler or SIMA Desktop. It allows for the creation of sales processes to assign customers to a salesperson.

Use cases

• Lead Creation: Leads typically originate from landing pages, CRM tools, or platforms where the end customer expresses interest in a vehicle.
• Diler Integration: A new lead is created in the Diler Lead pool. Advisors with access to the specific brand can then create a sales process associated with that lead.
• SIMA Desktop/SIMA Suite Integration: A sales process is created directly with the lead.

Availability

Currently available in Spain, Panama, and Peru. It becomes available as the customer is localized for the specific market.

Dependencies

CustomersApi

Vehicles API

Retrieve information about a vehicle

Use cases

• Vehicle´s definition
• Logistic information

Availability

Available for all markets.

Note: Not all methods are available in all markets.

VehicleOrders

This API allows users to:

• Work mainly with the stock and orders in Ordering
• Manage order proposals
• Send customer to be linked to an existing order from external systems such as DMS.

Use cases

Its main use case is to be linked to other tools such as portals or logistics tools.

• Stock Orders: a method that returns orders that are in Stock or Customer Delivery Pending status, but are vehicles that are already in the dealer's stock.
• Proposals: receive an order proposal from external systems that refers to an external sales process and can be linked to an existing order or a new order.
• Logistics, to receive and process the following cases:
• • Arrival at Importer: when the vehicle is in the importer's warehouse.
  • Estimated Delivery to Dealer: the planned delivery date from the importer to the dealer.
  • Delivery to Dealer: actual delivery date from importer to dealer.
  • Arrival at Dealer: date of arrival at the dealer, i.e. the vehicle is in the dealer's stock.
  • Delivery to customer: final delivery to customer.

Availability

Available for all markets.

Note: Not all methods are available in all markets.

SalesforceSalesprocessStreamingApi

This is a streaming API designed to expose real-time information regarding events associated with sales processes.

Use Cases

This API exposes information regarding events associated with sales processes. It functions as a reading API for the following specific events:

• Sales.Sales Process.Anonymized.v1: Occurs when a sales process is anonymized.
• Sales.Sales Process.Created.v1: Occurs when a sales process is created.
• Sales.Sales Process.CustomerChanged.v1: Occurs when the customer of a sales process is changed.
• Sales.Sales Process.SalesmanOwnerChanged.v1: Occurs when the advisor responsible for a sales process is changed.
• Sales.Sales Process.Sale.Completed.v1: Occurs when a sales process has been completed.
• Sales.Sales Process.Sale.Completed.Cancelled.v1: Occurs when a completed sales process is cancelled.
• Sales.Sales Process.Sale.Cancelled.v1: Occurs when a sales process is cancelled.
• Sales.Sales Process.Rejected.v1: Occurs when a sales process is rejected.
• Sales.Sales Process.Delivered.v1: Occurs when a sales process is delivered.
• Sales.Sales Process.Succeeded.v2: Occurs when a sales process is accepted.
• Sales.Sales Process.Vehicle.Delivered.v2: Occurs when a vehicle from a sales process is delivered.
• Sales.Sales Process.Vehicle.Delivery.Cancelled.v1: Occurs when the delivery of a vehicle from a sales process is cancelled.

Availability

Available in Spain, Peru, and Panama.

Dependencies

CustomersApi