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ètreTypeObligatoireDescription
idstringOuiId of an order from List orders, or the external_id of the order prefixed with @.
external_idstringNonYour own id for the order, unique in the store.
shippingstringNonShipping method: the id of a rate from Calculate shipping rates, such as STANDARD.
recipientobjectNonDelivery address. country_code is a two-letter ISO code; state_code is required for the US, Canada and Australia, and tax_number for Brazil.
itemsarrayNonThe 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_costsobjectNonRetail amounts printed on the packing slip of international shipments. Used only when every item has retail_price.
giftobjectNonGift message printed on the packing slip.
packing_slipobjectNonCustom 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

Voir les 12 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.