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
