Esta guía explica el flujo de conexión de Printful cuando Printful aparece explícitamente como disponible en Integraciones → Preparación de pedidos. Solo la pantalla de Integraciones en vivo de tu cuenta es la referencia. Este artículo, el logotipo de un proveedor o una URL directa no prueban la disponibilidad. Si Printful no aparece o no está disponible ahí, detente: está fuera de tu alcance real actual.
Una conexión correcta puede exponer las capacidades que concede tu token de Printful. El catálogo, los pedidos y el comportamiento de los webhooks siguen dependiendo de la tienda seleccionada, de los permisos y del estado actual de la integración. Verifica el flujo completo de un pedido asignado y una referencia aceptada del proveedor antes de pasar a producción.
Si primero quieres ver el panorama general, consulta cómo funciona conectar un proveedor.
Antes de empezar
Un poco de configuración en Printful hace que la conexión vaya sin problemas.
- Ten lista una cuenta de Printful, con tu tienda y tus ajustes de pago configurados. Confirma los datos de pago en Printful antes de validar un pedido de prueba y una referencia del proveedor.
- Decide desde qué tienda de Printful debe preparar los pedidos Composerie. Si tu cuenta de Printful tiene más de una tienda, eliges la correcta durante la conexión.
- Si conectas con una clave API, genera un token privado con solo el acceso que indican los pasos de configuración: pedidos, productos y webhooks. Revisa esos permisos en Printful antes de aprobar.
La vía de la clave API incluye tres breves pasos numerados: configura tu tienda y tus datos de pago, crea el token y luego pégalo y elige tu tienda. Enlazan directamente al panel de Printful y a la documentación de la API de Printful, así que puedes abrir cada paso en una pestaña nueva y seguirlo.
Conecta Printful
Sigue solo el método de configuración que muestra tu página de Printful. Donde está configurado el inicio de sesión con un clic de Printful, la tarjeta se titula “Conecta tu cuenta de Printful” y empieza con un botón “Continuar con Printful”. El formulario del token API queda plegado bajo Usar una clave API en su lugar. Donde no está configurado, la tarjeta muestra directamente el formulario del token API.
Abre la página de conexión de Printful
Ve al centro de Integraciones del panel y abre la sección Preparación de pedidos. Continúa solo cuando la tarjeta de Printful muestre explícitamente una acción de configuración disponible y selecciónala para abrir la página de conexión.
Elige cómo conectar
Usa uno de los métodos de conexión que muestra la página.
Para iniciar sesión, selecciona “Continuar con Printful”, inicia sesión en Printful y aprueba el acceso. Vuelves directamente a la página de Printful en Composerie. Si lo rechazas o la autorización falla, la página lo indica y no se cambia nada. El (i) junto a “Solo lo necesario para productos y pedidos” explica el acceso que solicita Composerie y la advertencia de un webhook por tienda que aparece más abajo.
Para usar un token que gestionas tú, selecciona Usar una clave API en su lugar.
Pega tu token y busca tiendas
Si elegiste la vía de la clave API, pega tu token API privado en el campo Clave API y luego selecciona Buscar tiendas. Composerie valida el token con Printful y lee las tiendas de tu cuenta.
Selecciona la tienda que conectar
Cuando se han encontrado las tiendas, elige en el selector de Tienda la tienda de Printful que Composerie debe usar para preparar los pedidos. Lista cada tienda de tu cuenta y empieza en la primera.
Termina de conectar
Selecciona “Conectar Printful”. El botón aparece solo después de que Buscar tiendas encuentre una tienda, y necesita una tienda seleccionada. Composerie guarda tu token cifrado y registra la tienda que elegiste.
Si el flujo de conexión informa de que se registró un webhook, Composerie puede recibir los eventos de estado compatibles de esa tienda seleccionada. Cuando Printful devuelve el seguimiento en un evento o una respuesta de estado compatible, Composerie puede registrarlo en el pedido del proveedor correspondiente.
Confirma la conexión
Después de conectar, la página de Printful cambia a su vista de conectado. Comprueba que todo se ve bien.
La cabecera muestra el estado Conectado. La línea del registro que hay debajo termina con Última comprobación, el momento en que Composerie confirmó por última vez que las credenciales siguen funcionando. La tarjeta Conexión muestra la Tienda que elegiste y Conectado desde, con la forma en que conectaste: “sesión iniciada con Printful” o “Clave API”. Usa esos valores, el estado de la conexión y un flujo de prueba para confirmar que la credencial sigue funcionando. El estado del proveedor y el seguimiento aparecen solo cuando Printful los devuelve por una vía de conexión compatible.
En la misma tarjeta, define la Moneda de compra con la moneda de facturación de tu cuenta de Printful, para que los costes y los márgenes sean correctos.
Desde aquí puedes abrir el catálogo de Printful y empezar a crear un producto. Selecciona Ver catálogo en la cabecera de la página.
Para traer productos y elegir qué vender, consulta explorar el catálogo de un proveedor. Para mantener la conexión funcionando con el tiempo, consulta mantener sana la conexión con un proveedor.
Preguntas frecuentes
¿Conexión con un clic o token API? ¿Cuál debo usar?
Usa uno de los métodos que se muestran en tu cuenta. Continuar con Printful usa la pantalla de aprobación de Printful. La vía de la clave API, bajo Usar una clave API en su lugar, te permite controlar tú la credencial y los permisos.
¿Por qué no veo el botón Conectar Printful?
Aparece cuando Buscar tiendas ha encontrado una tienda en tu cuenta. Pega tu token, selecciona Buscar tiendas y luego comprueba la tienda en el selector de Tienda.
El token funciona pero no apareció ninguna tienda. ¿Qué hago?
Crea primero una tienda en Printful, vuelve y selecciona Buscar tiendas otra vez. Composerie necesita una tienda desde la que preparar los pedidos antes de poder conectar.
¿Es seguro mi token API?
Sí. Composerie guarda el token cifrado y solo registra qué tienda seleccionaste. Para rotarlo, elige Editar credenciales en el menú Más acciones y guarda un token nuevo. El actual sigue funcionando hasta que guardes. Una conexión hecha iniciando sesión ofrece ahí Volver a conectar con Printful.
¿Conectar Printful sobrescribirá mi webhook existente?
Puede ser. Printful permite una configuración de webhook por tienda, así que el registro de Composerie sustituye el anterior. En la tarjeta de inicio de sesión con un clic, el (i) junto a Solo lo necesario para productos y pedidos lo indica antes de conectar.
Si te quedas atascado, contacta con soporte y te ayudaremos.
Siguiente paso: explora el catálogo de Printful para añadir tu primer producto.