# 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

1. Log in to your **XoroERP** account.
2. Navigate to the **Apps** module from the main dashboard.
3. Open the **3PL Connections** tab.
4. Click **Add 3PL Connection**.
5. Select **Veeqo** from the list of available integrations.

#### 2.2 Install the Veeqo Integration

1. Click **Install** to add the Veeqo integration to your XoroERP instance.
2. Once installed, the connection will be listed among your active integrations.

#### 2.3 Configure Veeqo Account

1. Open the **Veeqo** integration from the active 3PL or integrations list.
2. Enter the required credentials and connection settings provided by Veeqo (such as account identifiers, keys, or tokens as applicable).
3. 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.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F1W2rlEuelrZLn93FDT5f%2Fimage.png?alt=media&#x26;token=3c841c5b-e06e-4c0c-bac1-18b9d465115e" alt=""><figcaption></figcaption></figure>

#### 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.

<div align="center"><figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FANK0EbEqk5ATOS0001zh%2Fimage.png?alt=media&#x26;token=72ce2424-623d-45df-9576-7fabd251a450" alt=""><figcaption></figcaption></figure></div>

| Setting                             | UI Element | Description                                                                                                                                                                                                                                                                                                                                               |
| ----------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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.”** |

{% hint style="info" %}
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.
{% endhint %}

<div align="center"><figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F0QajTqRmi9Q8nPjtjGYr%2Fimage.png?alt=media&#x26;token=f9b4c939-8cf6-4212-8f63-cb25fdd1bcb2" alt=""><figcaption></figcaption></figure></div>

| Setting              | UI Element | Description                                                                                                                                                                                                                                                          |
| -------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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)**

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FyPezldzuVSWxjPpzxoum%2Fimage.png?alt=media&#x26;token=c7c7690a-982c-405c-8ba6-60152fca33f1" alt=""><figcaption></figcaption></figure>

| Setting               | UI Element | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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. |

***

<p align="center"><strong>Filter Configuration</strong></p>

<div align="center"><figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FLG64vhrQOQTHNFGFHHvZ%2Fimage.png?alt=media&#x26;token=4234a16e-bdeb-4beb-8d12-c5254c7f839f" alt=""><figcaption></figcaption></figure></div>

| Setting                        | UI Element    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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.**                                                                                                                                                                                                                                                      |

***

<p align="center"><strong>Carrier Name Mapping</strong></p>

<div align="center"><figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FOLcVyRHRiX6I9KkZRMOU%2Fimage.png?alt=media&#x26;token=d6dfeaaa-48e6-49ac-9d72-5a1fad0e75ed" alt=""><figcaption></figcaption></figure></div>

| Setting                                 | UI Element    | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 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**

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fq8do1PaYlKGT5BISnkUw%2Fimage.png?alt=media&#x26;token=4379cf19-f658-4512-b62a-2221dbf526b0" alt=""><figcaption></figcaption></figure>

| Setting                                           | UI Element               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FcApWlUv3Flyd1PxgscsS%2Fimage.png?alt=media&#x26;token=c0cabd63-6f07-4010-b10f-fd3bd9ea96b6" alt=""><figcaption></figcaption></figure>

| Setting   | UI Element | Description                                                                                                                                                                                                                                       |
| --------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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)**

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FuaXZveHSoSUxae9YHG4S%2Fimage.png?alt=media&#x26;token=3f41a3ac-88f6-4249-9960-87af51cd0756" alt=""><figcaption></figcaption></figure>

When enabled, XoroERP automatically runs all **Veeqo import and export jobs** based on the configured schedule.

| Setting                       | UI Element    | Description                                                                                                                                                                                                                                                                      |
| ----------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fkcgac7JhOvdfmaPVtNVb%2Fimage.png?alt=media&#x26;token=5be578f2-b295-4d33-917a-32758b87a752" alt=""><figcaption></figcaption></figure>

| Setting                                     | UI Element | Description                                                                                                                                                                                                |
| ------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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)**

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FcN5JDodPvezIdbYKsZBh%2Fimage.png?alt=media&#x26;token=4e7ca9c5-1a86-4435-aad3-5e92428ef3e7" alt=""><figcaption></figcaption></figure>

| Setting                | UI Element | Description                                                                                                                                                                            |
| ---------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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.**                                         |

***

| Setting      | UI Element | Description                                                                                                                                                                                                        |
| ------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 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**

1. Go to the **Apps** module in XoroERP.
2. Open the **3PL Connections** or integration list.
3. Select the **Veeqo** integration (e.g., *VeeqoTest*).
4. Click on **Operations** to open the Veeqo Operations Page.

**Header Options**

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FkAH2128kPWPLMtYAhTAn%2Fimage.png?alt=media&#x26;token=c0f0d184-1b5f-412b-9c03-fc0efc125027" alt=""><figcaption></figcaption></figure>

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&#x20;

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.