Importing Consignments
Overview
MachShip provides flexible methods for importing consignment data into the platform. Whether you need to upload files manually through our web interface or automate the process through folder monitoring, MachShip supports both standard CSV formats and custom file structures through workflow tasks. This guide helps you understand the available options and choose the right approach for your shipping workflow.
Consignment Types
Our import methods support two types of consignments:
Full Consignments
Ready-to-dispatch consignments that contain all required information:
- Complete from/to address details
- Package dimensions, weight, and type
- Selected carrier and service
- All reference numbers
Pending Consignments
Draft consignments that can be completed later:
- Minimal required information
- Flexible completion process
- Allows user carrier selection
- Supports phased data entry
Import Methods
Manual Import
Upload files directly through MachShip's web interface. This method is ideal for:
- Occasional bulk imports
- One-off data imports
- Testing new configurations
Key Benefits:
- Simple web-based upload interface
- Immediate validation feedback
- Detailed error reporting
- No setup required
Automated Import via Printer App
The MachShip Printer Application monitors folders and automatically processes files as they arrive. Perfect for:
- High-volume operations
- System-integrated workflows
- Hands-off processing
Key Features:
- Continuous folder monitoring
- Automatic file processing
- Real-time notifications
- Structured error handling
File Management:
- success folder: Contains successfully processed files
- error folder: Contains failed imports with detailed error information
Import Formats
Standard CSV Format
Our standard CSV format provides a straightforward template with predefined fields and validation rules.
Required Fields:
-
Address Information
- From/To Location Name
- Complete address details (street, suburb, state, postcode)
- Contact information
-
Package Details (for unmanifested consignments)
- Dimensions (length, width, height in cm)
- Weight (in kg)
- Item type (carton, pallet, etc.)
-
Reference Information
- Customer references
- Special instructions (if needed)
- Carrier account details (optional)
For information on how to implement our generic format, please read the generic import guide here.
Custom Workflow Format
When your file format differs from our standard template, workflow tasks provide powerful mapping capabilities:
Key Features:
- Flexible field mapping
- Complex file handling
- Multiple formats support
- Data transformation rules
Supported File Types:
- Delimited Files
- Custom CSV structures
- Tab-separated files
- Custom delimiters
- Header/footer handling
For information on how to setup your delimited file import, read our guide here.
- XML Files
- Complex hierarchies
- Nested data structures
- Custom schemas
- Node mapping
For information on how to setup your XML file import, read our guide here.
Best Practices
-
Data Preparation
- Validate addresses before import
- Verify package details
- Check reference numbers
- Ensure required fields are complete
-
Process Management
- Test in sandbox environment first
- Monitor error reports regularly
- Maintain clean file directories
- Document your procedures
-
System Integration
- Map all required fields
- Plan for missing data
- Configure error handling
- Set up appropriate notifications
Limitations & Alternatives
Current Limitations
- No dangerous goods support via file import
- Basic data transformation only
- Limited field combinations
Alternative Solutions
-
API Integration
-
Custom Integration
- Tailored to your needs
- Full feature support
- Custom data handling
- Integration fee applies
Contact our client integrations team to discuss custom solutions for requirements beyond standard import capabilities.