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

Dal 17 maggio 2025, Printful offre un’area di stampa frontale standard più grande, da 15″ × 18″, per alcuni articoli stampati direttamente su capo (DTG). Questo ti consente di integrare nel tuo negozio design più grandi e d’impatto. Questa guida ti spiegherà come collegare la tua integrazione API a questo standard.

Quale nome di posizione devo usare nell’API?

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

In che modo questa modifica influisce sui miei prodotti?

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

Per i prodotti esistenti: 

• Non è richiesta alcuna azione immediata. I tuoi prodotti attuali che utilizzano la posizione front continueranno a essere venduti e gli ordini saranno elaborati 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 bell’aspetto nell’area più grande da 15" x 18".
• L’aggiornamento è facoltativo. Se vuoi usare l’area di stampa più grande per gli articoli esistenti, ti basta aggiornare le informazioni sulla posizione del prodotto. 

Per i nuovi prodotti che crei: 

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

Aggiorna le tue chiamate API

Ora devi sapere dove implementare nel tuo codice il nuovo nome di posizione front_large. Puoi verificare che il nuovo nome di posizione sia disponibile chiamando un prodotto specifico dal catalogo: 

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

Ecco dove usare front_large nelle tue richieste API: 

Implementazione API V1: 

• Per creare un nuovo prodotto sincronizzato: 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 di 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à pronta per il passaggio alle nostre nuove posizioni di stampa DTG più grandi. 

Scopri di più sulla modifica della posizione di stampa e sui prodotti interessati qui