REST Resource: accounts.accounttax

Ressource: AccountTax

Paramètres de taxes d'un compte marchand. Toutes les méthodes nécessitent le rôle d'administrateur.

Représentation JSON
{
  "name": string,
  "account": string,
  "taxRules": [
    {
      object (TaxRule)
    }
  ]
}
Champs
name

string

Identifiant. Nom du paramètre de taxe. Format: "{accountTax.name=accounts/{account}}"

account

string (int64 format)

Uniquement en sortie. Numéro du compte auquel appartiennent ces paramètres de taxes.

taxRules[]

object (TaxRule)

Règles fiscales "Définissez les règles fiscales dans chaque région. Aucune taxe ne sera présentée si une région n'a pas de règle."

TaxRule

Convension du type principal

pourcentage micro : 100% = 1 000 000 et 1% = 10 000 ne peuvent pas être négatifs.

Informations sur le nexus de taxe et les paramètres associés applicables aux commandes livrées dans la zone couverte par un seul administrateur fiscal. Un Nexus est créé lorsqu'un marchand exerce ses activités dans une zone gérée par l'administrateur fiscal (seuls les États américains sont acceptés pour la configuration d'un Nexus). Si le marchand dispose d'un nexus dans un État américain, il doit payer des taxes à toutes les autorités fiscales associées à la destination de livraison. Identifiant suivant : 8

Représentation JSON
{
  "regionCode": string,
  "shippingTaxed": boolean,
  "effectiveTimePeriod": {
    object (Interval)
  },

  // Union field location can be only one of the following:
  "locationId": string,
  "postCodeRange": {
    object (TaxPostalCodeRange)
  }
  // End of list of possible types for union field location.

  // Union field rate_calculation can be only one of the following:
  "useGoogleRate": boolean,
  "selfSpecifiedRateMicros": string
  // End of list of possible types for union field rate_calculation.
}
Champs
regionCode

string

Code de la région dans laquelle cette règle s'applique

shippingTaxed

boolean

Si cette option est définie, les frais de port sont taxés (au même taux que le produit) lors des livraisons dans la zone géographique de cet administrateur. Ne peut être défini que sur les États américains sans catégorie.

effectiveTimePeriod

object (Interval)

Obligatoire. Période pendant laquelle cette règle entre en vigueur. Si la durée n'est pas spécifiée dans effective_time, la date de fin est ouverte dans le futur. Le début de cette période est inclusif, tandis que la fin est exclusive.

Champ d'union location. Décrivez la zone géographique à l'aide d'une plage de codes postaux ou d'un ID de critère. location ne peut être qu'un des éléments suivants :
locationId

string (int64 format)

Admin_id ou criteria_id de la région dans laquelle cette règle s'applique.

postCodeRange

object (TaxPostalCodeRange)

Plage de codes postaux à laquelle la règle est applicable.

Champ d'union rate_calculation. Comment calculer le taux de taxe pour les livraisons dans la zone de cet administrateur ? Ne peut être défini que sur les États américains. rate_calculation ne peut être qu'un des éléments suivants :
useGoogleRate

boolean

Tarif qui dépend du lieu de livraison: si le marchand dispose d'un nexus dans l'État américain correspondant, les tarifs des autorités compétentes concernant la zone de livraison sont additionnés.

selfSpecifiedRateMicros

string (int64 format)

Taux fixe spécifié en micros, où 100% = 1_000_000. Convient aux États appliquant un régime basé sur l'origine.

TaxPostalCodeRange

Plage de codes postaux définissant la zone.

Représentation JSON
{
  "start": string,
  "end": string
}
Champs
start

string

Obligatoire. Début de la plage de codes postaux, qui est également la plus petite de la plage.

end

string

Fin de la plage de codes postaux. Identique au début si aucune valeur n'est spécifiée.

Méthodes

get

Affiche les règles fiscales qui correspondent aux conditions de GetAccountTaxRequest

list

Liste les paramètres de taxes des sous-comptes uniquement dans votre compte Merchant Center.

patch

Met à jour les paramètres de taxes du compte.