# Rechnungsupload zu Shopware 6 #### 1. Ziel des Rechnungsuploads Über den Rechnungsupload der Schnittstelle **sync4** werden in der Warenwirtschaft erzeugte Rechnungsdokumente automatisch oder manuell in den angebundenen Shopware 6 übertragen. Die hochgeladenen Rechnungen werden dabei: * der jeweiligen Shop-Bestellung eindeutig zugeordnet * im Kundenkonto des Endkunden im Shop bereitgestellt * dort als PDF-Dokument zum Download angezeigt *** #### 2. Voraussetzungen Für einen erfolgreichen Rechnungsupload müssen folgende Bedingungen erfüllt sein: 1. Die Warenwirtschaft erzeugt die Rechnung als **PDF-Datei**. 2. Die Datei wird in einem definierten **Netzwerkpfad** abgelegt. 3. Die Datei wird korrekt benannt (siehe Abschnitt 3). 4. Der Netzwerkpfad ist für den sync4-Dienst sowie jeden Client erreichbar (Leserechte erforderlich). *** #### 3. Vorgaben zur Dateibenennung Die Benennung der Rechnungsdateien ist entscheidend für die korrekte Zuordnung zur Shop-Bestellung. **Standard-Anbindungen** Bei allen regulären Shop-Anbindungen gilt: ``` .pdf ``` **Beispiel:** ``` 47110023.pdf ``` Die Rechnungsnummer muss exakt der Rechnungsnummer aus der Warenwirtschaft entsprechen. *** **OpenTrans-Anbindungen** Bei Anbindungen über das OpenTrans-Format gilt eine abweichende Regel: ``` .pdf ``` **Beispiel:** ``` SO-100045.pdf ``` Hier muss die Datei exakt mit der **Bestellnummer aus dem Shop** benannt werden. *** #### 4. Ablageort der Rechnungen Die Rechnungen müssen in einem definierten **Netzwerkpfad** gespeichert werden, zum Beispiel: ``` \\Server\Rechnungen\Export\ ``` Wichtig: * Der Pfad muss in der sync4-Konfiguration hinterlegt sein. * Der sync4-Dienst sowie sync4 benötigt Leseberechtigung. * Die Dateien dürfen beim Zugriff nicht gesperrt sein. *** #### 5. Konfiguration in sync4 In sync4 wird der Rechnungsupload im entsprechenden Mandanten konfiguriert. Hier wird insbesondere definiert: * Netzwerkpfad für Rechnungen ***
*** #### 6. Ausführungsarten des Rechnungsuploads Der Rechnungsupload kann auf zwei Arten ausgeführt werden: **6.1 Manueller Upload** * Start über die sync4-Oberfläche * Geeignet für Tests oder Einzelverarbeitung **6.2 Automatischer Upload (Dienst)** * Verarbeitung erfolgt zyklisch über den sync4-Dienst * Der definierte Netzwerkpfad wird regelmäßig geprüft * Neue Rechnungsdateien werden automatisch verarbeitet * Empfohlen für den produktiven Betrieb *** #### 7. Ablauf der Verarbeitung 1. Die Warenwirtschaft erstellt eine Rechnung als PDF. 2. Die Datei wird mit korrekter Benennung im Netzwerkpfad gespeichert. 3. sync4 erkennt die neue Datei (manuell oder per Dienst). 4. Die Datei wird anhand des Dateinamens einer Shop-Bestellung zugeordnet. 5. Die Rechnung wird an den Shop übertragen. 6. Der Kunde kann die Rechnung in seinem Kundenkonto herunterladen. *** #### 8. Typische Fehlerquellen | Problem | Ursache | Lösung | | ------------------------------------ | ------------------------------------------------ | ---------------------------------- | | Rechnung wird nicht übertragen | Falsche Dateibenennung | Benennung gemäß Abschnitt 3 prüfen | | Keine Verarbeitung im Automatikmodus | Dienst läuft nicht | sync4-Dienst prüfen | | Zuordnung schlägt fehl | Rechnungs-/Bestellnummer existiert nicht im Shop | Nummernabgleich prüfen | | Datei wird nicht erkannt | Falscher Netzwerkpfad oder fehlende Rechte | Pfad und Berechtigungen prüfen | *** #### 9. Best Practices * Sicherstellen, dass Rechnungen erst nach vollständiger Erstellung im Zielordner abgelegt werden * Keine zusätzlichen Zeichen oder Leerzeichen im Dateinamen verwenden * Keine Unterordner verwenden, sofern nicht explizit konfiguriert * Regelmäßige Kontrolle des Verarbeitungsprotokolls --- # Agent Instructions: 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: ``` GET https://docs.sync4.de/faq/shops/shopware/rechnungsupload-zu-shopware-6.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.