SAASInventory

Import/Export

Import/Export provides bulk data operations for all major system modules, enabling efficient mass creation, updates, and data migrations through Excel and CSV file processing. The interface supports bidirectional data flow with template-based imports, validation-rich exports, and comprehensive error logging for data quality assurance.

Import/Export CategoryAccess PathPurpose
General ImportsImports → Import/Export → General SectionBulk operations for Items, Assets, BOM, Locations, Users
Order ImportsImports → Import/Export → Orders SectionPurchase Orders, Suppliers, Supplier Catalogs, Shipping Orders, Customers
Transaction ImportsImports → Import/Export → Stock TransactionsReceiving, Issues, Cycle Counts (direct inventory adjustments)
Export OperationsImports → Import/Export → Export LinksDownload current data for review, editing, or backup

Import/Export operations integrate with all system modules to maintain data consistency while enabling rapid deployment, migrations, annual updates, and integration with external systems through file-based data exchange.

Access: Imports → Import/Export Interface

Understanding Import/Export

The import/export system processes structured data files through stored procedures that validate, transform, and insert/update records across multiple related tables. Each import type follows a consistent pattern: template download, data preparation, file upload, processing with validation, and detailed result logging.

Screen Components:

  • Warehouse Selector: Context filter for imports requiring warehouse specification
  • Module Tables: Organized by category (General, Orders, Stock Transactions)
  • Export Links: Download existing data in Excel format
  • Import Forms: File upload interface with Accept/Submit buttons
  • Template Links: Download blank Excel templates with required column structure
  • Progress Indicators: Upload and processing status display
  • Import Logs: Detailed success/error results for troubleshooting

Key Operations:

  • Template Download: Obtain correctly formatted Excel files with headers
  • Data Preparation: Populate templates with import data
  • File Upload: Select and submit CSV/XLS/XLSX files
  • Validation: System checks data types, foreign keys, business rules
  • Processing: Insert new records or update existing based on key fields
  • Error Review: Examine import log for failures and corrections
  • Export: Download current system data for comparison or editing

Import Processing Flow:

  1. User downloads template for desired import type
  2. Data populated in Excel with required columns
  3. File saved as CSV, XLS, or XLSX format
  4. Upload via Import/Export interface
  5. System reads file row-by-row
  6. Each row validated against business rules
  7. Foreign key references verified (warehouses, suppliers, items, etc.)
  8. Valid rows inserted/updated in database
  9. Invalid rows logged with error descriptions
  10. Import log displayed with success/failure summary
  11. User reviews errors and corrects source data
  12. Re-import corrected rows as needed

General Imports

Foundational data imports for core system entities including items, assets, bill of materials, locations, and users. These imports establish master data referenced throughout operational workflows.

Items and Inventory

Import item master records with inventory quantities, locations, and attributes. Creates or updates parts with multi-warehouse stock levels.

Template: InventoryPro_Inventory.xlsx Required Permission: Create/Modify Item Master Record Key Fields: Item ID, Description, UOM, Category, Warehouse, Quantity, Location

When to Use:

  • Initial system setup with existing item catalog
  • Annual inventory physical count adjustments
  • Migrating from legacy systems
  • Bulk price updates or attribute changes
  • Adding new product lines with many SKUs

Validation Rules:

  • Item ID required, becomes primary identifier
  • UOM auto-created if doesn’t exist
  • Category must exist or be created during import
  • Warehouse required for quantity assignments
  • Location must exist if specified
  • Numeric fields validated for appropriate data types

Import Behavior:

  • Existing items updated based on Item ID match
  • New items created if ID not found
  • Inventory quantities set per warehouse-location combination
  • Multiple rows per item allowed for different warehouses
  • Cost and pricing fields updated if provided

Assets

Import fixed asset records with acquisition details, locations, and assignments.

Template: InventoryPro_Asset.xlsx Required Permission: Create/Modify Asset Key Fields: Asset Number, Description, Category, Location, Acquisition Date, Cost

When to Use:

  • Annual asset register updates
  • New equipment deployments
  • Asset transfers between locations
  • Depreciation schedule updates
  • Physical asset audit corrections

Validation Rules:

  • Asset number must be unique
  • Category references asset type master
  • Location optional but recommended
  • Acquisition date validated as date type
  • Cost must be numeric, non-negative
  • Serial number optional, unique if provided

Bill of Materials (BOM)

Import assembly components and sub-assembly structures with quantities and unit conversions.

Template: InventoryPro_BillOfMaterials.xlsx Required Permission: Bill of Materials (access) Key Fields: Assembly Item, Component Item, Quantity, UOM

