FAQ

General Questions

Questions about configuration

Which data are available online ?

At anytime, only the data corresponding to the latest applicable tariff of each marketing model are available. Applicable means that the application date defines in AOC by the tariff manager is equal or greater to the current date.

When data are updated ?

The data available online are updated automatically once a day during the night if a new applicable tariff is available for a marketing model.

How do I know if data have been updated ?

You have two ways to do it :

  • Check the docId of each documentations and compare it with what you have locally. If tariffNumber, tariffAdditiveNumber or creationTimeStamp has changed for the same market, program, phase, modelkind then it means that data for the marketing model has changed.
  • Check directly if the documentation has been changed by calling the doc URL. If it doesn't exist anymore you will get a HTTP 404 return code.

How can I retrieve the list of Models ?

For that you have to use the ressource C2GConfServerResource to retrieve the list of available docs. Each documentation represents a model marketing. Then you have to get each documentation by following the link present in doc element and finally get presentationData to retrieve the label of the marketing model. See the example.

How can I retrieve the list of Versions ?

For that you have to use the ressource C2GPresentationResource to retrieve marketingModelPresentation data. In those data you will find versionsPresentation which contains all the versions available for the selected model. Those versions are classified by presentationGroup. Be carefull, you may have multiple levels of presentationGroup. See the example.

How can I retrieve the list of Options ?

For that you have to use the ressource C2GPresentationResource to retrieve marketingModelPresentation data. In those data you will find equipementsPresentation which contains all the options available for the selected model. Those options are classified by presentationGroup. Be carefull, you may have multiple levels of presentationGroup. See the example.

How can I retrieve the technical features for a model ?

For that you have to use the ressource C2GPresentationResource to retrieve marketingModelPresentation data. In those data you will find technicalSpecificationsPresentation which contains all the technical features for the selected model. Those technical features are classified by presentationGroup. Be carefull, you may have multiple levels of presentationGroup.

How can I retrieve the price of a version and an option ?

For that you have to use the ressource C2GPriceListResource to retrieve pricesList. In those data you will find a list of prices and for each element the element priceType which defined the type of the price such as (Public price, Public price without VAT, ...) and the element versionPriceList which contains the price of each version and the price of the options for this version. Be carefull the price of the same option can be different between different versions. See the example.

How do I know which options can be shown for a specific version ?

For that you have to use the ressource C2GPresentationResource to retrieve marketingModelPresentation data. In those data you will find versionsPresentation which contains all the versions available for the selected model. For a specific version (versionItemElement) you will find the element showableSpecCodes which contains a list of all the options that can be shown for the version.

How do I know which colors and painting quality can be shown for a specific version ?

See previous question. Painting quality and colors are part of the element showableSpecCodes.

How do I know if an equipment is standard, on option, forbidden or belong to a pack on a specific version ?

For that you have to use the ressource C2GVersionCategoryResource to retrieve versionsCategories data. This will give you for each version all the options and the category they belong. Among the categories, you can find :

  • SYSTEMATIC : specification is standard on the version and there's no alternativ on same specification category
  • DEFAULT : specification is default on the version and there is an alternativ as option on same specification category
  • OPTION : specification is optional on the version and is not include in a pack
  • OPTION_PACK : specification is available as an option and as a part of a pack of specifications
  • PACK : specification is a part of a pack of equipments and is only available in a pack
  • FORBIDDEN : specification is unavailable on the version (It's not included neither as an option nor in a pack)

See the example.

How can I find the colors available for a model ?

For that you have to use the ressource C2GPresentationResource to retrieve marketingModelPresentation data. In those data you will find the element colors which contains all the colors available for the selected model. Be carefull, all the colors are not available on all the versions of the model.

How do I know which colors belong to a painting quality for a marketing model ?

For that you can use the ressource C2GCombinationsResource. You give the parameters docuri with the documentation corresponding to the marketing model, scc with the lexicon object code corresponding to color and scc with the lexicon object corresponding to the painting quality. See the example.

How do I retrieve the components of a pack ?

You can retrieve this information in the diversity data of a model by using the resource C2GSpecCatsResource. This will return a list of Specification categories (specCat) which will contain a list of Specifications (spec) and among the specifications the one with the properties "@type" equals to "packSpec" are the pack. The content of the pack is described in this specification. See the example.

How do I identify a version ?

Due to historical reasons there are 3 ways to identify a version :

  • The versionId
  • The versionSeq
  • The versionName

We advise you to use the versionId. If you want to get the mapping between those identifiants, you can use the service of combinations (C2GCombinationsResource) with the following parameters :

  • scc=004 (versionName)
  • scc=versionId (versionId)
  • scc=970 (versionSeq)

How do I get the semi-clair corresponding to a configuration ?

For that you can use the ressource C2GSemiClairResource. You give the confuri in parameter and the service will return you the Semi-Clair Renault corresponding to the configuration. If you want to get the semi clair local (country) of this configuration, you have to translate it by using the mapping between SCR - SCL returned by the ressource C2GLocalSemiClairResource.

What is a configurator ?

A configurator is a piece of software intended to help a customer to choose the specific product that best fits his needs among a whole range of products. This is an interactive process because the specifications of the product are chosen one at a time by the user, feature by feature. The use of a configurator is particularly suited to situations where the customer must pick up his choice among a high number of variants, with highly constrained combinations of features.

What is required is that the configurator ensures that every customer's choice is compatible with his former choices. No dead end: at every step, the partial specification has to remain consistent with the Product Diversity definition. This is not obvious because, generally, specifications of the product are subject to a number of logical constraints. For example SpecA excludes SpecB under certain conditions, or SpecA implies SpecB or SpecC. These constraints transform the configuration process into an inference process that can be entirely modeled as a constraint propagation problem.

Let's just say that configuration is a hard process on automotive products due to the huge diversity and that's why we provide you a web service which hide all this complexity.

How should I use the service of configuration ?

An example is better than an explanation...

When should I need to use the service of configuration ?

The service must be used anytime you want to select a car from the customer choices because it's the only way to ensure that the vehicule you propose can be manufactured (all the constraints are taken into account implications, exclusions, packs) and is at the right price.

How can I save a configuration in my application ?

To save the current configuration during the process of configuration you just have to save the link presents in the item canonicalURI.

How can I use a configuration which has been saved previously and may be in another application (Website, Mobile application, ...) ?

To do that you have to use the ressource C2GResolveConfURIResource which will help you to resolve the URI. Give the URI you want to resolve in parameter and the service returns you the most suitable configuration according to the documents on line at this time. It will also provide you the choices made in the configuration, the URL of the document that suits the best and his docId. If the service can't resolve the URI you will get a 404 error.