API-Integration Setup: 1-2 Tage

Etsy × PrintHub — Fulfillment über die Etsy Open API

Seit 2022 hat Etsy eine vollwertige REST-API (Open API v3). Wir ziehen neue Bestellungen automatisch, produzieren in Hamburg und pushen die Tracking-Nummer via createReceiptShipment zurück an Etsy.

Überblick

Etsys Open API v3 bietet vollen Zugriff auf Receipts (Bestellungen), Transaktionen und Versand-Tracking. PrintHub nutzt OAuth 2.0 für den sicheren Zugriff, holt neue Bestellungen per `getShopReceipts` und liefert nach der Produktion die Tracking-Nummer über `createReceiptShipment` zurück. Du hinterlegst PrintHub zusätzlich als offiziellen „Production Partner" in deinem Shop — das erfüllt Etsys Transparenzrichtlinien und baut Käufervertrauen auf.

Vorteile

Warum Etsy mit PrintHub?

Vollautomatisch über Etsy Open API v3

Kein CSV-Chaos, kein Zapier nötig. Direkter OAuth-Draht zwischen deinem Etsy-Shop und PrintHub — Bestellungen fließen innerhalb von Minuten in die Produktion.

Tracking-Rückmeldung an Etsy automatisch

Sobald DHL die Sendung abholt, schicken wir die Tracking-Nummer mit dem passenden Carrier-Code via `createReceiptShipment` an Etsy. Käufer sehen den Status im Etsy-Dashboard.

Made in Germany für Etsy-DE-Compliance

Etsy verlangt Transparenz über Produktionsort. „Made in Germany" ist ein Verkaufsargument — und für EU-Käufer rechtlich sauberer als Asien-Dropshipping.

DSGVO-konform mit EU-Versand

Alle Kundendaten liegen auf Servern in Deutschland. DHL-Versand innerhalb der EU in 2–4 Werktagen — ohne Zoll, ohne Mehrwertsteuer-Chaos.

Setup

In 1-2 Tage einsatzbereit

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

  1. 01

    Etsy Developer-Account und App anlegen

    Registriere dich auf developers.etsy.com und lege eine App an. Du bekommst einen API-Key (`x-api-key` Header) und kannst OAuth-Scopes konfigurieren. Für Fulfillment brauchst du `transactions_r` und `transactions_w`.

  2. 02

    OAuth 2.0-Flow mit PrintHub verbinden

    PrintHub stellt einen Connector bereit, der den OAuth-Flow mit deinem Etsy-Shop abwickelt. Nach Freigabe in Etsy ist der Shop verbunden — Access- und Refresh-Token werden verschlüsselt in deinem PrintHub-Account gespeichert.

  3. 03

    Produkte und SKUs mappen

    In deinem PrintHub-Dashboard ordnest du Etsy-Listings den passenden PrintHub-Produkten zu. Custom-Personalisierungsfelder (Wunschtext, Design-URL, Name) werden aus Etsys `variations` und `personalization` automatisch übernommen.

  4. 04

    Production Partner bei Etsy hinterlegen

    Gehe in deinem Etsy-Shop auf Shop-Manager → Einstellungen → Production Partner und trage PrintHub ein. Das erfüllt Etsys Transparenzrichtlinien und ist für personalisierte Produkte Pflicht.

  5. 05

    Automatischer Order-Sync aktivieren

    PrintHub pollt `getShopReceipts` im 5-Minuten-Takt (oder per Webhook, wenn verfügbar). Neue Bestellungen landen automatisch im Fulfillment — Tracking wird nach Versand via `createReceiptShipment` an Etsy zurückgemeldet.

Funktionen

Was diese Integration kann

  • Etsy Open API v3 mit OAuth 2.0
  • Automatischer Receipt-Abruf (`getShopReceipts`)
  • Tracking-Rückmeldung via `createReceiptShipment`
  • Custom-Personalisierungsfelder aus Etsy-Variations
  • Etsy-Production-Partner-Listing inkl. Logo und Beschreibung
  • Optionale Commercial-API-Approval-Unterstützung
Code-Beispiel

Direkt loslegen

So ruft PrintHub neue Bestellungen aus deinem Etsy-Shop ab und meldet die DHL-Tracking-Nummer zurück (passiert automatisch im Hintergrund).

javascript api.print-hub.com
// Teil 1: Neue, unversandte Bestellungen aus Etsy abholen
const receipts = await fetch(
  `https://openapi.etsy.com/v3/application/shops/${shopId}/receipts?was_shipped=false&limit=25`,
  {
    headers: {
      'x-api-key': process.env.ETSY_APP_KEY,
      Authorization: `Bearer ${accessToken}`,
    },
  },
).then((r) => r.json());

// → PrintHub legt die Bestellungen automatisch an (POST /api/orders)

// Teil 2: Nach Produktion & DHL-Versand — Tracking zurück an Etsy melden
await fetch(
  `https://openapi.etsy.com/v3/application/shops/${shopId}/receipts/${receiptId}/tracking`,
  {
    method: 'POST',
    headers: {
      'x-api-key': process.env.ETSY_APP_KEY,
      Authorization: `Bearer ${accessToken}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      tracking_code: '00340434161094015901',
      carrier_name: 'dhl-germany',
      send_bcc: true,
    }),
  },
);
Häufige Fragen

Was Partner uns oft fragen

Brauche ich Commercial API Access bei Etsy?
Für bis zu 5 eigene Shops reicht Personal Access. Wenn PrintHub als Third-Party-App für mehrere unabhängige Seller bereitstehen soll, wäre Commercial Access nötig — das beantragen wir gerade bei Etsy. Für Einzelshops läuft das heute schon.
Was ist mit Etsys Rate Limits?
Etsy erlaubt standardmäßig 10 Requests/Sekunde und 10.000/Tag pro App. PrintHub pollt nur alle 5 Minuten und bündelt Schreiboperationen — Limits sind kein Engpass.
Wie werden Etsy-Personalisierungen (Wunschnamen, Texte) übertragen?
Etsy liefert sie als `personalization` und `variations` in jedem Receipt-Transaction-Item. Wir mappen sie automatisch auf PrintHubs Custom-Fields (line1–line10, motiv1–motiv5) entsprechend deiner Produkt-Konfiguration.
Wie läuft das mit Retouren?
Retouren gehen direkt an PrintHub in Hamburg. Bei Produktionsfehler volle Erstattung, bei Kundenrückgaben greift deine Etsy-Rückgaberichtlinie. Refund-Transaktionen auf Etsy-Seite machst du selbst — wir stornieren nur die Produktionskosten.
Welche Carrier werden für Tracking unterstützt?
DHL Germany (`dhl-germany`), DHL Express (`dhl-express`), Deutsche Post (`deutsche-post`). Etsys Carrier-Liste umfasst über 200 Anbieter — alle, die PrintHub anbietet, sind dabei.

Bereit, Etsy mit PrintHub zu verbinden?

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