Getting Started
Core Features
Integrations
Administration
Getting Started → Quick Start Guide

Quick Start Guide

Get your first collection cycle running in under 2 hours. No IT project, no consultants.

Prerequisites: A Drop.Top account (Growth plan or above). Admin access to your company email domain.

Step 1: Create a Collection

A Collection is a single data gathering cycle — e.g., "Q1 FY2026 Monthly Report". Navigate to Collections → New Collection and give it a name and a deadline.

# Navigate to Collections
Collections > New Collection

Name: "Q1 FY2026 Monthly Report"
Deadline: 2026-02-05
Template: upload_master.xlsx (or define fields manually)

Step 2: Define your template

Upload your existing Excel master template or define columns manually. Drop.Top will use this to validate every incoming submission against your expected schema.

Step 3: Invite entities

Import your entity list from CSV. Each entity immediately receives an invitation email with their unique upload link. No account creation required on the entity side.

Step 4: Monitor & collect

Your compliance dashboard updates in real time as submissions arrive. Drop.Top handles validation and sends confirmation or error reports back to entities automatically.

Getting Started → Create your first collection

Create Your First Collection

A Collection is a single data-gathering cycle tied to a deadline, a schema, and a set of entities. Here's how to create one from scratch.

1. Name and describe the collection

Go to Collections → New Collection. Give it a descriptive name — typically the reporting period and type (e.g., "Q1 FY2026 P&L Consolidation"). Add an optional internal description visible only to your team.

2. Set the deadline

Choose a submission deadline. Drop.Top's automated chasing engine will use this date to schedule reminders. You can also set a soft deadline (internal reminder window) separate from the hard deadline shown to entities.

Tip: Set your internal deadline 2–3 days before the actual close date to give your team time to resolve last-minute errors and resubmissions.

3. Choose a template type

Drop.Top supports three template modes:

ModeBest forSetup time
Upload master templateTeams with an existing Excel schema~5 min
Define columns manuallyNew reporting cycles from scratch~15 min
Clone from previous collectionRecurring monthly / quarterly cycles~1 min

4. Configure per-entity overrides (optional)

If certain subsidiaries use different column headers or currency fields, you can configure entity-level mapping overrides. The AI mapper will remember these for future cycles.

5. Publish the collection

Click Publish to activate the collection. Entities will not be notified until you explicitly invite them in the next step. You can also save as Draft to continue configuring later.

Getting Started → Invite entities

Invite Entities

Entities are your subsidiaries, business units, or any external counterpart that needs to submit data. No Drop.Top account is required on their end.

Importing entities from CSV

Navigate to your collection and click Entities → Import CSV. The file should contain at minimum a name and contact email. Additional optional fields:

name,email,contact_name,upload_method,currency,group
"EMEA Holdings GmbH",[email protected],"Petra Müller",email,EUR,EMEA
"Asia Pacific Ltd",[email protected],"James Tan",sftp,SGD,APAC
"Latam Operations SA",[email protected],"Carlos Reyes",portal,BRL,LATAM

Adding entities manually

Click Add Entity to add a single entity. Fill in their name, primary contact email, preferred upload method, and local currency. You can assign them to a group for organised tracking on your dashboard.

Sending invitations

Once entities are added, select all or a subset and click Send Invitations. Each entity receives a personalised email containing their unique upload link, submission deadline, and a description of what's required. The email is sent from a Drop.Top address on your behalf.

Custom sender domain: Enterprise plan users can configure a custom sender domain (e.g., [email protected]) for branded invitation emails. See Administration → SSO setup for domain configuration.

Entity upload link

Every entity receives a unique, pre-authenticated URL. When they visit it, they see a branded upload portal showing exactly what's required, validation rules, and their submission history. No login or account required.

Getting Started → Configure validation rules

Configure Validation Rules

Validation rules ensure every submission conforms to your schema before it ever reaches your consolidation model. Set them once; Drop.Top enforces them automatically on every file.

Column-level rules

For each column in your template, you can configure:

