Executive Summary
The Document Management module provides centralised upload, validation, cloud storage, and retrieval for all platform document workflows. Customers attach supporting documents during booking and claim submission. Administrators access evidence directly from review dashboards. Compliance documents link to specific booking records. Every file is validated, stored securely, and associated with its parent transaction — creating an auditable document trail across the shipment lifecycle.
Business value delivered: Complete evidence on first submission, eliminated document-chasing, secure cloud storage, and audit-ready attachment records.
The Customer Problem
Document handling in manual logistics workflows creates recurring operational costs:
| Challenge | Consequence |
|---|---|
| Email attachments disconnected from transactions | Operations manually match documents to bookings or claims |
| No file type or size enforcement | Oversized or unsupported files clog inboxes and fail to process |
| Missing mandatory documents discovered late | Claims and bookings stall while handlers request evidence |
| No central retrieval | Customer service searches email archives to resend documents |
| Dangerous goods declarations without supporting files | Compliance gaps and regulatory risk |
| No audit trail for document versions | Disputes lack evidence of what was submitted and when |
| Inconsistent upload experience | Different workflows use different upload mechanisms |
For a carrier handling regulated cargo and insurance claims, document integrity is both an operational efficiency issue and a compliance requirement.
The Solution
Document Management operates as a platform-wide service supporting all document workflows:
Design principles:
- Transaction-linked — every document associated with a parent booking, claim, or compliance record
- Validated at upload — file type, size, and count enforced before storage
- Cloud-native storage — documents stored in enterprise cloud storage with secure access
- Metadata-rich — original filename, file size, document type, upload timestamp, and form context recorded
- Retrieval on demand — customers and administrators download documents from dashboard context
- Email integration — confirmation PDFs and claim summaries attached to notification emails
Document Contexts
Booking Documents
| Document Type | When Required | Purpose |
|---|---|---|
| Packing lists | Optional during booking | Cargo verification |
| Certificates | Optional during booking | Commodity or quality certification |
| Dangerous goods declarations | Mandatory for DG cargo | Regulatory compliance |
| MSDS sheets | Mandatory for DG cargo | Safety data for hazardous materials |
| Supporting correspondence | Optional | Additional booking context |
Claim Evidence
| Document Type | When Required | Purpose |
|---|---|---|
| Bill of lading (front and back) | Mandatory at submission | Proof of shipment |
| Shipper's commercial invoice | Mandatory at submission | Cargo value evidence |
| Packing/weight list | Mandatory at submission | Cargo condition evidence |
| Formal claim statement | Mandatory at submission | Claim declaration |
| Survey report | Optional / on request | Independent damage assessment |
| Quality certificate | Optional / on request | Product condition evidence |
| Photographs | Optional | Visual damage evidence |
| Additional documents (admin-requested) | On demand | Specific evidence requested by claim handler |
Compliance Documents
| Document Type | Context | Purpose |
|---|---|---|
| VGM supporting documents | Verified Gross Mass submission | Regulatory weight verification |
| ESI attachments | Electronic Shipping Instructions | Shipping instruction documentation |
User Journey
Customer Upload
| Stage | User Action | Platform Response |
|---|---|---|
| 1 | Select file(s) in booking, claim, or compliance workflow | Display upload interface with accepted type indicators |
| 2 | Upload file | Validate type and size; reject invalid files with clear message |
| 3 | (Automatic) | Store file in cloud storage; create metadata record linked to transaction |
| 4 | View uploaded files in review screen | Display filename, size, and remove option |
| 5 | Submit parent transaction | Documents permanently associated with booking/claim record |
| 6 | (Later) Download from dashboard | Retrieve file from cloud storage via secure download |
Administrator Review
| Stage | Admin Action | Platform Response |
|---|---|---|
| 1 | Open claim or booking from review dashboard | Display all associated documents with metadata |
| 2 | View or download evidence | Retrieve from cloud storage |
| 3 | Request additional documents | Specify required types; customer notified |
| 4 | Include documents in email notifications | Attach relevant files to admin/customer emails |
Key Capabilities
Validated Upload Interface
Drag-and-drop and file-picker upload with real-time validation. Accepted types (PDF, images, spreadsheets, Word documents) and size limits enforced before upload begins.
Cloud Storage with Secure Access
Documents stored in enterprise cloud storage. Access controlled through authenticated API — customers retrieve own documents; administrators access review-context documents.
Transaction-Linked Metadata
Every upload creates a metadata record: original filename, stored filename, file size, document type classification, upload timestamp, form context, and parent transaction reference.
Mandatory Document Enforcement
Claim submission wizard blocks final submission until all required evidence categories contain at least one uploaded file. Booking dangerous goods workflows require declaration attachments.
Document Type Classification
"Other documents" in claims support typed categorisation — survey report, quality certificate, photographs — enabling administrators to request specific evidence types.
Admin-Requested Document Workflow
Administrators select required additional documents from a configured list. Customer fulfils via dedicated submission screen; new uploads linked to existing claim record.
Download from Dashboard
Customers and administrators download documents from booking detail, claim detail, and compliance views — without separate email requests.
PDF Generation and Attachment
Platform generates PDF summaries (booking confirmations, quote summaries, claim details) and attaches them to notification emails — separate from user-uploaded documents but part of the document ecosystem.
File Size and Count Limits
Per-file and total upload limits enforced per workflow context — preventing storage abuse and ensuring processable submission sizes.
Amendment Document Support
Booking amendment workflows support attachment of supporting documents for proposed changes — linked to amendment records.
Functional Workflow
System Interactions
| Layer | Role |
|---|---|
| Customer Portal | Upload interfaces in booking, claim, and compliance workflows; download from dashboard detail views |
| Claims Portal | Evidence upload in claim wizard; additional document submission; admin document review |
| Integration Platform | Validation, cloud storage orchestration, metadata persistence, secure retrieval, email attachment assembly |
| Cloud Storage | Authoritative file storage with regional deployment |
| External Services | Email delivery with PDF attachments; PDF generation for confirmation documents |
Business Outcomes
| Outcome | Impact |
|---|---|
| Faster processing | Complete evidence on first submission eliminates document-chasing cycles |
| Reduced manual effort | No manual matching of email attachments to transaction records |
| Better customer experience | Clear upload requirements and instant validation prevent submission rejection |
| Improved visibility | All documents accessible from dashboard context — no archive searching |
| Audit compliance | Metadata records provide evidence of what was submitted, when, and by whom |
| Regulatory assurance | Dangerous goods and compliance documents linked to specific transactions |
Technical Highlights
- Unified upload endpoint serving booking, claim, and compliance workflows
- Client-side and server-side validation for file type and size
- Cloud storage integration with secure, authenticated retrieval
- Metadata model linking files to parent transactions with document type classification
- Asynchronous upload processing preventing file transfer from blocking form interaction
- Configurable document type lists managed through platform configuration
- Production CDN for static claim document assets and generated PDFs
Conclusion
Document Management ensures that the evidence supporting every booking, claim, and compliance submission is captured, stored, and retrievable from the moment of upload — not reconstructed from email archives weeks later. For Container Shipping, this module is the audit foundation that makes digital intake trustworthy: complete submissions, traceable evidence, and secure storage across the full shipment lifecycle.