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 sui resi 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 tariffa fissa o una percentuale del prezzo dell'articolo in micro.

Elenca tutte le norme sui resi online

Per elencare tutte le norme per i 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 a 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.