Rule typeDescriptionExample
Data typeEnforce numeric, text, date, booleanRevenue must be numeric
RequiredFlag column as mandatoryEntity code cannot be empty
Range checkMin/max value boundsMargin % between -100 and 100
FormatDate format, decimal separatorDate must be YYYY-MM-DD
Allowed valuesEnumerated list of valid entriesCurrency must be EUR, USD, GBP
Regex patternCustom pattern matchingCost centre must match CC-[0-9]4

Row-level and file-level rules

Beyond column checks, Drop.Top supports cross-column validation rules. For example: "If column A is non-zero, column B must also be filled." File-level rules include minimum row count, maximum file size, and sheet name validation for Excel files.

AI-assisted validation

Drop.Top's AI engine automatically detects common issues even without explicit rules: shifted columns, merged header rows, hidden rows, locale-specific number formats (1.000,00 vs 1,000.00), and renamed headers. Detected issues are flagged with confidence scores and auto-correction suggestions.

Validation feedback to entities

When a file fails validation, Drop.Top immediately sends the entity a detailed error report highlighting exactly which rows and columns failed and why. Entities can correct and resubmit directly from their upload link without contacting you.

Result: Customers using validation rules report data accuracy rates above 99% by submission deadline — compared to an industry average of ~57% for email-based collection.
Core Features → Column mapping & AI

Column Mapping & AI

Different subsidiaries use different templates. Drop.Top's AI mapper learns each entity's header conventions and normalises them to your master schema automatically.

How mapping works

When a file arrives, Drop.Top compares its column headers to your master schema. Exact matches are mapped automatically. Near-matches (e.g., "Rev" → "Revenue_EUR") are surfaced with a confidence score. You approve once; the AI remembers forever.

The mapping interface

In your collection dashboard, go to Validation → Column Mapping. You'll see a side-by-side view of the incoming file's headers and your master schema. Drag to remap, or let the AI auto-suggest.

AI auto-correction

Beyond header matching, the AI engine handles:

IssueAI action
Shifted columns (B shifted by 1)Auto-detects offset, corrects before validation
Date format mismatch (DD/MM vs MM/DD)Normalises to your configured standard
Locale number formatsConverts 1.000,00 → 1000.00 automatically
Merged header rowsFlattens to single-row headers
Hidden rows / filter artifactsStrips hidden rows before processing

Per-entity mapping profiles

Each entity builds up a mapping profile over time. After the first approved mapping, subsequent submissions from the same entity are mapped fully automatically — no manual intervention required. Profiles are version-controlled; you can review and roll back any change.

Core Features → Automated chasing

Automated Chasing

Stop spending two weeks of your month sending follow-up emails. Define your escalation sequence once; Drop.Top handles the rest.

Reminder sequences

Under Collection Settings → Chasing, configure a sequence of reminders. Each step has a trigger (days before deadline, days after deadline), a recipient (entity contact, or their manager), and a template.

Reminder sequence example:

Step 1 — 7 days before deadline → Entity contact (friendly reminder)
Step 2 — 2 days before deadline → Entity contact (urgent reminder)
Step 3 — 1 day after deadline → Entity contact + manager (escalation)
Step 4 — 3 days after deadline → Manager only (executive escalation)

Holiday awareness

Drop.Top maintains public holiday calendars for 60+ countries. Reminders are never sent on local public holidays, and deadline calculations automatically account for regional working calendars.

Smart suppression

Once an entity submits, all pending reminders are automatically suppressed. No entity will ever receive a chasing email after they've already submitted. Partial submissions (files that failed validation and need resubmission) keep the sequence active until a passing submission is received.

Live compliance dashboard

Your dashboard shows real-time status for every entity: Not Started, Reminder Sent, Submitted, Validation Error, Validated. Filter by group, region, or overdue status. Export a compliance report at any time in CSV or PDF.

Impact: Drop.Top customers report an average 87% reduction in manual follow-up effort across email, Slack, and phone within the first reporting cycle.
Core Features → ETL pipeline builder

