Créer une commande avec l'API Printful
Cré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.
- Identifiant
- printful_create_order
L'appel
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": []
}
}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 |
|---|---|---|---|
| external_id | string | Non | Your own id for the order, unique in the store. The order tools also accept it prefixed with @ in place of the Printful id. |
| shipping | string | Non | Shipping method: the id of a rate from Calculate shipping rates, such as STANDARD. The default is STANDARD. |
| recipient | object | Oui | Delivery address. country_code is a two-letter ISO code; state_code is required for the US, Canada and Australia, and tax_number for Brazil. |
| items | array | Oui | Items of the order. Each item names the product with one of: variant_id, a blank catalog variant from Get catalog product sent with its print files; sync_variant_id, a variant of a store product from Get store product, whose files are already set; or external_variant_id. |
| retail_costs | object | Non | Retail amounts printed on the packing slip of international shipments. Used only when every item has retail_price. |
| gift | object | Non | Gift message printed on the packing slip. |
| packing_slip | object | Non | Custom packing slip for this order. Give at least one of email, phone, message or custom_order_id. |
| update_existing | boolean | Non | When an order with this external_id already exists, updates it instead of failing. |
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_create_order. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
- 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.
