L'API Content ti consente di specificare le imposte e la spedizione che verranno applicate a tutti i prodotti all'interno di un account tramite i servizi shippingsettings e accounttax. Se vuoi essere più preciso, puoi specificare le imposte e la spedizione a livello di articolo tramite il servizio Prodotti.
Per informazioni sulle norme di Google e sulla gamma completa di opzioni per specificare imposte e spedizione, consulta i seguenti articoli del Centro assistenza:
Tieni presente che l'attributo tax e, di conseguenza, l'utilizzo del servizio accounttax, è applicabile solo ai prodotti che hanno come target gli Stati Uniti.
I servizi API Content accounttax e shippingsettings rispecchiano la funzionalità della UI di Merchant Center.
Esempio semplice
Per le spese di spedizione di 8 € in Francia e in base alle tariffe del corriere negli Stati Uniti, dove ogni servizio di spedizione impiega 3-7 giorni per la consegna:
PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
"accountId": <account_id>,
"services": [
{
"name": "Livraison Prioritaire",
"deliveryCountry": "FR",
"currency": "EUR",
"rateGroups": [
{
"singleValue": {
"flatRate": { "currency": "EUR", "value": "8" }
}
}
],
"active": true,
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
},
{
"name": "UPS in US",
"deliveryCountry": "US",
"currency": "USD"
"rateGroups": [
{
"singleValue": { "carrierRateName": "ups" },
"carrierRates": [
{
"name": "ups",
"carrierName": "UPS",
"carrierService": "Ground",
"originPostalCode": "10011"
}
]
}
],
"active": true,
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 },
}
]
}Per recuperare i nomi e i servizi dei corrieri disponibili, utilizza il metodo getsupportedcarriers.
Esempio complesso
Per creare una promozione con spedizione gratuita negli stati intorno a New York (senza addebitare la spedizione), utilizzare UPS per il resto degli Stati Uniti e applicare un'imposta diversa per ciascuno degli stati degli Stati Uniti, utilizza le richieste ai servizi accounttax e shippingsettings di Content API nel seguente modo. Per prima cosa, configura le impostazioni di spedizione:
PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
"accountId": <account_id>,
"services": [
{
"name": "Eligible for free shipping",
"deliveryCountry": "US",
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"locations": [
{ "locationIds": ["21167"] }, // NY
{ "locationIds": ["21164", "21139"] } // NJ, CT
]
},
"rows": [
{
"cells": [
{
"flatRate": { "currency": "USD", "value": "0" }
}
]
},
{
"cells": [
{
"flatRate": { "currency": "USD", "value": "0" }
}
]
}
]
}
}
],
"active": true,
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 },
"currency": "USD"
},
{
"name": "UPS in US",
"deliveryCountry": "US",
"rateGroups": [
{
"singleValue": { "carrierRateName": "UPS mainland" },
"carrierRates": [
{
"name": "UPS mainland",
"carrierName": "UPS",
"carrierService": "Ground",
"originPostalCode": "10011", // currently only US, AU, and DE postal codes
"percentageAdjustment": "1.05",
"flatAdjustment": { "currency": "USD", "value": "0.75" }
}
]
}
],
"active": true,
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 },
"currency": "USD"
}
],
"postalCodeGroups": [
{
"name": "More cities", // An alternative using postal codes
"country": "US",
"postalCodeRanges": [
{ "postalCodeRangeBegin": "94041" },
{ "postalCodeRangeBegin": "94042" },
{ "postalCodeRangeBegin": "94043", "postalCodeRangeEnd": "94045" },
{ "postalCodeRangeBegin": "9405*" },
{ "postalCodeRangeBegin": "9406*", "postalCodeRangeEnd": "9408*" }
]
}
]
}Gli ID località possono essere utilizzati per rappresentare le aree amministrative.
Successivamente, configura gli addebiti fiscali:
PUT /content/v2.1/<merchant_id>/accounttax/<account_id>
{
"accountId": <account_id>,
"rules": [
{
"country": "US", // currently only US is supported, may be omitted
"locationId": 21167,
"useGlobalRate": true,
"shippingTaxed": false
},
{
"locationId": 21137,
"useGlobalRate": false,
"shippingTaxed": true,
"ratePercent": "2.15"
}
// ...
]
}Nota: le tariffe corriere sono disponibili solo negli Stati Uniti, in Germania e in Australia. Al momento i gruppi di località sono supportati negli Stati Uniti e in Australia.
Regole di spedizione complesse: tabelle bidimensionali e sottotabelle
Per definire una promozione per la spedizione di 7 $negli Stati Uniti, 3 $ o 5 $per gli ordini di peso superiore a 4,5 kg a New York, a seconda del prezzo dell'ordine, e senza costi per gli ordini di peso inferiore, utilizza quanto segue:
PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id> { "accountId": <account_id>, "services": [ { "name": "Custom shipping rules", "deliveryCountry": "US", "rateGroups": [ { "mainTable": { "rowHeaders": { "postalCodeGroupNames": [ "NYC", "all other locations" ] }, "columnHeaders": { "weights": [ { "unit": "lb", "value": "10" }, { "unit": "lb", "value": "infinity" } ] }, "rows": [ { "cells": [ { "flatRate": { "value": "0", "currency": "USD" } }, { "subtableName": "NYC large packages" } ] }, { "cells": [ { "flatRate": { "value": "7", "currency": "USD" } }, { "flatRate": { "value": "7", "currency": "USD" } } ] } ] }, "subtables": [ { "name": "NYC large packages", "rowHeaders": { "prices": [ {"value": "100", "currency": "USD"}, {"value": "infinity", "currency": "USD"}] }, "rows": [ { "cells": [ { "flatRate": { "value": "3", "currency": "USD" } } ] }, { "cells": [ { "flatRate": { "value": "5", "currency": "USD" } } ] } ] } ] } ], "active": true, "currency": "USD", "deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 } } ], "postalCodeGroups": [ { "name": "NYC", // Approximation of NYC using postal codes "country": "US", "postalCodeRanges": [ { "postalCodeRangeBegin": "10000", postalCodeRangeEnd: "11999" } ] } ] }
Regole di spedizione complesse: suddivisione delle etichette di spedizione tra i servizi
In shippingsettings, ogni servizio di spedizione può contenere un massimo di 20 gruppi di tariffe di spedizione. Poiché i gruppi di tariffe di spedizione vengono utilizzati per distinguere le tariffe di spedizione tramite le etichette spedizione, ciò potrebbe sembrare suggerire che solo 20 tariffe di spedizione uniche possono essere applicate tramite le etichette spedizione. Tuttavia, puoi avere fino a 20 servizi di spedizione per paese. Suddividendo le tariffe distinte per etichette spedizione in più servizi per lo stesso paese, puoi distinguere fino a 400 tariffe di spedizione uniche tramite le etichette spedizione.
Nota: se hai più servizi, ogni prodotto per un determinato paese viene confrontato con tutti i servizi di spedizione per quel paese per calcolare le possibili tariffe di spedizione. Se più servizi restituiscono tariffe diverse per lo stesso prodotto, verrà utilizzata la tariffa più bassa.
L'esempio seguente suddivide 40 etichette di spedizione utilizzando tariffe uniche per due servizi diversi. Questo esempio nasconde gli altri dettagli della risorsa di spedizione, come le tariffe effettive, dietro i puntini di sospensione.
PUT /content/v2.1/<merchant_id>/shippingsettings/<account_id>
{
"accountId": <account_id>,
"services": [
{
"name": "labels_0_19",
"deliveryCountry": "US",
"active": true,
"currency": "USD",
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
"rateGroups": [
{ "applicableShippingLabels": ["shipping_label_0"], ... }
{ "applicableShippingLabels": ["shipping_label_1"], ... }
{ "applicableShippingLabels": ["shipping_label_2"], ... }
{ "applicableShippingLabels": ["shipping_label_3"], ... }
{ "applicableShippingLabels": ["shipping_label_4"], ... }
{ "applicableShippingLabels": ["shipping_label_5"], ... }
{ "applicableShippingLabels": ["shipping_label_6"], ... }
{ "applicableShippingLabels": ["shipping_label_7"], ... }
{ "applicableShippingLabels": ["shipping_label_8"], ... }
{ "applicableShippingLabels": ["shipping_label_9"], ... }
{ "applicableShippingLabels": ["shipping_label_10"], ... }
{ "applicableShippingLabels": ["shipping_label_11"], ... }
{ "applicableShippingLabels": ["shipping_label_12"], ... }
{ "applicableShippingLabels": ["shipping_label_13"], ... }
{ "applicableShippingLabels": ["shipping_label_14"], ... }
{ "applicableShippingLabels": ["shipping_label_15"], ... }
{ "applicableShippingLabels": ["shipping_label_16"], ... }
{ "applicableShippingLabels": ["shipping_label_17"], ... }
{ "applicableShippingLabels": ["shipping_label_18"], ... }
{ "applicableShippingLabels": ["shipping_label_19"], ... }
]
},
{
"name": "labels_20_39",
"deliveryCountry": "US",
"active": true,
"currency": "USD",
"deliveryTime": { "minTransitTimeInDays": 3, "maxTransitTimeInDays": 7 }
"rateGroups": [
{ "applicableShippingLabels": ["shipping_label_20"], ... }
{ "applicableShippingLabels": ["shipping_label_21"], ... }
{ "applicableShippingLabels": ["shipping_label_22"], ... }
{ "applicableShippingLabels": ["shipping_label_23"], ... }
{ "applicableShippingLabels": ["shipping_label_24"], ... }
{ "applicableShippingLabels": ["shipping_label_25"], ... }
{ "applicableShippingLabels": ["shipping_label_26"], ... }
{ "applicableShippingLabels": ["shipping_label_27"], ... }
{ "applicableShippingLabels": ["shipping_label_28"], ... }
{ "applicableShippingLabels": ["shipping_label_29"], ... }
{ "applicableShippingLabels": ["shipping_label_30"], ... }
{ "applicableShippingLabels": ["shipping_label_31"], ... }
{ "applicableShippingLabels": ["shipping_label_32"], ... }
{ "applicableShippingLabels": ["shipping_label_33"], ... }
{ "applicableShippingLabels": ["shipping_label_34"], ... }
{ "applicableShippingLabels": ["shipping_label_35"], ... }
{ "applicableShippingLabels": ["shipping_label_36"], ... }
{ "applicableShippingLabels": ["shipping_label_37"], ... }
{ "applicableShippingLabels": ["shipping_label_38"], ... }
{ "applicableShippingLabels": ["shipping_label_39"], ... }
]
}
],
"postalCodeGroups": [ ... ]
}
Questa suddivisione delle etichette spedizione nei gruppi di tariffe potrebbe essere necessaria
anche se le etichette spedizione condividono la stessa tariffa di spedizione, poiché ogni gruppo di tariffe
può avere solo 30 etichette spedizione nel campo
applicableShippingLabels. Quindi, come esempio estremo,
se tutte le etichette spedizione condividono la stessa struttura tariffaria, shippingsettings può gestire fino a
12.000 etichette spedizione per un singolo paese: 30 etichette spedizione per gruppo di tariffe, 20 gruppi di tariffe per servizio di spedizione e 20 servizi di spedizione per paese.
Per saperne di più, consulta la documentazione di riferimento per accounttax e shippingsettings.