ETL Pipeline Builder

Once files are collected and validated, the built-in ETL engine lets you join, transform, and load clean data into your warehouse, BI tool, or ERP — no SQL or coding required.

Pipeline overview

A pipeline consists of three stages: Extract (pull validated submissions), Transform (apply business rules), and Load (push to destination). Pipelines can be run on-demand or scheduled.

Transform operations

OperationDescription
Currency conversionNormalise all entities to a base currency using ECB daily rates or a fixed rate table
Intercompany eliminationAutomatically remove intragroup transactions using entity relationship mapping
Rollup & aggregationSummarise by group, region, entity type, or any custom dimension
Join / mergeCombine submissions with reference data (e.g., chart of accounts, cost centre master)
FilterExclude rows by criteria (e.g., zero-value lines, test entities)
Calculated columnsAdd derived fields using formula-based expressions

Pipeline scheduling

Pipelines can be set to run automatically: on each new validated submission, daily at a fixed time, or triggered via webhook. Scheduled runs are aligned to your close calendar and pause automatically outside your collection window.

Output destinations

Output targets supported: Excel download, CSV download, Snowflake (direct write), Power BI dataset refresh, SFTP push, or REST API endpoint. Multiple destinations per pipeline are supported.

Core Features → Upload methods

Upload Methods

Every entity submits how they prefer. Drop.Top validates all channels with the same rigorous engine.

Email

Each entity receives a unique submission email address (e.g., [email protected]). They email their file as an attachment — Drop.Top automatically parses it, extracts the attachment, and kicks off validation. No portal login required.

Online portal

A branded drag-and-drop upload page accessible via each entity's unique link. Shows the required template, validation rules, and submission history. Provides inline validation feedback before final submission — entities see errors immediately and can correct before confirming.

SFTP

For entities with automated export pipelines. Each entity receives dedicated SFTP credentials (host, username, password, port). Files dropped into their SFTP folder are automatically picked up, validated, and processed. Drop.Top sends a delivery confirmation via email.

SFTP connection details (per entity):

Host: sftp.drop.top
Port: 22
Username: entity-{uuid}
Password: (provided in invitation email)
Path: /inbox/

REST API

For tech-forward subsidiaries with developer resources. A clean RESTful API with per-entity authentication tokens and webhook callbacks on submission events. See the REST API reference for full details.

Choosing the right method per entity

MethodBest forSetup effort (entity side)
EmailSmall subsidiaries, manual processZero — they already have email
PortalEntities that want guided UX and inline validationZero — just click the link
SFTPEntities with automated ERP exportsLow — configure FTP target once
APITech-forward entities with developer resourcesMedium — API integration required
Integrations → Snowflake connector

Snowflake Connector

Push validated, consolidated data directly into Snowflake. Your BI team gets clean data the morning after deadline — not 10 days later.

Plan requirement: Snowflake connector is available on the Enterprise plan and above.

Configuration

Go to Settings → Integrations → Snowflake. Enter your Snowflake connection details:

Account identifier: yourorg-youraccount
Username: DROPTOP_SERVICE_USER
Password: (or use key-pair authentication)
Role: DROPTOP_ROLE
Warehouse: DROPTOP_WH
Database: FINANCE_REPORTING
Schema: DROPTOP_INGEST

Required Snowflake permissions

The service user requires: USAGE on the warehouse, CREATE TABLE and INSERT on the target schema. We recommend creating a dedicated role (DROPTOP_ROLE) and granting it only to the service user.

Write modes

ModeBehaviour
AppendEach pipeline run inserts new rows with a run_id and timestamp
ReplaceTruncates and rewrites the target table on each run
Merge (upsert)Upserts rows based on a configured primary key

Testing the connection

Use the Test Connection button after saving credentials. Drop.Top will verify connectivity, permission levels, and write a test row to a _droptop_connection_test table. The test row is deleted immediately after verification.

Integrations → Power BI connector

Power BI Connector

Trigger a Power BI dataset refresh automatically after each successful pipeline run. Your dashboards always reflect the latest validated submissions.

