Add optional refundId, returnId, exchangeId, lineItemsAdded, and lineItemsRemoved fields to ReprintReceiptData to support reprinting return and exchange receipts.

[mauriciosierra]

Background

This pull request enhances the ReprintReceiptData interface to support reprinting receipts for return and exchange transactions in addition to the existing sale transaction support.

Solution

Extended the ReprintReceiptData interface with five new optional fields:

• refundId: Tracks refund ID when a refund was issued for the return
• returnId: Identifies the completed return transaction
• exchangeId: Links the return to an exchange transaction when applicable
• lineItemsAdded: Captures items added to the customer during an exchange
• lineItemsRemoved: Captures items removed from the customer during an exchange

These fields are optional to maintain backward compatibility with existing sale transaction reprints while enabling comprehensive support for return and exchange receipt reprinting scenarios.

🎩

• Added optional refundId, returnId, and exchangeId fields to track transaction relationships
• Added lineItemsAdded and lineItemsRemoved arrays to support exchange transaction details
• Updated documentation comments to reflect broader transaction type support
• Imported LineItem type to support the new exchange-related fields

Checklist

• I have 🎩'd these changes
• I have updated relevant documentation

[github-actions]

🚨🚨🚨 Docs migration in progress 🚨🚨🚨

We are actively migrating UI extension reference docs to MDX in the areas/platforms/shopify-dev zone of the monorepo. This impacts docs for the following surfaces:

• Admin UI extensions
• App Home
• Checkout UI extensions
• Customer account UI extensions
• POS UI extensions

During this migration, please be aware of the following:

.doc.ts files are being deprecated. Changes to .doc.ts files in this repo will not be reflected in the new MDX-based docs. If you need to update docs for a reference that has already been migrated, make your changes directly in the areas/platforms/shopify-dev zone of the monorepo instead.

Doc comments in .ts source files (the comment blocks above types and functions) are also affected. Generating docs from these comments currently requires a newer version of the @shopify/generate-docs library that isn't yet available. Updates to doc comments may not produce the expected output until the migration is complete.

Examples that previously lived in this repo are being moved to the areas/platforms/shopify-dev zone of the monorepo and should be authored there going forward.

What should I do?

• If your PR includes changes to .doc.ts files, doc comments, or examples, please reach out to us in #devtools-proj-templated-refs so we can help ensure your updates are captured correctly.
• If your PR is limited to source code changes (non-docs), you can ignore this notice.

Thanks for your patience while we complete the migration! 🙏

[mauriciosierra]

• Add optional refundId, returnId, exchangeId, lineItemsAdded, and lineItemsRemoved fields to ReprintReceiptData to support reprinting return and exchange receipts. #4178 👈 (View in Graphite)
• 2026-04-rc

This stack of pull requests is managed by Graphite. Learn more about stacking.

[mauriciosierra]

Merge activity

• Mar 20, 7:08 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Mar 20, 7:09 PM UTC: @mauriciosierra merged this pull request with Graphite.