Créer et gérer vos conditions de retour en ligne

Cette page explique comment afficher vos conditions de retour en ligne.

L'API Merchant est compatible avec les méthodes suivantes pour récupérer les conditions de retour en ligne :

Nous vous recommandons de veiller à ce que vos conditions de retour soient visibles et accessibles à tous les utilisateurs qui consultent votre site Web, sans qu'ils aient à se connecter, à s'inscrire ni à saisir d'informations personnelles. Assurez-vous également que les conditions de retour sont les mêmes dans Merchant Center et sur votre site Web.

Récupérer des conditions de retour en ligne existantes

Pour récupérer des conditions de retour en ligne existantes, utilisez la accounts.onlineReturnPolicies.get.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

Une fois la requête traitée, la réponse contient la OnlineReturnPolicy, comme illustré dans l'exemple suivant :

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "ONLINE_RETURN_POLICY_ID",
      "label": "default",
      "countries": [
        "COUNTRY_CODE"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "RETURN_POLICY_URI"
    }
  ]
}

La valeur NO_RETURNS indique que les retours ne sont pas acceptés dans le pays mentionné.

Le champ restockingFee du corps de la réponse représente les frais de réapprovisionnement, qui peuvent être fixes ou correspondre à un pourcentage du prix de l'article en micros.

Lister toutes les conditions de retour en ligne

Pour lister toutes les conditions de retour en ligne, utilisez la accounts.onlineReturnPolicies.list, comme illustré dans la requête suivante :

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies

Une fois la requête traitée, la réponse contient toutes les conditions de retour en ligne existantes pour le compte, comme illustré dans l'exemple de réponse suivant :

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "7216992546",
      "label": "default",
      "countries": [
        "IN"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return"
    },
    {
      "returnPolicyId": "7274318400",
      "label": "default",
      "countries": [
        "GB"
      ],
      "policy": {
        "type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
        "days": "15"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "10000000",
          "currencyCode": "GBP"
        }
      },
      "returnMethods": [
        "AT_A_KIOSK"
      ],
      "itemConditions": [
        "NEW"
      ],
      "returnShippingFee": {
        "type": "FIXED",
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "GBP"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return-new",
      "processRefundDays": 7,
      "acceptExchange": true
    }
  ]
}

Dans le corps de cette réponse, le champ returnPolicyId représente l'identifiant unique des conditions de retour en ligne.

Le champ returnMethods indique les méthodes autorisées pour retourner des articles. AT_A_KIOSK indique que l'article peut être retourné en kiosque. Les autres valeurs possibles sont IN_STORE et BY_MAIL.

Le champ processRefundDays spécifie le nombre de jours nécessaires au marchand pour traiter les remboursements.

Créer des conditions de retour en ligne

Pour créer des conditions de retour, utilisez la requête suivante :

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}
{
  "label": "label", "countries": ["US"],
"policy": {"type": "NO_RETURNS"},
"returnPolicyUri": "https://www.uri.com"
}

Voici un exemple de réponse à un appel réussi :

{
  "name": "accounts/ACCOUNT_ID/onlineReturnPolicies/ONLINE_RETURN_POLICY",
  "returnPolicyId": "ONLINE_RETURN_POLICY",
  "label": "label",
  "countries": ["US"],
  "policy": {
    "type": "NO_RETURNS"
  },
  "returnShippingFee": {
    "type": "FIXED",
    "fixedFee": {
      "amountMicros": "0",
      "currencyCode": ""
    }
  },
  "returnPolicyUri": "https://www.uri.com"
}

Vous pouvez également utiliser l'interface utilisateur Merchant Center pour créer des conditions de retour. Pour en savoir plus, consultez Configurer vos conditions de retour pour les annonces Shopping et les fiches gratuites . Une fois que vous avez créé des conditions de retour dans Merchant Center, leur examen et leur disponibilité peuvent prendre jusqu'à 10 jours ouvrés.