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 vous assurer que vos conditions de retour sont 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 méthode accounts.onlineReturnPolicies.get.

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

Si la requête aboutit, la réponse contient la ressource OnlineReturnPolicy, comme le montre 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 réponse représente les frais de réapprovisionnement, qui peuvent être un montant fixe ou 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 méthode accounts.onlineReturnPolicies.list, comme indiqué 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 le montre 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 ce corps de 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 le retour d'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 une condition 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'UI 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, il peut s'écouler jusqu'à 10 jours ouvrés avant qu'elles soient examinées et disponibles.