Skip to main content

How to configure invoice settings for international returns (Returns V2)

How to configure the invoice settings that control commercial invoices for Returns V2 international returns — pricing, zero-value items, and HS code / country of origin fallbacks.

Written by Guido Kaspers

Applies to: Returns V2, international returns only. Some settings vary by carrier (DHL, FedEx, UPS).

This article explains how to configure the invoice settings that control what appears on commercial invoices for international returns.


Where to find these settings

  1. Go to Settings → General.

  2. Find the Commercial invoice configuration section.

These settings are aligned with Returns requirements, so changing them isn't recommended. Only make changes if you're certain the new configuration is correct.

Every field in this section loads pre-filled with your store's current configuration — none of them start empty.


Commercial invoice pricing

Controls which item prices are pulled onto the commercial invoice for international shipments.

Global returns

  • Global Prices (default) — use global prices as added to the outbound invoice.

  • Shopify Prices — use prices from the original order. Default if global prices aren't available.

Non-global returns

Labelled International returns if Swap Global isn't enabled.

  • Shopify Prices (default) — use prices from the original order. Default if cost isn't available.

  • Cost + markup — apply a markup over cost, set per region.

For example, if an item's cost is $20.00 and the markup for that region is set to 15%, the invoice shows a value of $23.00.


Zero value items

Sets the fallback used when an item has a $0 price and a label can't be generated.

  • Mark as 0.01 (in your store's currency) — fallback when an item's price is $0 and a label can't be generated. Used as the default when cost doesn't exist.

  • Shopify prices — use the price from the original order, even when it is $0.


HS code and country of origin

These settings are used only if the equivalent value isn't already configured in Shopify.

US returns

  • Always use this HS code (default for US returns) — applied to every line item shipped into the US.

  • Use Shopify HS code — reads each product's HS code from Shopify. Only choose this if your Shopify codes are full 10-digit HTS values.

Fallback values (all returns)

  • Fallback HS code (optional) — applied if the Shopify HS code is missing.

  • Country of origin (optional) — applied if the Shopify country of origin is missing.


Carrier-specific settings

Some invoice fields are configured directly within a carrier's own settings, rather than in the general Commercial Invoice configuration section described above. Currently, this only applies to FedEx.

For FedEx, the following are edited from within the FedEx carrier configuration:

  • Purpose of shipment — loads pre-filled with the store's current default; the merchant can change it.

  • Shipment instructions — also referred to as special instructions or remarks on some invoices; loads pre-filled with the store's current default.

DHL and UPS have equivalent fields (reason for export and remarks for DHL; reason for export and additional comments for UPS), but these aren't yet editable through carrier-specific settings.


FAQ

Why do the pricing options for Global and non-Global returns look different?

Swap Global orders can use the prices already set on the outbound invoice, so a Global prices option is available. Non-Global international returns don't have this outbound invoice data, so they choose between Shopify prices and cost + markup instead.

Did this answer your question?