REST Resource: accounts.accounttax

Recurso: AccountTax

As configurações fiscais de uma conta do comerciante. Todos os métodos exigem o papel de administrador.

Representação JSON
{
  "name": string,
  "account": string,
  "taxRules": [
    {
      object (TaxRule)
    }
  ]
}
Campos
name

string

Identificador. O nome da configuração de tributos. Formato: "{accountTax.name=accounts/{account}}"

account

string (int64 format)

Apenas saída. O ID da conta a que essas configurações de tributos pertencem.

taxRules[]

object (TaxRule)

Regras fiscais. "Defina as regras fiscais em cada região. Nenhum tributo será apresentado se uma região não tiver uma regra."

TaxRule

Convenção de tipo principal

porcentagem micro : 100% = 1.000.000 e 1% = 10.000 não podem ser negativos.

Informações sobre presença física e parâmetros relacionados aplicáveis a pedidos entregues na área coberta por um único administrador tributário. O Nexus é criado quando um comerciante faz negócios em uma área administrada por um administrador fiscal (somente os estados dos EUA são compatíveis com a configuração de presença física). Se o comerciante tiver presença física em um estado dos EUA, ele precisará pagar impostos a todas as autoridades fiscais associadas ao destino de envio. Próximo ID : 8.

Representação 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.
}
Campos
regionCode

string

Código da região a que esta regra é aplicável

shippingTaxed

boolean

Se definido, o frete é cobrado à mesma taxa do produto quando ele for entregue na área desse administrador. Só pode ser definido em estados dos EUA sem categoria.

effectiveTimePeriod

object (Interval)

Obrigatório. Período em que esta regra entra em vigor. Se a duração estiver ausente do effective_time listado, então ele é aberto para o futuro. O início desse período é inclusivo, e o final é exclusivo.

Campo de união location. Descreva o local por meio de um intervalo de código postal ou de um ID de critérios. location pode ser apenas de um dos tipos a seguir:
locationId

string (int64 format)

O "admin_id" ou o "criteria_id" da região em que essa regra é aplicável.

postCodeRange

object (TaxPostalCodeRange)

O intervalo de códigos postais ao qual essa regra é aplicável.

Campo de união rate_calculation. Como calcular a taxa de impostos para as entregas na área desse administrador? Pode ser definido apenas em estados dos EUA. rate_calculation pode ser apenas de um dos tipos a seguir:
useGoogleRate

boolean

Taxa que depende do local de entrega: se o comerciante tiver vínculo com um estado correspondente dos EUA, as taxas das autoridades com jurisdição sobre a área de entrega serão somadas.

selfSpecifiedRateMicros

string (int64 format)

Uma taxa fixa especificada em micros, em que 100% = 1_000_000. Adequado para estados com base na origem.

TaxPostalCodeRange

Um intervalo de códigos postais que define a área.

Representação JSON
{
  "start": string,
  "end": string
}
Campos
start

string

Obrigatório. O início do intervalo de código postal, que também é o menor no intervalo.

end

string

Fim do intervalo de códigos postais. Se não for especificado, será igual a "start".

Métodos

get

Retorna as regras fiscais que correspondem às condições de GetAccountTaxRequest

patch

Atualiza as configurações de tributos da conta.