xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsLoyaltyContract ManagementInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementPeople (HRMS)Learning ManagementCommercePortalsPartner Relationship ManagementAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Service/Claim part returns — sending failed parts back to the manufacturer
HOW-TO · Last reviewed

Claim part returns — sending failed parts back to the manufacturer

A claim part return is how the failed parts behind a warranty or damage claim travel back to the manufacturer (OEM), or to a quality lab, so the OEM can inspect them before deciding the claim. xMatix works out which parts go back from return rules. It raises a return order for them, tags each part and creates the delivery challan from the claim itself. The claim's Return Status and Stage show how far the parts have got. The return comes after the claim is submitted (or approved, depending on the setup) and before the OEM decides. See Service claims for the claim around it.

Overview

A Claim return setup for a claim type turns returns on for that type. Claim return rules decide, line by line, whether each part goes back and where. When the claim reaches the right status, xMatix raises an inventory fulfilment for the parts that go back. The dealer then uses the claim's Part return tab and Create return challan to ship them by courier, OEM pick-up or own vehicle. Warehouses that ship many claims on one vehicle can use consignments, cartons and loads instead (see Fulfilment and picking).

When to use it

  • The OEM requires failed warranty parts back before it approves the claim.
  • Some parts go to a quality lab instead of the OEM.
  • Cheap parts are scrapped at the dealer, with a photo as evidence.
  • Good stock (excess or wrong supply) goes back against a claim.

How xMatix handles it

Which parts go back

Each claim line gets a Part return value from the first claim return rule whose condition holds:

Part returnWhat happens to the part
Always returnGoes on the return.
Return to quality labGoes on the return, to the rule's Return to account.
OEM pick-upGoes on the return. The OEM collects it.
Scrap with photoStays at the dealer. The line needs a photo before the claim is submitted.
Not requiredStays at the dealer.

Only lines for items that track inventory are shipped; labour and charges never are. If no rule matches, the line gets the setup's default: Always return when the setup ships parts, and Not required when it does not. Lines are stamped when they are added and whenever their item, quantity or price changes while the claim is undecided. A decided claim's lines keep their value. The line's Why column shows the rule that decided it (blank when the default applied).

Only active rules of the claim's SLA policy version are read: the version stamped on the claim, or else the version in force on the claim's date. A rule in another version never applies to the claim.

A line whose rule names a Return to account gets its own return order for that destination. All other parts go to the claim's Supplier Account. A claim can therefore have one return per destination. When all its parts go to one place, the claim's Return to shows it; with several destinations it stays blank. Freight paid by works the same way: it shows on the claim only when every rule behind the shipped parts agrees.

A line whose return quantity is zero is not shipped. For an After approval type that means a line approved with quantity 0 (fully rejected) stays at the dealer.

When the return is raised

The setup's Ship When decides:

  • Before approval: when the claim reaches Pending Approval. The OEM decides after receiving the parts. The claimed quantity is shipped.
  • After approval: when the claim is Approved. The approved quantity is shipped.
  • Not required: never.

A setup with Ship When left blank behaves as Before approval.

You can also raise it, or add lines added since, with Create return fulfilment in the claim header. Unlike the automatic route, this button explains why it cannot run: the claim type has no active setup, the setup's Ship When is Not required, or the type ships after approval and the claim is not yet Approved. Raising it again adds only the lines that are not on the return yet.

Each part's bin and lot come from the goods receipt line the claim line points to. When the claim line has none, the setup's Return Storage Location is used.

Return Status

Return Status sits next to Status on the claim's Details tab. It moves from Ready to ship (return raised) through Partially shipped and Shipped to OEM received (every dispatched challan acknowledged and nothing left to ship). It is blank until a return is raised. The return never changes the claim's approval Status. On a claim that ships before approval, Stage shows Part return while the parts are on their way and OEM review once the OEM has them.

Prerequisites

  • The claim type has an active Claim return setup (one per type).
  • The claim has a Supplier Account, unless every part stays at the dealer.
  • With Post Inventory on, the parts are in the Damaged stock of the return bin. A part taken off a vehicle has no goods receipt, so record an adjustment of type Damaged into the setup's Return Storage Location first.

Procedure

Step 1 — Print part tags

