Return Processing App

Simplify and accelerate the acceptance of returns in your return locations and warehouses.

Overview

parcelLab’s Return Processing app can be used as an alternative to the Return Processed API to send a custom event to parcelLab, which is used to update a return registered in your Returns Portal based on the outcome of returns that were processed in your warehouse. This event can be used to trigger subsequent events (for example: paying out a refund, sending emails to the customer).

The app can be used in your warehouses to process each return and supports integration with your Returns Portal to enable return registrations in cases when customers do not have an RMA (for example: in-store returns).

An overview of how you can integrate the app into your returns processing workflow is described below.

1

Access the app

The app can be accessed in one of the following ways:

• Standard access (API token)

  • URL: returns-receive-ui.parcellab.com with the necessary query parameters configuring the setup for the warehouse

• Single Sign-On (SSO)

  • URL: returns-receive-ui-sso.parcellab.com

When using SSO to sign in, the configuration needs to be set up manually using the Setup page in the Return Processing app. For more information about using SSO for the Return Processing app, please contact your parcelLab representative.

2

Configure settings

The app can be configured in one of the two following ways:

• Setting query parameters in the URL

• Using the app's Setup page to enter the required settings for your warehouse

3

Using the app to approve returns

The app can be used on desktop (that is: with a USB barcode scanner) or mobile (that is: to scan QR codes with a device’s camera).

Returns teams in your warehouses or retail locations can use the app to do the following:

1. Approve or reject returned items

2. Select a reason for the rejection

3. Change the returned item’s condition

4. Close the return

After the return is reviewed and closed in the app, the data is transmitted to parcelLab and used to trigger different return flows based on the acceptance or rejection of the return (for example: to issue a refund based on partial acceptance of the returned items).

The following tips are recommended for optimal app usage:

• Use Chrome or Safari for the best mobile camera performance

• Good lighting improves QR code scanning speed

• Stable internet ensures real-time updates

• Clear old photos from device storage periodically

Key Benefits

The Return Processing app supports returns acceptance workflows in your warehouses and retail locations. The app's compatibility across device types (that is: mobile, tablet and desktop) enables flexible adaptation to processing returns wherever you receive them.

Flexible Return Processing

• Accept or reject individual items or entire returns

• Partial quantity processing supports handling damaged or missing items

• Photo evidence capture for quality documentation

• Multi-package returns support for complex shipments

Smart Configuration

• One-click setup via URL parameters

• Auto-approval thresholds for efficient processing

• Custom condition options tailored to your business

• Returns Portal integration for in-store return creation

Real-Time Integration

• Instant refund processing when configured

• Live inventory updates through parcelLab's API

• Automatic tracking updates for customers

• Instant notification system for status changes

Configuring the Return Processing App

The following sections describe the configuration required to use the Return Processing app with parcelLab.

Customer Requirements

For successful configuration and enabling use of the app to process returns, the following requirements must be met:

• parcelLab account

• parcelLab Returns Portal, if using the app to process returns without an RMA.

Implementation Process

This section describes the implementation process for using the Return Processing app.

Configure Settings via URL

To set up the Return Processing app via URL, you configure your settings by adding the desired parameters to the base URL: https://returns-receive-ui.parcellab.com/

The query parameters that can be used are described in the following table.

Query Parameter	Type	Description
scanAs	String	The name or identifier of your warehouse (for example: Parkers%20Warehouse).
autoApproveAmount	Integer	Sets a maximum limit for automatic return approval (that is: returns below the set value are automatically approved). This can be disabled by setting the value to 0.
autoSubmitScanFormActive	String	Enables the automatic submission of the return evaluation after all return items for an order is scanned. This value is set to false by default.
connectionToken*	digits$hash	The token provided by parcelLab to enable a secure connection to the parcelLab system.
instantRefundActive	String	Enables instant refund when the value is true. This is currently only supported for Shopify retailers.
articleConditionOptions	String	This is a comma-separated list of values without spaces, describing a returned item’s condition. This will render a drop-down list of item conditions that can be used during the approval process.
cameraCountdownTimer	Integer	Enables a countdown timer when the device camera is activated to take photo evidence for a rejected item. This value is set to 5 (that is: a five-second countdown) by default.
returnsPortalLangCode	String	ISO-2 language code for your Returns Portal (for example: en, de)
returnsPortalCountryCode	String	ISO-2 country code for your Returns Portal (for example: us, de)

Configure Settings via the Return Processing App

To configure your settings using the Return Processing app:

1. Navigate to the Setup page: https://returns-receive-ui.parcellab.com/setup

2. In the Connection Token field, enter your connection token for the Return Processing app.

3. In the Scan as field, enter the name of your warehouse (for example: Parker’s US Warehouse).

4. To enable automatic submission of a scan form for your barcode scanner, select the Auto-submit scan form checkbox.

5. In the Auto-approve field, enter a value threshold for automatic approval of returns. Returns below the set amount will be automatically approved. You can disable the auto-approve function by setting this value to ‘0’.

6. For Shopify retailers: In the Approval triggers sync refund section, select the checkbox to enable instant refunds for returns that are processed using the app.

7. In the Article condition of received items field, enter a comma-separated list of conditions for returned items.

8. In the Camera countdown timer field, enter the number of seconds for a countdown timer. This timer will display when the camera is activated to take photo evidence for a rejected item.

9. In the Linked Returns Portal section, enter the language code and country code to connect a Returns Portal. This enables return registration if no RMA is available (for example: for returns made in store).

10. Click Save. Your settings are saved.

Using the Return Processing App

This section describes how you can use the Return Processing app.

Processing Returns

To process a return using the app:

1. Scan the return QR code or barcode or enter the return ID manually. The system will search for the return.

2. Select the return to process.

3. Process each item in the return by doing one of the following:

   1. Accept the item if condition and quantity are correct

   2. Reject the item if the item does not fulfill conditions for return (for example: if missing or damaged) and record photo evidence or note additional information for rejection

   3. For partial acceptance, specify the quantity accepted and add notes for the rejected quantities.

4. Finish processing the return by selecting the Close Return option.

Registering Returns

If integration with your Returns Portal is configured (that is: values for the Returns Portal’s country code and language code are set in the URL or configured for your SSO access), a Register New Return option appears in the navigation, allowing staff to search for orders and create returns in your Returns Portal.

Errors and Troubleshooting

This section describes known errors and ways to troubleshoot common issues when using the Return Processing app.

“No active return found”

To troubleshoot this error:

• Verify that the return ID is correct

  • If the return ID is correct, you can try removing any symbols (for example: #).

• Check if the return has already been processed

• Ensure the return has an active status

Camera not working on mobile

To troubleshoot this error:

• If the camera fails to start, refresh the page to trigger the prompt for camera permissions.

• Grant camera permissions when prompted

• Ensure there is sufficient lighting to scan QR codes

Auto-approval not working

To troubleshoot this error:

• Check that the amount for automatic approval is set correctly

• Verify that the return is under the set threshold value

• Ensure that instant refund is enabled, if applicable to your returns process.

Configuration settings cannot be saved

To troubleshoot this error:

• Clear your browser cache and cookies, then re-configure your settings.

• Configure your settings via URL

• Contact your IT administrator for a new setup link