Nobody loves returns or exchanges, but when they happen, ACP and Commerce7 can keep everything neat, tidy, and accurate. When you process a return or exchange in Commerce7, the Wineshipping app will update the order in ACP β as long as the order is still open. If the order is already being packed or processed in the warehouse, any edits made in Commerce7 will not carry over into ACP.
When Changes Sync to ACP
Changes made in Commerce7 will update ACP only if the order is still editable.
Orders in the following statuses will sync:
Needs Action
Fulfillment Hold
Weather Hold
Received β Queued Publishing
Received β Published
Orders in warehouse processing or shipped statuses will not sync:
In Progress β Preparing to Pack
In Progress β Packing
Shipped
Delivered
If the order is unable to sync it will error with the below error:
Commerce7 Batch Order Processing has been Failed for #####. The error is:- The system is unable to update this order: {"type":"https://httpstatuses.com/403","title":"Forbidden","status":403,"detail":"Forbidden","errors":["Order cannot be edited."],"traceId":"#####}
π Exchanges: The Classic Swap
An exchange happens when a customer swaps one product for another.
Customer trades one bottle for another?
ACP steps in and removes the old item β and adds the shiny new item β.
Result: your order looks just like the customer wanted.
Example:
Customer returns a 2018 Cabernet and swaps for a 2019 Chardonnay.
ACP removes the Cab and adds the Chard β done! β
π΅ Refunds: Money Back, No Inventory Change
A refund where the customer gets money back but no product is returned.
If you give money back πΈ but donβt restock the wine, ACP wonβt touch the order.
The order stays as-is in ACPβbecause the refund is all about dollars, not bottles.
Example:
A customer paid $50 but was refunded $10 because of a discount that was missed at checkout.
The order shows the refund on the financial side, but all the items remain as originally purchased.
π¦ Refunds with Restock: Wine Goes Back on the Shelf
A refund where the customer returns a bottle and it is restocked.
When refunded wine is actually returned to inventory:
Full restock? ACP cancels out the item like it never happened.
Partial restock? ACP removes just the number of bottles returned, keeping the rest in place.
Example:
A customer returns 2 bottles out of a 6-pack.
In ACP, the order now shows 4 bottles instead of 6, and the refund amount is applied.
π·+π΅ Mixed Refunds: A Little of Both
Sometimes a single refund includes both bottles being restocked and bottles that are money-only adjustments.
Wineshipping app is smart:
If the item has a location + restock quantity β restocked.
If not β treated as money-only.
End result: no double-counting, no messy inventory.
Example:
1 bottle returned and restocked, plus a club discount on the remaining items.
In ACP, the order shows one less bottle.
π« Carry Out & Pickup Orders
Carry Out or Pickup orders are not shipped by Wineshipping. These orders will not pull into ACP through the Wineshipping app.
Inventory effect:
Handled entirely at the POS/tasting room location. Wineshipping does not touch these bottles.
π¦β‘οΈπ Pickup-to-Ship Orders: Start Local, End Shipped
Pickup orders will not pull through the app, but, if you update the pickup order to a shipping order we will pull the order through without requiring manual effort.
These orders begin as Pickup but are later flagged to ship.
ACP treats them as shipping orders, so they move through carrier workflows like FedEx/UPS.
Tracking + fulfillment behave the same as normal shipping orders.
Example:
Customer schedules a tasting room pickup, then calls and says,
βCan you ship it to me instead?β
C7 flips it into a shipping workflow β visible just like any regular shipping order with labels + tracking.
β οΈ Important Considerations: ACP Automation & Manual Edits
When Retransmit a Changed Order updates an existing order in ACP, the integration updates the existing order record rather than creating a new one. Because the order already exists, certain ACP automation does not run again.
ACP Rule Center
ACP Rule Center evaluates orders when they are initially created in ACP. If an order is later updated through Retransmit a Changed Order, Rule Center does not automatically re-evaluate the updated order.
If the order change would normally trigger a Rule Center action, those changes may need to be reviewed and applied manually.
Temperature Control
Temperature Control is also evaluated when an order is initially created in ACP.
If a retransmitted update changes information that could impact shipping eligibility, the existing Temperature Control decision is not automatically recalculated. Review the order in ACP to determine whether additional action is needed before fulfillment.
Manual Changes Made in ACP
Retransmitted updates are intended to keep ACP synchronized with Commerce7. If your team has manually modified an editable order directly in ACP, a retransmission from Commerce7 may overwrite those changes with the latest information from Commerce7.
To avoid unexpected results, make ongoing order changes in Commerce7 whenever possible and allow the Wineshipping Commerce7 App to synchronize those updates to ACP.
β οΈ Heads-Up: Inventory Locations Matter
Wineshipping app relies on inventory location IDs to figure out what should be pulled/restocked.
If a location is disabled or missing:
Your inventory status is "off" in Commerce7
Any refunds/exchanges will not update properly
Wineshipping app treats it as money-only refund, even if bottles came back. This means manual efforts for that specific item will need to be taken in ACP to update the order appropriately.
Monetary refunds: works fine, nothing will happen
Refund/Restock of an item: will not remove restocked item/qty
Refund/Restock entire order: will not cancel order in ACP
Exchange to remove item: will not remove item from order in ACP
Make sure your inventory is initialized for any item on a Wineshipping order
Best case scenario: Always track inventory when creating new items and initialize inventory for the shipping items that currently have their inventory status set to "off"
β
Summary:
The app ensures ACP matches what really happened:
Exchanges = old item removed, new item added.
Refunds with restock = items removed and put back into stock.
Refunds without restock = only money refunded, items stay as-is.
Mixed refunds = split correctly between restock and money-only.
Carry Out/Pickup = not handled by Wineshipping, but still visible in ACP reporting.
Pickup to Ship = ship like standard order
Inventory Location ID = very important