# High Jump

### 1. **Overview**

The HighJump integration in XoroERP enables seamless communication between your ERP system and the HighJump warehouse management system (WMS). This integration allows for the automatic export of orders, products, shipping information, ASNs, inventory adjustments, and transfer confirmations, ensuring that warehouse operations are synchronized in real time.

Key capabilities include:

* Exporting product and order data to HighJump.
* Receiving shipping confirmations and ASNs from HighJump.
* Handling inventory adjustments and transfer confirmations.
* Support for multi-location, damaged inventory, and custom fields for preparation codes.
* Scheduling recurring import/export jobs with automated notifications.

This integration ensures accurate order fulfillment, inventory tracking, and timely communication between XoroERP and HighJump.

***

### **2. Workflow**

1. **Data Export & Import**
   * Product and order data are exported from XoroERP to HighJump according to the configured directories and formats.
   * HighJump processes the data and updates inventory, order statuses, and shipping confirmations.
2. **Order Fulfillment**
   * Orders are picked, packed, and shipped in HighJump.
   * Ship confirmations are exported back to XoroERP, including details such as quantities shipped, carrier, and shipping method.
3. **Inventory Updates**
   * Inventory adjustments, including damaged or transferred stock, are imported/exported between XoroERP and HighJump.
   * Custom fields such as Back Order Number and Preparation Code help track order processing and packaging details.
4. **Automation & Notifications**
   * Scheduled auto import/export jobs ensure that product, order, and inventory data remain synchronized.
   * Email notifications alert the relevant stakeholders to any import/export errors.

### **3. Configuration Settings**

These settings define how product, order, ASN, and inventory data are exported to HighJump from XoroERP.

***

#### **Data Export Settings**

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FXRhbWDDanrFztWoHPblE%2Fimage.png?alt=media&#x26;token=46b07cd0-52b9-4af0-aedd-85cb83167444" alt=""><figcaption></figcaption></figure>

#### **Use Archive Directory (Checkbox)**

Enabling this will store a copy of every exported file into an archive folder. This helps maintain historical records of files sent to HighJump.

***

#### **Export Products to HighJump (Checkbox)**

When enabled, XoroERP will export product master data to HighJump. Once checked, the following fields become visible.

**Target Directory Products**

The folder path where product export files will be placed for HighJump to pick up.

**Product File Name**

Format: **\[ClientId]*****SKU\_IN*****\[yyyyMMdd\_HHmmssms]**\
Defines the naming pattern for product files so HighJump can ingest them consistently.

**Link item(s) containing the following tags**

Allows exporting only products that contain specific item tags. Useful for filtering products meant for a specific 3PL.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fh3bXWZ5k65osbmDLwjLq%2Fimage.png?alt=media&#x26;token=9c278935-6339-4869-a208-fab86024305c" alt=""><figcaption></figcaption></figure>

#### **Export Orders to HighJump (Checkbox)**

Enabling this will allow XoroERP to send sales orders to HighJump for fulfillment.

**Drop order(s) from the following store(s)**

Only orders created in the selected stores will be exported to HighJump.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FGla2vOBOsjts5zka8fUF%2Fimage.png?alt=media&#x26;token=bb08fb62-5093-4923-ab7f-cb89099abc0f" alt=""><figcaption></figcaption></figure>

#### **Block waves created via quickship in Xoro from flowing into HighJump (Checkbox)**

When enabled, waves generated through QuickShip will not be sent to HighJump. Useful when such waves should be fulfilled internally.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FgxlFGakXm5tbUhozjGKg%2Fimage.png?alt=media&#x26;token=2e9fa36e-0d7a-4470-9dd5-53aa9af25aa9" alt=""><figcaption></figcaption></figure>

#### **Item Identifier Code (Item Number, Item UPC, Item GTIN)**

Defines which product identifier XoroERP should use when sending items to HighJump.

***

#### **Split Quantity (Checkbox)**

When enabled, merged quantities (e.g., 5 units of the same item) will be sent as separate split lines to HighJump.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F8a1y1M0FH1yM4SblMhy3%2Fimage.png?alt=media&#x26;token=98aa1522-12f0-49bd-a1a0-6a863b546590" alt=""><figcaption></figcaption></figure>

#### **Ship Method Name(s)**

Ship methods listed here will **NOT** be exported to HighJump. Useful for methods fulfilled outside 3PL.

***

#### **Blocked SKU(s)**

Specific SKU(s) listed here will not be sent to HighJump. Useful for items stored outside the 3PL warehouse.

