API-Integration Setup: Tage (Middleware) bis Wochen (eigenes Approval)

Amazon × PrintHub — drei realistische Wege zum POD-Fulfillment

Amazons SP-API liefert Versandadressen und Personalisierungsdaten nur mit genehmigten „Restricted Roles" — der Prozess ist anspruchsvoll, aber machbar. Wir zeigen dir die drei Pfade: Middleware, Reports-API und eigenes Approval.

Überblick

Amazon behandelt Versanddaten und Personalisierungsinformationen (BuyerCustomizedInfo) als „Personally Identifiable Information" (PII). Zugriff darauf verlangt eine genehmigte Restricted Role — insbesondere „Direct-to-Consumer Shipping". Das gilt auch für Self-Authorized Private Apps: der Architecture Review entfällt, die Rollen-Genehmigung bleibt Pflicht. Es gibt drei praktikable Wege, die wir je nach Volumen und Setup empfehlen.

Vorteile

Warum Amazon mit PrintHub?

Personalisierte Produkte auf Amazon verkaufen

Über Amazon Custom, Brand Registry oder eigenes Listing mit Gravur-Service — Fulfillment via PrintHub ohne Lagerbestand. Personalisierung kommt entweder aus BuyerCustomizedInfo oder aus Variations.

Drei gangbare Wege, kein Vendor Lock-in

Du entscheidest: Middleware wie Billbee oder ShipStation (schnell, monatliche Gebühr), Reports-API mit eingeschränktem PII-Bedarf oder Direct-to-Consumer-Shipping-Role bei Amazon. Wir unterstützen alle drei Varianten.

SFP-kompatibel für Prime-Badge

DHL-Standardversand innerhalb von 1–2 Werktagen aus Hamburg erfüllt die Seller-Fulfilled-Prime-SLAs für Deutschland und die Kern-EU-Märkte.

Orders API v2026-01-01 kompatibel

In Amazons neuer Orders-API-Version sind Restricted Data Tokens (RDT) nicht mehr erforderlich — Zugriff erfolgt rollenbasiert. Das reduziert den technischen Overhead signifikant. Rollen-Approval bleibt aber Pflicht.

Setup

In Tage (Middleware) bis Wochen (eigenes Approval) einsatzbereit

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

  1. 01

    Weg 1: Middleware mit bestehendem PII-Zugriff (empfohlen zum Start)

    Tools wie Billbee, ShipStation, Sellercloud oder Linnworks sind bereits bei Amazon als PII-berechtigte Drittanbieter zertifiziert. Du verbindest Amazon Seller Central mit der Middleware und diese gibt die Bestelldaten (inklusive Customization) per Webhook oder API an unsere POST /api/orders weiter. Setup ca. 1 Tag, laufende Gebühr je nach Anbieter.

  2. 02

    Weg 2: Reports-API für eingeschränkte Anwendungsfälle

    Für Standardprodukte ohne Personalisierung reicht oft der Report GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL — aber auch dieser enthält PII und erfordert eine Restricted Role. Für Amazon Custom kann GET_AMAZON_CUSTOM_PRODUCT_REPORT teilweise Customization-Daten liefern. Check im Einzelfall erforderlich.

  3. 03

    Weg 3: Direct-to-Consumer-Shipping-Role bei Amazon beantragen

    Für höhere Volumen langfristig der sauberste Weg. Im Developer-Profile beantragst du die Restricted Role „Direct-to-Consumer Shipping" mit detailliertem Data Protection Plan (DSGVO, Verschlüsselung, Löschfristen, Zugriffskontrollen). Referenzen auf ISO 27001, SOC 2 oder NIST erhöhen die Chancen. Der Prozess dauert typischerweise 4–12 Wochen, inkl. Rückfragen und iterativer Nachbesserung.

  4. 04

    PrintHub API-Key erstellen und Mapping einrichten

    Unabhängig vom gewählten Weg: im Partner-Dashboard einen pk_live_-Key generieren, Webhook-URL für Status-Updates (order.shipped, order.error) konfigurieren und Amazon-ASINs oder SKUs zu PrintHub-Produkten mappen.

  5. 05

    Tracking-Pushback an Amazon

    Nach Versand sendet PrintHub einen order.shipped-Webhook. Deine Middleware ruft submitFeed (FulfillmentShipmentFeed) in der SP-API auf. Das Schreiben selbst ist weniger restriktiv als das Lesen von PII — für Feed-Submission reicht meist der normale App-Zugriff.

Funktionen

