Come faccio a passare la mia integrazione API all’area di stampa da 15" x 18"?

Dal 17 maggio 2025, Printful offre un’area di stampa frontale standard più ampia di 15″ × 18″ per alcuni articoli direct-to-garment (DTG). Questo ti consente di integrare design più grandi e audaci nel tuo negozio. Questa guida ti mostrerà come collegare la tua integrazione API a questo standard.

Quale nome di posizionamento devo usare nell’API?

Per utilizzare l’area di stampa da 15″ × 18″, devi usare il nome di posizione front_large nelle tue chiamate API. Il nome di posizione legacy, front, è stato gradualmente eliminato per la creazione di nuovi prodotti nel catalogo Printful, anche se resta attivo per i prodotti esistenti creati prima della transizione.

In che modo questa modifica influisce sui miei prodotti?

Per prima cosa, determina in che modo questo cambiamento influisce sui tuoi prodotti nuovi ed esistenti. 

Per i tuoi prodotti esistenti: 

• Non è richiesta alcuna azione immediata. I tuoi prodotti attuali che usano la posizione frontale continueranno a essere venduti e noi elaboreremo gli ordini come di consueto.
• Se modifichi un prodotto esistente, il nostro sistema aggiornerà automaticamente la sua posizione a front_large. A quel punto, dovresti controllare la scala e la risoluzione (DPI) del tuo design per assicurarti che abbia un ottimo aspetto sull’area più grande da 15" x 18".
• L’aggiornamento è facoltativo. Se vuoi utilizzare l’area di stampa più ampia per gli articoli esistenti, aggiorna semplicemente le informazioni di posizione del prodotto. 

Per i nuovi prodotti che crei: 

• Dopo il 17 maggio 2025, devi usare front_large per tutti i nuovi prodotti con stampa frontale. La posizione frontale non sarà più disponibile nel catalogo Printful per gli articoli interessati. 

Aggiorna le tue chiamate API

Successivamente, dovrai sapere dove implementare il nuovo nome di posizione front_large nel tuo codice. Puoi confermare che il nuovo nome di posizione è disponibile chiamando un prodotto specifico dal catalogo: 

• In API V1, controlla in: Result > Product > Files > Type
• In API V2, controlla in: Data > Placements 

Ecco dove usare front_large nelle tue richieste API: 

Implementazione API V1: 

• Per creare un nuovo Sync Product: specifica la posizione nel corpo della richiesta in Sync_variants > Files > Type
• Per creare un nuovo ordine: specifica la posizione nel corpo della richiesta in Items > Files > Type
• Per creare un’attività di generazione mockup: specifica la posizione nel corpo della richiesta in Files > Placement

Implementazione API V2: 

• Per creare un nuovo ordine: specifica la posizione nel corpo della richiesta in Order_items > Placements > Placement
• Per creare un mockup: specifica la posizione nel corpo della richiesta in Products > Placements > Placement 

Seguendo questi passaggi, la tua integrazione API sarà completamente pronta per il passaggio ai nostri nuovi posizionamenti di stampa DTG più grandi. 

Scopri di più sulla modifica del posizionamento di stampa e sui prodotti interessati qui