Plan requirement: Power BI connector is available on the Enterprise plan and above.

Setup via Azure AD app

The Power BI connector uses an Azure AD service principal. You'll need to register an app in your Azure tenant and grant it the Dataset.ReadWrite.All Power BI API permission. Provide Drop.Top with the Tenant ID, Client ID, and Client Secret.

Tenant ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Client ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Client Secret: (your app client secret)
Workspace ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Dataset ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Trigger options

Dataset refreshes can be triggered: after every successful ETL pipeline run, on a schedule (e.g., daily at 07:00 CET), or manually from the Integrations panel. Each refresh attempt is logged with status and duration.

Limitations

Power BI API refresh limits apply (typically 8 refreshes per day per dataset on Premium, or 3 per day on Pro). Drop.Top will queue refreshes and warn if the limit is approaching. Consider using the Snowflake connector for high-frequency pipelines.

Integrations → SFTP setup

SFTP Setup

SFTP works in two directions: entities can submit files via SFTP (inbound), and Drop.Top can push processed outputs to your SFTP server (outbound).

Inbound: Entity SFTP submission

When you assign an entity the SFTP upload method, Drop.Top provisions dedicated SFTP credentials for that entity automatically. The entity's ERP or reporting system can be configured to drop files into their designated path.

# Per-entity SFTP credentials
Host: sftp.drop.top
Port: 22
Username: entity-{uuid}
Auth: password or SSH key (configurable)
Inbox path: /inbox/
Processed path: /processed/ (files moved here after ingestion)

SSH key authentication

For enhanced security, entities can provide their public key and disable password authentication. Upload the entity's public key under Entity Settings → SFTP → Public Key. Drop.Top supports RSA (2048-bit minimum) and Ed25519 keys.

Outbound: SFTP output delivery

Drop.Top can push ETL pipeline outputs to your organisation's SFTP server. Provide your server credentials under Settings → Integrations → SFTP Output. Outputs are delivered as CSV or Excel files with configurable naming patterns (e.g., q1-2026-consolidated-{date}.xlsx).

IP allowlisting

If your SFTP server has an IP allowlist, add the following Drop.Top egress IP addresses: 185.220.10.0/24. These are static and will not change without prior notice on the status page.

Integrations → REST API

REST API

The Drop.Top API lets you manage collections, entities, and submissions programmatically. All endpoints are RESTful and return JSON.

Base URL & authentication

Base URL: https://api.drop.top/v1

# Authentication: Bearer token
Authorization: Bearer dt_live_xxxxxxxxxxxxxxxxxxxxxxxx

Generate API keys under Settings → API Keys. Each key can be scoped to read-only or read-write. Rotate keys at any time; old keys are immediately invalidated.

Collections

GET /collections List all collections
POST /collections Create a new collection
GET /collections/{id} Get collection details
PATCH /collections/{id} Update collection settings

Entities

GET /collections/{id}/entities List entities in a collection
POST /collections/{id}/entities Add a single entity
POST /collections/{id}/entities/bulk Bulk import entities from JSON array

Submissions

GET /collections/{id}/submissions List all submissions
POST /submissions/{entity_id}/upload Upload a file on behalf of an entity
GET /submissions/{submission_id}/validation Get validation results for a submission

Webhooks

Register webhook URLs under Settings → Webhooks. Drop.Top will POST to your endpoint on these events: submission.received, submission.validated, submission.failed, entity.overdue, pipeline.completed.

# Webhook payload example (submission.validated)
{
  "event": "submission.validated",
  "collection_id": "col_xxxx",
  "entity_id": "ent_xxxx",
  "submission_id": "sub_xxxx",
  "timestamp": "2026-02-01T09:14:23Z",
  "status": "validated",
  "rows": 412
}

Rate limits

The API is rate-limited to 300 requests per minute per API key. File upload endpoints are limited to 60 uploads per minute. Exceeding limits returns a 429 Too Many Requests response with a Retry-After header.

