Ready Shipper
1. Overview
The ReadyShipper Integration in XoroERP connects your order management and fulfillment workflows with ReadyShipper, a shipping and label-generation tool.
Using this integration, XoroERP can:
Export eligible orders from selected stores to ReadyShipper.
Apply weight and dimension units compatible with ReadyShipper.
Control which orders, ship methods, SKUs, and customers participate in the export flow.
Use mapped carrier and ship services to avoid failures during shipping.
Align transaction dates using the ship date from ReadyShipper.
Automate import/export runs and receive detailed error notifications.
Overall, the integration is designed to streamline shipping operations, reduce manual data handling, and provide clear operational visibility through the Operations Page in XoroERP.
2. Installation
2.1 Access ReadyShipper Integration
Log in to your XoroERP account.
Navigate to the Apps module from the main dashboard.
Go to the 3PL Connections or Integrations section.
Click Add 3PL Connection.
Select ReadyShipper from the list of available integrations.
2.2 Install the Integration
Click Install to add the ReadyShipper integration to your XoroERP instance.
Once installed, the ReadyShipper integration will appear in your list of active 3PL or shipping integrations.
3. Workflow
ReadyShipper 3PL Integration with XoroERP
The ReadyShipper 3PL integration automates the complete order fulfillment lifecycle between XoroERP and ReadyShipper, ensuring seamless execution and real-time synchronization.
Step 1: Wave Creation in XoroERP
Orders are created and grouped into waves within XoroERP based on allocation rules, warehouse logic, and fulfillment criteria. Each wave represents a consolidated batch of orders ready to be processed through ReadyShipper.
Step 2: Automatic Order Export to ReadyShipper
Once a wave is released, eligible orders are automatically exported to ReadyShipper. Order details, shipping information, and item data are transmitted for fulfillment processing.
Step 3: Fulfillment Processing in ReadyShipper
ReadyShipper executes the fulfillment operations, including:
Order processing
Pick, pack, and ship activities
Carrier and service selection
All fulfillment actions are performed at the ReadyShipper warehouse.
Step 4: Shipment Confirmation & Tracking Sync
After shipment completion, ReadyShipper sends shipment confirmation and tracking details back to XoroERP automatically. XoroERP updates:
Order status
Tracking numbers
Shipment completion details
Associated orders and waves are marked as fulfilled and closed.
Step 5: Invoice Generation in XoroERP
Upon successful shipment confirmation, invoices are automatically generated in XoroERP based on the fulfilled orders. This ensures accurate billing and financial reconciliation without manual intervention.
4. Configuration Settings
Data Export Settings
The following accounts and configuration will be used in XoroERP for the ReadyShipper integration. These settings can be modified later as needed.
Export Orders to ReadyShipper
Export orders to ReadyShipper (Checkbox) When this option is enabled, eligible orders from XoroERP will be exported to ReadyShipper.
Only orders created in the selected store(s) will be considered.
Export behavior is also influenced by ship method, blocked SKUs, allowed customers, filters, and other settings defined below.
Drop Order(s) from the Following Store(s)
Drop order(s) from the following store(s) Select one or more XoroERP stores from which orders should be exported to ReadyShipper.
Only orders belonging to the selected stores will be dropped to ReadyShipper.
Orders from non-selected stores will not be included in the ReadyShipper export flow.
This gives you store-level control over which orders participate in the integration.
Block Waves Created via QuickShip
Block waves created via QuickShip in Xoro from flowing into ReadyShipper (Checkbox)
Block Waves Created via QuickShip in Xoro from Flowing into ReadyShipper
Checkbox
Controls whether waves created using QuickShip in XoroERP are eligible for export to ReadyShipper.When enabled, waves created through QuickShip are blocked from export to ReadyShipper. This is useful for internal testing, local shipments, or scenarios that should not go through ReadyShipper’s processing. When disabled, QuickShip-created waves are treated like any other eligible waves and can be exported to ReadyShipper based on other configuration rules.
Weight & Dimension Configuration
Third Party Weight UOM Code
Dropdown
Defines the weight unit of measure (UOM) used when exporting orders from XoroERP to ReadyShipper. Available options include pounds, grams, and ounces. The selected UOM ensures that all weight values sent to ReadyShipper are consistent and correctly interpreted for shipping label generation and rate calculations, preventing discrepancies caused by unit mismatches.
Third Party Dimension UOM Code
Dropdown
Defines the dimension unit of measure (UOM) used when exporting orders from XoroERP to ReadyShipper. The selected UOM (such as inches, centimeters, or any configured unit) is applied to package length, width, and height values. This ensures dimensional data is interpreted correctly by ReadyShipper for packing, rating, and label generation.
Export Restrictions & Shipment Handling Settings
Ship Method Name(s)
Text Field
Specifies the shipping methods that should be excluded from export to ReadyShipper. Any order using a listed ship method will not be dropped to ReadyShipper, even if it meets other criteria such as store or customer filters.This is commonly used to exclude methods like local pickup, in-store delivery, or carrier/service combinations that should be handled outside ReadyShipper.
Blocked SKU(s)
Text Field
Defines item numbers (SKUs) that should be excluded from the ReadyShipper workflow. Any order containing a listed SKU will not be dropped to ReadyShipper, or the SKU will be omitted from fulfillment processing based on integration behavior.This is typically used to block non-physical items, charges, or SKUs not intended for shipment through ReadyShipper.
Allowed Customer(s)
Text Field
Restricts the ReadyShipper integration to specific customers only. Only orders belonging to the listed customers are exported to ReadyShipper. If left blank, orders for all customers are eligible, subject to other filters and configuration rules.
Disable Multishipment
Checkbox
Controls how shipment confirmations received from ReadyShipper affect wave lines in XoroERP.When enabled, the first ship 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 full order quantity has been shipped. This setting determines whether partial shipments are permitted or whether the first confirmation finalizes the order.
Filter Name / Operator / Value
Configuration
Allows you to define one or more filters that control which orders are exported to ReadyShipper.Filter Name specifies the order attribute to filter on (for example, source, order tag, ship-to country, or other supported fields).Operator defines the logical condition applied (such as Contains, Equals, Starts With, Greater Than, etc.).Value specifies the keyword, text, date, or numeric value used for comparison.By configuring filters, you can precisely control the subset of orders that flow into ReadyShipper based on your business rules.
Default SKU
Text Field
Defines a fallback SKU used during fulfillment when no SKU is provided or when an item identifier cannot be recognized for an order line. If ReadyShipper or intermediary data does not include an item identifier, this default SKU is applied, preventing order processing errors caused by missing SKU values.
Shipping Cost Markup Settings
Shipping Markup
Text Field
Specifies a percentage-based markup applied to the shipping cost received from ReadyShipper. The value entered represents the percentage increase applied to the shipping charge (for example, entering 10 applies a 10% markup). This can be used to recover handling costs, packaging expenses, or other shipping-related overhead.
Shipping Markup Order Type
Text Field
Defines which order types the shipping markup applies to. If one or more order types are specified, the markup is applied only to those orders. If left blank, the shipping markup applies to all orders processed through ReadyShipper. This provides fine-grained control over shipping-related charges.
Ship Service Mapping
Ship Service Name
Text Field
Defines the ship service as configured in XoroERP (for example, FedEx Ground). This value represents the internal shipping service used during order processing.
Third Party Ship Service Name
Text Field
Defines the corresponding ship service name or code used in ReadyShipper. Together with the Ship Service Name, this mapping ensures the correct service is used during label generation and prevents mismatches between XoroERP and ReadyShipper ship service definitions.
Use Ship Date as Transaction Date
Use Ship Date as Transaction Date
Checkbox
When enabled, the ship date received from ReadyShipper (or determined during shipping) is used as the transaction date in XoroERP. This helps align accounting, reporting, and operational logs with the actual shipment date instead of the order creation date or system processing date.
Import/Export Settings
You can schedule data import/export for ReadyShipper and configure email notifications for errors and logs.
Time Zone
Time Zone
Dropdown
Defines the time zone used to schedule all ReadyShipper-related import and export jobs. All automated tasks—such as recurring exports, imports, and synchronization processes—run according to this selected time zone, ensuring consistent execution timing.
Enable Auto Import/Export
Enable Auto Import / Export
Checkbox
When enabled, XoroERP automatically runs ReadyShipper import and export processes based on the configured schedule. You can choose to run jobs on a recurring basis or once per day. Enabling this option reveals additional scheduling fields.When disabled, all ReadyShipper-related import and export tasks must be triggered manually from the Operations interface.
Integration Start Date
Date Field
Specifies the date from which automated ReadyShipper jobs begin running. Any transactions prior to this date are excluded from scheduled processing.
Hour
Numeric Field
Defines the hour of the day at which the scheduled job should start or repeat, based on the selected scheduling mode.
Min
Numeric Field
Defines the minute offset at which the scheduled job should start or repeat, allowing precise control over execution timing.
Auto Import Start Time Offset
Numeric Field
Applies a negative minute offset to the scheduled start time, allowing the system to begin fetching or processing data slightly earlier than the defined interval when required.
Receive Import Error Notifications by Email
Receive Import Error Notifications by Email
Checkbox
When enabled, XoroERP sends immediate email alerts for any import errors related to the ReadyShipper integration. Enabling this option reveals the Instant Error Email(s) field, allowing teams to respond quickly to failures.
Instant Error Email(s)
Text Field
Specifies the email address(es) that should receive instant error notifications. Enter one or more email addresses separated by commas (,).
Send Daily Error Email
Send Daily Error Email
Checkbox
When enabled, XoroERP sends a once-per-day summary email containing error information related to ReadyShipper import and export activities. The daily summary respects the Exclude Logs configuration, ensuring only relevant error categories are included.
Exclude Logs
Text Field
Allows excluding specific log entries from both instant and daily email notifications. Enter comma-separated keywords, and use the asterisk (*) as a wildcard for partial matches (for example, *inventory*). This helps reduce notification noise by filtering out known or non-critical log patterns.
5. Operations Page
The ReadyShipper Operations Page in XoroERP provides a centralized control panel to monitor and manage all data flows between XoroERP and ReadyShipper. It enables you to:
Manually trigger exports.
Monitor order-level and batch-level status.
Review and resolve errors.
Inspect detailed logs for troubleshooting.
4.1 Accessing the Operations Page
In XoroERP, go to the Apps module.
Open 3PL Connections or the list of integrations.
Select the ReadyShipper integration.
Click on Operations to open the ReadyShipper Operations Page.
4.2 Header Options
At the top of the Operations Page, you have access to key actions for managing the ReadyShipper integration:
Add Account Add a new ReadyShipper account to your XoroERP instance. This allows multiple accounts for different stores, regions, or environments.
Change Account Switch between multiple ReadyShipper accounts or update credentials for an existing account.
Remove Account Disconnect a ReadyShipper account from XoroERP. All associated data exports will cease until another account is selected.
Settings Opens the configuration panel where you can adjust Data Export Settings and Import/Export Settings, including stores, filters, ship methods, email notifications, and scheduling.
These header options allow you to move between account-level configuration and operational monitoring without leaving the integration context.
4.3 Sync Xoro Data to ReadyShipper
This section controls how and when orders are synchronized from XoroERP to ReadyShipper.
Typical components include:
Run / Execute Export Manually initiates export of eligible orders to ReadyShipper, based on the current configuration:
Only orders from selected stores.
Excluding blocked ship methods and blocked SKUs.
Restricted by allowed customer(s) and filter rules.
Date Range or Filter Inputs (if available) Allows focusing the export on a specific period, such as:
Orders created between selected dates.
Orders matching certain criteria (e.g., specific tags, sources, or references).
This section is particularly useful when:
Running a first-time export after enabling the integration.
Reprocessing orders after modifying configuration.
Handling backlogged orders that were not previously exported.
4.4 Orders
The Orders (or Export Queue) tab provides detailed visibility into each order being processed through ReadyShipper:
Typical columns and actions may include:
Order # / Reference The unique order identifier from XoroERP.
Last Execution Date The timestamp of the last export attempt for that order.
Status / Message Shows whether the export succeeded, failed, or is pending, including error messages or notes where applicable.
Actions:
Run Manually attempts export for selected orders. Useful if an order previously failed due to configuration or connectivity issues and needs to be reprocessed.
Mark as Resolved Marks successful or already handled records as resolved, removing them from the active error/pending view.
Mark as Unresolved Reopens records that need further attention or reprocessing.
Filters:
Hide Resolved Hides resolved entries so you can focus only on pending or problematic orders.
Show Errors Only Limits the view to orders that encountered errors during export, simplifying troubleshooting.
This tab is the main operational workspace for ensuring that all orders intended for ReadyShipper are successfully exported.
4.5 Ship Confirmations
If ReadyShipper sends ship confirmations back to XoroERP, the corresponding tab (e.g., Ship Confirmations) allows monitoring and controlling how shipment updates are processed:
Ship Confirmation # / Reference The external reference for the shipment.
Last Execution Date The last time the confirmation was processed.
Message Shows success or error messages from processing the confirmation.
The behavior of this area is influenced by:
Disable multishipment (Checkbox)
If enabled: The first confirmation is treated as final; all wave lines are closed, and unshipped quantities are unallocated.
If disabled: Multiple confirmations can be processed until quantities are fully shipped.
This section ensures alignment between ReadyShipper shipments and XoroERP order status.
4.6 Logs Tab
The Logs tab provides an audit trail of all integration activities between XoroERP and ReadyShipper, including:
Export attempts.
Any import processes, if applicable.
Scheduling triggers and actions.
Errors and warnings.
Typical columns:
Export/Import Date When the integration process ran.
Type Indicates the process type, such as order export, ship confirmation handling, etc.
Keyword / Reference Often shows order numbers, shipment numbers, or other identifiers.
Message Displays the status or error message for each operation.
The log contents align with your email notification settings:
Receive import error notifications by email
Instant error emails are sent based on Instant Error Email(s).
Exclude Logs lets you filter out less relevant logs from notifications.
Send daily error email
Sends a summary of all integration errors, consolidated on a daily basis.
The Logs tab is your primary source for diagnosing issues, verifying that scheduled jobs are running, and confirming that ReadyShipper-related operations are behaving as expected.
Last updated
Was this helpful?