On the submitted claim (or approved claim, for After approval types), press Print part tags. You get one row per claim line with the tag number (claim number / two-digit sequence), the part, the failure code and its Part return value. Tie each tag to its part. A tag is stamped once and never renumbered. Lines with no tag stay at the dealer or are labour.

Step 2 — Complete the Part return tab

Open the claim's Part return tab. It shows:

  • Return to, Dispatch by and Must reach by (the SLA deadlines for dispatch and for OEM receipt), and Freight paid by;
  • the Before dispatch checklist: answer it and press Save;
  • Parts: every line with its tag and Part return. On a Scrap with photo line, use Add photo to attach an image of the failed part. The file must be an image; an archived or deleted file does not count;
  • Return challans and the return's fulfilment orders.

Step 3 — Pick the parts (pick modes only)

If the setup's Fulfilment Mode is Pick & ship or Pick, pack & ship, open the return fulfilment and confirm Picking. Damaged stock is picked straight from the order lines, and Available stock is allocated first. Ship only needs no picking. In the pick modes, the challan carries only what has been picked and confirmed.

Step 4 — Create the return challan

Press Create return challan in the header and fill in the dialog:

  • Courier: OEM prepaid courier, OEM pick-up, Own vehicle or Other courier. Other courier also needs the courier company.
  • Docket no.: required, at least four characters, for OEM prepaid courier and Other courier. Not asked for OEM pick-up or own vehicle. The docket is dated with your organisation's today.
  • Boxes (at least 1 when entered) and Declared value (not negative). A blank declared value uses the parts' value.
  • Tick Part is tagged, sealed in its original box and photographed.

Press Create challan and mark dispatched. The challan is created and dispatched at once, without a load, and Return Status becomes Shipped (or Partially shipped if part of the return is still waiting). That closes the part-dispatch window. With Post Inventory on, the parts move out of stock into Outward at the bin. With Pick, pack & ship, any unpacked challan lines are packed into one new carton for you. If a draft challan already exists for the return, it is reused, and anything consigned since is added to it. If the claim has parts for more than one destination, the dialog asks for Return to. Create one challan per destination.

Step 5 — Print the challan and record OEM receipt

