ReturnZap Returns - Configure for Automated Sales Order Returns

DropStream connects ReturnZap to your warehouse management system so returns raised in ReturnZap for your Shopify store flow automatically to the warehouse — and, once the warehouse receives them, receipt is reported back to ReturnZap so your refund and restock automation can run.

ReturnZap is a returns app for Shopify. Shoppers request returns through it, and ReturnZap assigns each approved return to the warehouse that will receive it. This integration picks those returns up and carries them the rest of the way.

What this integration does

• Imports the returns ReturnZap has assigned to your warehouse — ReturnZap’s expected arrivals feed.
• Links each return to its original Shopify order using the Shopify order ID, and matches the returned line items by SKU.
• Forwards returns to your warehouse management system so the warehouse can receive and process them.
• Reports receipt back to ReturnZap once the warehouse confirms what arrived. This is what kicks off the merchant’s refund and restock automation in ReturnZap.

This is a returns-only integration. It does not import new orders, inventory, or products — the Shopify orders themselves come in through a separate Shopify connection.

How returns flow

1. A shopper requests a return in ReturnZap, and the merchant approves it.
2. ReturnZap assigns the return to a warehouse, which puts it in that warehouse’s expected arrivals feed.
3. DropStream imports the return and links it to the original Shopify order.
4. DropStream sends the return to the warehouse management system.
5. The warehouse receives the units and confirms what arrived.
6. DropStream reports that receipt back to ReturnZap, which runs the refund and restock automation.

What you’ll need

• A ReturnZap account with the ReturnZap app installed on your Shopify store.
• A ReturnZap API Token for the Warehouse API — see ReturnZap Returns - Gather API Credentials.
• A Shopify connection already importing orders into the same DropStream account. Returns link to their original order by Shopify order ID, so the order has to be in DropStream for the link to resolve.
• A DropStream account. If you don’t have one yet, contact your DropStream administrator or fulfillment provider.

Setup at a glance

The setup involves work on two sides — ReturnZap, then DropStream — in this order:

1. Gather your API credentials (in ReturnZap) — request the Warehouse API token DropStream uses to read your returns and report receipts.
2. Enable API access (in DropStream) — add the connection through the Add Connection wizard, enter your API token, and set how received units are graded.

Who does what

• If you manage your own DropStream account, you’ll do both steps yourself.
• If a third-party fulfillment provider configures DropStream for you, you only need Gather your API credentials. Send the resulting API token to your provider; they handle the rest.

Notes and limitations

• Returns only. DropStream reads returns from ReturnZap and reports receipt back. It does not import orders, inventory, or products, and it does not issue refunds itself — ReturnZap does that in response to the receipt.
• Returns appear once ReturnZap assigns them to your warehouse, which can be days after the shopper raised the return. DropStream accounts for this: each import re-checks a window behind the previous one, so a return assigned late is still picked up. The first import for a new store looks back 30 days.
• Returns link to orders by Shopify order ID, and line items match by SKU — the only key ReturnZap provides for matching a return line to an order line. If the original order wasn’t imported into the same DropStream account, the return still imports but may not link to an order.
• Every received unit is reported as accepted. The receipt DropStream gets from the warehouse reports units as received, with no per-unit pass/fail, so DropStream does not report partial rejections to ReturnZap. If you need units graded, set a Condition Code on the store — it is applied to every received unit.
• Receipt is reported once per return, when the warehouse confirms it.