When to Use:

  • Setting up manufacturing assemblies
  • Engineering change orders affecting BOMs
  • New product introduction with component lists
  • BOM accuracy projects
  • Migrating from CAD or ERP systems

Validation Rules:

  • Assembly must exist as “Make” item
  • Component must exist in item master
  • Quantity must be positive numeric
  • UOM defaults to component’s base UOM if blank
  • Circular references prevented (item cannot contain itself)

BOM Structure:

  • One row per component-assembly relationship
  • Multiple components per assembly supported
  • Sub-assemblies allowed (component is itself a “Make” item)
  • Quantity represents units of component per assembly unit

Locations

Import warehouse storage locations with descriptions for barcode labeling and organization.

Template: InventoryPro_Locations.xlsx Required Permission: Create/Modify Warehouse Location Key Fields: Warehouse, Location, Description

When to Use:

  • Initial warehouse setup with rack/bin structure
  • Warehouse expansions or reorganizations
  • Adding zones or pick areas
  • Standardizing location naming conventions
  • Preparing for barcode labeling projects

Validation Rules:

  • Warehouse must exist in warehouse master
  • Location identifier unique per warehouse
  • Description optional, maximum 255 characters
  • Auto-assigned zone 0 and sequential pick paths
  • Maximum 50 characters for location identifier

See Also: Location Barcodes for bulk location import with barcode generation

Users

Import system user accounts with security permissions, warehouse assignments, and contact information.

Template: InventoryPro_Users.xlsx Required Permission: Create/Modify System User Key Fields: Username, Full Name, Email, Warehouse, Security Level

When to Use:

  • Initial system deployment with staff roster
  • Annual user access reviews and updates
  • Organizational restructuring affecting assignments
  • Mass security permission changes
  • New hire onboarding in batches

Validation Rules:

  • Username must be unique
  • Email format validated if provided
  • Warehouse assignment must exist
  • Security level references permission templates
  • Password reset required on first login if created via import

Security Considerations:

  • Imported users default to active status
  • Password policy enforced on first login
  • Audit log captures user creation source
  • Review imported users before granting elevated permissions

Order Imports

Transactional imports for procurement and sales order workflows including purchase orders, suppliers, supplier catalogs, shipping orders, and customer records.

Purchase Orders

Import purchase orders with line items, pricing, and expected delivery dates.

Template: InventoryPro_PurchaseOrders.xlsx Required Permission: Create/Modify PO Key Fields: PO Number, Supplier, Item, Quantity, Unit Cost, Expected Date

When to Use:

  • Migrating open POs from legacy systems
  • Bulk PO creation from planning systems
  • Contract order loading (blanket POs)
  • Annual forecasted order setup
  • Integration with procurement platforms

Validation Rules:

  • PO number unique or matches existing for updates
  • Supplier must exist in supplier master
  • Item must exist in item master
  • Quantity and unit cost must be positive numeric
  • Expected date validated as future date
  • Warehouse destination required for receipt planning

Line Item Handling:

  • Multiple rows per PO number creates multi-line orders
  • First row creates PO header with supplier and dates
  • Subsequent rows with same PO number add line items
  • Existing POs updated if PO number matches

Suppliers

Import vendor master records with contact information, payment terms, and performance metrics.

Template: InventoryPro_Suppliers.xlsx Required Permission: Create/Modify Supplier Key Fields: Supplier ID, Name, Contact, Phone, Email, Payment Terms

When to Use:

  • Initial vendor database setup
  • Annual vendor list updates
  • Consolidating supplier information from divisions
  • Adding new vendor relationships in bulk
  • Updating contact information after mergers

Export Available: Yes, download current suppliers for editing

Validation Rules:

  • Supplier ID unique across system
  • Name required, maximum 100 characters
  • Email format validated if provided
  • Payment terms reference standard terms table
  • Phone numbers accept various formats

Supplier Catalogs

Import vendor item mappings with pricing, UOM, and package sizes for procurement automation.

Template: InventoryPro_SuppliersCatalog.xlsx Required Permission: Create/Modify Supplier Catalog Entry Key Fields: Vendor, Item ID, Vendor Item ID, UOM, Package, Unit Cost

When to Use:

  • Receiving electronic price lists from vendors
  • Quarterly vendor price updates
  • Onboarding new suppliers with product lines
  • Contract pricing changes
  • Restocking automation setup

Export Available: Yes, filter by vendor or export all catalogs

See Also: Supplier Catalogs for detailed catalog management workflows

Shipping Orders

