Zum Hauptinhalt springen

PrestaShop

Verfügbar

Diese Integration ist aktiv und bereit zur Nutzung in allen Pro-Plänen.

Verbinde deinen PrestaShop-Store mit Frihet. Importiere Produkte und Bestellungen direkt über die Webservice-API.

Wozu dient es?​

Mit integriertem PrestaShop:

  • Bestellungen importieren — Die Bestellungen deines Shops werden in Frihet zu Rechnungen
  • Produkte importieren — Übertrage deinen PrestaShop-Katalog, um die Verwaltung zu vereinheitlichen
  • Synchronisierte Daten — Preise, Mengen, Referenzen und Status werden automatisch importiert

Voraussetzungen​

  • PrestaShop 1.7 oder höher — Mit aktiviertem Webservice
  • API-Schlüssel — Generiert aus dem Administrationsbereich
  • HTTPS erforderlich — Dein Shop muss ein SSL-Zertifikat haben
  • Frihet Pro oder höher

Verbindung einrichten​

Schritt 1: Generiere einen API-Schlüssel in PrestaShop​

  1. Gehe in deinem PrestaShop-Administrationsbereich zu Erweiterte Parameter → Webservice
  2. Klicke auf Neuen Schlüssel hinzufügen
  3. Aktiviere die Leseberechtigungen (GET) für:
    • products — Zum Importieren von Produkten
    • orders — Zum Importieren von Bestellungen
    • customers — Für Kundendaten
  4. Kopiere den generierten Schlüssel

Schritt 2: In Frihet verbinden​

  1. Gehe in Frihet zu Einstellungen → Integrationen
  2. Suche PrestaShop und klicke darauf
  3. Gib die URL deines Shops ein (z.B.: https://mitienda.com)
  4. Füge den API-Schlüssel ein
  5. Klicke auf Verbindung testen, um sie zu überprüfen
  6. Wenn korrekt, klicke auf Speichern

Daten importieren​

Produkte importieren​

  1. Gehe zu Einstellungen → Integrationen → PrestaShop → Tab Daten
  2. Klicke auf Produkte importieren
  3. Frihet importiert alle aktiven Produkte deines Shops
  4. Duplizierte Produkte (gleiche SKU oder Name) werden automatisch übersprungen

Bestellungen importieren​

  1. Klicke auf dem gleichen Tab Daten auf Bestellungen importieren
  2. Der erste Import holt die Bestellungen der letzten 30 Tage
  3. Die folgenden Importe holen nur die neuen Bestellungen seit der letzten Synchronisierung
  4. Jede Bestellung generiert eine Rechnung im Format PS-{id}

Importierte Daten​

Produkte​

PrestaShop-DatenFrihet-Daten
NameProduktname
ReferenzSKU
Preis (ohne Steuern)Stückpreis
KurzbeschreibungBeschreibung
Aktiv (ja/nein)Aktiv/inaktiv-Status

Bestellungen​

PrestaShop-DatenFrihet-Daten
Bestell-IDRechnungsnummer (PS-{id})
BestelldatumAusstellungsdatum
Bestellte ProdukteRechnungspositionen
MengeMenge
Stückpreis (ohne MwSt.)Stückpreis
BestellreferenzRechnungsnotizen

Reales Beispiel​

Bestellung in PrestaShop​

Bestellung #4521 - 18. Feb 2026
- 3x Basic T-Shirt (Ref: CAM-001) @ €15 = €45
- 1x Premium Sweatshirt (Ref: SUD-010) @ €45 = €45
Gesamt: €90 + €18,90 MwSt. (21%) = €108,90

In Frihet nach dem Import​

Rechnung PS-4521
Datum: 18. Feb 2026
- 3x Basic T-Shirt @ €15 = €45
- 1x Premium Sweatshirt @ €45 = €45
Zwischensumme: €90,00
MwSt. (21%): €18,90
Gesamt: €108,90
Status: Bezahlt

Unterschiede zu WooCommerce​

MerkmalPrestaShopWooCommerce
VerbindungstypAPI-Schlüssel (Webservice)Consumer Key + Secret
Echtzeit-SyncNein (manueller Import)Ja (Webhooks)
RichtungPrestaShop → FrihetWooCommerce → Frihet
RechnungsformatPS-{id}WC-{number}

Einschränkungen​

  • Manueller Import — Bestellungen werden nicht in Echtzeit synchronisiert. Du musst regelmäßig auf "Bestellungen importieren" klicken
  • Nur lesend — Frihet importiert Daten von PrestaShop, schreibt aber nicht zurück
  • Keine Adressdaten auf Rechnungen — Die Versanddaten der Bestellung werden nicht zum Kunden übertragen (demnächst)

Fehlerbehebung​

"Verbindungsfehler beim Testen"​

  • Überprüfe, ob die URL korrekt ist und https:// verwendet
  • Stelle sicher, dass der Webservice in PrestaShop aktiviert ist
  • Überprüfe, ob der API-Schlüssel Leseberechtigungen für products, orders und customers hat
  • Wenn du eine Firewall oder .htaccess verwendest, stelle sicher, dass sie /api/ nicht blockiert

"Nicht alle Produkte werden importiert"​

  • Es werden nur aktive Produkte (Status = 1) importiert
  • Produkte mit der gleichen SKU oder dem gleichen Namen, die bereits existieren, werden übersprungen (Deduplizierung)

"Bestellungen werden nicht angezeigt"​

  • Der erste Import holt nur die letzten 30 Tage
  • Überprüfe, ob die Bestellungen den Status "in Bearbeitung" oder höher haben
  • Klicke erneut auf "Bestellungen importieren", wenn neue eingegangen sind

"Kann ich die Verbindung trennen, ohne Daten zu verlieren?"​

Ja. Die bereits importierten Produkte und Rechnungen bleiben in Frihet. Das Trennen verhindert lediglich neue Importe.

Zum Trennen:

  1. Gehe zu Einstellungen → Integrationen → PrestaShop → Tab Konfiguration
  2. Klicke auf Trennen
  3. Bestätige

Nächste Schritte​