Returns Management in Channable Module

Turns the returns feature on or off per store view.

After enabling, a webhook URL is generated for each store view. Copy this URL and paste it into your Channable account under the marketplace connection settings. Make sure you copy the full URL — it's long and may be partially hidden.

Format: {base_url}/channable/returns/hook/store/{store_id}/code/{token}

When enabled, a return block appears on the credit memo creation page for Channable orders that have a pending return. This lets you manually select which return(s) to link when creating the credit memo.

When enabled, any pending return is automatically marked as "accepted" when you create a credit memo for that order. This overrides the manual return block selection.

When to use: You have established processes to handle credit memos and don't need to manually review each return.

When enabled, a credit memo is created automatically for returns that arrive with status "complete". These are returns already handled and fulfilled by the marketplace itself — the module just mirrors that in Magento.

When a return has status "new", you can set it to any other status directly from the grid: Accept, Reject, Repair, Exchange, Keep, or Cancel.

• Re-process — Re-links selected returns to their Magento orders (useful if order wasn't found during initial import)
• Create Credit Memo — Creates a credit memo for the linked order
• Create Credit Memo + Accept — Creates a credit memo and sets return status to "accepted"
• Delete — Removes the return from Magento (does not update Channable)

Select returns in the grid → "Create Credit Memo" mass action. The module finds the order item by matching the GTIN from the return to a product SKU (or configured GTIN attribute).

When "Show Return Block on Credit Memo Page" is enabled, you'll see a block with checkboxes on the credit memo creation page. Select which returns to link, and saving the credit memo updates those returns to "accepted".

Enable both "Automatically Match Returns" and "Credit Memo Completed Returns". Returns arriving as "complete" get a credit memo created automatically. Returns in "new" status get marked "accepted" whenever you create a credit memo for their order.

Some marketplaces don't include a GTIN in their return data. When the configured GTIN attribute doesn't produce a match and the value is numeric, the module automatically tries to load the product by entity ID as a fallback.

If neither the attribute match nor the ID fallback finds a product, the credit memo creation will fail and an error is logged.