Veeqo
1. Overview
The Veeqo Integration in XoroERP connects your XoroERP instance with Veeqo, enabling order export or fulfillment import between the two systems.
With this integration, you can:
Export eligible orders from XoroERP to Veeqo for processing and fulfillment, or
Fetch order fulfillments from Veeqo (for example, Amazon orders fulfilled at Veeqo) back into XoroERP.
This integration is designed so that only one mode is active at a time: either exporting orders to Veeqo or fetching fulfilled orders from Veeqo, avoiding conflict between the two flows.
Scheduling, filters, and mapping options in the configuration allow precise control over which data is exchanged and how it is processed.
2. Installation
2.1 Connect to XoroERP Instance
Log in to your XoroERP account.
Navigate to the Apps module from the main dashboard.
Open the 3PL Connections tab.
Click Add 3PL Connection.
Select Veeqo from the list of available integrations.
2.2 Install the Veeqo Integration
Click Install to add the Veeqo integration to your XoroERP instance.
Once installed, the connection will be listed among your active integrations.
2.3 Configure Veeqo Account
Open the Veeqo integration from the active 3PL or integrations list.
Enter the required credentials and connection settings provided by Veeqo (such as account identifiers, keys, or tokens as applicable).
Save the configuration before enabling auto import/export.
3. Workflow
The Veeqo integration automates the complete order processing and inventory synchronization cycle between XoroERP and the configured Veeqo store. This workflow ensures seamless movement of order, shipment, and inventory data across both systems.
3.1 Wave Creation in XoroERP
Sales Orders are created in XoroERP and grouped into waves based on defined allocation rules, warehouse logic, and fulfillment criteria. Each wave represents a batch of orders prepared for processing through the Veeqo integration.
3.2 Order Export to Veeqo (Order Push Enabled)
After waves are generated and orders satisfy the configured export filters, XoroERP automatically exports the orders to Veeqo. These orders are received in Veeqo under the mapped Third Party Store and are queued for picking, packing, and shipment processing.
Flow: XoroERP → Veeqo
3.3 Shipment Fulfillment and Confirmation
Veeqo processes the exported orders and performs shipment operations. Once an order (full or partial) is shipped, shipment confirmation and tracking details are generated.
When Fetch Ship Confirmation is enabled in XoroERP:
Shipment confirmations are imported into XoroERP.
Related order and wave records are updated with:
Shipment status
Tracking number(s)
Shipped quantities
Flow: Veeqo → XoroERP
4. Settings
The Configuration Settings for Veeqo define how orders and fulfillments flow between XoroERP and Veeqo, and how mappings and scheduling are handled.
4.1 Data Export Settings
The following accounts and configuration will be used in XoroERP. These settings can be modified later as needed.
Veeqo Account The Veeqo connection profile that XoroERP will use for this integration.
Export Orders to Veeqo
Checkbox
When enabled, XoroERP exports eligible orders from the selected store(s) to Veeqo based on store selection, filters, and other configuration rules.Behavior: This mode is used when XoroERP is the source of orders and Veeqo handles fulfillment. This option cannot be enabled at the same time as “Fetch Order Fulfillments from Veeqo.”
Fetch Order Fulfillments from Veeqo
Checkbox
When enabled, XoroERP fetches fulfillment details from Veeqo and updates order status, shipment information, and tracking data in XoroERP.Behavior: This mode is typically used for Amazon or marketplace orders fulfilled in Veeqo, where orders originate outside XoroERP. This option is mutually exclusive with “Export Orders to Veeqo.”
Only one of Export orders to Veeqo or the Fetch order fulfillments from Veeqo can be active at a time. The system will process data in only one direction to avoid conflicting flows.
Item Identifier Code
Dropdown
Defines which item identifier XoroERP uses to match products with Veeqo (for example, item number, SKU, or another supported identifier). This ensures order lines and fulfillment data received from or sent to Veeqo are correctly mapped to items in XoroERP.
Disable multishipment (Checkbox)
Disable Multishipment
Checkbox
Controls how shipment confirmations received from Veeqo affect wave lines in XoroERP.When enabled, the first shipment confirmation is treated as final. All wave lines are closed, and any remaining unshipped quantities are unallocated.When disabled, multiple shipment confirmations are allowed, and wave lines remain open until the entire order quantity is shipped. This setting determines whether partial shipments are permitted or whether the first confirmation finalizes the order in XoroERP.
Filter Configuration
Filter Name / Operator / Value
Configuration
Provides one or more filter rows to control which orders participate in the Veeqo integration.Filter Name defines the order field used for filtering (for example, order source or other supported attributes).Operator specifies the logical condition applied (such as Contains, Equals, etc.).Value is the value matched against the selected field.These filters allow you to refine and restrict the subset of orders that are exported to or processed with Veeqo.
Default SKU
Text Field
Defines a fallback SKU used during fulfillment when no SKU is provided or when an item identifier cannot be matched. This prevents order or fulfillment processing failures caused by missing or unrecognized item identifiers.
Carrier Name Mapping
Carrier Name / Third Party Carrier Name
Mapping Table
Defines the mapping between carrier names in XoroERP and their corresponding carrier names in Veeqo.Carrier Name represents the carrier as defined in XoroERP, while Third Party Carrier Name represents the equivalent carrier name used by Veeqo.This mapping ensures that carrier information is correctly translated between XoroERP and Veeqo during order export and fulfillment import.
Ship Service Mapping
Ship Service Name / Third Party Ship Service Name
Mapping Table
Defines the mapping between ship services in XoroERP and their corresponding ship service names in Veeqo.Ship Service Name represents the service as defined in XoroERP, while Third Party Ship Service Name represents the equivalent service label used by Veeqo.These mappings prevent processing failures caused by missing or mismatched ship service names and ensure consistent shipping service representation across both systems.
Third Party Store
Dropdown / Mapping Field
Maps a XoroERP store to its corresponding store name in Veeqo. This ensures that orders, shipment confirmations, and ship service mappings are correctly associated with the appropriate storefront in Veeqo.
4.2 Import/Export Settings
The Import/Export Settings section manages scheduling and notifications for Veeqo-related data exchange in XoroERP.
Time Zone
Dropdown
Defines the time zone used for scheduling all Veeqo-related import and export jobs. All automated tasks run according to the selected time zone. In this configuration, the time zone is set to (UTC-08:00) Pacific Time (US and Canada).
Enable Auto Import/Export (Checkbox)
When enabled, XoroERP automatically runs all Veeqo import and export jobs based on the configured schedule.
Enable Auto Import / Export
Checkbox
When enabled, XoroERP automatically runs Veeqo-related import and export jobs based on the configured schedule. Enabling this option reveals additional scheduling fields. When disabled, all Veeqo imports and exports must be triggered manually from the Operations Page.
Integration Start Date
Date Field
Specifies the date from which automated Veeqo jobs begin executing. Any transactions prior to this date are ignored during scheduled processing.
Hour
Numeric Field
Defines the hour at which the scheduled Veeqo job runs, based on the configured time zone.
Min
Numeric Field
Defines the minute at which the scheduled Veeqo job runs, allowing precise control over execution timing.
Auto Import Start Time Offset
Numeric Field
Allows the scheduled job to run earlier than the defined time by specifying a negative minute offset. This is useful when data needs to be fetched slightly ahead of the standard schedule.
Error Handling & Notifications
Receive Import Error Notifications by Email
Checkbox
When enabled, XoroERP sends immediate email alerts whenever a Veeqo-related import or export process encounters an error. This helps teams respond quickly to failures and minimize processing delays.
Instant Error Email(s)
Text Field
Specifies the email address(es) that should receive instant error notifications. Multiple email addresses can be entered, separated by commas.
Send Daily Error Email (Checkbox)
Send Daily Error Email
Checkbox
When enabled, XoroERP sends a consolidated daily summary of all errors related to the Veeqo integration. This provides a high-level view of issues encountered throughout the day.
Daily Error Email(s)
Text Field
Specifies the email address(es) that should receive the daily error summary. Multiple email addresses can be entered, separated by commas.
Exclude Logs
Text Field
Allows filtering out unwanted or non-critical log entries from email notifications. Enter comma-separated keywords or wildcard patterns to exclude matching log messages from instant and daily error reports.
5. Operations Page
The Veeqo Operations Page in XoroERP allows you to monitor and manage all Veeqo-related synchronization activities, including order exports, fulfillment imports, and log monitoring.
Accessing the Operations Page
Go to the Apps module in XoroERP.
Open the 3PL Connections or integration list.
Select the Veeqo integration (e.g., VeeqoTest).
Click on Operations to open the Veeqo Operations Page.
Header Options
Typical header actions include:
Add Account – Add another Veeqo account or environment if multiple connections are supported.
Change Account – Switch between existing Veeqo accounts or update account details.
Remove Account – Remove the current Veeqo integration from XoroERP.
Settings – Open configuration settings for Veeqo (Data Export Settings and Import/Export Settings).
Sync Xoro Data with Veeqo
This section allows manual control of data synchronization:
Trigger order export when Export orders to Veeqo is enabled.
Trigger fulfillment import when Fetch order fulfillments from Veeqo is enabled.
Optionally restrict synchronization to a date range or apply search criteria (such as order number or keyword) where available.
This is useful for initial syncs, handling backlogs, or reprocessing after configuration changes.
Previous Exports
5.1 Orders
Depending on the active mode (export or fetch), this tab will reflect:
Order Export Mode:
Shows orders pending export to Veeqo.
Includes actions like Run, Mark as Resolved, and Mark as Unresolved.
Filters such as Hide Resolved and Show Errors Only help focus on pending or failed records.
Fulfillment Fetch Mode:
Shows fetched fulfillments from Veeqo (for example, Amazon orders fulfilled there).
Allows marking records as resolved after successful processing.
Columns generally include reference number, last execution date, and a status/message field describing the result.
5.2 Logs
The Logs tab provides an overview of all Veeqo-related integration activity:
Displays each import/export execution entry for orders or fulfillments.
Shows timestamps, process type, and messages (including any errors).
Filter options (such as hiding resolved entries or focusing on errors) make it easier to troubleshoot integration issues.
The Logs tab is the primary place to confirm that Veeqo integrations are running properly and to diagnose any failures or mismatches.
Last updated
Was this helpful?