Wie stelle ich meine API-Integration auf den Druckbereich von 15" x 18" um?

Seit dem 17. Mai 2025 bietet Printful für ausgewählte DTG-Produkte einen größeren Standard-Frontdruckbereich von 15″ × 18″ an. Damit kannst du größere und auffälligere Designs in deinen Shop integrieren. Diese Anleitung zeigt dir, wie du deine API-Integration mit diesem Standard verknüpfst.

Welchen Platzierungsnamen sollte ich in der API verwenden?

Um den Druckbereich von 15″ × 18″ zu nutzen, musst du den Platzierungsnamen front_large in deinen API-Aufrufen verwenden. Der bisherige Platzierungsname front wurde für die Erstellung neuer Produkte im Printful-Katalog schrittweise abgeschafft, bleibt jedoch für bestehende Produkte, die vor der Umstellung erstellt wurden, weiterhin aktiv.

Wie wirkt sich diese Änderung auf meine Produkte aus?

Bestimme zunächst, wie sich diese Änderung auf deine neuen und bestehenden Produkte auswirkt. 

Für deine bestehenden Produkte: 

• Es ist keine sofortige Maßnahme erforderlich. Deine aktuellen Produkte mit der Front-Platzierung werden weiterhin verkauft, und wir bearbeiten Bestellungen wie gewohnt.
• Wenn du ein bestehendes Produkt bearbeitest, aktualisiert unser System seine Platzierung automatisch auf front_large. Dann solltest du die Skalierung und Auflösung (DPI) deines Designs überprüfen, damit es im größeren Bereich von 15" x 18" optimal aussieht.
• Das Upgrade ist optional. Wenn du den größeren Druckbereich für bestehende Artikel nutzen möchtest, aktualisiere einfach die Platzierungsinformationen des Produkts. 

Für neue Produkte, die du erstellst: 

• Nach dem 17. Mai 2025 musst du front_large für alle neuen Produkte mit Frontdruck verwenden. Die Front-Platzierung ist für betroffene Artikel im Printful-Katalog nicht mehr verfügbar. 

Aktualisiere deine API-Aufrufe

Als Nächstes musst du wissen, wo du den neuen Platzierungsnamen front_large in deinem Code implementieren musst. Du kannst bestätigen, dass der neue Platzierungsname verfügbar ist, indem du ein bestimmtes Produkt aus dem Katalog abrufst: 

• In API V1 prüfst du unter: Result > Product > Files > Type
• In API V2 prüfst du unter: Data > Placements 

Hier musst du front_large in deinen API-Anfragen verwenden: 

API V1-Implementierung: 

• Zum Erstellen eines neuen Sync-Produkts: gib die Platzierung im Request-Body unter Sync_variants > Files > Type an
• Zum Erstellen einer neuen Bestellung: gib die Platzierung im Request-Body unter Items > Files > Type an
• Zum Erstellen einer Mockup-Generierungsaufgabe: gib die Platzierung im Request-Body unter Files > Placement an

API V2-Implementierung: 

• Zum Erstellen einer neuen Bestellung: gib die Platzierung im Request-Body unter Order_items > Placements > Placement an
• Zum Erstellen eines Mockups: gib die Platzierung im Request-Body unter Products > Placements > Placement  an

Wenn du diese Schritte befolgst, ist deine API-Integration vollständig auf den Wechsel zu unseren neuen, größeren DTG-Druckplatzierungen vorbereitet. 

Hier erfährst du mehr über die Änderung der Druckplatzierung und die betroffenen Produkte