Creare e gestire le norme sui resi online

Questa pagina fornisce informazioni su come visualizzare le norme sui resi online.

L'API Merchant supporta i seguenti metodi per recuperare le norme di reso online:

Come best practice, assicurati che le norme sui resi siano rilevabili e accessibili a tutti gli utenti che visitano il tuo sito web senza richiedere l'accesso, la registrazione o l'inserimento di informazioni personali. Inoltre, assicurati che le norme sui resi siano coerenti tra Merchant Center e il tuo sito web.

Recuperare una norma sui resi online esistente

Per recuperare una norma sui resi online esistente, utilizza il metodo accounts.onlineReturnPolicies.get.

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

Se la richiesta ha esito positivo, la risposta contiene la risorsa OnlineReturnPolicy, come mostrato nell'esempio seguente:

{
  "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"
    }
  ]
}

Il valore NO_RETURNS indica che i resi non sono supportati per il paese menzionato.

Il campo restockingFee nel corpo della risposta rappresenta la commissione di riassortimento, che può essere una commissione fissa o una percentuale del prezzo dell'articolo in micro.

Elenca tutte le norme sui resi online

Per elencare tutte le norme sui resi online, utilizza il metodo accounts.onlineReturnPolicies.list, come mostrato nella seguente richiesta:

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

Se la richiesta ha esito positivo, la risposta contiene tutte le norme di reso online esistenti per l'account, come mostrato nella seguente risposta di esempio:

{
  "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
    }
  ]
}

Nel corpo della risposta, il campo returnPolicyId rappresenta l'identificatore univoco della norma sui resi online.

Il campo returnMethods indica i metodi consentiti per la restituzione degli articoli. AT_A_KIOSK indica che l'articolo può essere restituito presso un infopoint. Gli altri valori possibili sono IN_STORE e BY_MAIL.

Il campo processRefundDays specifica il numero di giorni necessari al venditore per elaborare i rimborsi.

Creare una norma sui resi online

Per creare una norma sui resi, utilizza la seguente richiesta:

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"
}

Ecco una risposta di esempio di una chiamata riuscita:

{
  "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"
}

Puoi anche utilizzare l'interfaccia utente di Merchant Center per creare norme sui resi. Per maggiori informazioni, consulta Configurare le norme sui resi per gli annunci Shopping e le schede senza costi. Dopo aver creato le norme sui resi in Merchant Center, potrebbero essere necessari fino a 10 giorni lavorativi prima che le norme vengano esaminate e rese disponibili.