File format & naming

Supported formats

Conflixis will pick up and ingest files with any of these extensions from the configured folder:

Extension	Notes
.csv	Primary format for people and supplier feeds. UTF-8 with BOM is fine.
.xlsx	Single-sheet Excel workbook; first sheet is used.
.xls	Legacy Excel; use .xlsx where possible.
.json	Structured data. Coordinate the schema with your Conflixis contact.
.txt	Treated as delimited text; coordinate delimiter with your contact.
.zip	A single-file archive; the inner file must match one of the above.

CSV is the recommended format for new integrations. It’s the most widely tested and the easiest to diff when something looks off.

File naming

• Files are tracked by filename. A filename is only ever imported once. Re-uploading a file with the same name is a no-op.
• To re-send corrected data, change the filename. A date stamp works well — for example, people-2026-04-23.csv.
• Your filePattern glob (for example, *.csv) determines which files Conflixis picks up. Files that don’t match are ignored.

Atomic uploads

To prevent Conflixis from reading a file while you’re still writing it, upload atomically:

1. Upload to a temporary filename (for example, people-2026-04-23.csv.partial).
2. Rename to the final filename only once the upload completes.

Rename is atomic on most SFTP servers, so this guarantees we only ever see a complete file.

Tip

If your upload tool doesn’t support atomic rename, upload into a staging directory that’s outside your basePath, then move the file into basePath when complete.

People file (CSV)

A typical people CSV looks like this:

first_name,last_name,email,external_id,title,department,manager_email
Ada,Lovelace,ada@example.com,EMP-00001,Engineer,Analytics Engineering,grace@example.com
Grace,Hopper,grace@example.com,EMP-00002,Director,Analytics Engineering,

• email is the natural identifier — it must be unique per row.
• external_id is optional but recommended; it’s stable across email changes.
• manager_email enables reporting relationships; leave blank for top-of-tree.
• Additional columns (custom attributes, departments, cost centers, etc.) are supported — coordinate the exact schema with your Conflixis contact.

If your existing export uses different column headers, provide a column mapping and Conflixis will translate on ingest — no changes needed on your side.

Supplier file (CSV)

The supplier feed follows the same pattern. Work with your Conflixis contact to lock down the exact schema; fields typically include supplier name, tax ID, parent/subsidiary relationships, and internal supplier IDs.

Encoding and line endings

• UTF-8 is required. UTF-8 with or without a BOM is fine.
• Both LF and CRLF line endings are accepted.
• Avoid Windows-1252 / Latin-1 encoded files — non-ASCII characters will be corrupted.

What to do about PII

The people feed typically contains personally identifiable information (names, work emails, sometimes manager relationships). Treat the files the same way you’d treat any export from your HRIS:

• Use the dedicated conflixis user and a directory that isn’t browsable by other users on the SFTP server.
• Rotate credentials (keys or passwords) on your normal cadence.
• If your organization requires encryption-at-rest on the SFTP server, verify that your server provides it.

Conflixis encrypts the file in transit (SFTP), at rest in our object store, and in our application database.