Docs / CSV Imports

Reference

Prepare CSV imports for governed payout calculations

CSV imports work best when each row has a stable source identifier, date, amount, currency, product context, and enough metadata for payout rules.

Details

What to know

Suggested columns

Column names can vary by source, but clean imports usually include these fields.

  • External revenue ID.
  • Transaction date.
  • Amount and currency.
  • Revenue type such as sale, refund, or adjustment.
  • External product identifier.
  • Optional metadata such as country, channel, partner, or contract reference.

Before you calculate

Review mapping and validation output before creating a calculation run.

  • Resolve unmapped product identifiers.
  • Confirm refunds and adjustments use the expected sign.
  • Keep sandbox files separate from production imports.

Reference Tables

Fields and checks

Minimum CSV checks

Use these checks before uploading a file for calculation work.

Check Why it matters Fix before upload
Stable row identifiers Supports duplicate review and audit traceability. Add or preserve a source transaction ID.
Single intended currency Avoids accidental mixed-currency calculation periods. Split files by currency when needed.
Product context present Allows rules to match revenue rows correctly. Add product ID, SKU, catalog ID, or metadata.
Refund signs reviewed Prevents refunds from increasing payout totals. Confirm negative signs or refund type mapping.

Troubleshooting

If this does not work

The import finishes but the calculation run reports unresolved rows.

Open mapping review, resolve external product identifiers, and confirm the relevant rules are active for the period.

Feedback

Was this page helpful?

Send a note if a step is unclear, missing, or out of date.

Email Support

Apply this in a workspace

Start free, use sample data, then replace examples with your own revenue rows when the workflow is clear.