Added documentation for shipping-plc

Author: aschempp

docs/shipping-plc/_index.de.md

@@ -0,0 +1,81 @@
+---
+title: "Post-Labelcenter"
+---
+
+# Post-Labelcenter 
+
+Mit Hilfe der Versandsoftware [**Post-Labelcenter**][PLC] erstellst du rasch und gemäß den Anforderungen der Post
+deine Paketaufkleber, Sendungslisten und die dazu notwendigen Avisodaten für eine optimale logistische Abwicklung.
+
+## Integration in Isotope eCommerce
+
+Mit der Erweiterung für Isotope eCommerce lassen sich Paketaufkleber für Bestellungen direkt aus dem
+Backend von Contao erstellen. Vorteil der Integration ist, dass die Absender- und
+Empfängeradresse sowie weitere Paketinformationen automatisch aus der Bestellung ausgelesen
+und an die Österreichische Post übermittelt werden.
+
+![Post-Labelcenter](plc.png)
+
+
+## Sendung erstellen
+
+Durch Klick auf «Sendung erstellen» öffnet sich die Konfigurationsmaske des Post-Labelcenter.
+Hier gibt es folgende Bereiche:
+
+1. **Absender:in**
+
+   Die Absenderadresse des Shops wird automatisch aus der Shop-Konfiguration übernommen.
+
+2. **Empfänger:in**
+
+   Auch die Empfängeradresse wird automatisch übernommen. Falls vorhanden zuerst die Versandadresse,
+   andernfalls die Rechnungsadresse der Bestellung.
+
+   {{% notice info %}}
+   Bei internationalen Sendungen ist die Angabe einer E-Mail-Adresse oder Telefonnummer zwingend.
+   Falls dies in der Bestellung fehlt, muss das Feld beim Erstellen der Sendung ausgefüllt werden. 
+   {{% /notice %}}
+
+
+3. **Versandinformationen**
+
+    In diesem Bereich lässt sich das gewünschte Produkt der Post wählen. Je nach [Konfiguration](./settings/)
+    wird bereits automatisch das bevorzugte Produkt vorausgewählt. Die verfügbaren Optionen sind
+    abhängig vom Vertrag mit der Österreichischen Post.
+
+    ![Versand konfigurieren](product.png)
+
+
+4. **Zusatzleistungen**
+
+   Erlaubt die Erfassung von zusätzlichen Leistungen für eine Sendung. Siehe [Zusatzleistungen](../features/).
+
+5. **Packstücke**
+
+   Erlaubt die Erfassung von mehreren Paketen für eine Sendung. Siehe [Mehrere Pakete](../parcels/).
+
+6. **Artikel**
+
+   Für eine Zollabwicklung (Versand ins Ausland) müssen die Artikel in den Paketen deklariert werden.
+   Siehe [Internationaler Versand](../international/).
+
+
+
+[PLC]: https://www.post.at/g/c/paket-versandsoftware-geschaeftlich
+
+
+## Etikett drucken
+
+{{% notice warning %}}
+Sobald die Sendung bei der Post angemeldet ist, kann diese nicht mehr bearbeitet werden!
+{{% /notice %}}
+
+Durch Klick auf _Etiketten drucken und speichern_ wird die Sendung bei der Post angemeldet. Wurde kein abweichendes
+Versanddatum unter _Versandinformationen_ konfiguriert, erwartet die Post, dass das Paket umgehend übergeben wird.
+
+Um die eingegebenen Daten nur zu speichern, kann die Aktion _Entwurf speichern_ genutzt werden.
+
+Entwürfe und angemeldete Sendungen werden in der Bestellung im Backend von Contao aufgelistet. 
+Hier lassen sich auch die Etiketten für den Versand herunterladen.
+
+![PDF herunterladen](download.png)

docs/shipping-plc/download.png

@@ -0,0 +1,15 @@
+---
+title: "Zusatzleistungen"
+weight: 3
+---
+
+
+Sollten für eine Sendung _Zusatzleistungen_ benötigt werden, beispielsweise eine Versicherung bei hohem Paketwert,
+können diese direkt im Contao Backend erfasst werden.
+
+![Zusatzleistungen konfigurieren](features.png)
+
+{{% notice info %}}
+Die verfügbaren Zusatzleistungen sind abhängig vom Zielland und dem gewählten
+Versandprodukt (Option «Versenden als Produkt»).
+{{% /notice %}}

