# Fiche connecteur Returnista Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno. Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur. ## Returnista URL : https://get-bruno.com/features/connectors/returnista Référence texte : https://get-bruno.com/features/connectors/returnista/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Commerce Description : Returnista est une plateforme de gestion des retours pour les e-commerçants. Le connecteur couvre les brouillons de retour, les commandes de retour, les lieux de retour, les raisons, les e-mails et plusieurs événements de suivi. Authentification : API key Présentation : Returnista est une plateforme de gestion des retours pour les e-commerçants. Le connecteur couvre les brouillons de retour, les commandes de retour, les lieux de retour, les raisons, les e-mails et plusieurs événements de suivi. Usage : Préparer un brouillon de retour client Exemple de demande : Je veux créer un brouillon de retour pour le client Atelier Martin au sujet de la paire de chaussures rouge. Résultat attendu : Un brouillon de retour créé et en attente de revue marchande avant acceptation ou refus. À préciser : Identité du client consommateur ; Référence ou contexte de la commande d origine ; Raison du retour et résolution attendue si connue Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/returnista/actions/create-draft-return-order Usage : Créer un point de retour pour un entrepôt Exemple de demande : Je veux créer le lieu de retour Entrepot Nord pour le compte de Returnista. Résultat attendu : Un lieu de retour enregistré avec l adresse fournie pour les retours physiques. À préciser : Identifiant du compte Returnista ; Nom du lieu ; Société, téléphone, rue, numéro, ville, code postal et pays Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/returnista/actions/create-return-location Usage : Consulter le dossier complet d un retour Exemple de demande : Je veux lire le retour RT-1842 du client Maison Lenoir avec ses éléments liés. Résultat attendu : Les détails complets d un retour unique, avec possibilité d inclure les objets liés si demandé. À préciser : Identifiant du retour ; Contexte de support ou de suivi ; Accès au compte Returnista Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/returnista/actions/get-return-order Limites propres au service : Aucune création de commande de vente n est documentée ici. Le renvoi d e-mail est immédiat et ne prévoit ni programmation ni aperçu. La consultation d une commande ou d une demande nécessite un identifiant de départ ou une liste préalable. Les événements documentés sont des déclencheurs instantanés, pas des actions de Bruno. Vocabulaire français : Créer un brouillon de commande de retour — Crée un nouveau brouillon de retour pour un consommateur, en attente de revue marchande. (https://pipedream.com/apps/returnista/actions/create-draft-return-order) Vocabulaire français : Créer un lieu de retour — Crée une nouvelle adresse de retour pour un compte. (https://pipedream.com/apps/returnista/actions/create-return-location) Vocabulaire français : Obtenir les achats d un consommateur — Récupère l historique d achat d un consommateur à partir de son identifiant. (https://pipedream.com/apps/returnista/actions/get-consumer-purchases) Vocabulaire français : Obtenir les brouillons de commande de retour — Liste les brouillons de retour pour un compte donné. (https://pipedream.com/apps/returnista/actions/get-draft-return-orders) Vocabulaire français : Obtenir les lieux de retour — Liste les lieux de retour d un compte donné. (https://pipedream.com/apps/returnista/actions/get-return-locations) Vocabulaire français : Obtenir une commande de retour — Récupère les détails complets d une commande de retour unique. (https://pipedream.com/apps/returnista/actions/get-return-order) Vocabulaire français : Obtenir les e-mails d une commande de retour — Récupère tous les e-mails associés à une commande de retour. (https://pipedream.com/apps/returnista/actions/get-return-order-emails) Vocabulaire français : Obtenir les commandes de retour — Liste les commandes de retour pour un compte donné. (https://pipedream.com/apps/returnista/actions/get-return-orders) Vocabulaire français : Obtenir les raisons de retour — Liste les raisons de retour disponibles pour un compte. (https://pipedream.com/apps/returnista/actions/get-return-reasons) Vocabulaire français : Obtenir une demande de retour — Récupère les détails complets d une demande de retour unique. (https://pipedream.com/apps/returnista/actions/get-return-request) Vocabulaire français : Obtenir les demandes de retour — Liste les demandes de retour pour un compte donné. (https://pipedream.com/apps/returnista/actions/get-return-requests) Vocabulaire français : Lister les produits d expédition — Retourne les options de transport, de type d étiquette et de code produit disponibles. (https://pipedream.com/apps/returnista/actions/list-shipping-products) Vocabulaire français : Traiter un brouillon de commande de retour — Accepte ou refuse un brouillon de retour; l acceptation déclenche la création de l étiquette d expédition. (https://pipedream.com/apps/returnista/actions/process-draft-return-order) Vocabulaire français : Renvoyer l e-mail de confirmation — Renvoie immédiatement l e-mail de confirmation d un retour existant. (https://pipedream.com/apps/returnista/actions/resend-confirmation-email) Vocabulaire français : Mettre à jour un lieu de retour — Met à jour un lieu de retour existant avec les champs fournis. (https://pipedream.com/apps/returnista/actions/update-return-location) Vocabulaire français : Nouveau retour terminé — Déclenche un événement quand une commande de retour est terminée. (https://pipedream.com/apps/returnista/triggers/return-order-completed-instant) Vocabulaire français : Nouveau retour confirmé — Déclenche un événement quand une commande de retour est confirmée. (https://pipedream.com/apps/returnista/triggers/return-order-confirmed-instant) Vocabulaire français : Nouvelle commande de retour créée — Déclenche un événement quand une nouvelle commande de retour est créée. (https://pipedream.com/apps/returnista/triggers/new-return-order-created-instant) Vocabulaire français : Nouvelle commande de vente approuvée ou refusée — Déclenche un événement quand une commande de vente est approuvée ou refusée. (https://pipedream.com/apps/returnista/triggers/sales-order-approved-or-denied-instant) Vocabulaire français : Nouvelle étiquette d expédition créée — Déclenche un événement quand une nouvelle étiquette d expédition est créée. (https://pipedream.com/apps/returnista/triggers/new-shipment-label-created-instant) Vocabulaire français : Nouvelle mise à jour de suivi reçue — Déclenche un événement quand une expédition reçoit une mise à jour de suivi. (https://pipedream.com/apps/returnista/triggers/shipment-received-tracking-updates-instant) Vocabulaire français : Nouvelle mise à jour de livraison reçue — Déclenche un événement quand le statut d expédition passe à livré. (https://pipedream.com/apps/returnista/triggers/tracking-update-delivered-instant) - action : Create Draft Return Order — Creates a new draft return order for a consumer. Draft return orders are pending merchant review before being accepted or rejected. Use Process Draft Return Order to accept or reject the created draft. See the documentation (https://pipedream.com/apps/returnista/actions/create-draft-return-order) - action : Create Return Location — Creates a new return location (warehouse or depot address) for an account. Required: accountId , name , companyName , phoneNumber , street , houseNumber , city , postalCode , countryCode (ISO 3166-1 alpha-2, e.g. NL , DE , GB , US ). Optional: suffix , stateProvinceCode , attention , contactName . To update a location after creation, use Update Return Location with the returned ID. See the documentation (https://pipedream.com/apps/returnista/actions/create-return-location) - action : Get Consumer Purchases — Gets the purchase history for a consumer by their consumer ID. Useful for support workflows to understand what a consumer has purchased before they initiated a return. To find a consumer ID, use Get Return Orders with expand: ["consumer"] on a related return order — the consumer object will include the ID. See the documentation (https://pipedream.com/apps/returnista/actions/get-consumer-purchases) - action : Get Draft Return Orders — Gets a list of draft return orders for the given account. See the documentation (https://pipedream.com/apps/returnista/actions/get-draft-return-orders) - action : Get Return Locations — Gets a list of return locations for the given account. See the documentation (https://pipedream.com/apps/returnista/actions/get-return-locations) - action : Get Return Order — Gets the full details of a single return order by ID. Use expand to inline related objects (consumer, shipments, returnRequests) in one call instead of making separate requests. To find a return order ID, use Get Return Orders first. To view the email communications for a return order, use Get Return Order Emails . See the documentation (https://pipedream.com/apps/returnista/actions/get-return-order) - action : Get Return Order Emails — Gets all email communications associated with a return order. Useful for support and audit workflows to see what emails were sent to the consumer during the return process. To find a return order ID, use Get Return Orders first. See the documentation (https://pipedream.com/apps/returnista/actions/get-return-order-emails) - action : Get Return Orders — Gets a list of return orders for the given account. See the documentation (https://pipedream.com/apps/returnista/actions/get-return-orders) - action : Get Return Reasons — Gets a list of return reasons for the given account. See the documentation (https://pipedream.com/apps/returnista/actions/get-return-reasons) - action : Get Return Request — Gets the full details of a single return request by ID. Return requests contain item-level information: purchase order number, return reason, requested resolution (refund, exchange, etc.). To find a return request ID, use Get Return Requests first. See the documentation (https://pipedream.com/apps/returnista/actions/get-return-request) - action : Get Return Requests — Gets a list of return requests for the given account. See the documentation (https://pipedream.com/apps/returnista/actions/get-return-requests) - action : List Shipping Products — Returns all shipping product options available in Returnista, including carrier integrations, label types, and product codes. See the documentation (https://pipedream.com/apps/returnista/actions/list-shipping-products) - action : Process Draft Return Order — Accepts or rejects a draft return order. Draft return orders are created when a consumer initiates a return and are pending merchant review. Set action to accept to approve the return (this triggers shipment label creation) or reject to decline it. Use Get Return Orders with filter: "status:draft" to find draft order IDs. See the documentation (https://pipedream.com/apps/returnista/actions/process-draft-return-order) - action : Resend Confirmation Email — Resends the return confirmation email to the consumer for an existing return order. Use this when a consumer did not receive their original confirmation, when an email bounced, or to re-trigger a notification after a return order is updated. To look up a return order ID, use Get Return Orders or Get Return Order first. To view the email history before resending, use Get Return Order Emails . Requires both an Account ID (from your Returnista dashboard settings) and a Return Order ID. Note: this triggers an immediate send — there is no scheduling or preview step. See the documentation (https://pipedream.com/apps/returnista/actions/resend-confirmation-email) - action : Update Return Location — Updates an existing return location for an account. All fields are optional — provide only the ones you want to change. At least one field must be provided. To find the return location ID, use Get Return Locations . Use a two-letter ISO 3166-1 alpha-2 country code for countryCode (e.g., NL , DE , GB , US ). See the documentation (https://pipedream.com/apps/returnista/actions/update-return-location) - trigger : New Return Order Completed (Instant) — Emit new event when a return order is completed. See the documentation (https://pipedream.com/apps/returnista/triggers/return-order-completed-instant) - trigger : New Return Order Confirmed (Instant) — Emit new event when a return order is confirmed. See the documentation (https://pipedream.com/apps/returnista/triggers/return-order-confirmed-instant) - trigger : New Return Order Created (Instant) — Emit new event when a new return order is created. See the documentation (https://pipedream.com/apps/returnista/triggers/new-return-order-created-instant) - trigger : New Sales Order Approved or Denied (Instant) — Emit new event when a sales order is approved or denied. See the documentation (https://pipedream.com/apps/returnista/triggers/sales-order-approved-or-denied-instant) - trigger : New Shipment Label Created (Instant) — Emit new event when a new shipment label is created. See the documentation (https://pipedream.com/apps/returnista/triggers/new-shipment-label-created-instant) - trigger : New Shipment Received Tracking Updates (Instant) — Emit new event when a shipment receives tracking updates. See the documentation (https://pipedream.com/apps/returnista/triggers/shipment-received-tracking-updates-instant) - trigger : New Tracking Update Delivered (Instant) — Emit new event when a tracking update is received and the shipment status changes to delivered. See the documentation (https://pipedream.com/apps/returnista/triggers/tracking-update-delivered-instant)