Ebit - Banner - Introdução

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

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

Abaixo fornecemos um exemplo de código. Implemente este código com as informações de sua loja, sem nenhuma alteração, na página de confirmação de compra:

Imagem do banner:

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

Parâmetros com dados da compra:

<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}"
/>

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>

 

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 ser conter todos os itens preenchidos e separados por | (PIPE) respectivamente.

Exemplo com 1 item de produto na transação:

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.

 

Os valores 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"
/>

Exemplo com mais de 1 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"
/>

No exemplo com mais de 1 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

Identificação da loja.

Atributo Tipo Descrição
storeId Int (Obrigatório) ID da loja no 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 - Iphones.
  • 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 são:

  • F (Feminino)
  • M (Masculino)
birthDay String Data de nascimento do usuário. Deve ser no formato DD-MM-AAAA. (DD = dia, MM = mês, AAAA = ano)
zipCode String Código postal do usuário (CEP).

Nomenclatura dos parâmetros para a compra.

Atributo Tipo Descrição
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 ou mais).
deliveryTax Decimal (Obrigatório) Para frete grátis informar o número 0. Quando o frete for cobrado informar o valor do frete. O separador decimal deve ser o ponto final. (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 Market Place, 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. O separador decimal deve ser um ponto. (Ex: 210.39)
value Decimal (Obrigatório) Valor do item da transação. O separador decimal deve ser um ponto. (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.
invoiceEmissor Int Instituição emissora.
Valores aceitos são:
  • 4 (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:
  • 5 (Cartão de Crédito),
  • 8 (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).
eanCode 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).