docs/shipping-plc/features/_index.de.md

@@ -0,0 +1,17 @@
+---
+title: "Internationaler Versand"
+weight: 8
+---
+
+Bei internationalem Versand müssen die Artikel in den Paketen für die Zollabwicklung deklariert werden.
+Auch hier bietet die Integration in Contao eine grosse Hilfe, da die Artikeldaten automatisch übernommen werden.
+
+![Produkte konfigurieren](products.png)
+
+Ist beim Produkt ein Gewicht eingetragen, wird dies automatisch übernommen. Wurden für die Sendung mehrere
+Pakete angelegt, muss pro Paket die enthaltene Anzahl des Produkts eingegeben werden. Optional lässt sich der Zollwert
+korrigieren, sollte er nicht dem Verkaufspreis des Produktes entsprechend.
+
+{{% notice info %}}
+Sollte sich das Produkt nicht in einem Paket befinden, muss `0` bei Anzahl eingetragen werden.
+{{% /notice %}}

docs/shipping-plc/features/features.png

@@ -0,0 +1,20 @@
+---
+title: "Mehrere Pakete"
+weight: 5
+---
+
+
+Kann eine Bestellung nicht in einem Paket versendet werden, gibt es zwei Möglichkeiten:
+
+1. Die Aktion _Sendung erstellen_ kann beliebig oft ausgeführt werden, um eine weitere Sendung zur Bestellung hinzuzufügen.
+   Das ist beispielsweise sinnvoll, wenn nicht alle Artikel gleichzeitig lieferbar sind, oder verschiedene Zusatzleistungen
+   für die Pakete gebucht werden sollen.
+
+2. Innerhalb einer Sendung können auch mehrere Pakete bei der Post angemeldet werden. Der Versand dieser Pakete
+   erfolgt dann in der Regel gleichzeitig.
+   ![Pakete hinzufügen](parcels.png)
+
+{{% notice info %}}
+Bei mehreren Paketen ist unbedingt auf das Brutto-Gewicht zu achten. Wurden in den Produktdaten ein Gewicht eingetragen,
+berechnet Isotope hier alle Artikel zusammen! Das Gewicht muss also entsprechend dem Paketinhalt korrigiert werden.
+{{% /notice %}}

docs/shipping-plc/international/_index.de.md

@@ -0,0 +1,20 @@
+---
+title: "Einrichtung"
+weight: 1
+---
+
+Nach der Installation der Erweiterung muss eine Verbindung zum Post-Labelcenter hergestellt werden.
+Die Konfiguration dazu erfolgt in der jeweiligen Shop-Konfiguration. Die benötigten Zugangsdaten findest du im
+Backend des Post-Labelcenters unter _Gerätekonfiguration_, dann _API_.
+
+![Einstellungen des Post-Labelcenter](settings.png)
+
+
+## Bevorzugte Produkte
+
+In der Shop-Konfiguration kann auch eine Reihenfolge der _bevorzugten Produkte_ konfiguriert werden.
+Bei der Übermittlung der Paketdaten an die Post versucht Isotope dann, automatisch das beste passende Paket
+zu wählen. Die verfügbaren Optionen sind ggf. abhängig vom Vertrag mit der Post, die tatsächlich verfügbaren
+Optionen werden jeweils pro Bestellung neu berechnet (z.B. je nach Zielland).
+
+![Konfiguration der bevorzugten Produkte](products.png)

docs/shipping-plc/international/products.png

@@ -0,0 +1,4 @@
+contentDir: '../docs/shipping-plc'
+title: 'Post-Labelcenter'
+defaultContentLanguageInSubdir: true
+DefaultContentLanguage: de

docs/shipping-plc/parcels/_index.de.md

@@ -0,0 +1,3 @@
+de:
+  languageName: Deutsch
+  weight: 1

docs/shipping-plc/parcels/parcels.png

@@ -0,0 +1,3 @@
+DocumentationTitleDe: Post-Labelcenter
+#extensionPermalink: https://extensions.terminal42.ch/shipping-plc
+extensionIcon: shipping-plc.svg