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.
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.
In 1-2 Tage einsatzbereit
Schritt für Schritt von Null zur ersten automatisierten Bestellung.
- 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`.
- 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.
- 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.
- 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.
- 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.
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
Direkt loslegen
So ruft PrintHub neue Bestellungen aus deinem Etsy-Shop ab und meldet die DHL-Tracking-Nummer zurück (passiert automatisch im Hintergrund).
// 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,
}),
},
); Was Partner uns oft fragen
Brauche ich Commercial API Access bei Etsy?
Was ist mit Etsys Rate Limits?
Wie werden Etsy-Personalisierungen (Wunschnamen, Texte) übertragen?
Wie läuft das mit Retouren?
Welche Carrier werden für Tracking unterstützt?
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.