Import sales orders, work orders, or shipping orders with line items and delivery details.

Template: InventoryPro_ShippingOrders.xlsx Required Permission: Create/Modify SO Key Fields: SO Number, Customer, Item, Quantity, Ship Date, Delivery Address

When to Use:

  • Bulk order import from e-commerce platforms
  • Contract fulfillment order loading
  • Forecasted shipment planning
  • Migration from legacy order systems
  • Integration with sales/CRM systems

Validation Rules:

  • SO number unique or matches existing for updates
  • Customer must exist in customer master
  • Item must exist and have available inventory
  • Quantity validated against stock levels (warning if insufficient)
  • Ship date must be current or future date

Customers

Import customer master records with billing addresses, contacts, and account settings.

Template: InventoryPro_Customers.xlsx Required Permission: Create/Modify Customer Key Fields: Customer ID, Name, Billing Address, Contact, Phone, Email

When to Use:

  • Initial customer database setup
  • CRM data synchronization
  • Annual customer record updates
  • Adding new customer accounts in batches
  • Updating contact information after organizational changes

Export Available: Yes, download current customers for review

Transaction Imports

Direct inventory transaction imports for receiving, issuing, and cycle count adjustments that immediately affect stock levels.

Receive Stock

Import receipts directly into inventory without PO reference, useful for returns, adjustments, or external receipts.

Template: InventoryPro_DirectReceive.xlsx Required Permission: Import Receipts Key Fields: Item, Quantity, Location, Warehouse, Transaction Date, Reason Code

When to Use:

  • Physical inventory adjustments increasing stock
  • Return to stock from jobs or work orders
  • Found inventory during cycle counts
  • Receiving without formal PO (donations, samples)
  • Correcting prior receipt errors

Validation Rules:

  • Item must exist in item master
  • Quantity must be positive numeric
  • Location must exist in warehouse
  • Warehouse required for stock assignment
  • Transaction date defaults to current if blank
  • Reason code references system reason codes

Caution: Direct receives bypass PO receiving workflows and cost tracking. Use PO receipts for normal procurement operations.

Issue Stock

Import issue transactions reducing inventory, such as consumption, scrap, or transfers out.

Template: InventoryPro_DirectIssue.xlsx Required Permission: Import Issues Key Fields: Item, Quantity, Location, Warehouse, Transaction Date, Reason Code

When to Use:

  • Physical inventory adjustments decreasing stock
  • Bulk scrap or disposal transactions
  • Lost inventory during cycle counts
  • Consumption not tied to specific jobs
  • Correcting prior over-receipts

Validation Rules:

  • Item must exist and have inventory in specified location
  • Quantity must not exceed available stock
  • Location must contain item being issued
  • Warehouse context required
  • Reason code required for audit trail
  • Transaction date validated as past or current

Caution: Direct issues bypass job costing and work order tracking. Use standard issue processes for operational consumption.

Cycle Count

Import cycle count results to adjust inventory quantities based on physical counts, reconciling system vs actual stock.

Template: InventoryPro_CycleCount.xlsx Required Permission: (Cycle count access) Key Fields: Item, Location, Warehouse, System Quantity, Physical Count, Count Date

When to Use:

  • Annual physical inventory updates
  • Cycle count program result loading
  • Third-party inventory audit corrections
  • Migrating inventory from external systems
  • Correcting systemic inventory discrepancies

Validation Rules:

  • Item and location must exist
  • Warehouse context required
  • System quantity retrieved automatically for comparison
  • Physical count must be non-negative numeric
  • Variance calculated as Physical - System
  • Adjustment transactions created for non-zero variances

Processing Behavior:

  • Positive variances create receive transactions
  • Negative variances create issue transactions
  • Zero variance (count matches system) logs count without adjustment
  • Reason code auto-assigned as “Cycle Count Adjustment”
  • Audit trail captures counter, date, and variance amounts

Export Operations

Download current system data in Excel format for review, editing, backup, or analysis. Exports include all active records with key fields formatted for re-import after modifications.

Available Exports:

  • Warehouse/Inventory: Full item master with current stock levels per warehouse-location
  • BOM: Assembly structures with component lists and quantities
  • Locations: Warehouse storage spots with descriptions and pick paths
  • Users: System user accounts with permissions and assignments
  • Suppliers: Vendor master with contact and payment terms
  • Supplier Catalogs: Vendor item mappings with pricing (filter by vendor)
  • Customers: Customer master with billing and contact information

