> For the complete documentation index, see [llms.txt](https://docs.shop-studio.io/shopware/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shop-studio.io/shopware/de/erweiterungen/tree-per-order/haufige-fehlerquellen.md). # Häufige Fehlerquellen ### APP\_URL ist falsch in der .env Auf dem Server gibt es eine .env Datei, wo eine wichtige URL bei der Variable `APP_URL` gespeichert ist. Diese URL wird benutzt, damit die externe App eine URL von deinem Shopware-Shop für die Kommunikation zurück enthält (es handelt sich hier um eine externe Shopware Cloud-App). Leider wird diese URL bei Self-Hosted-Shops fast immer falsch gesetzt - bereits vom Installer. Die URL könnte ähnlich falsch stehen wie hier ``` APP_URL="http://127.0.0.1" ``` Wichtig bei der Korrektur ist es die URL des Shops zu verwenden. Unbedingt auch http & https beachten. In einigen Fällen kann es auch eine abweichende URL zum Admin des Shops sein (z.B. Shopware PWA oder mehrere Shop-Domains innerhalb einer Installation). Richtig wäre z.B. ``` APP_URL="https://www.mein-shop.de" ``` Nach der Änderung einmal die Datei speichern und den Shop Cache leeren. Nun wird im Admin ein neues Fenster erscheinen, da sich die URL geändert hat. Hier wäre eine Möglichkeit allen externen Cloud-Apps mitzuteilen, dass sich die URL geändert hat, weil der Shop "umgezogen" ist. Etwas mehr steht an dieser Stelle: Als Letztes nochmal die App neu installieren. Danach sollte alles soweit funktionieren. ### Die App erreicht deinen Shop nicht (Firewall / Cloudflare) Bei „Baum pro Bestellung (Cloud)" handelt es sich um eine externe Cloud-App: Sie läuft auf unseren Servern und kommuniziert mit deinem Shop über die Shopware-Schnittstelle (API), die dafür von außen erreichbar sein muss. Über diese Schnittstelle hält die App deine Bestellungen und Baumspenden aktuell. Viele Shops schützen diese Schnittstelle mit einer Firewall, einem Sicherheitsdienst oder einem CDN wie Cloudflare. Das ist grundsätzlich gut — aber wenn dein Shop am Tag viele Änderungen vornimmt, entstehen entsprechend viele API-Aufrufe, und diese Schutzsysteme können unsere ganz normalen Anfragen fälschlicherweise für unerwünschten Traffic halten und blockieren. Dann kommt unsere App nicht mehr zu deinem Shop durch und es kommen keine Updates mehr an — zum Beispiel werden keine Spenden mehr erfasst (es werden keine neuen Bäume gepflanzt). Du erkennst das meist daran, dass keine Spenden mehr erfasst werden; in den Server-Logs taucht dann eine `403 Forbidden`-Meldung auf. Um das zu verhindern, trage unsere IP-Adressen in deiner Firewall, deinem Sicherheitsdienst oder bei Cloudflare auf die Allowlist (Whitelist) ein. So werden unsere Anfragen immer als vertrauenswürdig erkannt und nie blockiert: ``` 74.220.51.43 74.220.51.44 74.220.51.45 ``` Falls du nicht sicher bist, wie das geht: Dein Hoster — oder wer Cloudflare für dich eingerichtet hat — kann diese drei Adressen in einer Minute hinterlegen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.shop-studio.io/shopware/de/erweiterungen/tree-per-order/haufige-fehlerquellen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.