Content API vous permet de spécifier les taxes et les paramètres de livraison qui s'appliquent à tous les produits de votre compte via les services Shippingsettings et Accounttax. Si vous souhaitez fournir des informations plus précises, vous pouvez définir les taxes et les paramètres de livraison au niveau d'articles individuels via le service Products.
Pour en savoir plus sur les règles de Google et sur les options de définition des taxes et de la livraison, consultez les articles suivants du centre d'aide :
Sachez que l'attribut tax, et donc l'utilisation du service Accounttax, ne s'appliquent qu'aux produits ciblant les États-Unis.
Les services Accounttax et Shippingsettings de Content API présentent les mêmes fonctionnalités que celles de l'interface utilisateur de Merchant Center.
Exemple simple
Pour définir des frais de port de 8 euros en France basés sur les tarifs d'un transporteur aux États-Unis, où chaque livraison est réalisée dans un délai de 3 à 7 jours, procédez comme suit :
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 },
}
]
}Vous pouvez récupérer les noms et les services de transporteurs disponibles à l'aide de la méthode getsupportedcarrier.
Exemple complexe
Pour proposer la livraison gratuite dans les États autour de New York (aucuns frais de port facturés), utiliser UPS dans le reste des États-Unis et appliquer des taxes différentes pour chacun des États, envoyez des requêtes aux services Accounttax et Shippingsettings de Content API comme suit. Commencez par configurer les paramètres de livraison :
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*" }
]
}
]
}Notez que les ID de zone géographique peuvent être utilisés pour représenter des régions administratives.
Ensuite, configurez les taxes :
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"
}
// ...
]
}Remarque : Les tarifs de transporteurs ne sont disponibles qu'en Allemagne, en Australie et aux États-Unis. Les groupes de zones géographiques sont actuellement acceptés pour l'Australie et les États-Unis.
Règles de livraison complexes : tableaux et sous-tableaux à deux dimensions
Pour créer une promotion proposant des frais de port de 7 $ aux États-Unis, de 3 $ ou de 5 $ pour les commandes pesant plus de 4,5 kg à New York selon leur montant et la livraison gratuite pour les commandes inférieures à ce poids, envoyez la requête suivante :
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" } ] } ] }
Règles de livraison complexes : répartir les étiquettes de livraison entre les services
Dans "Shippingsettings", chaque service de livraison ne peut contenir que 20 groupes de frais de port maximum. Comme les groupes de frais de port servent à différencier les différents tarifs au moyen d'étiquettes de livraison, on peut penser que seuls 20 frais de port uniques peuvent être appliqués via des étiquettes de livraison. Cela dit, vous pouvez définir jusqu'à 20 services de livraison par pays. En répartissant les frais distingués par les étiquettes de livraison sur plusieurs services dans le même pays, vous pouvez configurer jusqu'à 400 frais de port uniques grâce aux étiquettes de livraison.
Remarque : Si vous proposez plusieurs services de livraison, ces derniers sont comparés pour chaque produit dans un pays donné afin de calculer les frais de port possibles. Si plusieurs services renvoient des tarifs différents pour le même produit, le tarif le plus bas sera appliqué.
Dans l'exemple ci-dessous, 40 étiquettes de livraison associées à des frais de port uniques sont réparties entre deux services différents. Les autres détails de la ressource de livraison, comme les tarifs exacts, sont représentés par des points de suspension.
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": [ ... ]
}
Vous pouvez également avoir besoin de répartir des étiquettes de livraison en groupes de frais de port lorsqu'elles partagent les mêmes frais de port, car chaque groupe ne peut contenir que 30 étiquettes de livraison dans le champ applicableShippingLabels. Pour prendre un exemple extrême, si toutes les étiquettes de livraison possèdent la même structure tarifaire, Shippingsettings peut traiter jusqu'à 12 000 étiquettes de livraison pour un seul pays : 30 étiquettes de livraison par groupe de frais de port, 20 groupes de frais de port par service de livraison et 20 services de livraison par pays.
Pour en savoir plus, consultez la documentation de référence sur Accounttax et Shippingsettings.