Supplier portal mobile app fails to upload large attachments over 10MB

Our suppliers are having major issues uploading documents through the Blue Yonder mobile portal app (v2023.1). Any attachment over 10MB fails with a timeout error. This is blocking critical document sharing - suppliers need to upload quality certificates, technical drawings, and compliance documents that are often 15-25MB.

The error message we’re seeing is:


HTTP 504 Gateway Timeout
Upload failed after 60000ms
File size: 18.4MB

This is causing significant delays in supplier onboarding and our procurement team has to manually collect these documents via email, which defeats the purpose of the portal. Is there a file size limit we can adjust, or do we need to implement chunked uploads? The mobile app seems to try uploading the entire file in one request.

The 60 second timeout combined with 10MB+ files suggests the upload isn’t chunked. Most mobile networks can’t reliably upload large files in a single HTTP request within that timeframe. Does the supplier portal API support multipart/chunked uploads? If so, the mobile app should be configured to split large files into 2-5MB chunks and upload them sequentially.

In version 2023.1, chunked upload support exists but requires configuration. Check your mobile app config file for the uploadChunkSize parameter. Set it to something like 5242880 (5MB) and enable chunkedUploadEnabled flag. The app will then automatically split files exceeding this size into chunks. You’ll also want to increase the overall upload timeout to account for multiple chunks - maybe 300 seconds for a 25MB file split into 5 chunks.

How do we enable chunked uploads in the mobile app? Is this a configuration setting or does it require custom development? Our suppliers are getting frustrated and some are threatening to revert to email-based document sharing which creates compliance tracking issues.

Don’t forget to check your API gateway settings too. If you’re on Azure API Management or AWS API Gateway, there’s likely a request timeout and payload size limit configured there as well. These need to be aligned with your chunked upload strategy. I’ve seen cases where the app was configured correctly but the gateway was still rejecting large uploads.

We’re using Azure API Management. I’ll check those gateway settings - that could definitely be blocking us even if the app is configured correctly. Are there any other infrastructure considerations for large file uploads?

I’ll walk you through the complete solution addressing all three aspects:

1. File Size Limits - Increase and Configure Properly:

First, update your Azure API Management policies to allow larger payloads and longer timeouts:

<policies>
  <inbound>
    <set-body-size>52428800</set-body-size>
    <timeout>300</timeout>
  </inbound>
</policies>

This sets max body size to 50MB and timeout to 5 minutes. Also verify your Azure Storage account (where documents are ultimately stored) doesn’t have restrictive limits.

2. Chunked Upload Implementation - Enable in Mobile App:

Modify the mobile app configuration file (typically mobile-config.json or via admin console):

{
  "documentUpload": {
    "chunkedUploadEnabled": true,
    "chunkSize": 5242880,
    "maxFileSize": 52428800,
    "timeout": 300000
  }
}

This enables chunked uploads for files over 5MB, with a max file size of 50MB and 5-minute total timeout. The app will automatically split large files into 5MB chunks and upload them sequentially with resume capability if a chunk fails.

3. Supplier Onboarding Delays - Implement Progress Feedback:

The chunked upload approach solves the technical issue, but you also need to improve the user experience. Enable upload progress notifications so suppliers can see their large files uploading chunk by chunk rather than appearing frozen. In the mobile app settings, enable:

  • Real-time progress bars showing chunk completion
  • Background upload support (suppliers can continue using the app while files upload)
  • Retry logic for failed chunks (automatically retries up to 3 times before failing)

Additional Recommendations:

  1. Document Compression: For technical drawings and PDFs, enable automatic compression in the mobile app. This can reduce file sizes by 30-50% without quality loss.

  2. Validation Before Upload: Implement client-side file validation to check file size, type, and basic integrity before starting the upload. This prevents wasted bandwidth on invalid files.

  3. Monitoring and Alerts: Set up monitoring on your API gateway to track upload success rates and average upload times. Alert if success rate drops below 95%.

  4. Supplier Communication: Once implemented, send guidance to suppliers about optimal file formats (PDF over TIFF for documents, compressed images for photos). This helps keep file sizes manageable.

Testing: Before rolling out, test with various file sizes (5MB, 15MB, 25MB, 40MB) on different mobile networks (WiFi, 4G, 5G) to ensure chunked uploads work reliably. We’ve seen upload success rates improve from 45% to 98% after implementing this approach for a similar supplier portal deployment.

There are actually two limits at play here - the API gateway timeout (60s default) and the maximum request body size. Blue Yonder’s supplier collaboration module does support chunked uploads via the DocumentUpload API endpoint, but it’s not enabled by default in the mobile app. You’ll need to configure the mobile client to use chunked mode for files over a certain threshold, typically 5MB.