Skip to main content

The Document Lifecycle

How a document moves through Docupath from the moment it is uploaded to the moment structured data is exported

Every document uploaded to Docupath passes through a clear, structured pipeline designed to ensure accurate processing, thorough review, and proper validation before final approval or rejection. The document lifecycle spans from initial upload through review, transformation, validation, and export - creating a mutually exclusive endpoint where documents are either Approved or Rejected.

This document lifecycle provides complete auditability and transparency, with each stage serving a specific purpose in the document processing workflow. The system supports multiple ingestion paths and includes flexible review capabilities with optional validation layers.


How It Works

Ingestion Paths

Docupath supports four document ingestion methods:

1. Web Upload Users upload documents directly through the web application. Multiple files can be queued for batch processing. Sub-organization routing is selected during upload.

2. Email Ingestion Files are sent as attachments to an organization-specific email address. Docupath supports two types of email ingestion:

  • Single Primary Document with Optional Attachments: One attachment is treated as the primary document, and any additional attachments are associated with it as supporting attachments.

  • Multiple Primary Documents: Each attachment is processed as a separate primary document. This mode is supported via separate email addresses configured for every organization and sub-organization.

Sub-organization routing is configured via override trading parties.

On the Single Primary Document address, when an email arrives without a valid business-document attachment, Docupath processes the email body itself as the document. The Multiple Primary Documents address never turns the body into a document. See Processing the Email Body as a Document.

3. API Upload Programmatic document submission via Docupath’s ingestion API, using unique API keys generated under Destination Format & APIs settings.

4. Mobile App Document capture and upload via the Pathfinder by Docupath mobile app (Android/iOS).

Review Screen & Dual-Pane Interface

The review screen provides comprehensive document assessment capabilities:

Left Panel Displays structured data extracted by Docupath in Docupath Internal Format (DIF), presenting information in a dynamic layout optimized for validation. At the bottom of the panel, two tabs are available:

  • Input: Shows the captured fields in a structured GUI, with editable fields and their captured values.

  • Destination: Switches to a view showing how the document's data will be sent downstream - the XML file generated from the document's data, created according to the configured Destination Format.

Right Panel Shows the original uploaded document in its native format (PDF, XML, image, etc.), allowing direct comparison with extracted data.

Smart Field-to-Document Linking Clicking any extracted field in the left panel automatically highlights the corresponding section in the source document on the right, improving validation accuracy and speed. Select Mode allows you to draw bounding boxes around data that must be captured from the document, making it easy to capture values directly into fields instead of manually typing them out - useful when a value has not already been captured accurately by Docupath.

Footer Action Bar Contains primary actions for document disposition:

  • Approve: Accept the document into the system

  • Validate: Flag for validation review (validator role only)

  • Reject: Decline the document with required reason documentation

  • Close: Exit review without taking action

Search & Filtering

The review interface includes a search bar and comprehensive filtering options:

  • Regions

  • Documents

  • Organizations

  • Urgency

  • Document types

  • Status

  • Date

  • Validated by

Users can customize visible columns and perform bulk actions including Delete, Download, Reprocess, and Review.

Data Enrichment

During processing, Docupath applies multiple enrichment types to extracted data:

  • Verified Org Data - Updated: Data corrected using verified organization settings

  • Verified Org Data - Autofilled: Data populated from verified organization settings

  • AI Enriched: Data inferred contextually from document content

  • AI Standardized: Formats normalized (dates, currency, identifiers)

  • AI Transformed: Business rules and transformations applied

Document Splitting

Scanned batches and forwarded attachments often arrive as one file holding several business documents back to back. When Split documents from this organization is enabled on the organization a document arrives under, Docupath detects where each document begins and ends, separates the file into one document per part, and processes every part as a document of its own. While this happens the document shows the Splitting status, and each resulting part is labeled with its position, such as 1 of 3. One uploaded file can therefore become several Pending documents. See the Document Splitting article for the full behavior.

Auto Review

For repeat documents from the same trading pair, Docupath can approve documents automatically instead of routing every one to a reviewer. After a few documents from a pair have been approved manually, the pair can be trusted, and matching Invoice and Purchase Order documents are then approved automatically - moving straight to the Approved tab with Auto Review shown as the reviewer. Any document that looks different is flagged and left in the queue for a person to check. See the Auto Review article for the full workflow.

Lifecycle Stages

The document lifecycle consists of four distinct stages:

Pending The document has been uploaded and is waiting for review. During this stage, the document may still be under AI processing or ready for human validation. The Pending tab includes three sub-statuses:

  • Processing: AI is actively extracting data from the document

  • Splitting: The uploaded file was found to contain several business documents and is being separated into one document per part. See Document Splitting.

  • Pending: Document is ready for human validation

  • Failed: Document could not be processed (e.g., unsupported format, corrupted file, unreadable content)

Validated The document has been reviewed by a validator role but is not yet finalized. This optional stage provides a second layer of assurance and quality control before final acceptance.

Approved The document has passed validation and has been accepted into the system. Once approved, the document can optionally be sent to external systems for further processing or archiving. The Approved tab includes sub-statuses:

  • Approved: Document successfully accepted

  • Sent: Document pushed to external system

  • Acknowledged: External system confirmed receipt

Rejected The document has failed validation or violated applicable business rules. Rejection always requires a documented reason, creating an auditable trail for transparency and compliance.


Supported Configurations & Options

Batch Configuration

The system supports configurable batch processing with the following options:

  • Sub-organization assignment during upload

  • Multiple file queuing within a single batch

  • Bulk action selection (Delete, Download, Reprocess, Review)

Validation Configuration

  • Standard Lifecycle: Pending -> Approved/Rejected (included with base product)

  • Extended Lifecycle: Pending -> Validated -> Approved/Rejected

  • Validator role assignment

Review Interface Customization

  • Custom column selection in review screen

  • Tab view organization (Pending, Approved, Rejected tabs)

  • Search and filter criteria combination


Other Technical Specifications

Document Specifications

Parameter

Limit

Maximum file size

50 MB per file

Maximum pages per document

150 pages

Maximum documents per batch

100 documents

Maximum line items per document

500 items

Supported File Formats

  • Documents: PDF, DOCX, DOC, HTML, TXT

  • Spreadsheets: XLSX, XLS

  • Images: JPG, PNG, TIFF, TIF, HEIC

  • Structured Data: XML, JSON

Data Format

Extracted data is presented in Docupath Internal Format (DIF), a structured schema optimized for validation and export. Custom output formats can also be configured via Data Export Templates.


Notes

Processing Limitations

  • Corrupted Files: Files with corruption errors will be placed in the Pending -> Failed sub-status and require user action

  • Unsupported Formats: File types not in the supported list will fail processing and be marked as Failed

  • Large Documents: Documents exceeding 150 pages or 50 MB may experience processing delays or failure

Lifecycle Constraints

  • Mutually Exclusive Endpoints: A document can only be in one final state - Approved or Rejected - never both

  • Rejection Irreversibility: Once rejected, documents cannot be re-approved without reprocessing through the full lifecycle

Email Ingestion Limitations

  • Maximum 10 attachments per email; additional attachments are not processed

  • In Multiple Primary Documents mode, each attachment is processed as a separate primary document; in Single Primary Document mode, one attachment is the primary document and the rest are treated as supporting attachments.

  • Email ingestion must use the organization-configured email address

Batch Upload Limitations

  • Maximum 100 documents per batch

  • Sub-organization assignment is required during upload

Did this answer your question?