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

Depuis le 17 mai 2025, Printful propose une zone d’impression standard plus grande sur le devant, de 15″ × 18″, pour certains articles imprimés en impression numérique textile (DTG). Vous pouvez ainsi intégrer des designs plus grands et plus audacieux à votre boutique. Ce guide vous explique comment relier votre intégration API à cette norme.

Quel nom de positionnement dois-je utiliser dans l’API ?

Pour utiliser la zone d’impression de 15″ × 18″, vous devez utiliser le nom de positionnement front_large dans vos appels API. L’ancien nom de positionnement, front, n’est plus utilisé pour la création de nouveaux produits dans le catalogue Printful, mais reste actif pour les produits existants créés avant la transition.

Quel est l’impact de ce changement sur mes produits ?

Tout d’abord, déterminez 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 le positionnement front continueront d’être vendus, et nous traiterons les commandes comme d’habitude.
• Si vous modifiez un produit existant, notre système mettra automatiquement à jour son positionnement en front_large. Vous devrez alors vérifier la mise à l’échelle et la résolution (dpi) de votre design pour 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, il vous suffit de mettre à jour les informations de positionnement 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 un imprimé avant. Le positionnement front ne sera plus disponible dans le catalogue Printful pour les articles concernés. 

Mettez à jour vos appels API

Vous devez ensuite savoir où intégrer le nouveau nom de positionnement front_large dans votre code. Vous pouvez vérifier la disponibilité du nouveau nom de positionnement 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 de l’API V1 : 

• Pour créer un nouveau produit synchronisé : indiquez le positionnement dans le corps de la requête sous Sync_variants > Files > Type
• Pour créer une nouvelle commande : indiquez le positionnement dans le corps de la requête sous Items > Files > Type
• Pour créer une tâche de génération de maquette : indiquez le positionnement dans le corps de la requête sous Files > Placement

Implémentation de l’API V2 : 

• Pour créer une nouvelle commande : indiquez le positionnement dans le corps de la requête sous Order_items > Placements > Placement
• Pour créer une maquette : indiquez le positionnement dans le corps de la requête sous Products > Placements > Placement 

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

Pour en savoir plus sur le changement de positionnement d’impression et les produits concernés, cliquez ici