***

#### **Allowed Customer(s)**

Only orders belonging to these customers will be exported. Overrides all other filters.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FLvzAPGfY8Pj7XmzP9AEV%2Fimage.png?alt=media&#x26;token=97b406fb-6a05-44e1-9ee9-28daf759ec29" alt=""><figcaption></figcaption></figure>

#### **Target Directory Order**

Location where order export files are dropped for HighJump to retrieve.

***

#### **Target Directory Ship Confirmation**

Directory from which XoroERP will import shipping confirmations sent by HighJump.

***

#### **Archive Directory Ship Confirmation**

Backup location where imported ship confirmation files are stored.

***

#### **Order File Name**

Format: **\[ClientId]*****ORD\_IN*****\[yyyyMMdd\_HHmmssms]**\
Defines naming for order export files.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FApGppOl8gkPxT3VDdrE4%2Fimage.png?alt=media&#x26;token=2c545531-d2d9-4174-b3c8-79ebef0c394f" alt=""><figcaption></figcaption></figure>

#### **Disable Multishipment (Checkbox)**

When enabled, a single ship confirmation from HighJump will close the entire order, and any remaining quantities will be unallocated.

***

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FBxV8iNkWcxvQdJnlrL28%2Fimage.png?alt=media&#x26;token=7bda139e-a5d5-418f-b1f7-1906028f7562" alt=""><figcaption></figcaption></figure>

#### **Filter Name / Operator / Value**

Allows advanced filtering (e.g., only export orders with a specific status or custom field value).

***

#### **Default SKU**

Fallback SKU used when the incoming file from HighJump does not contain an item identifier.

***

#### **Shipping Markup**

Percentage markup that XoroERP will apply to shipping charges received from HighJump.

***

#### **Shipping Markup Order Type**

Applies shipping markup only for specific order types (e.g., wholesale, eCommerce).

***

#### **Carrier Name**

Name of the main carrier (e.g., Canada Post) to be mapped for HighJump shipments.

***

#### **Third Party Carrier Name**

Specifies a third-party logistics carrier if applicable.

***

#### **Ship Service Name**

Name of the shipping service to map for HighJump (e.g., Standard, Expedited).

***

#### **Third Party Ship Service Name**

Used when a third-party shipping service must be mapped separately.

***

#### **Xoro Custom Field for Back Order Number**

HighJump returns failed order numbers. These are saved into this custom field for tracking order failures at the WMS level.

***

#### **Batch Receive Location For Damaged Inventory**

Default location for HighJump to place damaged inventory during receiving.

***

#### **Xoro Custom Field for Order Status at WMS**

Used to display the current HighJump order processing status inside XoroERP.

***

#### **Xoro Custom Field for Preparation Code**

Used to send preparation codes (like special handling instructions) to HighJump.

***

#### **Xoro Custom Field for Preparation Code (Split Line into Multiple Cartons)**

Used when HighJump must split order lines into multiple cartons based on preparation code logic.

***

#### **Use Ship Date as Transaction Date (Checkbox)**

When enabled, ship confirmations will use the ship date from HighJump as the transaction date.

***

#### **Use Import Date as Transaction Date (Checkbox)**

Overrides ship date; uses the import date as transaction date instead.

***

#### **Allow Shipping of Locked Wave (Checkbox)**

Permits HighJump to process waves even if they’re locked in XoroERP.

***

#### **Use Order Locking (Checkbox)**

Locks orders during export and import processing to prevent changes until synchronization completes.

***

#### **Export ASNs to HighJump (Checkbox)**

Enables sending ASN (Advanced Shipment Notice) files to HighJump.

**Batch Receive Location**

Default receiving location for incoming ASNs.

**Batch Receive Location For Damaged Inventory**

Default location for receiving damaged items during ASN processing.

**Target Directory ASN**

Folder path where ASN files are exported.

**Target Directory ASN Confirmation**

Directory from where XoroERP reads ASN confirmation files sent by HighJump.

**Archive Directory ASN Confirmation**

Backup folder for storing processed ASN confirmations.

**ASN File Name**

Format: **\[ClientId]*****PRA\_IN*****\[yyyyMMdd\_HHmmssms]**

**Return ASN File Name**

Format: **\[ClientId]*****RMA\_IN*****\[yyyyMMdd\_HHmmssms]**

***

#### **Enable Inventory Adjustment (Checkbox)**

Enables exporting or importing inventory adjustment files.

**Display Location Name**

