# PrestaShop verbinden

PrestaShop wird über die standardisierte **API2Cart-Schnittstelle** angebunden. Sie benötigen nur einen einzigen **Webservice-Key**, den Sie im PrestaShop-Backend erzeugen und anschließend in SendDrop hinterlegen.

{% hint style="info" %}
**Video-Anleitung:** Eine kurze Schritt-für-Schritt-Demo zur Anbindung finden Sie hier: [Loom-Video PrestaShop ↗](https://www.loom.com/share/3d15c8965a3647f78af49a08e05c8416)
{% endhint %}

***

### Voraussetzungen

* **PrestaShop 1.7 oder 8.x** (aktuelle Version empfohlen).
* Admin-Zugriff auf Ihr **PrestaShop-Backend**.
* Eine öffentlich erreichbare **Shop-URL**, z. B. `https://meinshop.at`.
* Das **Webservice-Modul** in PrestaShop muss aktiv sein (ist in den meisten Installationen Standard).

{% hint style="warning" %}
**HTTPS ist Pflicht.** Ihr Shop muss über ein gültiges SSL-Zertifikat erreichbar sein.
{% endhint %}

***

### Schritt 1: Webservice-Key in PrestaShop anlegen

{% stepper %}
{% step %}

#### Webservice-Bereich öffnen

Im PrestaShop-Backend: **Erweiterte Einstellungen → Webservice**.
{% endstep %}

{% step %}

#### Webservice aktivieren

Stellen Sie sicher, dass **„Aktiviere den Webservice von PrestaShop"** auf **Ja** steht.
{% endstep %}

{% step %}

#### Neuen Schlüssel erstellen

Klicken Sie auf das **„+"-Symbol** (neuen Webservice-Key hinzufügen).
{% endstep %}

{% step %}

#### Berechtigungen vergeben

* **Schlüsselbeschreibung:** z. B. `SendDrop`
* **Status:** Aktiviert
* **Berechtigungen:** SendDrop benötigt Lese- und Schreibrechte auf Bestellungen, Kunden, Adressen und Order-States. Am einfachsten ist es, **alle Ressourcen mit Lese-/Schreibzugriff** zu aktivieren.
  {% endstep %}

{% step %}

#### Speichern & Key kopieren

PrestaShop zeigt den generierten **Webservice-Key** an. Kopieren Sie ihn – Sie benötigen ihn gleich in SendDrop.
{% endstep %}
{% endstepper %}

\[BILD-068 – Bild einfügen, welches Folgendes darstellt: PrestaShop-Backend mit dem Webservice-Bereich und dem neu generierten Webservice-Key.]

***

### Schritt 2: Shop in SendDrop anlegen

{% stepper %}
{% step %}

#### „Neuer Shop" öffnen

Unter **Einstellungen → Shops → „Neuer Shop"** oder direkt im Onboarding.
{% endstep %}

{% step %}

#### PrestaShop auswählen

In der Systemauswahl **PrestaShop** wählen.
{% endstep %}

{% step %}

#### Zugangsdaten eingeben

| Feld               | Wert                                     |
| ------------------ | ---------------------------------------- |
| **Shop-URL**       | `https://meinshop.at` (inkl. `https://`) |
| **Webservice Key** | Der in Schritt 1 erzeugte Schlüssel      |
| {% endstep %}      |                                          |

{% step %}

#### Validierung

SendDrop prüft die Zugangsdaten über die API2Cart-Verbindung. Bei Erfolg erscheint ein grüner Haken.
{% endstep %}

{% step %}

#### Standards wählen

Legen Sie **Standard-Marke** (Absenderadresse) und **Standard-Carrier** fest.
{% endstep %}

{% step %}

#### Fertig

Die erste Synchronisation startet automatisch. Neue Bestellungen erscheinen danach live in SendDrop.
{% endstep %}
{% endstepper %}

***

### Was wird synchronisiert?

| Datenpunkt                                              | Richtung                                    |
| ------------------------------------------------------- | ------------------------------------------- |
| **Bestellungen** (Empfänger, Positionen, Gewicht)       | PrestaShop → SendDrop                       |
| **Tracking-Nummer**                                     | SendDrop → PrestaShop (am Bestelldatensatz) |
| **Versandstatus** (z. B. „In Bearbeitung", „Versendet") | SendDrop → PrestaShop                       |
| **Produkte / Lagerbestand**                             | nicht synchronisiert                        |

{% hint style="success" %}
**Tracking-Rücksync:** Sobald Sie in SendDrop ein Label erzeugen, schreibt SendDrop die **Tracking-Nummer** automatisch in die PrestaShop-Bestellung und setzt deren Status auf **„Versendet"**. Ihre Kunden bekommen damit (sofern in PrestaShop konfiguriert) automatisch die Versandbestätigungs-E-Mail mit Tracking-Link.
{% endhint %}

***

### Fehlerbehebung

<details>

<summary><strong>„Verbindung fehlgeschlagen" – Webservice-Key korrekt, trotzdem keine Verbindung</strong></summary>

Häufige Ursachen:

1. **Shop-URL ohne `https://`** – bitte vollständig eingeben.
2. **Webservice nicht aktiviert** – in PrestaShop unter **Erweiterte Einstellungen → Webservice** auf „Ja" setzen.
3. **Berechtigungen zu eingeschränkt** – dem Key alle Lese-/Schreibrechte auf relevanten Ressourcen geben.
4. **Firewall / Security-Plugin** blockiert externe API-Anfragen – SendDrop-Zugriff erlauben.
5. **Wartungsmodus aktiv** – Shop muss öffentlich erreichbar sein.

</details>

<details>

<summary><strong>Bestellungen erscheinen verzögert oder gar nicht</strong></summary>

Klicken Sie manuell auf **„Alle synchronisieren"** in der Bestell-Übersicht. Wenn auch das keine Daten zieht, prüfen Sie in PrestaShop unter **Bestellungen**, ob die fraglichen Einträge dort tatsächlich als bezahlte Bestellung markiert sind. Bestellungen mit Status „Cart" oder „Awaiting payment" werden in der Regel nicht importiert.

</details>

<details>

<summary><strong>Tracking-Nummer wird nicht in PrestaShop angezeigt</strong></summary>

Prüfen Sie, ob der Webservice-Key Schreibrechte auf die Ressourcen **`orders`** und **`order_carriers`** besitzt. Ohne diese Rechte kann SendDrop die Tracking-Nummer zwar erzeugen, aber nicht zurück in PrestaShop schreiben.

</details>

***

### Häufige Fragen

<details>

<summary>Welche PrestaShop-Versionen werden unterstützt?</summary>

PrestaShop **1.7** und **8.x**. Ältere Versionen werden nicht mehr aktiv unterstützt.

</details>

<details>

<summary>Werden Multi-Shop-Installationen unterstützt?</summary>

Ja. Bestellungen aus mehreren Shops derselben PrestaShop-Multistore-Installation werden gemeinsam importiert. Sie können sie in SendDrop nach Shop-Name oder Referenz filtern.

</details>

<details>

<summary>Was passiert, wenn ich den Webservice-Key in PrestaShop lösche?</summary>

Die Verbindung in SendDrop schlägt ab diesem Zeitpunkt fehl. Erzeugen Sie einen neuen Key in PrestaShop und aktualisieren Sie ihn in SendDrop unter **Einstellungen → Shops → Shop bearbeiten**.

</details>

<details>

<summary>Können mehrere PrestaShops parallel verbunden werden?</summary>

Ja. Jeder PrestaShop wird als eigene Verbindung gepflegt und hat eigene Standards (Marke, Carrier).

</details>

***

{% hint style="info" %}
**Brauchen Sie Hilfe?** Unser Support-Team hilft Ihnen gerne weiter: <support@senddrop.com> oder über den Chat unten rechts in Ihrem Dashboard.
{% endhint %}

***

### Siehe auch

{% content-ref url="/pages/afzpYobkmkiQzWB9jB1n" %}
[Shop-Anbindung: Überblick](/2.-ihren-shop-verbinden/ueberblick.md)
{% endcontent-ref %}

{% content-ref url="/pages/34mLRZ7tylkvsQmfTkIU" %}
[Häufige Probleme bei der Shop-Anbindung](/2.-ihren-shop-verbinden/haeufige-probleme.md)
{% endcontent-ref %}

{% content-ref url="/pages/h7CIjXXtG4ZsjeFkUNMd" %}
[Carrier pro Shop automatisch festlegen](/4.-versanddienstleister/carrier-pro-shop.md)
{% endcontent-ref %}


---

# 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://wiki.senddrop.com/2.-ihren-shop-verbinden/prestashop.md?ask=<question>
```

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.