Retail & ecommerceBuilt app template

Ecommerce returns management app template

An ecommerce returns app for operations teams. Create returns, inspect items, approve or reject the request, and close it with an external refund reference.

»Built by ToolJet·Reviewed September 14, 2026·Change the design, branding, and features with AI

Return desk · Dashboard screenshot

Return desk ecommerce returns management dashboard. A lavender returns workspace with a selected-case summary above the action queue, clear requested and approved values, and an inspection workspace.

Actual app · Sample data

AT A GLANCE

What is the ecommerce returns management app template?

Return desk follows a return from Draft through submission, inspection, approval, and closure. Each item has a requested quantity and value, inspection condition, disposition, and approved refund quantity. The app enforces a 30-day interval between purchase and receipt before submission. Closing an approved return requires a reference to a refund recorded elsewhere; no payment is executed. The built pilot uses ToolJet Database and fictional records. Choose Deploy to ToolJet to start on Cloud, or download the application package for self-hosting. Follow the included README to import the app and load its fictional sample data.

Screens: 4 connected pages
Data source: ToolJet Database
Language: English
Appearance: Light + dark

Built for Retail and ecommerce operations teams recording return inspections and manual refund decisions.

THE WORKFLOW

Returns processing from start to finish.

An ecommerce returns app for operations teams. Create returns, inspect items, approve or reject the request, and close it with an external refund reference.

Overview
Find the next return to inspect
Review open requested value, inspection and decision counts, oldest cases, and return reasons.
Returns
Create an intake and its items
Record order reference, customer, purchase and received dates, and return reason. Add or edit returned items in Draft before submitting.
Return
Inspect every item
Record condition, disposition, approved refund units, and a note for each item. Advance only after the inspection is complete.
Decisions
Record the outcome
Approve or reject inspected work, then close an approved return with a refund reference and note. The app stores the outcome without executing a refund.

INSIDE THE TEMPLATE

What’s included in the ecommerce returns management template?

A clear inspection and decision queue

Review the oldest submitted or inspected returns, requested return value, and reasons items came back.

Return intake with item details

Create a unique return reference linked to an order and customer, then add SKU, item name, quantity, and unit value in Draft.

Item-level inspection and refund quantities

Record condition, disposition, approved quantity, and inspection notes. Approved quantities cannot exceed returned quantities, and every item must be inspected before the case advances.

Approval, rejection, and recorded closure

Approve a positive refund value or reject the return with a note. Close approved work with an external refund reference; reopen rejected or cancelled work to Draft when review must restart.

ToolJet Database with sample data

The pilot uses 1 table with fictional records. No external database is needed to explore the source app.

Data included in the returns processing pilot
Table	Sample data	What it stores
Returns	5 sample returns	Order and customer references, dates, reason, item-level inspection, refund decision, and history. Includes five sample items.

Where this template stops

The pilot uses a fixed 30-day intake rule and USD item values. It does not verify purchases against an order system, issue labels, arrange shipping, update stock, execute refunds, or send notifications. Approval requires a positive approved item value. Reopening to Draft clears the current inspection fields while retaining decision history. This English desktop pilot reads up to 1,000 rows per table; larger datasets need pagination. Access policies, package export, and clean installation remain unverified.

YOUR DESIGN. YOUR BRAND. YOUR WORKFLOW.

Make it yours with AI.

This design is a starting point. Describe the look you want, add your logo and brand colors, or ask for new features in a prompt. Use the starter prompt to build your own version in the ToolJet AI builder, or use a suggested prompt to modify an app you already have. Review and test the result.

Start with an idea

Starter prompt

Build an ecommerce returns management app called Return desk with Overview, Returns, Return, and Decisions pages. Use a clear operational design with a strong inspection-to-decision flow and distinct requested versus approved values.

Create a unique return reference with order reference, customer, purchase date, received date, reason, items, status, refund reference, and history. Dates must be ordered and received date must not be in the future. Add and edit unique SKU lines in Draft with positive quantities and unit values. Submission requires items and no more than 30 days between purchase and receipt.

In Submitted, inspect each item with condition, disposition, approved quantity from zero to returned quantity, and notes. Require every item inspected before Inspected. Approve only a positive approved value, or reject with a reason. Close Approved only with an external refund reference and note. Allow cancellation from Draft and reopening rejected or cancelled cases to Draft, resetting inspection fields while preserving history. Make clear that stock and payments are not changed outside the app.

Use ToolJet Database and fictional sample records. Include coherent light and dark appearances, native tables and forms, clear validation, loading and empty states, duplicate-submit protection, stale-edit handling, successful refreshes, and preserved drafts after errors. Use custom HTML for read-only context where useful. Let me adapt the logo, colors, typography, layout, fields, language, and workflow with follow-up prompts. Test the complete workflow after changes; do not imply external integrations, message delivery, or access policies unless implemented and verified.

Design direction: A lavender returns workspace with a selected-case summary above the action queue, clear requested and approved values, and an inspection workspace. Use theme tokens for coherent light and dark appearances. Treat this as a starting point: adapt the palette, typography, navigation, and layout to the team’s brand and workflow. Preserve readable contrast, clear actions, and working data bindings after customization.

Edit this prompt before copying.

Suggested prompts describe changes you can request. Additional features and translations still need to be built and tested.

FROM TEMPLATE TO YOUR TOOL

How to use this template.

Add it to your workspace
Choose ToolJet Cloud, or download the application package to import into your self-hosted instance. Unzip the download, import its application JSON, then follow its README to load the fictional sample data.
Start with the included database
Explore the sample records in ToolJet Database, then add your records and configure the workflow for your team.
Make it work your way
Describe your preferred design, branding, and new features in the AI builder. Test your workflow, then share your app with the people who need it.

New to ToolJet? Explore the getting-started documentation

Frequently asked questions

What does the returns template include?

Return desk includes intake, item details, inspection, approval or rejection, and closure using an external refund reference across four pages.

What return window does it use?

The pilot blocks submission when more than 30 days separate purchase and receipt. It uses dates entered by the coordinator; it does not verify a purchase against a live order system.

Does approving a return issue a refund?

No. Approval records a decision and approved item value. Process the refund through your normal payment system, then record its reference when closing the return.

What happens when a return is reopened?

A rejected or cancelled return can return to Draft. Its current inspection fields reset so items can be reviewed again; the decision history remains.

Can I change the design, branding, or features with AI?

Yes. Use the starter prompt or ask the ToolJet AI builder to adapt Return desk with your logo, colors, preferred layout, fields, and workflow. Suggested prompts describe extensions to build and test.

Which database and languages are included?

The pilot uses ToolJet Database and fictional sample data. It is in English with light and dark appearances. Other languages and right-to-left layouts need implementation and testing.

Can I deploy or download Return desk?

Choose Deploy to ToolJet to start on Cloud, or download the application package for self-hosting. Follow the included README to import the app and load its fictional sample data.

KEEP EXPLORING

Explore related app templates.

View all templates

APP PREVIEW

Order fulfillment

Order management

Keep orders moving from the first line item to delivery. Coordinate picking, packing, dispatch, and the final handover.

Multi-stepEnglish

APP PREVIEW

After-sales service

Warranty claims management

Receive product warranty claims, review coverage and proof, coordinate repair or replacement, and retain the decision history.