E-commerce
Printify en tu producto y en tus agentes de IA, con una API
El toolkit de Printify cubre tiendas, productos, pedidos, el catálogo de blueprints con sus print providers y variantes, y la biblioteca de medios. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda el token de API y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/printify_create_product/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"shop_id": "<shop_id>",
"title": "<title>",
"blueprint_id": 1,
"print_provider_id": 1,
"variants": [],
"print_areas": []
}
}Cómo funciona
Del cliente conectado a la primera llamada a Printify.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Printify. 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 Printify.
Crea productos desde diseños
Una herramienta de diseño sube una imagen desde una URL pública y crea un producto a partir de un blueprint, un print provider y las variantes a vender.
Publica en el canal de ventas
Una app para comerciantes actualiza un producto y lo publica en el canal de ventas de la tienda, como Shopify o Etsy.
Sigue el cumplimiento de pedidos
Un panel lista los pedidos de una tienda con estado, costes y envíos con seguimiento, y obtiene un pedido al detalle.
Tools
13 tools de Printify
- Listar tiendasGETLista las tiendas de la cuenta con id, title y sales_channel, como shopify, etsy o disconnected. El id es el shop_id que piden todas las otras herramientas.
- Listar productosGETLista los productos de una tienda con title, description, tags, variantes con precio en centavos, imágenes de mockup, blueprint_id, print_provider_id y estado de publicación. 10 por página por defecto; current_page y last_page vienen en la respuesta.
- Obtener productoGETDevuelve un producto: title, description, tags, opciones, variantes con sku, precio y coste en centavos, áreas de impresión con las imágenes y su posición, mockups, is_locked y los enlaces al canal de ventas.
- Crear productoPOSTCrea un producto en una tienda a partir de un blueprint del catálogo, un print provider, las variantes a vender con sus precios y las imágenes subidas colocadas en cada área de impresión. Una imagen de baja resolución se rechaza con el error 8203. El producto no se publica: usa Publicar producto.
- Actualizar productoPUTModifica un producto y lo devuelve. Solo cambian los campos enviados, pero variants debe listar todas las variantes del producto. Se rechaza mientras is_locked sea true, durante una publicación. Los cambios llegan al canal de ventas solo después de Publicar producto.
- Publicar productoPOSTEnvía un producto al canal de ventas de la tienda, como Shopify o Etsy, y lo bloquea en Printify hasta que el canal confirme; en una tienda conectada por API, esa tienda tiene que confirmar. Cada campo true se envía, false conserva lo que tiene el canal. Limitado a 200 llamadas cada 30 minutos.
- Listar pedidosGETLista los pedidos de una tienda con estado, líneas, dirección, costes en centavos y envíos con seguimiento. Como máximo 10 por página; current_page y last_page vienen en la respuesta.
- Obtener pedidoGETDevuelve un pedido: estado, líneas con su estado de producción, dirección de envío, costes en centavos, envíos con transportista y seguimiento, y las fechas de creación, producción y cumplimiento.
- Listar blueprintsGETLista todo el catálogo de productos en blanco de Printify, llamados blueprints, con id, title, brand, model e imágenes, en una única respuesta larga. Prefiere el blueprint_id de un producto existente cuando uno sirva.
- Listar print providers del blueprintGETLista los print providers que fabrican un blueprint, con id y title. Cada uno tiene sus propias variantes, precios y áreas de impresión.
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 Printify
¿Necesito implementar la API de Printify?
No. Connect ya trae 13 tools de Printify 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 Printify?
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.