Export Workflow:

  1. Navigate to Imports → Import/Export Interface
  2. Locate desired module row in appropriate section
  3. Click Export link in second column
  4. Select optional filters (warehouse, vendor, etc.)
  5. Choose file format (XLS recommended for Excel compatibility)
  6. Click Download or Generate
  7. System executes query and formats results
  8. File downloads with timestamp in filename
  9. Open in Excel for review or editing
  10. Save as new file if making changes (preserve original export)
  11. Re-import edited file using corresponding import function

Export Uses:

  • Backup: Preserve data snapshots before bulk changes
  • Audit: Review data quality and completeness
  • Analysis: Export to Excel for pivot tables or external analysis tools
  • Editing: Bulk updates via Excel formulas and fill-down
  • Comparison: Diff exports over time to track changes
  • Documentation: Support training or business process documentation
  • Integration: Provide data to external systems or partners

Export Format:

  • Excel (.xls) default for maximum compatibility
  • CSV available for text-based integrations
  • Column headers match import template structure
  • Data formatted for direct re-import without modification
  • Timestamps included for audit trail

Validation and Business Rules

File Format Requirements

  • Accepted formats: CSV, XLS, XLSX
  • Maximum file size varies by import type (typically 10-50 MB)
  • Column headers must match template exactly (case-sensitive)
  • UTF-8 encoding recommended for special characters
  • First row must contain headers, data starts row 2
  • Empty rows skipped during processing

Data Validation

  • Required fields enforce non-null constraints
  • Foreign key relationships validated (items, warehouses, suppliers exist)
  • Data type validation (dates, numbers, text lengths)
  • Business rule enforcement (quantities non-negative, dates logical)
  • Duplicate key detection (unique identifiers)
  • Circular reference prevention (BOMs)

Error Handling

  • Invalid rows skipped, processing continues
  • Error log details row number, field, and reason
  • Partial imports allowed (valid rows process, invalid rows logged)
  • No automatic rollback (valid data commits even if errors exist)
  • Import log persists for troubleshooting
  • Re-import corrected rows without affecting previously successful imports

Update vs Insert Logic

  • Key field match updates existing record
  • No match creates new record
  • Update overwrites all provided fields
  • Blank fields in import may clear existing data (use caution)
  • Some imports merge (add lines to PO) vs replace (overwrite item)

Performance Considerations

  • Large imports (>1000 rows) process in batches
  • Script timeout extended for bulk operations (600 seconds)
  • Import during off-peak hours for minimal user impact
  • Break very large files (>10,000 rows) into multiple imports
  • Database indexes optimize foreign key lookups
  • Progress indicator may not update for every row (batched feedback)

Admin Options

OptionSettingDescription
279Import / ExportMaster security permission controlling access to all import/export operations
Script Timeout600 secondsServer-side timeout for large file processing, configurable in ASP page headers

Module-Specific Permissions: Each import requires both Security ID 279 AND module-specific create/modify permission:

  • Create/Modify Item Master Record (Items)
  • Create/Modify Asset (Assets)
  • Bill of Materials (BOM access)
  • Create/Modify Warehouse Location (Locations)
  • Create/Modify System User (Users)
  • Create/Modify PO (Purchase Orders)
  • Create/Modify Supplier (Suppliers)
  • Create/Modify Supplier Catalog Entry (Catalogs)
  • Create/Modify SO (Shipping Orders)
  • Create/Modify Customer (Customers)
  • Import Receipts (Receive Stock)
  • Import Issues (Issue Stock)

File Upload Configuration:

  • basUploadFunc.inc handles file processing
  • Supported MIME types: text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • Upload path configured in global settings
  • Temporary files cleaned after processing

Best Practices

Template Discipline. Always start with downloaded template for each import type rather than creating from scratch. Preserve column order and headers exactly as provided. Add data rows below header row without modifying template structure. Use Excel data validation and conditional formatting to catch errors before upload. Save working file separate from original template for reuse. Document custom column mappings if integrating with external systems. Test with small sample file (5-10 rows) before full import. Keep template library updated when system versions change or new fields added. Train staff on template usage and common pitfalls before granting import permissions.

Data Quality Assurance. Validate data completeness in source system before export and import. Cleanse data for special characters, leading/trailing spaces, and formatting inconsistencies. Use Excel formulas to standardize formats (TRIM, UPPER, date formatting). Cross-reference foreign keys (verify warehouses, suppliers, items exist) before import. Export current data first for comparison and validation of changes. Perform test imports in non-production environment when available. Review error logs immediately after import and correct all failures. Reconcile record counts (exported vs imported) to ensure completeness. Document data transformation rules for repeatable processes. Maintain audit trail of import files with timestamps and user annotations.

