Inventory feed spec

This page is for the team that produces a dealership's inventory file (vAuto, HomeNet, a DMS export, a website provider). The dealer's credential sheet carries the login; this page carries everything else. Already have an Agentic Dealer Network export on file? Clone it to the dealer's login — nothing here changes per dealer.

Delivery

Two things are required by the drop itself; everything else is a preference.

Required

• Transfer: SFTP (SSH File Transfer Protocol), port 22, username and password from the credential sheet — no key exchange needed.
• File format: CSV, with a .csv filename — files with other extensions never enter processing. Each delivery is a full inventory snapshot, not a delta: the newest complete file always replaces the previous one.

Preferred

• Comma-delimited; use a pipe (|) between values inside multi-value fields (photo URLs, options). New and used in one file is fine.
• Vehicle page URL column: include each vehicle's public detail-page URL on the dealer's website (often called VDP URL, Vehicle URL or Listing URL). AI shopping agents use it to send buyers straight to the car.
• Multi-store groups: one combined file for all stores with a dealer-ID column when the login covers a group; one file per store also works — same login, same drop folder.
• Schedule: daily at minimum; up to hourly is welcome — fresher data makes the inventory more accurate for AI shopping agents.
• Company name for setup forms: Agentic Dealer Network.

Publishing files to the drop

• The login opens directly in the drop folder (/drop/) — upload where you land; no other path exists in the session.
• Upload finished files only — never .part or .tmp names, and never a file you are still writing.
• A file is treated as complete once it has sat unmodified for five minutes; a .done sidecar does not shorten that.
• Leave default permissions on upload — a client that forces owner-only mode makes the file unreadable and the delivery fails.
• Drop full snapshots on your normal cadence. The newest complete file wins; consumed files are removed automatically after a successful load.

Questions

Write to support@agenticdealernetwork.com — a real person reads it.