Skip to content

Seller Schema

Complete field reference for the Seller (Customer) entity.

Based on the CSN-DTO Customer standard. The Seller object is included with each vehicle payload to identify the dealership.

Seller (Customer)

FieldTypeRequiredDescription
IdentifierGUID / stringYesUnique identifier for the dealership. We map this to the correct franchise and feed on our end
NamestringYesBusiness or dealership name
TypestringNoDealer, Private, OEM
LocationCodestringNoLocation identifier code
LocationNamestringNoLocation display name
LocationIdnumberNoLocation numeric ID
LogostringNoURL to dealership logo
DealerLicenceNumberstringNoe.g. LMCT number
DealershipGroupNamesstring[]NoParent dealer group names

Addresses

Array of address objects for the dealership location:

FieldTypeDescription
Line1stringStreet address
Line2stringAdditional address line
SuburbstringSuburb or city
StatestringState code, e.g. VIC, NSW
PostcodestringPostcode
CountrystringCountry name
CountryCodestringISO two-char code, e.g. AU
LatitudenumberGPS latitude
LongitudenumberGPS longitude

Contact

FieldTypeDescription
PhonestringPrimary phone number
OperatingHours[].WeekdaystringDay of week
OperatingHours[].StatusstringOpen or Closed
OperatingHours[].OpenstringOpening time
OperatingHours[].ClosestringClosing time

Example

{
  "Seller": {
    "Identifier": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "Type": "Dealer",
    "Name": "Metro Ford",
    "LocationCode": "MF01",
    "LocationName": "Metro Ford City",
    "DealerLicenceNumber": "LMCT12345",
    "DealershipGroupNames": ["Example Dealer Group"],
    "Addresses": [{
      "Line1": "100 Main Street",
      "Suburb": "Richmond",
      "State": "VIC",
      "Postcode": "3121",
      "Latitude": -37.8232,
      "Longitude": 144.9876
    }],
    "Contact": {
      "Phone": "03 9000 0000",
      "OperatingHours": [
        { "Weekday": "Monday", "Status": "Open", "Open": "8:30am", "Close": "5:30pm" },
        { "Weekday": "Saturday", "Status": "Open", "Open": "9:00am", "Close": "1:00pm" },
        { "Weekday": "Sunday", "Status": "Closed" }
      ]
    }
  }
}

Mapping setup

Before sending production data, contact support with your Seller.Identifier values for each dealership location. See Seller Mapping for details.