Configuration

After installation, open the Kiss Datafeed Configuration tool from the Start menu. You'll see a window with a left-hand navigation rail listing the five screens: Settings, Schedule, Service, Image Download, and About.

This page walks you through the Settings screen, which is where you enter your credentials and choose where your CSV files should be saved.

Settings screen

The Settings screen has two cards — API Connection and Output — plus an optional Advanced section near the bottom.

API Connection

This card is where you tell the app who you are and which Kiss data endpoint to use.

Field	What to enter
Customer code	The customer code Kiss issued you when you signed up.
Client secret	The API key Kiss issued you. After saving, this is shown as dots; click Change to enter a new value.
API profile	Leave this on the default value (e.g. "Kiss Datafeed API (2026‑04) — Production") unless Kiss has asked you to switch.
API base URL	Pre-filled from the API profile. You only need to change it if Kiss has given you a specific custom endpoint.

When you've entered your credentials, click Save first, then click Test connection. The Test connection button verifies the credentials that are currently saved on disk — not whatever is typed into the client-secret box at that moment — so any changes need to be saved before they can be tested. After a successful test you'll see a green confirmation message such as "Connected — API 2026‑04". If the test fails, see Troubleshooting.

:::tip Keep your API key safe Treat your API key like a password. Anyone with your Customer Code and API key can download your data. If you suspect it's been exposed, contact your Kiss account manager to have a new one issued. :::

Output

This card tells the app where to save your files and what they should be named.

Field	What it does
Output folder	The folder where products.csv and stock.csv will be written. Click Browse to pick one.
Filename mode	Choose Fixed to keep two files that are overwritten on every run. Timestamped is reserved for a future release and currently behaves the same as Fixed.

In version 1.0.0, both filename modes write to the fixed filenames products.csv and stock.csv. Timestamped output (one file per sync) is on the roadmap for a future release.

:::caution Network locations If you pick a network location, use the full UNC path (e.g. \\fileserver\share\datafeed\) rather than a mapped drive letter. The background service runs as the LocalSystem account and cannot see drive letters mapped by an interactive user. The Configuration tool will offer to convert a mapped drive to UNC for you automatically. :::

Advanced (optional)

The Advanced section is collapsed by default. Most customers will never need to change anything here.

Setting	Default	When to change
CSV encoding	UTF‑8 with BOM	Switch to Windows‑1252 if Excel shows garbled characters when opening the file.
CSV delimiter	Comma	Switch to semicolon or tab if your downstream system requires a different separator.
Array separator	| (pipe)	Choose a different character if pipe clashes with data in your downstream system. See Data files.
Composition delimiter	: (colon)	Choose a different character to separate fields inside a single array item. See Data files.
Include unknown fields as extra columns	On	Leave this on so new fields added to the Kiss data service automatically appear in your CSVs.

Saving your changes

The Save button is in the bottom-right of the window. A small dot appears next to it when you have unsaved changes. After saving, a green confirmation banner appears at the top.

You do not need to restart the background service after saving. The configuration tool notifies the service immediately, and your changes take effect within a few seconds. If the service isn't running when you save, your changes are preserved on disk and will be picked up the next time the service starts.

Next: schedule when the data refreshes

Continue to Scheduling to choose how often your data refreshes and to trigger your first sync.