e commerces DOCUMENTO DE INTEGRAÇÃO Sumário Dúvidas: Atualizado em: 10/09/2014

Tamanho: px

Começar a partir da página:

Download "e commerces DOCUMENTO DE INTEGRAÇÃO Sumário Dúvidas: 55 51 3023.2332 suporte@hookit.cc www.hookit.cc Atualizado em: 10/09/2014"

Martim Martini Pais
8 Há anos
Visualizações:

1 DOCUMENTO DE INTEGRAÇÃO e commerces Atualizado em: 10/09/2014 Sumário 1. Cadastro e atualização de produtos 2. Exibição do botão Hookar 3. Conversão de acesso em venda 4. Status das vendas

2 1. Cadastro e atualização de produtos Para que o e commerce tenha seus produtos exibidos na vitrine do Hookit, terá que disponibilizar a URL de um XML onde tenham os seguintes dados: Tag no XML Tipo de dado Descrição <codigo> String (45) Identificação do produto <nome> String (255) Nome do produto <descricao> Long Text Descrição do produto <valor> Float (10,2) Preço do produto <imageurl> String (255) URL da imagem principal do produto <linkurl> String (255) URL do produto no e commerce IMPORTANTE: Caso um produto que já adicionado anteriormente não constar no XML, o mesmo não será exibido no Hookit até que seus dados sejam adicionado novamente nos próximos XMLs. Ou seja, se um produto estiver inativo no e commerce, ele não deverá aparecer no XML de atualização. Parâmetros de campanha para a URL dos produtos: exemplo.com.br?utm_source=hookitcc&utm_medium=afiliado&utm_campaign=hookit Exemplo de arquivo XML a ser disponibilizado para atualização de produtos: xml produtos.xml Esse XML será conferido uma vez ao dia pelo Hookit, e seus dados serão imediatamente alterados no sistema. Ao e commerce cabe a responsabilidade de manter o XML o mais atualizado possível, preferencialmente uma vez ao dia.

3 2. Exibição do botão Hookar 2.1. Para exibir o botão Hookar junto aos produtos da loja virtual, o e commerce deverá inserir o script Hookit dentro da tag <head> das páginas dos produtos. <script type="text/javascript" src=" latest.min.js"></script> 2.2. Logo abaixo à chamada do script, deverá ser informada a ID do e commerce (Ex.: 9) dentro de um código javascript. <script type="text/javascript"> Hookit.init({ shopid: '9' }); </script> 2.3. Na página do produto, onde o e commerce desejar exibir o botão Hookar, deverá ser adicionado o seguinte código contendo a ID do produto em questão (Ex.: ) <div class="hkbutton style1" data productid=" "></div> Com isso, o botão Hookar será adicionado e, quando o usuário clicá lo, será exibida uma popup de compartilhamento nas redes sociais.

4 3. Conversão de acesso em venda Para informar ao Hookit que o acesso foi convertido em venda, o e commerce deverá adicionar três argumentos na função javascript que já está dentro da tag <head>: Finalize IDs dos produtos contidos no carrinho ID da venda: Identificador único da venda no e commerce Logo, o javascript da página de confirmação da venda ficará assim <script type="text/javascript"> Hookit.init({ shopid: '1', /*Código fornecido pelo HOOKIT*/,finalize: true, /*Apenas para a página de conclusão de venda*/,saleid: '40', /*Apenas para a página de conclusão de venda*/,productid: false }); </script> O parâmetro saleid servirá para que o e commerce atualize o Hookit sobre a situação do pagamento. Assim, saberemos se a venda foi confirmada ou cancelada. Caso o saleid não seja informado pelo e commerce no momento da finalização da compra, a venda será automaticamente registrada como confirmada e a comissão de conversão será repassada ao Hookster e ao Hookit.

5 4. Status das vendas Para garantir que a comissão ao Hookit e aos Hooksters sejam pagas apenas sobre as vendas com pagamento aprovado, será disponibilizada uma dinâmica de atualização de status das vendas. Assim, o e commerce poderá avisar sempre que uma venda teve seu pagamento aprovada ou, por algum motivo, foi cancelada pelo cliente ou pelo próprio e commerce. Através de um XML, serão informados ao Hookit as atualizações das vendas. O hookit então, uma vez ao dia, lerá o XML e atualizará o registro da venda conforme informado pelo e commerce. O XML em questão deverá ser somente editado conforme instruções abaixo. XML para atualização dos dados da venda: Exemplo: xml vendas.xml Tag no XML Tipo de dado Descrição <id_venda> String (100) Identificação da venda <id_status> INT (1, 2, 3) 1 Confirmada, 2 Aguardando, 3 Cancelada <data_xml> Timestamp D/M/Y H:M:S Data de inclusão ao XML <data_venda> Timestamp D/M/Y H:M:S Data da venda na loja virtual <valor_total> Float (10,2) Valor total da venda Informação dos produtos da venda <codigo> String (45) Identificação do produto <quantidade> INT Quantidade do produto vendida <valor_unitario> Float (10,2) Valor unitário do produto

Documentos relacionados

Manual - Versão 1.2 1

Manual - Versão 1.2 1 2 Requisitos para emissão da Nota Fiscal de Consumidor eletrônica - Sistema Gerenciador Gestor Prime - Sistema Transmissor - Uninfe Instalado automaticamente pelo Gestor. - Internet