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:
- accounts.onlineReturnPolicies.get
- accounts.onlineReturnPolicies.list
- accounts.onlineReturnPolicies.create
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 accedere, registrarsi o inserire informazioni personali. Inoltre, assicurati che le norme sui resi siano coerenti tra Merchant Center e il tuo sito web.
Recuperare le norme sui resi online esistenti
Per recuperare le norme sui resi online esistenti, utilizza il accounts.onlineReturnPolicies.get.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}
Se la richiesta va a buon fine, la risposta contiene la 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 commissione di riassortimento, che può essere una tariffa fissa o una percentuale del prezzo dell'articolo in micro.
Elencare tutte le norme sui resi online
Per elencare tutte le norme sui resi online, utilizza il accounts.onlineReturnPolicies.list, come mostrato nella seguente richiesta:
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies
Se la richiesta va 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
}
]
}
Nel corpo della risposta, il campo returnPolicyId rappresenta l'identificatore univoco delle norme 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 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"
}
Di seguito è riportata 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 ulteriori 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.