Pro Pack
ProPack Integration with XoroERP
1. Overview
The ProPack integration allows XoroERP to send orders and products to ProPack for fulfillment and receive shipment updates back into XoroERP.
Using this integration, you can:
Export products from XoroERP to ProPack so item data stays in sync.
Export orders from selected stores for picking and shipping in ProPack.
Receive ship confirmations from ProPack to update shipments in XoroERP.
Monitor SKU syncs and log activity for troubleshooting and audit.
Configuration is done once in the ProPack Integration Settings, and day-to-day activity is managed from the Operations page.
2. Installation
Follow these steps to connect ProPack with XoroERP:
Navigate to Apps
Go to Apps in XoroERP.
Open the 3PL Connections section.
Add ProPack Connection
Click Add 3PL Connection.
Select ProPack from the list of available 3PLs.
This will install/activate the ProPack integration and open the configuration screen.
Enter ProPack Credentials
Fill in the API keys / credentials provided by ProPack (if applicable).
Save the connection.
Once saved, ProPack will appear in your list of connected 3PLs.
Configure Data Export & Scheduling
Complete the Data Export Settings and Import/Export Settings (detailed in the next section).
Optionally enable Auto Import/Export to automate the sync.
After installation and initial configuration, you can manage day-to-day integration from the ProPack Operations page.
3. Configuration Settings
3.1 Data Export Settings
These settings control what is exported to ProPack and which orders/products are included.
Export Products to ProPack
(Checkbox) Enables export of product master data from XoroERP to ProPack so that SKUs exist in ProPack before order export.
Link Item(s) Containing Following Tags
(Tag List) Restricts product export to items with specific tags.
If blank → all items can be exported.
If tags selected → only tagged items are exported.
Export Orders to ProPack (Checkbox)
Enables order export from XoroERP to ProPack.
Orders created in eligible stores (minus exclusions and filters) will be exported.
Drop Order(s) From the Following Store(s)
(Store List) Exclude specific stores from export.
Orders created in any selected store will not be exported to ProPack.
Block Waves Created via QuickShip in Xoro from Flowing into ProPack (Checkbox)
Prevents waves created via QuickShip from being exported. Use this if QuickShip is handled completely within XoroERP without passing through ProPack.
Ship Method Name(s)
Any ship methods listed here will not be exported to ProPack. Leave blank if no ship methods need to be blocked.
Blocked SKU(s)
Any SKU listed here will not be exported to ProPack as part of an order. Leave blank to allow all SKUs.
Allowed Customer(s)
Limit exports to specific customers.
If customers are listed → only orders for those customers are exported.
If blank → orders for all customers are eligible (subject to other rules).
Disable Multishipment
(Checkbox) When enabled:
ProPack’s ship confirmation is treated as the final shipment.
All wave lines are closed.
Remaining quantities (if any) are unallocated and not expected to ship later.
Filter Options
You can define additional filters for order export via:
Filter Name – e.g., Ship to Country, Order Date, Order Tags, Ship Service, Order Type.
Operator – Contains, Does Not Contain, Equals, Greater Than, Less Than, etc.
Value – Keyword / date / numeric value.
Filters help you refine which orders are pushed to ProPack (for example, only orders with a specific tag or country).
Currency Code
Sets the currency code for export (e.g., USD, CAD, EUR).
Exchange Rate
Defines the exchange rate used for conversions when needed.
Default SKU
Fallback SKU used when a ProPack ship confirmation line does not include a SKU. This prevents failures due to incomplete SKU references.
3.2 Import/Export Settings
These settings control scheduling and notifications.
Time Zone
Select the operational time zone for the ProPack integration. All schedules align with this time zone.
Enable Auto Import/Export
(Checkbox) Enables automated import/export between XoroERP and ProPack.
Once checked, you can choose:
Recurring – run at regular intervals.
Once per Day – run once daily at a specified time.
Integration Start Date
Date from which the auto-scheduler becomes active.
Hour / Min
Time of day for the first and subsequent runs.
Auto Import Start Time Offset
Negative offset in minutes applied to the scheduled time to fetch data slightly earlier.
3.3 Email Notifications & Log Filters
Receive Import Error Notifications by Email(Checkbox)
Sends instant error notifications by email when imports fail.
Instant Error Email(s)
Enter one or more email addresses, separated by commas.
Send Daily Error Email(Checkbox)
Sends a daily summary of integration errors.
Daily Error Email(s)
Enter comma-separated recipient addresses.
Exclude Logs
Comma-separated keywords that define which logs should be excluded from emails.
Supports * wildcard for partial matching (e.g., *info*).
4. Operations Page (ProPack)
The Operations page is where you monitor and manage day-to-day ProPack integration. It includes four tabs:
Orders
Ship Confirmations
SKU
Logs
The overall behavior is similar to ReadyShipper, but field labels and filters are specific to ProPack.
4.1 Orders Tab
Use the Orders tab to push orders from XoroERP to ProPack and monitor their export status.
Purpose
Export eligible orders to ProPack for fulfillment.
Track whether orders exported successfully or encountered errors.
Re-run or reprocess problematic records.
Key Actions
Run Triggers export of selected orders from XoroERP to ProPack based on your configuration and filters.
Mark as Resolved Marks the selected records as resolved/handled in XoroERP. Useful after you verify that an export issue or warning has been addressed.
Mark as Unresolved Reopens previously resolved records so they can be reviewed or reprocessed again.
Search / Filter Fields
Order # – Search by order number.
Keyword – Search by keyword (may include customer name, tag, or reference text).
You also have global filters like:
Hide Resolved – Hide all records marked as resolved to focus on active or pending ones.
Show Errors Only – Display only records that have errors or warnings.
Information Displayed
Typically includes:
Order # – XoroERP order reference.
Last Execution Date – Date/time of the last export attempt.
Message – Status or error message from the export attempt (e.g., success, missing SKU, invalid ship method).
Use Show Errors Only to quickly locate failed exports, correct the issue (like a missing SKU or a blocked method), and run them again using Run.
4.2 Ship Confirmations Tab
Use the Ship Confirmations tab to receive and review shipment data returned from ProPack.
Purpose
Import shipment confirmations from ProPack back into XoroERP.
Update shipment status and quantities for exported orders.
Review and troubleshoot shipment-related errors.
Key Actions
Run Fetches and processes shipment confirmations from ProPack.
Mark as Resolved Marks selected shipment records as handled after validation.
Mark as Unresolved Reopens records for further investigation or reprocessing.
Search / Filter Fields
Ship Confirmation # – Search by ProPack shipment reference.
Keyword – Search based on a keyword (could be order ref, customer, or comment text).
Global filters may include:
Hide Resolved – Exclude resolved confirmations from the grid.
Show Errors Only – Focus only on failed or problematic confirmations.
Information Displayed
Ship Confirmation # – Unique shipment identifier from ProPack.
Last Execution Date – When the confirmation was last processed.
Message – Status, errors, or additional notes related to the confirmation.
Once confirmations are processed successfully, shipment data in XoroERP (quantities, tracking, status) is updated accordingly.
4.3 SKU Tab
The SKU tab manages product synchronization between XoroERP and ProPack.
Purpose
Push new SKUs created in XoroERP to ProPack.
Update existing SKUs (e.g., description, UOM) in ProPack when changed in XoroERP.
Monitor SKU sync errors and reprocess them if needed.
Key Actions
Run Pushes or updates SKUs in ProPack.
Mark as Resolved Marks SKU records as handled, typically after a successful retry or fix.
Mark as Unresolved Reopens SKU records for investigation.
Search / Filter Fields
SKU # – Search by item number.
Keyword – Search by generic keyword (description, tag, etc.).
Information Displayed
SKU # – The product code from XoroERP.
Last Execution Date – Last sync attempt for this SKU.
Message – Status or error message (e.g., product created, updated, invalid data).
ProPack supports SKU creation and updates driven from XoroERP, so SKU tab is critical to keep item data aligned.
4.4 Logs Tab
The Logs tab gives you a consolidated view of all integration activity and is your main troubleshooting tool.
Purpose
Monitor export/import runs for Orders, Ship Confirmations, SKUs.
View detailed success/failure messages.
Filter down to only errors for quick debugging.
Search / Filter Columns
Common columns include:
Export Date / Import Date – When the job ran.
Type – Entity type (Order, Ship Confirmation, SKU, etc.).
Keyword – Allows free-text search.
Order Ref # – Order reference (if applicable).
Additional filters:
Hide Resolved Exports – Only show records that are still pending/unresolved.
Show Errors Only – Focus strictly on failed or error entries.
Information Displayed
Import Date / Export Date
Start Date / End Date
Entity Type
Resolved (Yes/No)
Type – Direction (Import/Export) or entity subtype.
Message / Details – Status and error details.
You can use the Exclude Logs setting in configuration to prevent certain log messages from appearing in email notifications.
Last updated
Was this helpful?