Wie stelle ich meine API-Integration auf den Druckbereich 15″ × 18″ um?

Seit dem 17. Mai 2025 bietet Printful für ausgewählte DTG-Artikel (Direct-To-Garment-Druck) einen größeren standardmäßigen Druckbereich auf der Vorderseite von 15″ × 18″ an. So kannst Du größere und auffälligere Designs in Deinen Store integrieren. In dieser Anleitung erfährst Du, 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 verwenden, musst Du in Deinen API-Aufrufen den Platzierungsnamen front_large verwenden. Der veraltete Platzierungsname front wird bei der Erstellung neuer Produkte im Printful-Katalog nicht mehr unterstützt. Für bestehende Produkte, die vor der Umstellung erstellt wurden, ist er jedoch weiterhin aktiv.

Wie wirkt sich diese Änderung auf meine Produkte aus?

Prüfe zunächst, wie sich diese Änderung auf Deine neuen und bestehenden Produkte auswirkt. 

Für Deine bestehenden Produkte: 

• Es ist keine sofortige Aktion erforderlich. Deine aktuellen Produkte mit der Platzierung front können weiterhin verkauft werden, und wir bearbeiten Bestellungen wie gewohnt.
• Wenn Du ein bestehendes Produkt bearbeitest, aktualisiert unser System dessen Platzierung automatisch auf front_large. Anschließend solltest Du die Skalierung und Auflösung (dpi) Deines Designs überprüfen, damit es auf dem größeren Bereich von 15" x 18" gut aussieht.
• Ein 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 für alle neuen Produkte mit einem Druck auf der Vorderseite front_large verwenden. Die Platzierung front ist für die betroffenen Artikel dann nicht mehr im Printful-Katalog verfügbar. 

API-Aufrufe aktualisieren

Als Nächstes musst Du wissen, an welcher Stelle in Deinem Code Du den neuen Platzierungsnamen front_large eintragen musst. Du kannst bestätigen, dass der neue Platzierungsname verfügbar ist, indem Du ein bestimmtes Produkt aus dem Katalog abfragst: 

• In API V1 findest Du ihn unter: Result > Product > Files > Type
• In API V2 findest Du ihn unter: Data > Placements 

Hier erfährst Du, wo Du front_large in Deinen API-Anfragen verwendest: 

Implementierung in API V1: 

• Um ein neues Produkt synchronisieren zu erstellen: Gib die Platzierung im Anfragetext unter Sync_variants > Files > Type an.
• Um eine neue Bestellung zu erstellen: Gib die Platzierung im Anfragetext unter Items > Files > Type an.
• Um eine Mockup-Generierungsaufgabe zu erstellen: Gib die Platzierung im Anfragetext unter Files > Placement an.

Implementierung in API V2: 

• Um eine neue Bestellung zu erstellen: Gib die Platzierung im Anfragetext unter Order_items > Placements > Placement an.
• Um ein Mockup zu erstellen: Gib die Platzierung im Anfragetext unter Products > Placements > Placement an. 

Wenn Du diese Schritte befolgst, ist Deine API-Integration vollständig auf die Umstellung auf unsere neuen, größeren DTG-Druckplatzierungen vorbereitet. 

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