Introducing semantic filenames for SFTP files received from Stedi

You can now configure Stedi's SFTP server to deliver files with semantic filenames that include the X12 transaction set.

Previously, files in the from-stedi directory used UUIDs, such as f9591145-8343-4bd8-a338-5bcca8ac3baf.x12, as filenames. You had to open or parse each file to know whether it contained a 277CA claim acknowledgment, 835 Electronic Remittance Advice (ERA), and so on. Semantic filenames include a transaction set identifier so you can route, filter, or sort files without parsing their contents.

How semantic filenames work

You can configure filenames on the SFTP setup page of your account settings. Set File naming to one of:

• Semantic – {TIMESTAMP}_{UUID}_{SEMANTIC_IDENTIFIER}.x12

Example: 20260416124500_f9591145-8343-4bd8-a338-5bcca8ac3baf_277CA.x12

• UUID only – {UUID}.x12 Example: f9591145-8343-4bd8-a338-5bcca8ac3baf.x12

Semantic identifiers cover the X12 transaction sets that Stedi delivers:

The filename configuration only affects files that you receive from Stedi. Stedi delivers these files to your from-stedi directory. Files you upload to Stedi keep their original names, and files Stedi sends to payers are unaffected.

Existing Stedi accounts will continue using UUID-based filenames by default. New Stedi accounts will default to semantic filenames.

For more information, see our SFTP file naming docs.