E-commerce
Printful en tu producto y en tus agentes de IA, con una API
El toolkit de Printful cubre pedidos, tarifas de envío, el catálogo de productos en blanco, los productos de la propia tienda y estadísticas de ventas: crear un pedido en borrador, actualizarlo, confirmarlo para producción o cancelarlo y leer los números de seguimiento. El comerciante conecta con una API key de Printful, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/printful_create_order/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"recipient": {},
"items": []
}
}Cómo funciona
Del cliente conectado a la primera llamada a Printful.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Printful. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Printful.
Cumplir pedidos de tu tienda
Crea un pedido en borrador con destinatario, ítems y archivos de impresión, cotiza el envío y confírmalo para que Printful inicie la producción.
Estado del pedido en tu panel
Lista los pedidos y lee los envíos con transportista y número de seguimiento para mostrar a los clientes dónde está su paquete.
Agente de IA para tiendas de merch
Deja que un agente explore el catálogo y sus variantes, consulte productos de la tienda, calcule tarifas de envío y cancele un pedido que sigue en borrador o pendiente.
Tools
12 tools de Printful
- Listar pedidosGETLista los pedidos de la tienda con estado, destinatario, ítems, costos y envíos. Pagina con offset y limit; paging.total en la respuesta es el número de pedidos.
- Obtener pedidoGETDevuelve un pedido con estado, destinatario, ítems, costos y los envíos con transportista y número de seguimiento.
- Crear pedidoPOSTCrea un pedido como borrador y lo devuelve con los costos que calculó Printful. No se cobra nada hasta Confirmar pedido. recipient e items son obligatorios, y los archivos de impresión se descargan de URLs públicas.
- Actualizar pedidoPUTModifica un pedido que aún no se envió a producción y lo devuelve. Envía solo los campos que cambian; enviar items reemplaza la lista de ítems. No se cobra nada hasta Confirmar pedido.
- Confirmar pedidoPOSTEnvía un pedido en borrador a producción y lo devuelve. Printful cobra el método de pago del dueño de la tienda en este momento; un pedido pendiente aún se puede cancelar con Cancelar pedido.
- Cancelar pedidoDELETECancela un pedido en borrador o pendiente y lo devuelve. Un monto cobrado vuelve a la tarjeta del dueño de la tienda. Los pedidos en revisión, en proceso o ya enviados no se pueden cancelar.
- Calcular tarifas de envíoPOSTDevuelve los métodos de envío para una lista de ítems y un destino, con tarifa, moneda y estimación de entrega. El id de un método va en shipping de Crear pedido y Actualizar pedido. Llama justo antes de hacer el pedido, porque las tarifas cambian.
- Listar productos del catálogoGETLista los productos en blanco del catálogo de Printful, como camisetas, tazas y pósteres, con id, title, type, brand y main_category_id. Obtener producto del catálogo devuelve las variantes de uno de ellos.
- Obtener producto del catálogoGETDevuelve un producto del catálogo y sus variantes. Cada variante tiene el id que reciben los pedidos y las tarifas de envío como variant_id, con talla, color, precio y stock; el producto lista las posiciones de archivo de impresión (files) y las opciones que acepta.
- Listar productos de la tiendaGETLista los productos de una tienda creados en Printful para pedidos manuales y para la API, con id, external_id, name y cuántas variantes tiene cada uno. Obtener producto de la tienda devuelve las variantes.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Printful
¿Necesito implementar la API de Printful?
No. Connect ya trae 12 tools de Printful descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Printful?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
