Support

DTO Flow help center

Practical guidance for launching partner file exchanges, helping partners succeed, connecting systems, and getting support when you need it.

Answers

FAQ

Practical answers for customer teams, partner users, and integration owners working with recurring partner file exchanges in DTO Flow.

Basics

Product fit and files

What is DTO Flow?

DTO Flow is a Partner File Gateway for recurring business files. It gives partners a controlled place to upload or collect files, checks table-like Excel and CSV data against your agreed rules, keeps every submission in context, and makes accepted files available to authorized people and systems.

Who is DTO Flow for?

DTO Flow is for teams that rely on recurring partner file handoffs: spreadsheets, supplier files, distributor reports, ZIP packages, or controlled partner downloads. It is especially useful when the same file arrives every week or month and small format changes can break a downstream process.

How is DTO Flow different from general file-transfer or data platforms?

DTO Flow is purpose-built for recurring partner-file exchanges. It combines controlled partner access, spreadsheet validation, clear status, accountable history, and reliable handoffs in one focused workflow.

What file layouts work best?

Flat table-like CSV files and Excel sheets work best. A good file has one clear header row, predictable columns, and rows that represent the records your receiving process expects.

How should we prepare complex spreadsheets for validation?

For the clearest self-service validation, export reporting workbooks and complex layouts as a flat Excel or CSV table with one header row and predictable columns. DTO Flow can then give partners precise, actionable feedback.

Can DTO Flow track ZIP files and other expected files?

Yes. DTO Flow tracks ZIP packages and other expected files in the same feed, keeps their status and history visible, and makes them available through controlled portal or automation paths. Spreadsheet-specific checks apply where the file contains table-like Excel or CSV data.

Setup

Feeds and setup

What is a file feed?

A file feed is the recurring exchange routine: direction, partner access, schedule, expected files, validation rules, notifications, and history. For example, one weekly invoice CSV from one supplier should usually be one feed.

Should I create one feed per partner or one shared feed?

For inbound exchanges, use one feed per submitting partner when each partner needs independent tracking. For outgoing exchanges, your team can publish the same file privately to several assigned download partners.

What is a feed file?

A feed file is one expected physical file inside a feed. A submission can contain one or more feed files, and each feed file can define whether it is required, what format it expects, how names are matched, and whether validation should run.

What is a validation contract?

A validation contract is the versioned set of deterministic checks for a feed file: target sheet or part, header rules, required columns, aliases, data types, allowed values, duplicate checks, and row-count expectations.

Can one submission include multiple required files?

Yes. Multi-file feeds can require several files in the same submission, such as a header file and a detail file. Required files must be present before the submission can satisfy the feed for that period.

What are feed slugs and file slugs used for?

Slugs are stable, readable names used by integrations and support conversations. They give each feed and expected file a consistent reference over time.

What is the difference between a draft feed and an active feed?

Draft feeds are still being configured. Active feeds are available for real submissions, partner access, schedules, notifications, and automation, depending on each user's permissions.

Access

Partners and permissions

Can partners see other partners' files?

Partner users see only the feeds and submissions assigned to them. Organization-wide feed data and other partners' submissions remain outside their view.

What partner roles are available?

Partner Operators can upload files, review validation reports, and download authorized feed files. Partner Observers can view reports, setup, and authorized files. Partner Feed Managers can upload files and manage validation setup for assigned feeds.

Who can create feeds and manage partners?

Tenant Owners and Tenant Admins manage feed setup, partner access, tenant settings, and webhooks. Tenant Operators and Tenant Observers work with operational data according to their permissions.

How do partner invitations work?

Invite a partner by email and assign the feeds and role relevant to their work. After accepting, the partner sees the exchanges and actions included in that access.

What happens when partner access is removed?

Removing feed access stops that partner from seeing or using the feed going forward. Historical submissions, downloads, validation results, and activity remain available to authorized internal users.

Can partners create private access tokens or webhooks?

Partners can create private access tokens for feeds they can access when their role allows it. Partner Feed Managers can manage webhooks for their assigned feeds, while tenant-wide webhook management stays with Tenant Owners and Tenant Admins.

Validation

Uploads and validation

What happens after a file is uploaded?

DTO Flow keeps the submitted file with its partner, feed, and period context, runs the configured checks, and updates the submission page from receipt through the final outcome.

What does validation check?

Validation can check file arrival, extension, size, readability, target sheets, headers, required columns, aliases, date and number formats, accepted values, duplicates, row-count anomalies, and other deterministic rules configured in the validation contract.

What does current accepted submission mean?

The current accepted submission is the accepted submission that counts for a feed period. If a later upload for the same period is accepted, it becomes current. Earlier submissions remain visible in history, but they no longer count as the current version.

