¿Cómo puedo migrar mi integración de API al área de impresión de 15″ × 18″?

Desde el 17 de mayo de 2025, Printful ofrece un área de impresión frontal estándar más grande, de 15″ × 18″, para determinados artículos de impresión directa sobre prenda (DTG). Esto te permite integrar diseños más grandes y llamativos en tu tienda. En esta guía te explicaremos cómo vincular tu integración de API a este estándar.

¿Qué nombre de ubicación debo usar en la API?

Para utilizar el área de impresión de 15″ × 18″, debes usar el nombre de ubicación front_large en tus llamadas a la API. El nombre de ubicación heredado, front, se ha eliminado para la creación de nuevos productos en el catálogo de Printful, aunque sigue activo para los productos existentes creados antes de la transición.

¿Cómo afecta este cambio a mis productos?

Primero, determina cómo afecta este cambio a tus productos nuevos y existentes. 

Para tus productos existentes: 

• No es necesario realizar ninguna acción de inmediato. Tus productos actuales que usan la ubicación front seguirán vendiéndose y procesaremos los pedidos como de costumbre.
• Si editas un producto existente, nuestro sistema actualizará automáticamente su ubicación a front_large. En ese momento, debes comprobar la escala y la resolución de tu diseño (DPI) para asegurarte de que se vea bien en el área más grande de 15" x 18".
• La actualización es opcional. Si quieres usar el área de impresión más grande para los artículos existentes, solo tienes que actualizar la información de ubicación del producto. 

Para los productos nuevos que crees: 

• Después del 17 de mayo de 2025, debes usar front_large para todos los productos nuevos con impresión frontal. La ubicación front dejará de estar disponible en el catálogo de Printful para los artículos afectados. 

Actualiza tus llamadas a la API

A continuación, debes saber dónde implementar el nuevo nombre de ubicación front_large en tu código. Puedes confirmar que el nuevo nombre de ubicación está disponible consultando un producto específico del catálogo: 

• En API V1, comprueba la ruta: Result > Product > Files > Type
• En API V2, comprueba la ruta: Data > Placements 

Aquí puedes usar front_large en tus solicitudes a la API: 

Implementación de API V1: 

• Para crear un nuevo producto sincronizado: especifica la ubicación en el cuerpo de la solicitud, en Sync_variants > Files > Type
• Para crear un nuevo pedido: especifica la ubicación en el cuerpo de la solicitud, en Items > Files > Type
• Para crear una tarea de generación de maquetas: especifica la ubicación en el cuerpo de la solicitud, en Files > Placement

Implementación de API V2: 

• Para crear un nuevo pedido: especifica la ubicación en el cuerpo de la solicitud, en Order_items > Placements > Placement
• Para crear una maqueta: especifica la ubicación en el cuerpo de la solicitud, en Products > Placements > Placement 

Si sigues estos pasos, tu integración de API estará totalmente preparada para el cambio a nuestras nuevas ubicaciones de impresión DTG, más grandes. 

Obtén más información sobre el cambio de ubicación de impresión y los productos afectados aquí