Determines whether a readable location name is displayed in files.

**Target Directory Inventory Adjustment**

Export directory for inventory adjustment files.

**Archive Directory Inventory Adjustment**

Archive folder for adjustment files.

***

#### **Enable Transfer Confirmation (Checkbox)**

Enables import/export of transfer confirmation files between warehouses.

**Target Directory Transfer Confirmation**

Where transfer confirmation files are dropped.

**Archive Directory Transfer Confirmation**

Location for archiving processed transfer confirmations.

***

#### **Time Zone**

Defines the time zone for all scheduled import/export tasks.

***

#### **Enable Auto Import/Export (Checkbox)**

Allows XoroERP to automatically run HighJump jobs on a schedule.

Appearing fields:

* **Integration Start Date** – Date automation begins
* **Hour** – Hour of scheduled run
* **Min** – Minute offset
* **Auto Import Start Time Offset** – Negative offset for early execution

If disabled, all tasks must be triggered manually.

***

#### **Receive Import Error Notifications by Email (Checkbox)**

Sends instant email alerts for any failed HighJump import.

Fields that appear:

* **Instant Error Email(s)** – Comma-separated list of emails for alerts

***

#### **Send Daily Error Email (Checkbox)**

Sends a daily summary of integration errors.

**Exclude Logs**

Comma-separated keywords to filter out unwanted logs using wildcards.

### **4. Operations Page**

#### **2.1 Product Export**

* **Purpose:** Export product data from XoroERP to HighJump.
* **Steps:**
  1. Ensure “Export Products to HighJump” is enabled in configuration settings.
  2. Verify **Target Directory Products** and **Product File Name** are correctly set.
  3. Apply any tag-based filters if required.
  4. Click **Run Export** to initiate product export.
* **Notes:** Exported files are stored in the target directory, and optionally archived if “Use Archive Directory” is enabled.

***

#### **2.2 Order Export**

* **Purpose:** Export orders to HighJump for fulfillment.
* **Steps:**
  1. Enable “Export Orders to HighJump.”
  2. Configure stores, filters (Allowed Customers, Blocked SKUs, Ship Methods), and quantity splitting if needed.
  3. Click **Run Export** to send orders to HighJump.
* **Notes:** Locked waves or Quickship orders are handled according to your configuration. Multishipment behavior depends on the “Disable Multishipment” setting.

***

#### **2.3 Ship Confirmation**

* **Purpose:** Import shipping confirmations from HighJump back into XoroERP.
* **Steps:**
  1. Verify **Target Directory Ship Confirmation** and **Archive Directory Ship Confirmation** are configured.
  2. Ship confirmations can be imported manually or automatically.
  3. Custom fields such as **Order Status at WMS** and **Preparation Code** are updated automatically.

***

#### **2.4 ASN Export**

* **Purpose:** Export Advanced Shipping Notices to HighJump.
* **Steps:**
  1. Enable “Export ASNs to HighJump.”
  2. Configure **Batch Receive Location** and **Batch Receive Location for Damaged Inventory.**
  3. Set **Target Directory ASN**, **ASN Confirmation**, and archive directories.
  4. Click **Run Export** to generate ASN files.

***

#### **2.5 Inventory Adjustment**

* **Purpose:** Sync inventory adjustments with HighJump.
* **Steps:**
  1. Enable “Enable Inventory Adjustment.”
  2. Verify **Target Directory Inventory Adjustment** and archive directory.
  3. Ensure **Display Location Name** is configured.
  4. Run the import/export process as required.

***

#### **2.6 Transfer Confirmation**

* **Purpose:** Confirm stock transfers between locations or warehouses.
* **Steps:**
  1. Enable “Enable Transfer Confirmation.”
  2. Configure target and archive directories.
  3. Run transfer confirmations manually or automatically.

***

#### **2.7 Auto Import/Export**

* **Purpose:** Automate import/export jobs with HighJump.
* **Steps:**
  1. Enable “Enable Auto Import/Export.”
  2. Configure schedule: start date, hour, minute, and optional offset.
  3. Automated jobs will run according to the configured schedule.
* **Manual Mode:** If auto import/export is disabled, jobs must be triggered manually from the operations page.

***

#### **2.8 Error Handling & Notifications**

* **Receive Import Error Notifications by Email:** Sends instant alerts for import/export errors.
* **Send Daily Error Email:** Provides a consolidated daily summary of errors.
* **Exclude Logs:** Filters unnecessary logs using keywords or wildcards.

***

####
