404 Error - Retouren-Portal oder Tracking-Portal nicht erreichbar

Warum funktioniert meine App-Proxy-URL nicht wie erwartet – z. B. /apps/tracking oder /apps/returns?

1. Verwendet ihr ein Headless-Setup (z. B. mit Next.js, Nuxt, Vue etc.)?

Wenn ihr ein eigenes Frontend außerhalb von Shopify nutzt, also ein sogenanntes Headless-Setup, dann werden die URLs wie /apps/tracking oder /apps/returns nicht mehr von Shopify selbst verarbeitet, sondern von eurem eigenen System.

In diesem Fall funktionieren Shopify App-Proxys nicht, weil die URL nie bei Shopify (und damit auch nicht bei der App) ankommt.

2. Warum hängt Shopify -1 oder -2 an meine App-URL an?

Wenn eure erwartete App-URL z. B. /apps/tracking lautet, Shopify aber stattdessen /apps/tracking-1 verwendet, liegt das daran, dass der ursprüngliche Pfad bereits durch eine andere App oder ein früheres Setup belegt war.

Shopify hängt dann automatisch -1, -2 usw. an den Pfad an, um Namenskonflikte zu vermeiden.

Lösung:

    •    Prüft im Shopify Admin oder in der App-Konfiguration, welcher Pfad aktuell verwendet wird.

    •    Wenn /apps/tracking oder /apps/returns nicht wie erwartet funktioniert, versucht stattdessen /apps/tracking-1 oder /apps/returns-1 im Browser.

In Shopify unter "Einstellungen -> Apps und Vertriebskanäle -> App -> drei Punkte -> Details" anzeigen könnt ihr die URL selbst ändern. Sollte das nicht funktionieren, kontaktiert uns Bitte unter Angabe der App-Proxy-Url die dort angezeigt wird.