Can a partner fix a failed upload?

Yes. Failed validation should give clear partner feedback with the affected rows, columns, sheets, or files where possible. The partner can correct the file and upload a new submission for the same period.

What if a column name changes?

If the change is intentional, an authorized internal user or Feed Manager can add the new column name as an alias in the saved validation rules. If the change is accidental, the partner should resend the file using the agreed template.

What if an Excel workbook has extra sheets?

Extra sheets can be ignored when the feed targets the correct sheet or part. Validation should focus on the configured table-like sheet, such as a sheet named data, instead of treating every workbook tab as part of the import.

Can a submitted file be revalidated?

Yes. When saved validation rules are updated, authorized users can revalidate files checked with an earlier version. Each result remains connected to the submission history.

Why does a submission say accepted without validation?

This status is used for tracked files accepted through package rules rather than spreadsheet content checks, such as outgoing partner downloads and reference files. DTO Flow still keeps the file archived, connected to its exchange, and available through authorized paths.

Operations

Periods, dashboards, and downloads

How do periods and deadlines work?

A period is the recurring window a feed expects, such as a weekly invoice period or a monthly publish period. Daily, weekly, monthly, and ad hoc schedules help the dashboard show what is due, late, missing, processing, or accepted.

What does the dashboard show?

The dashboard highlights feeds needing attention, upcoming deadlines, summary counts, and recent accepted submissions so your team can prioritize the next action quickly.

Which statuses should I pay attention to?

Missed, late, validation failed, processing failed, and in-progress submissions usually need attention. Accepted and accepted without validation mean the period has a usable current submission based on that feed's setup.

What can internal users download?

Authorized internal users can download accepted submitted files, with each file remaining connected to its partner, period, and submission history.

How do outgoing partner downloads work?

In an outgoing feed, your team publishes a file for a period and assigns download access. Partners collect it privately through the portal, while DTO Flow keeps the download activity visible in the exchange history.

Does DTO Flow overwrite old files?

Every re-upload adds to the history. A later accepted submission can become the current version for a period while earlier submissions remain available according to the agreed retention approach.

Integrations

Automation, tokens, and webhooks

When should I use the API instead of the portal?

Use the portal for manual partner uploads, setup, and review. Use the automation API for scheduled jobs, partner systems, CLI tools, readiness checks, uploading repeat files, and downloading accepted originals before downstream imports run.

What are private access tokens?

Private access tokens give scripts and connected systems focused access to selected feeds and actions. The secret is shown once, should be stored securely, and can be revoked while past activity remains visible.

Can automation upload or download multiple files?

Yes. Multi-file automation creates one upload session for the submission, uploads each expected file to its returned target, completes the submission once, then downloads each accepted original after the submission is accepted.

Where is the automation OpenAPI spec?

The automation OpenAPI spec is served from the production API origin: https://api.dtoflow.com/api/automation/v1/openapi.json.

How are webhooks different from email alerts?

Email alerts notify people. Webhooks notify systems. Use webhooks when another service needs a signed event after a submission becomes available, a selected final status is reached, or a deadline is missed.

Which webhook event should I start with?

Start with feed.submission.available for downstream imports. It fires only when the current submission for a period is accepted and ready for downstream use.

What happens if my webhook receiver is down?

DTO Flow retries transient webhook failures and records delivery history. Receivers should verify signatures, return a 2xx response quickly, and use event and delivery IDs for idempotency.

Support

Security, privacy, and troubleshooting

Are full files sent to AI?

Saved deterministic rules decide whether a file meets the agreed expectations. Full partner files are not sent to an AI service for validation.

Why did my upload fail before validation?

Pre-validation failures usually mean the file was missing, empty, too large for the plan, used an unexpected extension, was unreadable, or matched the wrong expected file. Open the submission detail for the specific reason and next step.

Why can't I see a feed, button, token, or webhook option?

Visibility follows your role and assigned feeds. You may be signed into the wrong account, have access only to selected partner feeds, or need permission for setup, uploads, private tokens, organization settings, or webhooks.

What should I do if a download link expires?

Return to the submission or outgoing feed and request the download again. Download links are intended to be short-lived, while the underlying accepted file remains tracked and available according to access rights and retention policy.

What should I include when contacting support?

Include your organization name, feed name, partner name if relevant, submission ID or period, and whether the issue is about upload, validation, download, automation, webhooks, notifications, or account access.

Should I send files, private tokens, or webhook secrets to support?

Do not send private access token secrets, webhook signing secrets, passwords, or full sensitive files through support messages. Share IDs, timestamps, feed names, sanitized screenshots, and the smallest safe sample needed to explain the issue.