Error Resolution Workflow. Download import log immediately after processing completes. Sort errors by type to identify systematic issues (missing foreign keys, format problems). Correct source data in original Excel file rather than manually in system. Re-import corrected rows using same template structure. Verify corrections processed successfully via second import log review. Use exports to validate final state matches intended changes. Escalate persistent errors to system administrator for stored procedure review. Document common errors and resolutions in team knowledge base. Consider data validation rules in source systems to prevent recurring issues. Schedule periodic data quality audits to identify import-related problems proactively.

Troubleshooting

Issue: Import fails with “file format not supported” error

Problem: Upload rejected before processing begins. Solution: Verify file saved as CSV, XLS, or XLSX (not XLSM with macros). Check file extension matches actual format (Excel can save with wrong extension). Remove any special formatting (merged cells, formulas, conditional formatting) before saving. Re-save from template rather than converted file. Try CSV format as simplest alternative. Prevention: Always use Save As with explicit format selection. Test file opens in Excel without errors before upload.

Issue: All rows failing with “item not found” errors

Problem: Every import row rejected for missing item reference. Solution: Verify item IDs match exactly (case-sensitive in some configurations). Check for leading/trailing spaces in item ID column. Confirm items exist in item master via export or search. Validate item IDs not using display format vs system ID. Import items first if creating new items and inventory simultaneously. Prevention: Export items and use VLOOKUP to validate IDs before import. Standardize item ID format in source systems.

Issue: Import processing extremely slow or timing out

Problem: Upload begins but never completes or shows timeout error. Solution: Reduce file size (split into multiple imports of 500-1000 rows each). Remove unnecessary columns beyond required fields. Import during off-peak hours with less system load. Increase script timeout if administrative access available. Check for locked records or concurrent processes blocking database. Verify network stability for large file uploads. Prevention: Establish file size limits (5,000 rows max recommended). Schedule large imports for overnight processing.

Issue: Partial import with some rows successful, others failed

Problem: Import log shows mix of successes and errors. Solution: Review error log to identify failure patterns. Correct failed rows in source file. Re-import only corrected rows (successful rows already in system). Check if failures concentrated in specific data patterns (e.g., all from one warehouse). Verify foreign key references for failed rows exist. Prevention: Use data validation in Excel before import. Test with small sample before bulk import.

Issue: Imported data missing or incorrect values

Problem: Import successful but data not as expected in system. Solution: Verify column headers match template exactly (order and spelling). Check for column shifts due to extra columns in import file. Review if blank cells interpreted as updates clearing existing values. Export data to compare before/after import results. Check stored procedure logic for field mapping if custom integrations. Prevention: Use unmodified templates. Document any custom column mappings. Review first few imported records before processing full file.

Problem: Clicking export produces error or no download. Solution: Verify export permission (Security ID 279 and module-specific view). Check for browser popup blockers preventing download. Try different browser if issues persist. Verify export stored procedure exists and executes. Check for data query timeouts if exporting very large datasets. Review IIS logs for server-side errors. Prevention: Test exports with small datasets first. Use filters to limit export size. Enable popup exceptions for application URL.

Issue: Import log not displaying after upload

Problem: Upload completes but no feedback on results. Solution: Check if import redirected to log page (URL should show import log reference). Review browser console for JavaScript errors preventing display. Verify import log records created in database. Check if error occurred during import preventing log creation. Refresh page or navigate directly to import history if available. Prevention: Document expected import flow for user training. Maintain manual record of import file details for audit trail.

Key Reports

Report IDReport NameDescriptionUse Case
Import LogsModule-Specific Import ResultsDetailed success/error logs for each import operationTroubleshoot failed imports, verify completion, audit data quality, document corrections
52Inventory Master ListingComplete item master with attributes and stock levelsPre-import validation of items, post-import verification, export template preparation
39Error LogSystem errors including import processing failuresIdentify technical issues during imports, escalate to administrators for resolution
67User ActivityImport operations logged with user and timestampAudit trail of import operations, compliance reporting, training effectiveness analysis

Import Analytics: Track import frequency and volume by module to identify automation opportunities. Monitor error rates by user to identify training needs. Analyze import timing to optimize performance. Review data quality trends from error logs to improve source system validations. Maintain import file archive for historical reference and disaster recovery.

Data Quality Metrics: Calculate import success rate (rows processed / rows submitted). Track time-to-resolution for import errors (initial upload to error correction). Monitor data accuracy post-import through cycle counts and transaction audits. Establish baseline data quality scores for continuous improvement initiatives.

On this page