Modifier une commande avec l'API Printful
Modifie 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.
- Identifiant
- printful_update_order
L'appel
POST https://connect.reportei.com/api/tools/printful_update_order/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": "<id>"
}
}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 |
|---|---|---|---|
| id | string | Oui | Id of an order from List orders, or the external_id of the order prefixed with @. |
| external_id | string | Non | Your own id for the order, unique in the store. |
| shipping | string | Non | Shipping method: the id of a rate from Calculate shipping rates, such as STANDARD. |
| recipient | object | Non | 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 | Non | The new item list. An item with the id of an existing line item from Get order changes it, an existing item left out is removed, and an item without id is added. Each new item names the product with variant_id, sync_variant_id 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. |
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_update_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.
- 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.
- 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.
