E-commerce
Printful dans votre produit et vos agents IA, via une API
Le toolkit Printful couvre les commandes, les tarifs de livraison, le catalogue de produits vierges, les produits de la boutique elle-même et les statistiques de ventes : créer une commande en brouillon, la modifier, la confirmer pour production ou l'annuler, et lire les numéros de suivi. Le marchand se connecte avec une clé API Printful, et votre produit ou agent IA appelle chaque opération via un seul endpoint Connect.
15 jours d'essai. Sans carte bancaire.
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": []
}
}Fonctionnement
Du client connecté au premier appel à Printful.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Printful. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Printful.
Traiter les commandes de votre boutique
Créez une commande en brouillon avec destinataire, articles et fichiers d'impression, chiffrez la livraison, puis confirmez-la pour que Printful lance la production.
Statut des commandes dans votre tableau
Listez les commandes et lisez les expéditions avec transporteur et numéro de suivi pour montrer aux clients où est leur colis.
Agent IA pour boutiques de merch
Laissez un agent parcourir le catalogue et ses variantes, consulter les produits de la boutique, calculer les tarifs de livraison et annuler une commande encore en brouillon ou en attente.
Tools
12 tools Printful
- Lister les commandesGETListe les commandes de la boutique avec statut, destinataire, articles, coûts et expéditions. Paginez avec offset et limit ; paging.total dans la réponse est le nombre de commandes.
- Obtenir une commandeGETRenvoie une commande avec statut, destinataire, articles, coûts et les expéditions avec transporteur et numéro de suivi.
- Créer une commandePOSTCrée une commande en brouillon et la renvoie avec les coûts calculés par Printful. Rien n'est facturé avant Confirmer la commande. recipient et items sont obligatoires, et les fichiers d'impression sont téléchargés depuis des URL publiques.
- Modifier une commandePUTModifie une commande qui n'a pas encore été soumise à la production et la renvoie. N'envoyez que les champs qui changent ; envoyer items remplace la liste d'articles. Rien n'est facturé avant Confirmer la commande.
- Confirmer une commandePOSTSoumet une commande en brouillon à la production et la renvoie. Printful débite le moyen de paiement du propriétaire de la boutique à ce moment ; une commande en attente peut encore être annulée avec Annuler la commande.
- Annuler une commandeDELETEAnnule une commande en brouillon ou en attente et la renvoie. Un montant débité retourne sur la carte du propriétaire de la boutique. Les commandes en revue, en cours ou déjà expédiées ne peuvent pas être annulées.
- Calculer les tarifs de livraisonPOSTRenvoie les modes de livraison pour une liste d'articles et une destination, avec tarif, devise et estimation de livraison. L'id d'un mode va dans shipping de Créer une commande et Modifier une commande. Appelez juste avant de commander, car les tarifs changent.
- Lister les produits du catalogueGETListe les produits vierges du catalogue Printful, comme t-shirts, mugs et posters, avec id, title, type, brand et main_category_id. Obtenir un produit du catalogue renvoie les variantes de l'un d'eux.
- Obtenir un produit du catalogueGETRenvoie un produit du catalogue et ses variantes. Chaque variante a l'id que prennent les commandes et les tarifs de livraison comme variant_id, avec taille, couleur, prix et stock ; le produit liste les emplacements de fichiers d'impression (files) et les options qu'il accepte.
- Lister les produits de la boutiqueGETListe les produits d'une boutique créés dans Printful pour les commandes manuelles et l'API, avec id, external_id, name et le nombre de variantes de chacun. Obtenir un produit de la boutique renvoie les variantes.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Printful
Dois-je intégrer l'API Printful moi-même ?
Non. Connect fournit 12 tools Printful décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Printful ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
