Gerar código de integração do banner


O código a ser implementado é dividido em três partes:

  • 1) Os parâmetros com dados da compra;
  • 2) A chamada da imagem do banner;
  • 3) O script do banner.

1) Parâmetros com dados da compra.


Substitua os termos em destaque pelas variáveis com informações correspondentes em sua plataforma de e-commerce:

<param id="ebitParam"
value="email=email
&gender=gender
&birthDay=birthDay
&zipCode=zipCode
&parcels=parcels
&deliveryTax=deliveryTax
&deliveryTime=deliveryTime
&totalSpent=totalSpent
&value=value
&quantity=quantity
&productName=productName
&transactionId=transactionId
&ean=eanCode
&sku=sku
&buscapeId=BuscapeId
&storeId=storeId"
/>

2) Código da imagem do banner (implemente como está):


<a id="bannerEbit"></a>

3) Substitua o termo "storeId" pelo ID de sua loja na Ebit e implemente o script do banner:


<script type="text/javascript" id="getSelo"src="https://imgs.ebit.com.br/ebitBR/selo-ebit/js/getSelo.js?storeId&lightbox=true"></script>

Atenção

  • Caso opte por não fornecer algum(ns) dos parâmetros não obrigatórios (não recomendado), basta retirar a(s) linha(s) de código referente(s) ao(s) parâmetro(s).
  • Caso queira desabilitar o lightbox para sua loja (não recomendado) troque o trecho do código script do banner "lightbox=true" para "lightbox=false".

Como fica o código completo:

(Substitua os termos em destaque pelas variáveis com informações correspondentes em sua plataforma de e-commerce).

<param id="ebitParam" value="email=email&gender=gender&birthDay=birthDay&zipCode=zipCode&parcels=parcels&deliveryTax=deliveryTax&deliveryTime=deliveryTime&totalSpent=totalSpent&value=value&quantity=quantity&productName=productName&transactionId=transactionId&ean=eanCode&sku=sku&buscapeId=BuscapeId&storeId=storeId" />

<a id="bannerEbit"></a>

<script type="text/javascript" id="getSelo" src="https://imgs.ebit.com.br/ebitBR/selo-ebit/js/getSelo.js?storeId&lightbox=true"></script>

Mais de um item de compra:


Uma transação pode ter mais de um item de compra, por exemplo: TV LED 32 e CONSOLE DE VIDEOGAME.

Os campos productName, value, quantity e sku devem conter todos os itens preenchidos e separados por | (PIPE) respectivamente.

Exemplo: com 1 item de produto na transação. Atenção: Substitua os termos em destaque pelas variáveis com informações correspondentes em sua plataforma de e-commerce:

Dados da compra:

  • E-mail (e-mail): email@email.com
  • Sexo (gender): Masculino
  • Data de Nascimento (birthDay): 01/01/1980
  • CEP (zipCode): 00000-000
  • Parcelas (parcels): 1
  • Taxa de Entrega (deliveryTax): 0 (gratuito)
  • Total da Compra - Somando entrega e com descontos (totalSpent): 1000.00
  • Preço de VENDA do produto - ou seja, com desconto aplicado - unitário (value): 1000.00
  • Quantidade do produto (quantity): 1
  • Nome do Produto - Encodado para URLs (productName): PRODUTO
  • ID da Transação (transacionId): 1000-abcd
  • SKU do produto (sku) = SKU_PRODUTO
  • Seu ID Buscapé (buscapeId): 1
  • Seu ID Ebit (storeId): 1
Atenção: Não se esqueça de
substituir pelo ID de sua loja na Ebit

Os valores do exemplo, então, ficarão:

<param id="ebitParam"
value="email=email@email.com
&gender=M
&birthDay=01-01-1980
&zipCode=00000000
&parcels=1
&deliveryTax=0
&deliveryTime=3
&totalSpent=1000.00
&value=1000.00
&quantity=1
&productName=PRODUTO
&transactionId=1000-abcd
&sku=SKU_PRODUTO
&buscapeId=1
&storeId=1"
/>
Atenção: Não se esqueça de
substituir pelo ID de sua loja na Ebit

Exemplo com mais de um item de produto na transação:

<param id="ebitParam"
value="email=email@email.com
&gender=M
&birthDay=01-01-1980
&zipCode=00000000
&parcels=1
&mktSaleID=00000|00000|00000
&deliveryTax=00000|00000|00000
&deliveryTime=3|2|1
&totalSpent=2500.00
&value=1000.00|500.00|500.00
&quantity=1|1|2
&productName=PRODUTO1|PRODUTO2|PRODUTO3
&transactionId=1000
&sku=SKU_PRODUTO1|SKU_PRODUTO2|SKU_PRODUTO3
&buscapeId=1
&storeId=1"
/>
Atenção: Não se esqueça de
substituir pelo ID de sua loja na Ebit