Was diese Integration kann

  • Drei dokumentierte Integrationspfade (Middleware / Reports / eigenes Role-Approval)
  • Kompatibel mit Billbee, ShipStation, Sellercloud, Linnworks, Customily
  • Orders API v2026-01-01 ready — ohne RDT-Token-Handling
  • Unterstützung beim Data Protection Plan für Role-Approval
  • SFP-Ready mit DHL-SLA-Konformität (1–2 Werktage DE)
  • Retour-Handling über Amazons regulären Return-Flow
Code-Beispiel

Direkt loslegen

Beispiel für Weg 1: Middleware (Billbee) ruft PrintHub-API mit fertigen Bestelldaten auf — du musst selbst keine PII bei Amazon beantragen.

javascript api.print-hub.com
// Webhook-Handler in deiner Middleware (Billbee, ShipStation, eigene Lambda)
// Die Middleware hat bereits Amazon-PII-Zugriff — wir bekommen nur fertige Bestellungen

export async function handleAmazonOrder(billbeeOrder) {
  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: billbeeOrder.orderNumber,    // Amazon-Order-ID
      customer: {
        name: billbeeOrder.buyer.name,          // Kommt aus Billbee, nicht direkt aus SP-API
        street: billbeeOrder.shipping.street,
        zip: billbeeOrder.shipping.zip,
        city: billbeeOrder.shipping.city,
        country: billbeeOrder.shipping.country,
      },
      items: billbeeOrder.items.map((item) => ({
        product_id: mapAsinToPrinthub(item.asin),
        quantity: item.quantity,
        properties: {
          engraving: item.customization,        // BuyerCustomizedInfo via Middleware
        },
      })),
    }),
  });
}
Häufige Fragen

Was Partner uns oft fragen

Kann ich die PII-Restricted-Role bei Amazon umgehen?
Nicht komplett, aber du kannst sie delegieren: PII-zertifizierte Middleware wie Billbee oder ShipStation hält das Approval bereits und gibt dir die fertigen Bestelldaten weiter — du rufst die SP-API dann nie selbst mit PII auf. Self-Authorized Private Apps umgehen nur das Architecture Review, nicht die Rollen-Genehmigung für PII-Zugriff.
Wie komme ich an die Personalisierungsdaten (BuyerCustomizedInfo)?
BuyerCustomizedInfo wird von Amazon als PII klassifiziert und nur mit genehmigter Restricted Role ausgeliefert. Drei praktikable Wege: (1) Middleware wie Customily oder Billbee, die den Zugriff bereits haben, (2) GET_AMAZON_CUSTOM_PRODUCT_REPORT im Einzelfall prüfen, (3) eigenes Approval beantragen — siehe nächste Frage.
Wie läuft das Approval für Direct-to-Consumer Shipping ab?
Du aktualisierst dein Developer-Profile in Seller Central mit Use Case („personalisierte Produktion, Direktversand an Endkunden"), detailliertem Data Protection Plan (DSGVO, Verschlüsselung, Löschfristen, Zugriffskontrollen) und Verweisen auf ISO 27001, SOC 2 oder NIST-Standards. Amazon prüft 4–12 Wochen, häufig mit Rückfragen. Wir unterstützen beim Draft — sprich uns im Beratungsgespräch darauf an.
Was bringt die neue Orders API v2026-01-01?
In der neuen Version ist der Restricted Data Token (RDT) nicht mehr erforderlich — Zugriff läuft rein rollenbasiert. Das spart einen technischen Extra-Schritt pro Call. Die Restricted Role selbst (Direct-to-Consumer Shipping) bleibt trotzdem Voraussetzung für PII-Daten.
Brauche ich Amazon Seller Central?
Ja, ein aktives Seller-Central-Konto ist Voraussetzung. Für Weg 1 (Middleware) reicht das aus. Für Weg 3 (eigenes Approval) zusätzlich ein Developer-Account in der Entwicklerzentrale und die genehmigten Restricted Roles.
Kann ich Prime-Versand (SFP) anbieten?
Ja. Wir erfüllen die SFP-SLAs für Deutschland — Produktion und DHL-Versand innerhalb von 1–2 Werktagen. Amazons Prime-Badge hängt von deiner persönlichen SFP-Freischaltung ab.
Wie laufen Retouren?
Über Amazons regulären Return-Flow. Der Kunde schickt an deine Returns-Adresse (entweder dein Lager oder PrintHub Hamburg). Bei Produktionsfehlern ersetzen wir kostenlos.

Bereit, Amazon mit PrintHub zu verbinden?

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