Skip to content
DriveAgent
Documentation Menu

Tools

Seller Mapping

How your dealership identifier routes vehicles to the correct inventory feed.

How routing works

Each vehicle you send includes a Seller.Identifier — this is your dealership’s ID from your own system. On our end, we map this identifier to the correct franchise, location, and inventory feed.

Your System                          DriveAgent
┌─────────────────────────────┐     ┌──────────────────┐
│ Seller.Identifier           │────>│ Franchise Feed    │
│ "a1b2c3d4-e5f6-7890-..."   │     │ "Metro Ford"     │
└─────────────────────────────┘     └──────────────────┘

This means:

  • You send your own identifiers as-is
  • We handle the mapping on our end
  • Each dealership location needs its own unique Seller.Identifier
  • Vehicles with the same Seller.Identifier appear in the same inventory feed

Multi-location dealers

If you operate multiple dealership locations, each location must use a distinct Seller.Identifier. For example:

Your Seller.IdentifierMaps to
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"Metro Ford
"b2c3d4e5-f6a7-8901-bcde-f12345678901"Southside Toyota
"c3d4e5f6-a7b8-9012-cdef-123456789012"Eastgate Hyundai

This ensures each location has its own separate inventory feed.

Setting up mapping

Before sending production data, contact support with:

  1. Your Seller.Identifier value(s) for each dealership location
  2. The dealership name and address for each location
  3. Which franchise/brand each location represents

We will configure the mapping and confirm when you’re ready to send.

Seller fields

These fields are sent with each vehicle to identify the seller:

"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
  }]
}

The Seller.Identifier and Seller.Name are required. All other seller fields are optional but recommended for complete listings.