Lister les commandes avec l'API Printful
Liste 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.
- Identifiant
- printful_list_orders
L'appel
POST https://connect.reportei.com/api/tools/printful_list_orders/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"status": "<status>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| status | string | Non | Only orders in this status: draft, inreview, pending, failed, canceled, inprocess, onhold, partial, fulfilled or archived. |
| offset | integer | Non | Number of orders to skip, to read the next pages. |
| limit | integer | Non | Orders per page, up to 100. |
Connexions possibles
Votre client connecte son compte Printful une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/printful_list_orders. Il devient la définition de tool de votre agent sans conversion.
Autres tools Printful
- 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
