Cómo hacer la transición de mi integración API al área de impresión de 15" x 18"

Desde el 17 de mayo de 2025, Printful ofrece un área estándar más grande para la impresión frontal 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. Esta guía te mostrará cómo vincular tu integración API a este estándar.

¿Cuál 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 anterior, front, se ha eliminado gradualmente 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 se requiere ninguna acción inmediata. Tus productos actuales que usan la ubicación frontal seguirán vendiéndose y procesaremos los pedidos como siempre.
Si editas un producto existente, nuestro sistema actualizará automáticamente su ubicación a front_large. En ese momento, debes revisar la escala y la resolución (DPI) de tu diseño para asegurarte de que se vea genial 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 nuevos productos 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 frontal ya no estará disponible en el catálogo de Printful para los artículos afectados.

Actualiza tus llamadas a la API

A continuación, tendrás que 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 llamando a un producto específico del catálogo:

En API V1, compruébalo en: Result > Product > Files > Type
En API V2, compruébalo en: Data > Placements

Aquí es donde debes usar front_large en tus solicitudes de API:

Implementación de API V1:

Para crear un nuevo Sync Product: 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 mockups: 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 un mockup: especifica la ubicación en el cuerpo de la solicitud, en Products > Placements > Placement

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

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