QUELL-CODE
API & Entwickler

Binde deinen Shop an

Binde deinen Shop — in jeder Programmiersprache — an das ERP an: ein Shop-API-Key und die untenstehenden REST-Endpunkte. Kein Plugin, keine Installation im Shop.

1. Authentifizierung

Jeder Shop — egal in welcher Sprache (PHP, Node, Python, .NET, Ruby …) — bindet identisch an: EIN Shop-API-Key + die untenstehenden Endpunkte. Kein Plugin, keine Installation im Shop.

Deinen persönlichen Shop-API-Key erzeugst du nach der Registrierung im Panel unter „Kanäle“. In den Beispielen unten steht dafür der Platzhalter DEIN_SHOP_KEY.

Header bei jedem Aufruf: X-Shop-Key: DEIN_SHOP_KE… · Basis-URL: https://demo.script-tech.de/api/shop

2. Bestellung senden (Shop → ERP)

Im Checkout deines Shops aufrufen, sobald eine Bestellung entsteht. Kunde wird per E-Mail zugeordnet/angelegt, Artikel per SKU. external_id verhindert Doppel-Import (409).

curl -X POST https://demo.script-tech.de/api/shop/orders \
  -H "X-Shop-Key: DEIN_SHOP_KEY" -H "Content-Type: application/json" \
  -d '{
    "external_id": "BESTELL-123",
    "payment_status": "paid", "payment_method": "paypal", "currency": "EUR",
    "shipping_amount": 4.90, "discount_amount": 0,
    "customer": {"first_name":"Max","last_name":"Muster","email":"max@shop.de",
                 "street":"Weg 1","zip_code":"10115","city":"Berlin","country":"DE"},
    "items": [{"sku":"ART-1","quantity":2,"unit_price_net":19.90}]
  }'

Antwort: { status:"created", order_number, total_gross }

Varianten (optional): Unbekannte/neue Artikel werden immer automatisch angelegt — der Import bricht nie. Schickst du je Position zusätzlich "variant_attributes": {"Farbe":"Rot","Größe":"L"} und "parent_sku": "TSHIRT", werden die Varianten automatisch unter EINEM Vater-Artikel gruppiert (Farbe/Größe werden übernommen). Ohne diese Felder = flacher Artikel.

3. Bestände abrufen (ERP → Shop)

Regelmäßig aufrufen (z. B. per Cron alle 5–15 Min.), um die Lagerbestände im Shop aktuell zu halten.

curl https://demo.script-tech.de/api/shop/stock -H "X-Shop-Key: DEIN_SHOP_KEY"
# → [{"sku":"ART-1","quantity":42}, ...]

Weitere GET-Endpunkte: /products (Artikel), /orders/{id} (Status/Rechnungsnr.), /orders/{id}/invoice (Rechnung-PDF).

4. Benachrichtigungen empfangen (ERP → Shop Webhook)

Trage im Panel unter Kanäle deine Webhook-URL ein. Der ERP schickt dorthin automatisch bei: versendet, verpackt, Rechnung erstellt.

# ERP ruft DEINEN Endpunkt auf (versendet/verpackt/Rechnung):
# POST https://mein-shop.de/erp-webhook
# Body: { "external_id":"BESTELL-123", "event":"shipped",
#         "status":"shipped", "tracking_number":"...", "invoice_number":"RE-2026-00042" }

5. Fertige Konnektoren (kein Code nötig)

Für Standard-Plattformen gibt es fertige Anbindungen unter Kanäle — nur API-Schlüssel eintragen:

✓ Amazon SP-API
✓ eBay
✓ WooCommerce
✓ Shopify
✓ Shopware 6
✓ DHL/DPD/Hermes/GLS/UPS
✓ PayPal/Stripe/Klarna/Mollie

Bereit zum Anbinden?

Erstelle deinen Zugang und generiere den Shop-API-Key.

Kostenlos registrieren