Administration → SSO / SAML setup

SSO / SAML Setup

Enforce single sign-on for your internal Drop.Top users. SAML 2.0 is supported, with direct integrations for Okta, Azure AD, and Google Workspace.

Plan requirement: SSO is available on the Enterprise plan and above.

SAML 2.0 configuration

Navigate to Settings → Security → SSO. Drop.Top will display your Service Provider (SP) metadata URL and the ACS (Assertion Consumer Service) URL to configure in your IdP:

SP Entity ID: https://app.drop.top/saml/metadata
ACS URL: https://app.drop.top/saml/acs
Name ID format: EmailAddress
Binding: HTTP-POST

Attribute mapping

Drop.Top requires the following SAML attribute claims from your IdP:

Drop.Top attributeSAML claim (suggested)
emailhttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
first_namehttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
last_namehttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
role (optional)droptop_role (custom attribute)

Just-in-time provisioning

With JIT provisioning enabled, users who authenticate via SSO for the first time are automatically created in Drop.Top with the Viewer role. Admins can configure the default role and optionally map IdP group memberships to Drop.Top roles.

Custom sender domain

To send collection invitation emails from your own domain, go to Settings → Branding → Sender Domain. Add the provided DNS records (SPF, DKIM, DMARC) to your domain registrar. Verification typically takes up to 48 hours.

Administration → User roles & permissions

User Roles & Permissions

Drop.Top uses a role-based access control model. All internal (non-entity) users are assigned one of four roles.

Roles overview

RoleDescription
AdminFull access. Manage billing, SSO, API keys, users, and all collections.
Collection ManagerCreate and manage collections, invite entities, configure chasing and ETL pipelines. Cannot access billing or SSO.
AnalystView submissions, download outputs, run existing ETL pipelines. Cannot create collections or invite entities.
ViewerRead-only access to collection dashboards and submission status. Cannot download files.

Collection-level permissions

In addition to global roles, Collection Managers can be restricted to specific collections. A user with the Collection Manager role can be granted access only to the collections they're responsible for — preventing them from seeing other teams' data.

Managing users

Invite users under Settings → Team → Invite User. Enter their work email and assign a role. They'll receive an invitation email. If SSO is enabled and JIT provisioning is on, users can also self-provision by signing in via your IdP — no manual invitation required.

Removing users

Deactivated users immediately lose access to Drop.Top. Their historical actions remain in the audit log. If the deactivated user was the sole contact for any entity's chasing sequence, Drop.Top will warn you to reassign those contacts before deactivation completes.

Administration → Audit log export

Audit Log Export

Drop.Top maintains a full, tamper-evident audit trail of every action taken in the platform — by your team and by entities. Export it at any time for compliance, auditors, or internal review.

What's logged

CategoryEvents captured
AuthenticationLogin, logout, SSO auth, failed login attempts, API key usage
CollectionsCreated, modified, published, deleted, deadline changes
EntitiesAdded, removed, invitation sent, escalation triggered
SubmissionsFile received, validation pass/fail, resubmission, manual override
MappingColumn mapping created, modified, approved, rolled back
PipelineRun triggered, output delivered, error, schedule change
SettingsRole changes, SSO config, API key creation/deletion

Exporting the audit log

Go to Settings → Audit Log. Filter by date range, event category, or user. Export as CSV or JSON. Exports are generated asynchronously for large date ranges — you'll receive an email with a download link when ready.

Automated export via API

GET /v1/audit-log?from=2026-01-01&to=2026-01-31&category=submissions

Authorization: Bearer dt_live_xxxxxxxxxxxxxxxxxxxxxxxx

Retention policy

Audit logs are retained for 2 years on the Enterprise plan and 5 years on the Global plan. Logs cannot be deleted or modified by any user, including Admins, ensuring tamper-evidence. For longer retention requirements, use the API to export and archive logs to your own storage.

Drop.Top is SOC 2 Type II certified. Your auditor can request a copy of the Drop.Top SOC 2 report from your account manager or via [email protected].