No exemplo com mais de um item, podemos visualizar a separação por | (PIPE) em vermelho, o valor total (totalSpent) continua sendo o total da transação com a soma de todos os seus itens.

Parâmetros

Nomenclatura dos parâmetros para a identificação da loja

Atributo Tipo Descrição
storeId Int (Obrigatório) ID da loja na Ebit
BuscapeId Int (Obrigatório) ID da loja no Buscapé
plataform String (Obrigatório) Esse parâmetro indica se a compra é proveniente de um APP, sendo que os valores são:
  • 0 - Não APP . Compra feita via interface normal, responsiva ou não, via mobile ou outro device
  • IOS - Dispositivos IOS, como iPod ou não identificados
  • IPAD - iPad
  • IPHONE - iPhone
  • WP - Windows Phone
  • ANDROID - Devices Android
  • OUTROS

Nomenclatura dos parâmetros para o associado/cliente

Atributo Tipo Descrição
email String (Obrigatório) E-mail do comprador
gender String Gênero. Opções aceitas:
  • F (Feminino)
  • M (Masculino)
birthDay String Data de nascimento do usuário. Atenção! É obrigatório o uso do formato DD-MM-AAAA. (Em que DD = dia, MM = mês, AAAA = ano)
zipCode String Código postal do usuário (CEP)
parcels Int Quantidade de parcelas da transação. Valores aceitos são:
  • 1 (à vista)
  • 2 (2 vezes)
  • 3 (3 vezes)
  • 4 (4 vezes)
  • 5 (5 vezes)
  • 6 (6 vezes)
  • 7 (7 vezes)
  • 8 (8 vezes)
  • 9 (9 vezes)
  • 10 (10 vezes)
  • 11 (11 vezes)
  • 12 (12 vezes)
  • 13 (13 vezes)
deliveryTax Decimal (Obrigatório) Para frete grátis informar o número 0.
Quando o frete for cobrado informar o valor do frete.
É obrigatório o fornecimento das 2 casas decimais e o uso do ponto final como separador decimal.
(Ex: 10.50)
deliveryTime Int Tempo de frete em dias corridos. (Ex: 3)
mktSaleID String (Obrigatório) Esse parâmetro informa se a compra ocorreu através de Marketplace, sendo que os valores são: 0 - Caso a compra não tenha sido realizada através de Marketplace N - Código da loja do Marketplace
totalSpent Decimal (Obrigatório) Valor total da transação.
É obrigatório o fornecimento das 2 casas decimais e o uso do ponto final como separador decimal.
(Ex: 210.39)
value Decimal (Obrigatório) Valor do item da transação.
É obrigatório o fornecimento das 2 casas decimais e o uso do ponto final como separador decimal. (Ex: 1210.39).
Caso seja uma lista, concatenar com | (Pipe). No caso de haver desconto na compra, os valores deverão ser enviados com o mesmo desconto, de modo que a soma dos valores somados com o frete resultem igual o totalSpent.
quantity Quantidade por item de produto (Obrigatório) Quantidade por item de produto.
Caso seja uma lista, concatenar com | (Pipe).
productName String (Obrigatório) Nome do produto (Caso seja uma lista, concatenar com | (Pipe). Este parâmetro deve ser encodado no formato ASCII para URLs. (Ex: TV LED 32 POLEGADAS | NOTEBOOK 2 GB RAM)
transactionId String (Obrigatório) ID da transação (Nº do pedido)
invoiceEmissor Int Instituição emissora. Valores aceitos são:
  • 04 (Banco do Brasil)
  • 10 (Bradesco)
  • 11 (Caixa Econômica Federal)
  • 12 (Citibank)
  • 13 (Credicard)
  • 14 (HSBC)
  • 15 (Itaú)
  • 16 (Santander)
  • 19 (Outros)
  • 32 (Cetelem)
paymentType Int Tipo de pagamento. Valores aceitos são:
  • 05 (Cartão de Crédito)
  • 08 (Boleto Bancário)
  • 14 (Outros)
  • 24 (Cartão da Loja)
  • 25 (Pagamento por Celular)
  • 28 (Cartão de Débito / Débito em Conta)
cardFlag Int Bandeira do pagamento. Valores aceitos são:
  • 1 (American Express)
  • 2 (Aura)
  • 3 (Diners Club)
  • 4 (Hipercard)
  • 5 (Mastercard)
  • 6 (VISA)
  • 7 (Outros)
  • 8 (Elo)
ean String Código EAN do produto
Sku String (Obrigatório) Código SKU do produto. Se o código SKU possuir espaços e/ou caracteres especiais, ele deverá ser encodade no formato ASCII para URLs. ATENÇÂO : Informar o SKU exatamente como é enviado para o Buscapé.
lang String Linguagem da exibição (Caso não informado toma o valor pt_BR). Opções aceitas são:
  • pt_BR (Português)
  • en_US (Inglês)
  • es_AR (Espanhol)