La Content API consente di specificare le tasse 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 l'IVA e la spedizione a livello di articolo tramite il servizio products.
Per informazioni sulle norme di Google e sulla gamma completa di opzioni per specificare tasse e spese di spedizione, consulta i seguenti articoli del Centro assistenza:
Tieni presente che l'attributo tax, e quindi l'uso del servizio fiscale fiscale, si applica solo ai prodotti destinati agli Stati Uniti.
I servizi di account Taxtax e shippingsettings riflettono la funzionalità dell'interfaccia utente di Merchant Center.
Esempio semplice
Per le tariffe di spedizione di 8 euro in Francia e basate sulle tariffe dei corrieri negli Stati Uniti, dove ogni servizio di spedizione richiede 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 degli operatori disponibili, utilizza il metodo getsupportedcarriers.
Esempio complesso
Per creare una promozione di spedizione gratuita negli stati vicini a New York (non addebitando i costi di spedizione), utilizza UPS per gli altri Stati Uniti e per applicare un'imposta diversa per ciascuno degli stati degli Stati Uniti, utilizza le richieste inviate ai servizi accounttax e shippingsettings di Content API come indicato di seguito. Innanzitutto, 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*" }
]
}
]
}
Tieni presente che gli ID località possono essere utilizzati per rappresentare le aree amministrative.
A seguire, 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 dei corrieri sono disponibili solo negli Stati Uniti, in Germania e in Australia. I gruppi di località sono attualmente supportati negli Stati Uniti e in Australia.
Regole di spedizione complesse: tabelle e sottotabelle bidimensionali
Per definire una promozione di spedizione di 7 $ negli Stati Uniti, 3 o 5 $ per gli ordini di peso superiore a 10 libbre a New York, a seconda del prezzo dell'ordine, e della spedizione gratuita al di sotto di tale peso, 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: suddividere le etichette di spedizione tra i servizi
Nelle impostazioni di spedizione, ogni servizio di spedizione può contenere al massimo 20 gruppi di tariffe di spedizione. Poiché i gruppi di tariffe di spedizione vengono utilizzati per distinguere le tariffe di spedizione tramite le etichette di spedizione, questo può sembrare indicare che è possibile applicare solo 20 tariffe di spedizione univoche tramite le etichette di spedizione. Tuttavia, puoi avere fino a 20 servizi di spedizione per paese. Suddividendo le tariffe distinte per le etichette di spedizione in più servizi per lo stesso paese, puoi distinguere fino a 400 tariffe di spedizione univoche tramite etichette di spedizione.
Nota: se hai più servizi, ogni prodotto in un determinato paese viene confrontato con tutti i servizi di spedizione per tale 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 univoche in due servizi diversi. Questo esempio nasconde gli altri dettagli della risorsa di spedizione, ad esempio 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 può essere necessaria anche per le
etichette di spedizione, anche se le stesse condividono la stessa tariffa, in quanto ogni gruppo può avere solo 30 etichette di spedizione nel campo
applicableShippingLabels. Quindi, come esempio estremo,
se tutte le etichette di spedizione condividono la stessa struttura di tariffe, shippingsettings può gestire fino a
12.000 etichette di spedizione per un singolo paese: 30 etichette di spedizione per gruppo
di tariffe, 20 gruppi di tariffe per servizio di spedizione e 20 servizi di spedizione per
paese.
Per ulteriori informazioni, consulta la documentazione di riferimento per accounttax e shippingsettings.