Transactions

Under Review

This article is currently under review. Some content may be incomplete or inaccurate.

Transactions represent a batch of documents uploaded for processing. They are the primary unit of work in DocAI Fabric.

Transaction Lifecycle

Created → Processing → Completed / Failed

1. Created: Transaction is created, documents can be uploaded
2. Processing: Workflow engine is running activities on the documents
3. Completed: All activities finished successfully
4. Failed: One or more activities encountered errors

Creating a Transaction

Via the UI

1. Open a project
2. Click New Transaction
3. Upload files using drag-and-drop or the file picker
4. (Optional) If a single file is selected, enable Limit Pages and set the number of pages to process
5. Click Process to start the workflow

Page Limit

When uploading a single file, you can choose to process only the first N pages. The full file is always stored; only the conversion step is limited. This is useful for previewing large documents or testing workflow settings.

Via the API

# Create a transaction
curl -X POST "https://app.docaifabric.com/api/v1/projects/{project_id}/transactions" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: multipart/form-data" \
  -F "files=@invoice.pdf"

Transaction Contents

Each transaction contains:

Component	Description
Documents	Individual documents detected after splitting
Pages	Individual pages with OCR text and images
Workflow State	Current processing status per activity
Source Files	Original uploaded files

Viewing Results

In the transaction detail view, you can:

• Browse documents: See all documents detected in the upload
• View extractions: See extracted field values with confidence scores
• Inspect pages: View page images with bounding boxes around extracted data
• Check classification: See how each document was classified
• Review & correct: Manually fix any extraction errors

Transaction States

State	Icon	Description
pending	⏳	Waiting to be processed
processing	🔄	Currently being processed
completed	✅	All activities completed successfully
failed	❌	Processing encountered errors
cancelled	🚫	Processing was manually cancelled

Bulk Operations

You can process multiple transactions at once:

1. Select transactions in the project view
2. Use the bulk action menu to:
   • Process selected transactions
   • Reprocess failed transactions
   • Delete selected transactions