Discrepancy#

Services to report discrepancies in the catalog data, upload screen grabs and get statuses.

Create Discrepancy#

This service provides a method for users to report discrepancies in the catalog data.

Service Endpoint#
POST /v2/catalog/discrepancy

Parameters#

Warning

contact_email or contact_phone are required for follow up information regarding a discrepancy. If one is not provided, the discrepancy may not be resolved.

contact_name string required

First and Last name of user submitting discrepancy

contact_email string optional

Valid email address of user submitting discrepancy

contact_phone integer optional

Valid phone number of user submitting discrepancy including country code. Must adhere to E.164 international phone number standard.

location_id string required

Location ID of the user submitting discrepancy. Must be a valid location ID.

catalog_region string required

Catalog Region used to filter the catalog data. Must be a valid catalog region.

base_vehicle_id integer required

Base Vehicle ID returned from Vehicles service.

part_type_id integer required

Part Type ID returned from the Parts service.

mfr_code string optional

Manufacturer Code if available.

part_number string optional

Part Number if available.

reason_id integer optional

Reason code for the discrepancy. See Reason Codes below.

comments string required MAX 300 Characters

Detailed comment from the user describing the issue. See Comments below.

Example#

Example Request#
{
    "contact_name": "John Doe",
    "contact_email": "john.doe@example.com",
    "contact_phone": "+15555551234",
    "location_id": "STN",
    "catalog_region": "74dff468-4228-45f2-b63b-441dc8ab70c3",
    "base_vehicle_id": 3386,
    "part_type_id": 1684,
    "mfr_code": "ACD",
    "part_number": "P123",
    "reason_id": 5,
    "comments": "DOES NOT FIT 2022+ MITSUBISHI OUTLANDER",
}
Example Response#
{
    "id": 123456,
    "status": "success",
    "message": "Discrepancy submitted successfully."
}

Reason Codes#

  • 0 - Uncategorized/Other

  • 5 - Missing Part Application

  • 7 - Incorrect Part Application

  • 8 - Incorrect Image

  • 9 - Incorrect Video

Comments#

Hint

Resolution of discrepancies depends on the quality of the comments provided. We recommend providing examples or instructions to users to provide sufficiently detailed information for timely resolution of discrepancies.

The following are examples of quality comments:

  • “2010 Lexus RX350, parts is listed as #2 solenoid, is actually #1 solenoid”

  • “THIS SHOULD BE NOTED TO FIT THE 395MM ROTOR OPTION FOR THIS VEHICLE”

  • “THIS PART IS ALSO THE FRONT LEFT OUTER SHOULD COME UP WHEN YOU CLICK F.L.O. NOT JUST ON LEFT OUTER”

  • “Also fits 1988 Chevy c1500 5.7L”

  • “DOES NOT FIT 2022+ MITSUBISHI OUTLANDER”

UI Recommendations#

Example of a discrepancy UI

Upload Media#

This service provides a method for users to upload a screenshot or video to be attached to the discrepancy.

Warning

Only one media file can be uploaded per discrepancy.

Service Endpoint#
POST /v2/catalog/discrepancy/:id:/upload

URL Parameters#

id integer required

ID of the discrepancy to upload screenshot or video to. This ID is returned by the Create Discrepancy service.

The Content-Type header must be set to multipart/form-data and the method to POST. The name of the upload input must be screenshot

Get Discrepancy Status#

This service provides a method for users view the current status of a discrepancy.

Service Endpoint#
GET /v2/catalog/discrepancy/:id:

URL Parameters#

id integer required

ID of the discrepancy to be retrieved. This ID is returned by the Create Discrepancy service.

Example#

Example Response#
{
    "base_vehicle_id": 3386,
    "catalog_region": "a441b0b2-ae65-4378-9c04-08f0eeb63d95",
    "comments": "test comment",
    "created_at": "Fri, 09 May 2025 19:38:08 GMT",
    "id": 910050,
    "location_id": "STN",
    "mfr_code": "MFRCODE",
    "notes": "<p>Need more info</p>",
    "part_number": "PARTNO",
    "part_type_id": 1684,
    "reason": "Missing Part Application",
    "resolution": "Not enough information given by store team member",
    "status": "Waiting on Complaintant",
    "updated_at": "Fri, 09 May 2025 19:41:53 GMT"
}