Open the challan from Return challans and press Print challan for the delivery challan, in three copies: consignee, transporter and consignor. When the OEM confirms receipt, enter its reference in OEM Reference Number on the challan and press OEM received. The button shows only on a dispatched challan. The Received date is today unless you entered a date first. Once every challan is acknowledged, Return Status becomes OEM received, and any SLA window that counts from OEM receipt (typically the OEM's decision window) starts.

Fields

Claim return setup

FieldWhat it meansNotes
Claim TypeThe claim type this setup servesRequired. One active setup per type.
Ship WhenWhen the return is raisedBefore approval, After approval, Not required. Blank behaves as Before approval.
Fulfilment ModeHow the parts leavePick & ship (default), Pick, pack & ship (every challan line must be in a carton; Create return challan packs them for you), Ship only (no picking; Damaged stock only).
Before-dispatch checklistChecklist answered before the challanMandatory lines must be answered. Blank means no checklist.
Source BucketWhich stock the parts come fromDamaged stock (no allocation) or Available stock (allocated first).
Post InventoryWhether picking and dispatch move stockMust be on for Available stock. Each fulfilment keeps the setting it was raised with.
Return Storage LocationBin the parts leave from when the claim line has no goods receipt lineRequired for Ship only.

Claim return rule

FieldWhat it meansNotes
Claim return setup / Policy versionThe setup and SLA policy version the rule belongs toRules of a published version are locked.
OrderEvaluation orderChecked in ascending order. The first rule that holds wins.
ConditionWhen the rule appliesA formula over the line and its item, for example LineAmount < 500 or Item.InGroup("Batteries"). Blank means always. See the list of names below.
Part returnWhat happens to the partRequired. See the table above.
Return toWhere the part goesBlank means the claim's Supplier Account.
Freight paid byWho pays the freightPaid by OEM or Paid by dealer. Shown on the Part return tab.
Keep at dealer if not called (days)How long a kept part is heldA guide only. Nothing enforces it.
Evidence requiredWhat evidence the part needsShown on the rule.

Names a condition can use. LineAmount (the line's claim amount, or unit price × quantity when it has none), UnitPrice, Quantity, ClaimTotal, ClaimType, ItemCode, ItemName, ItemType, and the line's item as Item.Code, Item.Name, Item.Type, Item.IsActive, Item.Family, Item.Segment, Item.Make, Item.TrackInventory, Item.TrackLots and Item.InGroup("group name"). InGroup matches a group's name or label in any case, and only for groups the item is listed in as a member; rule-based item groups are not resolved. The condition is checked when you save the rule, and a condition that does not evaluate is refused.

Business rules

  • A claim type with no active return setup has no part return. Part return is blank, and no fulfilment is raised.
  • A claim of a type with a return setup no longer gets the old approved-part / rejected-part delivery orders.
  • When a line's Part return changes while the claim is undecided, a part that now stays has its unshipped quantity cancelled on the return. A part that now goes back joins the return if the claim is already at its ship status.
  • A scrapped part (Scrap with photo or Not required) stays in the dealer's Damaged stock. Nothing writes it off, so adjust it out once it is scrapped.
  • Shipped parts sit in Outward at the bin. Claim returns share the Picked and Outward buckets with sales, so read claim stock from the claim's return orders and challans.
  • The e-way bill is recorded on the challan, not generated. Generate it on the GST portal and enter the number.
  • Return Status is recalculated when the return is raised, on dispatch and on OEM received. It is not recalculated when lines or picks are cancelled later.
  • A Claim return setup refuses Ship only with Available stock (good stock must be picked), Ship only without a Return Storage Location, and Available stock with Post Inventory off.
  • Part tags are stamped only on lines that go back, numbered after the claim's highest existing tag. Dispatch by, Must reach by and the before-dispatch checklist are filled only while the claim has a part to ship.

Example

A dealer's warranty claim has three lines: a fuel pump (₹6,800), a gasket (₹120) and labour. The return rules say: order 1, LineAmount < 500 → Scrap with photo; order 2, blank condition → Always return. The gasket is stamped Scrap with photo and the pump Always return. Labour is not a stock item, so it never ships. The advisor attaches a photo of the gasket with Add photo and submits the claim. The setup ships before approval, so a return fulfilment for the pump is raised and Stage becomes Part return. The advisor prints the part tags, answers the before-dispatch checklist and presses Create return challan: OEM prepaid courier, docket 77881234, 1 box, sealed ticked. Return Status becomes Shipped. Four days later the manufacturer confirms receipt. The advisor presses OEM received on the challan, and Stage moves to OEM review.

Training

Practice exercise

In a sandbox with a return setup for a claim type (Ship When Before approval, Fulfilment Mode Ship only, Source Bucket Damaged stock, Post Inventory off), create a claim of that type with one stock-item line and a Supplier Account. Submit it. Expected result: Return Status shows Ready to ship and the Part return tab lists the fulfilment. Then press Create return challan without ticking the seal box. Expected result: it is refused with "Confirm the part is tagged, sealed in its original box and photographed." Tick it and create the challan. Expected result: Return Status becomes Shipped.

Quick reference

  • One active Claim return setup per claim type turns returns on.
  • Return rules decide each line's Part return. The first match by Order wins.
  • Only stock items ship; labour never does.
  • Scrap with photo needs a photo before submission.
  • Create return challan dispatches at once, with no load; pick modes ship only what is picked and confirmed.
  • A docket of at least four characters is needed for OEM prepaid courier and Other courier.
  • One challan per destination.
  • OEM received on the challan completes the return.
  • Return Status never changes the claim's approval Status.

Permissions

Create return fulfilment, Create return challan, Print part tags and Add photo on the claim, and Pack and OEM received on the challan, are granted to the shipped Sales Executive, Sales Manager, Standard User and System Admin profiles. Editing return setups and rules needs edit access to those records in the Claims app. A button your profile lacks is not shown.

Configuration

  1. Checklist: Setup → Checklists → New. Create a before-dispatch checklist (for example "Part photos, 4 sides with tag visible") and tick Mandatory on the lines that must be answered. See Checklists.
  2. Return setup: Claims → Settings → Claim return setups → New. Set Claim Type, Ship When, Fulfilment Mode, Before-dispatch checklist, Source Bucket, Post Inventory and Return Storage Location.
  3. Return rules: Claims → Settings → Claim return rules → New, or the Claim return rules tab of an SLA policy version. Set Order, Condition, Part return, Return to, Freight paid by and Keep at dealer days. Publish the version to put the rules in force.
  4. SLA windows: a window counting from part dispatch or OEM receipt in the claim's SLA policy fills Dispatch by and Must reach by. See Service claims.
  5. Challan template: the printed challan uses the Delivery challan (claim return) document template. Duplicate it under document templates to change the wording.

Common problems

"Set the OEM (Supplier Account) on the claim before its parts can be returned."

The return is raised against the Supplier Account. Set it on the claim and save again.

"Complete the before-dispatch checklist first: …"

A mandatory checklist line is unanswered. A yes/no line must be ticked yes. Answer it on the Part return tab, press Save and create the challan again.

"Nothing on claim … is waiting to ship: its parts are dispatched, stay at the dealer, or its return is not raised yet."

Everything has been dispatched, every part stays at the dealer, or the return has not been raised. Submit the claim, or press Create return fulfilment.

"Claim … returns parts to N destinations …: create one challan per destination (choose Return to)."

Some lines go to a quality lab or other account. Choose Return to in the dialog and create one challan for each destination.

"Nothing on claim … is waiting to ship to that destination."

You chose a Return to that has nothing left to ship. Pick the other destination, or leave Return to blank if only one destination is waiting.

"Nothing picked and confirmed on this fulfilment is left to consign. Pick the parts and Confirm Picking first."

The setup uses a pick mode and nothing new has been picked. Open the return fulfilment, pick the parts and confirm picking, then create the challan.

"Claim … : line … is scrapped at the dealer, so it needs a photo of the failed part before the claim is submitted."

A Scrap with photo line has no image attached. Open the Part return tab, use Add photo on that line with an image file, then submit again.

"Claim type … has no active Claim Return Setup …" / "… does not return parts to the OEM (Ship When: Not Required)."

Create return fulfilment was pressed on a claim whose type does not ship parts. Create or activate a setup for the type, or set its Ship When, if parts should go back.

"This claim type ships its parts after approval. Approve the claim first."

The setup's Ship When is After approval. Approve the claim; the return is then raised automatically.

"Choose how the parts travel: …" / "Boxes must be at least 1." / "The declared value cannot be negative."

Choose a Courier option in the dialog, and enter a box count of 1 or more and a declared value of zero or more (or leave it blank).

"Only a dispatched consignment can be acknowledged."

OEM received works only on a challan that has been dispatched. Dispatch it first; an acknowledged challan cannot be acknowledged again.

"Ship only returns damaged stock. …" / "Ship only needs the Return Storage Location …"

The setup is not valid. Choose Pick & ship or Pick, pack & ship for Available stock, and set the Return Storage Location for Ship only.

"Claim type … already has an active Claim Return Setup."

Only one active setup is allowed per claim type. Edit the existing one, or deactivate it first.

"Return rule …: the condition does not evaluate (…)."

The condition uses a name that does not exist or has a syntax error. The message lists the names you can use; correct the formula and save again.

"Consignment … is already on load …"

A draft challan was put on a warehouse load. Dispatch it with that load, or clear its Load field first.

"Enter the courier's docket number." / "Enter the courier company."

A courier challan needs a docket number of at least four characters. Other courier also needs the company name.

"Returning available stock reserves it in the inventory, so Post Inventory must be on."

An Available stock setup must post inventory. Turn Post Inventory on, or return Damaged stock instead.

Picking is refused for negative stock

The part is not in the bin's Damaged stock. Record an adjustment of type Damaged into the Return Storage Location, then pick again.

Common questions

Does the claim wait for the part before it can be approved?

It depends on Ship When. With Before approval, the return is raised at submission, and the OEM normally decides after it receives the parts. Stage shows Part return and then OEM review. Nothing in xMatix stops an approver approving earlier. With After approval, the parts go back only once the claim is approved, and Stage stays Approved while they travel.

Can I ship several claims on one vehicle?

Yes. Use the warehouse route instead of Create return challan: Create return consignment on each claim's fulfilment, pack cartons if needed, put the consignments on a Load and press Dispatch on the load. Return Status follows the same way. Create return challan is the short route for one claim by courier.

What happens to a part we scrap?

A Scrap with photo or Not required part stays in the dealer's Damaged stock and is never shipped. The photo on the line is the evidence for the OEM. xMatix does not write the part off by itself. Adjust it out of stock once it is physically scrapped.