API-Integration Setup: 1-2 Tage

WooCommerce × PrintHub — API-Integration mit voller Flexibilität

Wir bieten (noch) kein offizielles WooCommerce-Plugin — stattdessen bekommst du direkten Zugriff auf unsere REST API. Flexibler, schneller, zukunftssicher.

Überblick

Für WooCommerce-Shops setzen wir auf API-Integration statt auf ein Plugin. Das gibt dir volle Kontrolle über Logik, Mapping und Fehlerbehandlung — ohne dass du auf Plugin-Updates warten musst. Zwei Wege führen zum Ziel: ein eigener Webhook-Listener (PHP, Node.js, Python) oder Low-Code-Tools wie Zapier, Make oder Uncanny Automator.

Vorteile

Warum WooCommerce mit PrintHub?

Keine Vendor-Lock-in-Angst

Du besitzt den Integrationscode. Wenn sich unsere API ändert, passt du einmal eine Funktion an — ohne Plugin-Cycle.

Volle Logik-Kontrolle

Filter nach Kategorie, SKU, Versandklasse oder Meta-Feldern: Entscheide selbst, welche WooCommerce-Bestellungen an PrintHub gehen.

Gleiche API wie für Shopify-Partner

Du baust einmal den Integrations-Layer — und kannst ihn für andere Plattformen (eigene App, Mobile-Shop, B2B-Portal) wiederverwenden.

Sandbox-Modus für risikofreies Testen

Mit deinem pk_test_-Key simulierst du komplette Bestellungen, ohne dass ein Blatt Papier gedruckt wird.

Setup

In 1-2 Tage einsatzbereit

Schritt für Schritt von Null zur ersten automatisierten Bestellung.

  1. 01

    API-Key im PrintHub-Admin generieren

    Melde dich im Partner-Dashboard an und erstelle einen Sandbox-Key (pk_test_) plus einen Live-Key (pk_live_). Beide werden im Header X-API-Key mitgeschickt.

  2. 02

    WooCommerce-Webhook auf „Order Created" konfigurieren

    WooCommerce → Einstellungen → Erweitert → Webhooks. Event: „Bestellung erstellt" (oder „Bestellung bezahlt", je nach Use-Case). Ziel-URL ist dein eigener Endpoint oder ein Zapier-Hook.

  3. 03

    Translation-Layer implementieren

    Dein Endpoint empfängt das WooCommerce-JSON, mappt Varianten auf PrintHub-Produkt-IDs und ruft POST /api/orders auf. Fehler antwortest du mit HTTP 500 — WooCommerce versucht dann mehrfach erneut.

  4. 04

    Mit Sandbox-Key testen

    Gib im Endpoint pk_test_ an und lege eine Testbestellung an. Du bekommst eine Order-ID zurück, die im Sandbox-Dashboard sichtbar ist — ohne Druckauftrag.

  5. 05

    Auf Live-Key umstellen

    Tausche pk_test_ gegen pk_live_, lade dein Wallet auf und hinterlege eine Webhook-URL bei PrintHub, damit du Status-Updates (shipped, error) zurück in WooCommerce schreiben kannst.

Funktionen

Was diese Integration kann

  • REST API (JSON, OAuth-freier X-API-Key Header)
  • Bulk Orders: bis zu 20 Aufträge pro Request
  • Custom Fields und Meta-Daten werden durchgereicht
  • Sandbox Testing ohne Produktion
  • Rate Limit: 60 Requests pro Minute
  • HPOS- und WPML-kompatibel
Code-Beispiel

Direkt loslegen

Beispiel: WooCommerce Webhook "Order Created" an eigene Node.js-Function → PrintHub weiterleiten.

javascript api.print-hub.com
// Express-Handler (oder Vercel/Netlify/Cloudflare Worker)
// Empfängt WooCommerce Webhook "order.created" und leitet an PrintHub weiter

import express from 'express';

const app = express();
app.use(express.json());

app.post('/webhooks/woocommerce-order', async (req, res) => {
  const order = req.body;

  const items = order.line_items.map((line) => ({
    product_id: line.meta_data.find((m) => m.key === '_printhub_id')?.value,
    quantity: line.quantity,
    properties: {
      engraving: line.meta_data.find((m) => m.key === 'Gravur')?.value,
    },
  }));

  await fetch('https://api.print-hub.com/api/orders', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.PRINTHUB_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      external_id: String(order.id),
      customer: {
        name: `${order.shipping.first_name} ${order.shipping.last_name}`,
        street: order.shipping.address_1,
        zip: order.shipping.postcode,
        city: order.shipping.city,
        country: order.shipping.country,
      },
      items,
    }),
  });

  res.status(200).json({ ok: true });
});

app.listen(3000);
Häufige Fragen

Was Partner uns oft fragen

Gibt es ein offizielles WooCommerce-Plugin?
Nein, bewusst nicht. Ein Plugin muss jeden Edge-Case abdecken — was zu Bloat führt. Über unsere API baust du genau das, was du brauchst: einmalig 1–2 Tage Arbeit, danach wartungsarm.
Brauche ich einen eigenen Entwickler?
Für das initiale Setup: ja, ein Developer mit Node.js/Serverless-Erfahrung oder ein Automatisierungstool wie Make/Zapier. Die Integration läuft typisch als kleiner Webhook-Handler auf Vercel, Netlify, Cloudflare Workers oder AWS Lambda. Danach läuft sie vollautomatisch.
Funktioniert das mit WPML und mehrsprachigen Shops?
Ja. Unsere API erwartet Produkt-IDs, keine Namen — Sprache ist also irrelevant. Auch Versand an EU-Länder mit länderspezifischen Steuern läuft transparent.
Ist das mit HPOS (High-Performance Order Storage) kompatibel?
Ja. Unsere Beispielhooks nutzen die CRUD-API (wc_get_order), die für HPOS optimiert ist — keine Legacy-Post-Meta-Direktzugriffe.

Bereit, WooCommerce mit PrintHub zu verbinden?

Wir besprechen in einem 30-Minuten-Call dein Setup, Sortiment und Volumen — und schicken dich mit konkretem Fahrplan raus.