! POS Exchange workflow V2 Issues for API

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Shopify’s new POS exchange workflow (V2) now edits the original order instead of creating a new “exchange order,” causing API gaps for ERP integrations (e.g., NetSuite).

Key issues reported:

  • No explicit “exchange” object/flag; refunds only list returned items, not items given in exchange.
  • No returned/exchange status on Order; multiple Refund IDs for a single exchange with partial refunds/payments.
  • Inability to distinguish payments taken during exchange (e.g., gift card/card) from original order payments.
  • Lack of documentation and coherent JSON linking removed vs. added line items.

Requested changes:

  • Clear exchange metadata (e.g., refund_type: exchange), returned/exchange statuses on orders, a single refund grouping line items and related transactions, and explicit markers on exchange-added/returned line items.

Shopify guidance/workarounds:

  • “Exchange” = refund (returned items) + order edit (added items) + transactions (price deltas).
  • Use Refund and Transaction resources; subscribe to refunds/created and orders/edited webhooks and reconcile.
  • Submit feature requests to App Bridge repo.

Most recent update:

  • Private functionality exists (since February) for select ERP integration partners to address these gaps; not publicly available and no timeline shared. Merchants should contact their ERP providers for access.

Status: Unresolved in public API; partial private solution available via select partners.

Summarized with AI on January 28. AI used: gpt-5.
2

Another BIG issue is when a SINGLE Exchange also has customer Refunded money it reports in two separate Refund IDs. When it should all be contained in 1 Refund ID for the Single Exchange including the transactions refunded.

1 Exchange with Refund of 10 dollars

in8sync_0-1667331890954.png
in8sync_0-1667331890954.png711×549 15.5 KB

but two refund ids 1 for Refund transaction and 1 for Line Items

in8sync_1-1667331921858.png
in8sync_1-1667331921858.png702×884 37.4 KB