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 relative ai 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 loro di effettuare l'accesso, registrarsi o inserire informazioni personali. Inoltre, assicurati che le norme sui resi siano coerenti tra Merchant Center e il tuo sito web.

Recuperare norme sui resi online esistenti

Per recuperare le norme sui resi online esistenti, utilizza il metodo accounts.onlineReturnPolicies.get.

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

Una volta che la richiesta è andata a buon fine, 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 indicato.

Il campo restockingFee nel corpo della risposta rappresenta la tariffa 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 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

Una volta che la richiesta è andata a buon fine, la risposta contiene tutte le norme sui resi 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
    }
  ]
}

In questo corpo della risposta, il campo returnPolicyId rappresenta l'identificatore univoco per le norme sui resi online.

Il campo returnMethods indica i metodi consentiti per restituire gli elementi. 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 norme sui resi online

Per creare norme 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 un esempio di risposta di una chiamata andata a buon fine:

{
  "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 le norme sui resi. Per maggiori informazioni, consulta l'articolo 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.