🏪SellerTroubleshooting & ErrorsRecentUpdated Jul 12, 2026·Verified against the app Jul 12, 2026

Returns Errors & Blocks

#errors#returns#refunds#sla#disputes
Troubleshooting · Returns

Returns span two workspaces — the Returns module (the customer’s request) and the Warehouse Returns workspace (the physical units). This page covers the blocks and errors in both, including the ones that are deliberate (features awaiting platform activation) so you don’t fight them.

How to read this page

Match your exact message to a card. A recurring theme here: several return actions are gated platform-side today — the card tells you which ones work now, and what to do meanwhile. Code-only lookup: error code index.

Warehouse-return decisions not enabled

FEATURE_DISABLEDTransfer to FBF / Return to me / Keep stored are blocked
What you see

Choosing any decision other than Dispose in Warehouse Returns shows the toast «هذا الإجراء غير مفعّل بعد — قريباً.» / “This action isn’t enabled yet — coming soon.”

Likely causes
  • Seller return-decisions (other than Dispose) are awaiting platform activation — the server answers with the FEATURE_DISABLED code by design.
How to fix it
  1. Dispose works today if disposal is genuinely what you want (a reason is required; success shows «تمت إضافة الإتلاف إلى قائمة المستودع.» / “Disposal queued for the warehouse team.”).
  2. Otherwise wait — your units stay safely stored and nothing is lost by waiting.
  3. Storage continues while units remain stored. The financial details of this step are covered in a dedicated Finance guide coming soon.
When to contact support

If a case is urgent (e.g. perishable or high-value stock), open a support ticket (Returns & refunds) and include the case ID from the Warehouse Returns page.

🚫Common Mistake

Do not choose Dispose just because it is the only enabled button — disposal is irreversible.

Read-only returns

Return shows a read-only banner
What you see

“This return is not managed by the seller” («هذا المرتجع لا يديره البائع») with a Read Only chip and no action buttons.

Likely causes
  • The return belongs to an FBF or MARKET order — Fawran manages the request, inspection and refund. Only FBS returns are seller-actionable.
How to fix it
  1. Nothing to action in the Returns module — this is by design.
  2. Watch the Warehouse Returns workspace instead: if the physical units end up there, the disposition decision (what happens to the goods) is where you come back in.
When to contact support

Only if you believe the return was misclassified — ticket with the return ID.

FBS return form errors

Reject note too short
What you see

“Explanation must be at least 20 characters” («الشرح يجب أن يكون على الأقل 20 حرف») when rejecting an FBS return.

Likely causes
  • A rejection is reviewed by the support team, so a substantive reason is mandatory — the note field requires at least 20 characters.
How to fix it
  1. Pick the closest rejection reason from the list.
  2. Write a factual explanation of at least 20 characters (what you inspected, why the claim does not hold).
  3. Confirm the rejection.

SLA countdowns and expiry

A return stage deadline expired
What you see

The countdown chip on an FBS return turns red and then shows expired.

Likely causes
  • Each FBS return stage has a deadline: 48 hours for the initial response, the review stage and the shipping-in-progress stage; 24 hours for the other stages.
  • The stage action was not taken in time.
How to fix it
  1. Act now — an expired timer does not remove your action buttons; the longer it stays red, the worse for your performance record and the more likely platform intervention.
  2. Prioritize returns from the warning state (yellow) before they expire — the list shows near-deadline counts.
When to contact support

If you could not act because a button errored (not because of time), report that specific error with a screenshot and the return ID.

Dispute evidence

Dispute images are not reliably saved
What you see

You attach images to a dispute (up to 5) and they preview fine, but they may not reach the review team.

Likely causes
  • Evidence upload in the dispute form is not fully wired yet — image persistence is still being completed platform-side.
How to fix it
  1. Submit the dispute with its written reason and description as usual.
  2. Then open a support ticket (Returns & refunds) and attach the same images there — tickets accept up to 5 attachments of 10MB each and are reliably stored.
  3. Reference the return ID in the ticket so the two are linked.
When to contact support

This IS the escalation — the ticket is currently the dependable evidence channel.

Unit identity problems

Returned unit flagged as wrong or duplicate
What you see

A warehouse-return case shows an identity problem on a unit — e.g. the returned unit’s code does not match any unit sold for that order, or the same unit code appears twice.

Likely causes
  • Every unit carries a permanent identity code (shaped like FWU-2026-000000000123-C7) bound at warehouse receipt; the platform validates returned units against it.
  • The buyer returned a different physical unit than the one delivered, or a unit was scanned twice.
How to fix it
  1. You do not resolve the scan yourself — the warehouse opens a case for the mismatched unit.
  2. Follow the case in your Inventory cases/Warehouse Returns view and respond to any decision it asks of you.
When to contact support

If you believe the flag is wrong (e.g. you can prove the unit is yours), open a ticket with the case ID, the unit code and your evidence.

Return stuck at a stage

Who moves next depends on the surface:

WhereStuck stateWhose move
Returns module (FBS)Any stage 1–11Yours — advance the stage or the timer runs down.
Returns module (FBF/MARKET)AnyFawran’s — read-only for you.
Warehouse Returns«بانتظار الفحص» (pending inspection)The warehouse inspects first; decisions unlock only when the case is inspected and pending decision.
Warehouse Returns«بانتظار القرار» (pending decision)Yours — but non-Dispose decisions are awaiting platform activation (see the first card).

Before you contact support

  • The return ID or warehouse-return case ID.
  • The exact message or the stage where things stopped.
  • Unit codes if the problem is unit-level (FWU-…).
  • Photos/screenshots — attach them to the ticket, especially for disputes.

Was this article helpful?