Partial Delivery Plugin

Einführung

Hauptfunktionen

Kompatibilität

• ✅ Shopware 6.6.x

Erste Schritte

Installation & Activation

• Plugin-Repository klonen:

• Öffnen Sie Ihr Terminal und führen Sie den folgenden Befehl im Verzeichnis für benutzerdefinierte Plugins Ihrer Shopware-6-Installation aus (in der Regel custom/plugins/):

git clone https://github.com/solution25com/partial-delivery-shopware-6-solution25.git

Packagist

composer require solution25/partial-delivery

• Melden Sie sich im Shopware-6-Administrationsbereich an.

• Navigieren Sie zu Erweiterungen > Meine Erweiterungen.

• Suchen Sie das neu geklonte Plugin und klicken Sie auf Installieren.

• Klicken Sie nach der Installation auf Aktivieren, um das Plugin zu aktivieren.

• Gehen Sie im Shopware-Adminbereich zu Einstellungen > System > Plugins.

• Laden Sie das Plugin „PartialDelivery“ hoch oder installieren Sie es.

• Nach der Installation aktivieren Sie das Plugin über den Schalter.

• Nach der Aktivierung wird PartialDelivery in der Liste der installierten Plugins angezeigt.

• Der Plugin-Name, die Version und das Installationsdatum sollten wie im unten gezeigten Screenshot erscheinen.

Plugin-Konfiguration

Funktionsweise

• Menge

• Eine benutzerdefinierte Paketbezeichnung (z. B. „Paket 1“)

• Sendungsnummer

• Paketname

• Versandte Menge

• Sendungsverfolgungsinformationen

• Die Spalte Versendet wird basierend auf der insgesamt verschickten Menge aktualisiert.

• Jede verbleibende Menge bleibt unversendet, sodass zukünftige Teillieferungen möglich sind.

• Es wird stets eine vollständige Übersicht darüber behalten, welche Artikel bereits versendet wurden und welche noch ausstehen.

Best Practices

• Konsistente Beschriftung: Verwenden Sie einheitliche Namen für Paketetiketten (z. B. „Paket 1“, „Box A“), um Sendungen leicht identifizieren zu können.

• Alles nachverfolgen: Tragen Sie immer Sendungsnummern für jede Lieferung ein, um eine vollständige Versandhistorie zu gewährleisten.

• Datenbereinigung: Überprüfen Sie regelmäßig alte Sendungsaufzeichnungen, um Klarheit und Genauigkeit im Bestellmanagement sicherzustellen.

• Vor Nutzung testen: Testen Sie den Teillieferungsprozess in einer Staging-Umgebung, um das erwartete Verhalten vor Live-Bestellungen zu bestätigen.

Admin API Dokumentation

🔧 Teillieferungen erstellen

orderLineItemIds

• Menge zum Versand

• Paketname

• Tracking-Code für die Sendung

• Die Menge überschreitet nicht die verbleibende Menge der ursprünglich bestellten Produkte

• Gültige orderLineItemIds

• Alle erforderlichen Felder sind vorhanden

Request-Header

Authorization: Bearer Content-Type: application/json

{
  "partialDeliveries": [
    {
      "orderLineItemId": "0195a178f96b7345ad27051c34609e52",
      "quantity": 4,
      "package": "Package 6",
      "trackingCode": "DHL12sad31e279"
    },
    {
      "orderLineItemId": "0195a3aea0447296bc5377d49ab95c1e",
      "quantity": 1,
      "package": "Package 2",
      "trackingCode": "1234ABCD789"
    }
  ]
}

{
  "insertedIds": [
    "0195a178f96b7345ad27051c34609e52",
    "0195a3aea0447296bc5377d49ab95c1e"
  ],
  "skippedItems": []
}

GET /api/_action/shipment/5b6a139e54e54ed7b7997c71f6f56f9e

[
  {
    "lineItemId": "0195a3aea0447296bc5377d49ab95c1e",
    "quantityOrdered": 3,
    "shipments": [
      {
        "quantity": 1,
        "package": "Package 2",
        "trackingCode": "12334ASDAD9",
        "createdAt": "2025-05-22T14:36:12+00:00"
      }
    ]
  },
  {
    "lineItemId": "0195a178f96b7345ad27051c34609e52",
    "quantityOrdered": 4,
    "shipments": [
      {
        "quantity": 4,
        "package": "Package 6",
        "trackingCode": "DHL12sad31e279",
        "createdAt": "2025-05-22T14:36:12+00:00"
      }
    ]
  }
]

bin/build-administration.sh

bin/console cache:clear
bin/console plugin:refresh