DOCS

Hello events

/

Hello eventos

Como usar eventos do Hello.

Aprenda como o Zonos Hello utiliza eventos e métodos, e como você pode usá-los para aprimorar seu site de comércio eletrônico.

z-country-change 

Este evento será acionado cada vez que o país for alterado, incluindo a seleção inicial do país. A propriedade detail do evento será um objeto que inclui code e name.

PropriedadeDescrição
codeCódigo ISO de dois caracteres do país de origem do produto
nameNome do país

Hello script de integração

1
2
3
4
{
  "code": "US",
  "name": "United States"
}

z-duty-tax-quote 

Este evento será acionado uma vez que uma resposta de cotação de impostos e taxas for recebida. A propriedade detail do evento será um objeto com as seguintes propriedades:

PropriedadeDescrição
subtotalO subtotal do item no qual a cotação foi baseada
taxOrVatO valor estimado do imposto sobre vendas ou VAT cotado com base no subtotal
dutyTotalO valor estimado do imposto cotado com base no subtotal
dutyTaxTotalOs valores combinados de taxOrVat e dutyTotal
foreign (premium)Um objeto contendo os mesmos valores acima, que são então convertidos para o valor em moeda estrangeira

Hello script de integração

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "subtotal": 89.99,
  "taxOrVat": 18.0,
  "dutyTotal": 32.54,
  "dutyTaxTotal": 50.54,
  "foreign": {
    "currencyCode": "GBP",
    "subtotal": 89.99,
    "taxOrVat": 18.0,
    "dutyTotal": 32.54,
    "dutyTaxTotal": 50.54
  }
}

z-message-change 

Este evento será acionado sempre que a mensagem exibida Hello for alterada. A propriedade do evento detail será um objeto que inclui a message.

PropriedadeDescrição
messageString HTML da mensagem atualmente exibida

Hello script de integração

1
2
3
{
  "message": "<div>Welcome ...</div>"
}

Métodos 

Abaixo estão métodos utilitários que você pode usar para integrar com seu site.

MétodoRetornaDescrição
zonos.isDomestic()BooleanoVerdadeiro se o país atual for doméstico
zonos.country()StringObtém o código do país atualmente selecionado.
zonos.country(code)StringDefine o país manualmente e o retorna. code deve ser um código ISO de dois caracteres.

zonos.config(object) é um método utilizado por Hello. Ele pode ser configurado para trabalhar com estimativas de cotações, conversão de moeda ou reexibição da Hello splash screen e movimentação da posição da bandeira. Dependendo do que você deseja fazer, o objeto enviado para config muda:

TarefaPreencha a configuração com o objeto como…
Estimativas de cotações{detail: {items: [{id: "String", name: "String", price: Double / "String", quantity: Integer / "String", image: "String URL da imagem / Opcional", hsCode: "String / Opcional", category: "String / Opcional", country: "String (país de origem) / Opcional", SKU: "String / Opcional"}], currencyCode: "String / opcional padrão para USD", includedTaxRate: Double / opcional padrão para 0}}
Conversão de moeda{detail: {currencySelectors: ["seletor css 1", "seletor css 2"], customConverter: "função personalizada para converter os seletores / Opcional, melhor deixar como padrão", showDecimal: booleano / Opcional}}
Reexibição da Hello splash screen e movimentação da posição da bandeira{detail: {location: "Opções de String são: left, right, top, bottom, floating & attached / Opcional", showSplash: booleano / Opcional}}

Esta página foi útil?