This article explains how to set up and configure the Veeqo integration with Mintsoft. The integration enables comprehensive order management, stock synchronisation, and automated purchase order processing between the two systems.
Integration features
The Veeqo integration provides the following features:
Order sync.
Stock and product sync.
Despatch updates (status and tracking information).
Create ASNs directly from purchase orders in Veeqo.
Prerequisites
Before setting up the Veeqo integration, ensure you have:
An active Veeqo account with administrator access.
Access to the Employees section in Veeqo (required for API token generation).
Setting Up the Integration
To set up the Veeqo integration in Mintsoft:
Click Order Integrations > Veeqo.
Click Add Account.
Complete the configuration as described in the sections below.
Setup Process
Step 1: Configure Basic Settings
Before entering your API credentials, you'll need to configure:
Client: Select the client this integration is for.
Warehouse: Select the Mintsoft warehouse for order fulfilment.
Channel: Select the sales channel this integration represents.
Active: Check this box to enable the integration.
Step 2: Enter Veeqo API Credentials
To set up the Veeqo integration with Mintsoft, you'll need an API token. Follow these steps to generate one:
Log in to your Veeqo account.
Navigate to the Employees page in the top right corner.
Click Add New Employee.
Once you've created the user, go to Edit User.
Scroll down to the API Key Section.
Either copy the existing API Key or click Refresh API Key to generate a new one.
Copy the API Key that's generated.
Tip: You can add the API to an existing user, but creating a new employee helps track who makes changes.
Once you have your API key:
Paste it into the API Key field.
Leave the Veeqo Warehouse ID field blank for now.
Click Save to create the connection.
Step 3: Retrieve Veeqo Warehouse Information
After saving the initial configuration:
Click the Get Warehouses button.
This will retrieve a list of warehouses from your Veeqo account.
Copy the following -
The Veeqo Warehouse ID.
The Veeqo Warehouse Name.
Click Save to update the connection.
Note: The Veeqo Warehouse ID is the actual warehouse ID used for order and stock synchronisation. This field must be populated for the integration to work correctly. The Veeqo Warehouse Name field is for reference only and helps you identify which warehouse you've selected. It doesn't affect the integration functionality.
Step 4: Configure Order Import Settings
Order Import Status (Required): Set to awaiting_fulfillment (displayed as 'Ready To Ship' in Veeqo).
Important: This field is required. Orders won't sync from Veeqo to Mintsoft if this field is left blank. Only orders matching the specified status(es) will be imported.
You can configure multiple statuses by entering them as a comma-separated list with no spaces between values. For example: awaiting_stock,awaiting_fulfillment
Available status values include:
awaiting_payment
awaiting_stock
awaiting_fulfillment
shipped
on_hold
cancelled
refunded
Step 5: Configure Additional Settings
Order Prefix (Optional)
The Order Prefix field allows you to add a prefix to order numbers imported from Veeqo. This is useful if you need to distinguish Veeqo orders from orders imported from other sources.
For example, if you set the prefix to "VQ-", an order with number "12345" in Veeqo will be imported as "VQ-12345" in Mintsoft. Leave this field blank if you want to keep the original Veeqo order numbers.
Update Remote Orders in Veeqo
Request Veeqo to Update Remote Order: Check this box if you want Mintsoft to send despatch updates back to Veeqo, which will update the order status and add tracking information.
When enabled, orders despatched in Mintsoft will automatically be marked as shipped in Veeqo with tracking details.
Customer Notifications
Request Veeqo to Notify Customer When Shipped: Toggle to ON if you want Veeqo to send notification emails to customers when orders are marked as Despatched in Mintsoft.
ON: Veeqo handles customer shipping notifications.
OFF: Customer notifications will be handled according to your Mintsoft email settings (if configured).
Note: This setting only applies when Request Veeqo to Update Remote Order is also enabled.
Stock Synchronisation
To enable automatic stock level updates between Mintsoft and Veeqo:
Check the Stock Sync checkbox to enable stock synchronisation.
Set the Stock Sync Delay to control how frequently stock levels are updated (default: 30 minutes).
Enter the Veeqo Stock Sync Warehouse ID for the warehouse whose stock levels should be synchronised.
When enabled, stock level changes in Mintsoft will automatically update in Veeqo at the configured interval.
Note: To trigger an immediate full stock sync, use the Trigger Full Stock Sync button on the integration list page.
Product Synchronisation
To enable automatic product information sync from Veeqo to Mintsoft:
Check the Sync New Products checkbox to enable product synchronisation.
Set the Product Sync Delay to control the sync interval (default: 1, meaning every 15 hours based on the Order Sync Delay setting).
When enabled, new products and product updates from Veeqo will be automatically imported into Mintsoft.
Important: Ensure your product SKUs match exactly between Veeqo and Mintsoft (case-sensitive) for proper synchronisation.
Purchase Order Integration (ASN Creation)
The integration can automatically create Advanced Shipping Notices (ASNs) in Mintsoft from purchase orders in Veeqo.
Configuration
Purchase Order Import to ASNs: Check this box to enable automatic ASN creation from Veeqo purchase orders.
Purchase Order Status' To Import to ASNs: Enter the Veeqo purchase order statuses that should trigger ASN creation (comma-separated, no spaces).
ASNs Imported as Awaiting Delivery: Check this box to import ASNs with "Awaiting Delivery" status instead of "NEW" status.
Create Product from PO if it doesn't exist: Check this box to automatically create products in Mintsoft if they don't exist when importing a purchase order.
How It Works
When a purchase order in Veeqo reaches one of the configured statuses:
An ASN is automatically created in Mintsoft.
You can receive the stock against this ASN in Mintsoft.
Stock levels are updated in both systems once received.
This eliminates duplicate data entry and streamlines your receiving process.
Sync Frequencies
The integration runs automated syncs at the following intervals:
Order Sync: Every 15 minutes (default) – configurable via the Delay field.
Product Sync: Every 15 hours (default) – only runs if Sync New Products is enabled.
Stock Sync: Every 30 minutes (default) – configurable via the Stock Sync Delay field, only runs if Stock Sync is enabled.
Purchase Order to ASN Sync: Every 15 minutes (default) – only runs if Purchase Order Import to ASNs is enabled.
You can adjust these frequencies in the integration settings to match your business needs.
Troubleshooting
Orders Not Syncing
Verify that the Order Import Status field isn't blank.
Check that the status matches orders in Veeqo (e.g., "awaiting_fulfillment").
Ensure the Active checkbox is checked.
Confirm the API key is valid.
Stock Levels Not Updating
Verify the Stock Sync checkbox is checked.
Confirm the Veeqo Stock Sync Warehouse ID is correctly configured.
Ensure product SKUs match exactly between systems (case-sensitive).
Despatch Updates Not Appearing in Veeqo
Check that Request Veeqo to Update Remote Order is enabled.
Verify the Veeqo Warehouse ID matches the warehouse in Veeqo.
Ensure orders were imported from Veeqo (not manually created in Mintsoft).
API Authentication Errors
Regenerate your API token in Veeqo if authentication fails.
Ensure the Veeqo employee account has administrator permissions.
Verify there aren't any extra spaces when pasting the API key.
For additional support, contact the Mintsoft support team.