> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/haufige-fragen-faq/faq-synchronisation-and-fehler.md). # FAQ – Synchronisation & Fehler ### Wie automatisiere ich Uploads und Downloads? Über die **Aufgabenwarteschlange** von Business Central. Damit lassen sich Bestellabruf, Artikel-, Preis- und Bestands-Upload sowie die Statusrückmeldung planen. Konkrete Beispiele unter Empfohlene Job-Queue-Setups. ### Wo sehe ich, ob eine Synchronisation erfolgreich war? Im **Aktivitätsprotokoll** sehen Sie jede fachliche Übertragung mit Erfolg/Fehler-Status. Für technische Details (URL, Request, Response) aktivieren Sie den **API Call Log**. Siehe Aktivitätsprotokoll und API Call Log. ### Ein Upload schlägt wiederholt fehl – wie finde ich die Ursache? Öffnen Sie den betreffenden Eintrag im **API Call Log** und lesen Sie die Shopware-Antwort (Feld `errors` bzw. `detail`). Dort steht die konkrete Ursache, z. B. ein fehlendes Pflichtfeld. Siehe API-Antworten analysieren. ### Warum wird ein Datensatz erneut synchronisiert? Jede Änderung an einem Artikel, Preis, Kunden oder einer Adresse setzt den Datensatz automatisch auf **nicht synchronisiert**. Beim nächsten Lauf wird er deshalb erneut übertragen – so bleibt der Shop aktuell. ### Was bedeuten die Shopware-Fehlercodes 400, 404 und 409? **400** steht für eine Validierung (Pflichtfeld fehlt/ungültiger Wert), **404** für ein nicht gefundenes Objekt (Web-ID/Zuordnung prüfen) und **409** für ein Duplikat (Matching/Web-ID prüfen). Eine Übersicht finden Sie unter API-Antworten analysieren. ### Wie aktiviere ich das technische API-Logging? Über die Konfigurationseinstellung **Enable Developer Log**. Bei HTTP-Fehlern wird ein Eintrag auch dann erzwungen, wenn das Logging ausgeschaltet ist. Aktivieren Sie es gezielt zur Fehlersuche, da im Dauerbetrieb viele Einträge entstehen. ### Wie starte ich nach schweren Fehlern sauber neu? Nutzen Sie die gestuften **Reset-Funktionen** – von einzelnen Zuordnungen bis zum vollständigen Reset. Sichern Sie vorher die Konfiguration per Export. Siehe Sauberer Neustart per Reset. ### Läuft die Synchronisation in Business Central Cloud automatisch? Ja. Die Automatisierung erfolgt über Aufgabenwarteschlangenposten, die sowohl in der Cloud als auch On-Premise laufen. Verteilen Sie die Startzeiten, damit nicht mehrere große Läufe gleichzeitig starten. ### Wie automatisiere ich die Synchronisation? Über die Aufgabenwarteschlange (Job Queue) in Business Central richten Sie geplante Aufgaben für Artikel-, Preis-, Bestands- und Bestellsynchronisation ein. Empfohlene Intervalle und Reihenfolgen finden Sie unter Empfohlene Job-Queue-Setups und Scheduler & AutoSync. ### Wo sehe ich, warum ein Upload fehlgeschlagen ist? Fehlgeschlagene Uploads und die genaue Shopware-Antwort sehen Sie im **API Call Log** sowie im Massen-Upload-Report (Shopware Upload Data). Dort finden Sie Statuscode, Endpunkt und Fehlermeldung zur gezielten Analyse. Details unter API Call Log und API-Antworten analysieren. ### Was bedeutet ein HTTP-Fehler 400 bei der Synchronisation? Ein **400 Bad Request** deutet auf ungültige oder fehlende Daten hin, z. B. ein Pflichtfeld ohne Wert, eine nicht zugeordnete Steuer oder ein ungültiger Verkaufskanal. Prüfen Sie die betroffenen Feldwerte und Mappings und wiederholen Sie den Upload. Die Serverantwort im API Call Log nennt meist das konkrete Feld. ### Wie wiederhole ich fehlgeschlagene Vorgänge? Nach dem Beheben der Ursache können Sie den betroffenen Datensatz erneut hochladen bzw. den Job in der Aufgabenwarteschlange neu starten. Der Massen-Upload-Report hilft, alle betroffenen Datensätze gebündelt erneut zu verarbeiten. Details unter Fehlerhandling bei automatischen Prozessen. ### Kann die Automatisierung Bestellungen und Artikel gleichzeitig verarbeiten? Ja, Sie können mehrere Aufgaben parallel bzw. zeitversetzt einplanen. Achten Sie auf sinnvolle Intervalle und Reihenfolgen (z. B. erst Stammdaten, dann Preise/Bestände, dann Bestellungen), um API-Last und Abhängigkeiten zu berücksichtigen. Details unter Empfohlene Job-Queue-Setups. --- # 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.solutioo.de/shopware/haufige-fragen-faq/faq-synchronisation-and-fehler.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.