Feeds

Feeds are incoming inventory files that are mapped to autoZnetwork. We currently accept SFTP feeds, with vendor credentials provided when creating the feed through the API.

We do provide a selection of common 3rd party vendors with formatting established already by using Feed Providers. These vendors are already in our system and as soon as the file is dropped in the SFTP directory, autoZnetwork will begin importing the inventory.

Anytime a file is dropped into the SFTP directory, it begins processing immediately. No more waiting around for the next hour to process the imported file!

Feed Providers

ProviderValue
Dealer Firedealer-fire
vAutovauto
Homenethomenet
Lot Wizardlotwizard
ASN Softwareasn-software

Feed Bundling

A common scenario that automotive vendors struggle to handle is moving inventory between locations without taking the vehicle offline. Consider the following scenario:

  • A vehicle is located at Feed (Location) 1 (feed1.csv)
  • The vehicle is added to Feed (Location) 2 (feed2.csv)

Most providers mark the vehicle as "sold" at Feed (Location) 1, and then create a new vehicle at Feed (Location) 2. This results in logs not going with the original vehicle, along with all sorts of disconnected data.

We offer "Feed Bundling" which allows you to wait for multiple feed files to arrive before processing resulting in the following:

  • A vehicle is located at Feed (Location) 1 (feed1.csv)
  • Bundling is enabled so Feed (Location) 1 will not be processed until the remaining files have arrived
  • The vehicle is moved to Feed (Location) 2 (feed2.csv)
  • feed1.csv and feed2.csv are combined, then the inventory is synced up resulting in the vehicle moving between locations without being taken offline.

List Feeds

GET Request: https://api.autoznetwork.com/v1/feeds

CURL
AUTOZNETWORK_TOKEN="your API token"
AUTOZNETWORK_ORG_ID="your organization id"

curl https://api.autoznetwork.com/v1/feeds \
  -H "Authorization: Bearer $AUTOZNETWORK_TOKEN" \
  -H "X-AutozNetwork-Organization-Id: $AUTOZNETWORK_ORG_ID" \
  -H 'Accept: application/json'
PHP
<?php 
$apiToken = 'ABCD12345 ...';
$organizationId = '1234';

$autoZnetwork = new AutozNetwork($apiToken);

$feeds = $autoznetwork
              ->withOrganization($organizationId)
              ->feeds()
              ->get();

print($feeds)

Add a Feed

POST Request: https://api.autoznetwork.com/v1/feeds

CURL
AUTOZNETWORK_TOKEN="your API token"
AUTOZNETWORK_ORG_ID="your organization id"

curl -X POST https://api.autoznetwork.com/v1/feeds \
  -H "Authorization: Bearer $AUTOZNETWORK_TOKEN" \
  -H "X-AutozNetwork-Organization-Id: $AUTOZNETWORK_ORG_ID" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "active": true,
    "supplemental": false,
    "provider": "vauto",
    "name": "your feed name",
    "filenames": "filename1.csv,filename2.csv",
    "mapping": "",
    "location_mapping_type": "file",
    "location_mapping": {
      "LOCATION_ID": "filename1.csv",
      "LOCATION_ID_2": "filename2.csv",
    },
    "driver": "sftp",
  }'
PHP
<?php 
$apiToken = 'ABCD12345 ...';
$organizationId = '1234';

$autoZnetwork = new AutozNetwork($apiToken);

$feed = $autoZnetwork
              ->withOrganization($organizationId)
              ->feeds()
              ->create([
                'active' => true,
              ]);

print($feed)

Parameters

A Feed must have a driver.
ParameterTypeDescription
activeBooleanDetermines whether to process the feed files when dropped.
supplementalBooleanIdentifies if the feed is a supplemental feed or inventory feed.
providerStringFeed Provider slug/value for pre-formatted mappings.
nameStringA friendly name to identify the incoming feed.
filenamesArrayAn array of filenames that are whitelisted to be processed.
mappingObjectA mapping of column headers to values for the inventory feed.
location_mapping_typeStringDetermines whether the location_mapping is by "file" or "column".
location_mappingObjectKey value object, with the key being the LOCATION_ID and the filename matching a file in the "filenames" array.
driverStringCurrently only "sftp" is supported. The credentials will be returned in the the "driver_settings".

Response

JSON
{
  "id": 5000,
  "active": true,
  "supplemental": false,
  "provider": "vauto",
  "name": "your feed name",
  "filenames": [
    "filename1.csv",
    "filename2.csv"
  ],
  "mapping": "",
  "location_mapping_type": "file",
  "location_mapping": {
    "LOCATION_ID": "filename1.csv",
    "LOCATION_ID_2": "filename2.csv",
  },
  "driver": "sftp",
  // Generated Driver Settings
  "driver_settings": {
    "sftp_host": "sftp.autoznetwork.com",
    "sftp_port": "22",
    "sftp_user": "vauto_username",
    "sftp_password": "RandomPassword123!"
  },
  "created_at": "2020-07-29 16:08:30",
  "updated_at": "2020-07-29 16:08:30",
}
Table of Contents