Comment faire passer mon intégration API à la zone d’impression de 15" x 18" ?

Depuis le 17 mai 2025, Printful propose une zone d'impression avant standard plus grande de 15″ × 18″ pour certains articles d’impression directe sur vêtement (DTG). Cela vous permet d’intégrer des designs plus grands et plus audacieux dans votre boutique. Ce guide vous expliquera comment lier votre intégration API à cette norme.

Quel nom d’emplacement dois-je utiliser dans l’API ?

Pour utiliser la zone d'impression de 15″ × 18″, vous devez utiliser le nom d’emplacement front_large dans vos appels API. L’ancien nom d’emplacement, front, a été supprimé progressivement pour la création de nouveaux produits dans le catalogue Printful, bien qu’il reste actif pour les produits existants créés avant la transition.

Comment ce changement affecte-t-il mes produits ?

Déterminez d’abord l’impact de ce changement sur vos nouveaux produits et vos produits existants. 

Pour vos produits existants: 

• Aucune action immédiate n’est requise. Vos produits actuels utilisant l’emplacement avant continueront à être vendus, et nous traiterons les commandes comme d’habitude.
• Si vous modifiez un produit existant, notre système mettra automatiquement son emplacement à jour vers front_large. À ce moment-là, vous devrez vérifier l’échelle et la résolution (DPI) de votre design afin de vous assurer qu’il s’affiche parfaitement sur la zone plus grande de 15" x 18".
• La mise à niveau est facultative. Si vous souhaitez utiliser la zone d'impression plus grande pour les articles existants, mettez simplement à jour les informations d’emplacement du produit. 

Pour les nouveaux produits que vous créez: 

• Après le 17 mai 2025, vous devez utiliser front_large pour tous les nouveaux produits avec impression avant. L’emplacement avant ne sera plus disponible dans le catalogue Printful pour les articles concernés. 

Mettez à jour vos appels API

Ensuite, vous devrez savoir où implémenter le nouveau nom d’emplacement front_large dans votre code. Vous pouvez confirmer que le nouveau nom d’emplacement est disponible en appelant un produit spécifique du catalogue: 

• Dans API V1, vérifiez sous : Result > Product > Files > Type
• Dans API V2, vérifiez sous : Data > Placements 

Voici où utiliser front_large dans vos requêtes API: 

Implémentation API V1: 

• Pour créer un nouveau Sync Product: spécifiez l’emplacement dans le corps de la requête, dans Sync_variants > Files > Type
• Pour créer une nouvelle commande: spécifiez l’emplacement dans le corps de la requête, dans Items > Files > Type
• Pour créer une tâche de génération de maquettes: spécifiez l’emplacement dans le corps de la requête, dans Files > Placement

Implémentation API V2: 

• Pour créer une nouvelle commande: spécifiez l’emplacement dans le corps de la requête, dans Order_items > Placements > Placement
• Pour créer une maquette: spécifiez l’emplacement dans le corps de la requête, dans Products > Placements > Placement 

En suivant ces étapes, votre intégration API sera entièrement prête pour le passage à nos nouveaux emplacements d’impression DTG plus grands. 

En savoir plus sur le changement d’emplacement d’impression et les produits concernés ici