Overview:

This method saves a new Dealer Review for a specified Dealer.  Note that even if the save was successful, the review will not appear on the site and in the getReviews call until it has gone through our fraud processing and been approved.  This generally takes 24-48 hours.    

API: 
Dealer Review Management API
API Class: 
Dealer Review Management API
Description: 

Overview:

This method saves a new Dealer Review for a specified Dealer.  Note that even if the save was successful, the review will not appear on the site and in the getReviews call until it has gone through our fraud processing and been approved.  This generally takes 24-48 hours.          

Endpoint: /DRMService/1.2/rest/reviews/saveDealerReview

HTTP Method: POST

Query Params: None

Possible Return Codes:

Saving a Review:

SAVE_NOT_SUCCESSFUL: Failed validation (see message for details),

SAVE_SUCCESSFUL: Review was saved

Input Object:

DealerReview Object that includes a single ConsumerDealerReview.  Required fields are:

Property

Description

Validation Rule

customerIdentifier

Dealer Id

 

visitReason

1-3 of these are required.  Note that "id" can be left as 0.  

Valid Visit Reason Codes:

           SHOPUSED

            SHOPNEW

            SVCREPAIR

title

Title of the review

String Min: 5, Max 50

text

Review text

String Min: 50, Max: 4000

displayName

Users display name

String

locationDescription

Users location

String

email

Users Email Address

String

dealerEmployed

Is user employed by a dealer?

Boolean

overallRating

Overall rating user gave to dealer

1-5

recommendDealer

Would the user recommend this dealer?

Boolean

purchaseVehicle

Did the user purchase a vehicle from this Dealer?

Boolean

categoryRatings

One entry for each category. The rating number is also required (0 for N/A).  As with Visit Reason, "Id" field can be left as 0.   

One for each of the following category rating codes:

            CustomerService

            BuyingProcess

            QualityOfRepair

            OverallFacilities

affiliate

Affiliate Id of the service used to post the review.

 

Example:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dealerReview xmlns="http://api.cars.com/schemas/dealer_review.xsd">
    <customerIdentifier>5250062</customerIdentifier>
    <consumerDealerReview>
        <consumerDealerReviewIdentifier>0</consumerDealerReviewIdentifier>
        <visitReason>
            <id>0</id>
            <code>SHOPNEW</code>
        </visitReason>
        <title>Yuriy Review 2012-05-04 - 1</title>
        <text>I bought a new car from this dealer last week. The customer service was excellent and I would recommend
            them to anyone. They were very helpful with questions and made a few good recommendations.
        </text>
        <displayName>Minivan Enthusiast</displayName>
        <locationDescription>Chicago</locationDescription>
        <email>sample@cars.com</email>
        <dealerEmployed>false</dealerEmployed>
        <overallRating>5.0</overallRating>
        <recommendDealer>true</recommendDealer>
        <purchaseVehicle>true</purchaseVehicle>
        <categoryRatings>
            <id>0</id>
            <categoryType>
                <code>CustomerService</code>
            </categoryType>
            <rating>
                <id>
                    <code>CustomerService</code>
                    <ratingNumber>5.0</ratingNumber>
                </id>
            </rating>
        </categoryRatings>
        <categoryRatings>
            <id>0</id>
            <categoryType>
                <code>BuyingProcess</code>
            </categoryType>
            <rating>
                <id>
                    <code>BuyingProcess</code>
                    <ratingNumber>5.0</ratingNumber>
                </id>
            </rating>
        </categoryRatings>
        <categoryRatings>
            <id>0</id>
            <categoryType>
                <code>QualityOfRepair</code>
            </categoryType>
            <rating>
                <id>
                    <code>QualityOfRepair</code>
                    <ratingNumber>5.0</ratingNumber>
                </id>
            </rating>
        </categoryRatings>
        <categoryRatings>
            <id>0</id>
            <categoryType>
                <code>OverallFacilities</code>
            </categoryType>
            <rating>
                <id>
                    <code>OverallFacilities</code>
                    <ratingNumber>4.0</ratingNumber>
                </id>
            </rating>
        </categoryRatings>
        <ipAddress>127.0.0.1</ipAddress>
        <affiliate>
            <name>yahoo</name>
        </affiliate>
    </consumerDealerReview>
</dealerReview>

Test
Method Type: 
POST