Skip to main content

​
What is Brightpearl?

Brightpearl is a retail operations platform and ERP system designed for multi-channel retailers and wholesalers. It provides comprehensive order management, inventory control, warehouse management, purchasing, and financial management capabilities in a single platform. Primary Purpose: Brightpearl delivers complete retail operations management for growing brands, handling everything from order processing and inventory tracking to accounting and reporting. Built for omnichannel retail, Brightpearl helps businesses scale their operations across multiple sales channels while maintaining accurate financial records.

​
What Does the Integration Do?

When a customer initiates a return through Redo, the system automatically creates a Sales Credit in Brightpearl linked to the original sales order. This ensures accurate financial tracking, proper inventory management, and seamless integration with your accounting workflows. Products are mapped using SKUs, and returns are linked to the original Brightpearl sales order using the Shopify order ID. The integration validates that products exist on the original sales order, retrieves pricing and tax information from the original transaction, and creates a properly formatted sales credit with accurate amounts. Return values are calculated based on the original product prices, taxes, and any adjustments, ensuring financial accuracy. The sales credit references the parent sales order in Brightpearl, maintaining complete audit trails and enabling proper accounting reconciliation. Each product line in the return is matched to the corresponding line in the original sales order, preserving product IDs, tax codes, and pricing details.

​
How to Set It Up

Follow these steps to configure the Brightpearl integration with Redo.

​
Prerequisites

Before you begin, ensure you have:
You must have an active Brightpearl subscription with API access enabled.
Your Brightpearl account must be activated for the integration before you can connect. Contact Redo support at support@getredo.com with your Brightpearl account code to have this done.
Your sales orders must already be synced to Brightpearl (typically through your e-commerce platform integration like Shopify). Returns cannot be created for orders that don’t exist as sales orders in Brightpearl.
You need administrative access to your Redo merchant dashboard to configure integrations.
Know which field in your Brightpearl sales orders contains the Shopify order ID. Common options include:
  • customerRef (default)
  • reference
  • Custom field
This field must be populated with SO{shopify_order_id} format (e.g., SO1234567890).
Ensure product SKUs in your Brightpearl sales orders match the SKUs in Redo. The integration uses SKUs to match returned products to sales order line items.

​
Configuration Steps

1

Navigate to Integrations

  1. Log in to your Redo merchant dashboard
  2. Go to Settings > Returns & Claims > Integrations
  3. Locate the “Brightpearl” card in the list of available integrations
2

Initiate Connection

Click the Connect button on the Brightpearl integration card.
3

Enter Your Brightpearl Account Code

​
string
required
Your Brightpearl account code, all lowercase (e.g., examplebrand). This is the short identifier for your Brightpearl account, not your company’s display name, and it is the only value you need to enter.
Then click Connect via OAuth.
4

Authorize Redo in Brightpearl

You are redirected to Brightpearl. Sign in if prompted and approve the Redo app. Brightpearl redirects you back to Redo and the connection is saved automatically.
5

Test the Integration

Create a test return to verify the integration is working correctly:
  1. Initiate a test return through your Redo return portal
  2. Check the return timeline in Redo for a Brightpearl sales credit creation entry
  3. Log in to Brightpearl to verify the sales credit was created
  4. Confirm the sales credit:
    • References the correct parent sales order
    • Contains accurate products, quantities, and SKUs
    • Has correct pricing and tax calculations
    • Shows proper linkage in Brightpearl’s order hierarchy

​
How Long Does It Take?

​
Setup Timeline

​
Operational Timing

1

Sales Credit Creation

Real-time (1-3 seconds) after return is created.
2

Sales Order Lookup

Immediate - Redo searches for the original sales order in Brightpearl using the Shopify order ID to ensure it exists before creating the sales credit.
3

Product Validation

Automatic - Each returned product is validated against the original sales order to ensure SKUs match and proper pricing/tax codes are retrieved.
4

Financial Recording

Sales credits are immediately visible in Brightpearl’s sales order list and financial reports, enabling accurate accounting and reconciliation.

​
Important Considerations

Product Matching Required: All returned products must exist as line items on the original Brightpearl sales order with matching SKUs. If a product cannot be matched, the sales credit creation will fail.

​
Troubleshooting

This error occurs when Redo cannot locate the original sales order in Brightpearl.Solution:
  • Verify the order exists in Brightpearl as a sales order
  • Ensure the field in Brightpearl contains the Shopify order ID in SO{order_id} format
  • Confirm orders are syncing correctly from Shopify to Brightpearl
  • Check if there’s a delay in order sync between Shopify and Brightpearl
This error means a product being returned doesn’t exist as a line item on the original Brightpearl sales order, or the SKU doesn’t match.Solution:
  • Verify the product SKU in Redo matches the SKU in the Brightpearl sales order exactly
  • Check if the product was on the original order
  • Review SKU mapping between your e-commerce platform and Brightpearl
  • Ensure no SKU changes occurred after the order was placed
This message indicates a sales credit has already been created for this return.Solution:
  • Verify that the sales credit already exists for the cooresponding sales order in BrightPearl
  • If the sales credit is incorrect, delete it in Brightpearl and retry the sync from Redo
Your Brightpearl account has not been activated for the integration yet. This is the error you get when you complete the authorization in Brightpearl but activation is still outstanding.Solution:
  • Contact Redo support at support@getredo.com with your Brightpearl account code to have your account activated
  • Once support confirms activation is complete, retry the connection from the start
Re-entering your account code will not resolve this until activation is complete.

​
Support

For issues with the Redo integration configuration, return processing, or data synchronization, contact support@getredo.com. For issues with access, API credentials, or warehouse operations, contact your account manager or support team.