# Sobre o espaco

Neste espaço você encontrará toda a documentação dos módulos desenvolvidos por nossa equipe além de dicas, informações e sugestões para solucionar dúvidas e otimizar detalhes importantes do seu e-comm

As informações desta página, assim como de todos os tópicos internos, são constantemente atualizados, incluindo sugestões úteis e tutoriais simplificados. Explorando cada uma delas você conhece mais sobre nossos módulos e analisa em detalhes todas as mudanças e novidades desenvolvidas pela NeoGest.

## Sobre a NeoGest

A NeoGest é uma empresa especializada em soluções para plataforma PrestaShop, localizada na cidade de Presidente Prudente, interior do estado de São Paulo. 

<div align="center"><img src="/files/2TtVjeLWa4o0wUSYLo6Y" alt=""></div>

Estamos a mais de uma década trabalhamos com lojas virtuais em PrestaShop, em diversas fases de suas trajetórias, em todo o mundo. Seja no suporte, no desenvolvimento personalizado, com a infra estrutura de hospedagem e até mesmo na elaboração do projeto e no desenvolvimento e publicação da sua loja virtual.&#x20;

Compreendemos que podemos ajuda-los a aumentar a conversão da sua loja, a resolver os problemas que eventualmente você possa enfrentar e como auxiliar nos próximos passos para seu crescimento.


# PrestaShop

Neste ponto, é claro, você precisa ter um PrestaShop instalado e configurado em sua hospedagem.

## Requisitos do PrestaShop

* **Sistema**: Unix, Linux ou Windows.
* **Servidor Web**: Apache Web Server 2.2 ou qualquer versão posterior.&#x20;
* **Versão do PHP**: recomendamos o PHP v7.0 ou posterior (veja o quadro de compatibilidade abaixo para mais detalhes).
* **Versão do MySQL**: 5.6 mínimo ou uma versão mais recente é recomendado.&#x20;
* **Memória RAM**: quanto mais, melhor. Recomendamos definir a alocação de memória por script (memory\_limit) para um mínimo de 196M.

## Requisitos do PHP

Veja abaixo o gráfico de compatibilidade:

![Versões do PHP compatíveis com versões do PrestaShop.](/files/-Mc-jrb2qw9lxpCfywby)

O PrestaShop precisa de algumas extensões do PHP e do MySQL para funcionar corretamente.&#x20;

### Extensões

Certifique-se de que suas configurações do PHP tenham as seguintes extensões habilitadas:

* **CURL**: é usada para baixar recursos remotos, como módulos e pacotes de localização;
* **DOM**: é necessária para analisar documentos XML. O PrestaShop utiliza várias funcionalidades, como o Localizador de lojas. Ele também é usado por alguns módulos, bem como pela biblioteca pear\_xml\_parse;
* **Fileinfo**: é usada para descobrir o tipo de arquivo dos arquivos enviados;
* **GD**: é usada para criar miniaturas para as imagens que você envia;
* **Iconv:** é usado para converter conjuntos de caracteres;
* **Intl**: é usada para exibir dados localizados, como valores em diferentes moedas;
* **JSON:** é usado para gerenciar o formato JSON;
* **Mbstring:** string multibyte para realizar operações de string em qualquer lugar;
* **OpenSSL:** é usado para melhorar a segurança;
* **PDO:** é usado para conectar-se a bancos de dados;
* **PDO (MySQL):** é usado para se conectar a bancos de dados MySQL;
* **SimpleXML:** é usado para gerenciar arquivos XML;
* **Zip**: é usada para descomprimir arquivos compactados, como módulos e pacotes de localização.

### Definições

* **allow\_url\_fopen**: Esse parâmetro permite que o PrestaShop acesse arquivos remotos, o que é uma parte essencial do processo de pagamento, entre outras coisas. Portanto, é imprescindível que seja definido como On (ativo).

{% hint style="info" %}
Temos um exemplo de configuração do arquivo **php.ini** (arquivo de configuração para o PHP): <https://www.neogest.com.br/blog/configuracao-servidor-com-php-ini-no-prestashop.html>
{% endhint %}

As informações acima foram obtidas através do [canal oficial da PrestaShop](https://devdocs.prestashop.com/1.7/basics/installation/system-requirements/) e pode ser [acessada aqui](https://devdocs.prestashop.com/1.7/basics/installation/system-requirements/).


# Servidor de Hospedagem

Neste tópico vamos preparar sua hospedagem para avançar com as instalações.

{% content-ref url="/pages/-M16yeSyqkFoGlzuH0zl" %}
[Verificando a versão do PHP](/pre-requisitos/hospedagem/verificando-a-versao-do-php)
{% endcontent-ref %}

{% content-ref url="/pages/-Mbt3K9nHtWt8tEvK0h4" %}
[Verificando se o ionCube está ativo](/pre-requisitos/hospedagem/verificando-se-o-ioncube-esta-ativo)
{% endcontent-ref %}

{% content-ref url="/pages/-Mbt3fKSBDaMDytZ57WH" %}
[Ativando o ioncube na hospedagem](/pre-requisitos/hospedagem/ativando-o-ioncube-na-hospedagem)
{% endcontent-ref %}

Após essas verificações, vamos processeguir com a [instalação do módulo NeoGest Cliente](/pre-requisitos/ngcliente).


# Verificando a versão do PHP

Você precisará saber a versão do PHP para baixar a versão correta do módulo da NeoGest a ser utilizado.

Você pode checar a versão acessando o menu do seu PrestaShop: **Parâmetros Avançados** > **Informações do Servidor**:

![PrestaShop > Parâmetros Avançados > Informações](/files/-M17Ksia3CBkMIBHxgwG)


# Verificando se o ionCube está ativo

Você precisará verificar se o ioncube está ativo, pois é um dos requisitos das integrações da NeoGest.

Na grande maiorias das hospedagens, este recurso está ativo por padrão.

Para verificarmos, crie um arquivo chamado "info.php" na raiz da sua hospedagem e insira o código abaixo dentro deste arquivo:

```
<?php phpinfo(); ?>
```

Feito isso, basta acessar a URL: [www.seudomínio.com.br/info.php](http://www.seudomínio.com.br/info.php) e checar se a informação abaixo existe:

![Verificando se o ionCube está ativo na hospedagem](/files/-M17Rm_Ev7cS52h9_qwN)

{% hint style="warning" %}
Caso essa informação **não exista** ou você não tenha conseguido abrir o arquivo "info.php", **precisará de auxílio do suporte de sua hospedagem** para ativação do mesmo.
{% endhint %}

Com o **Ioncube Loader** ativo, podemos avançar com a instalação do NeoGest Cliente:

{% content-ref url="/pages/-Mbt4ymHuQmnkZfype4R" %}
[Instalando o módulo](/pre-requisitos/ngcliente/instalando-o-modulo)
{% endcontent-ref %}


# Ativando o ioncube na hospedagem

Você pode solicitar ao suporte de sua hospedagem para ativar este recurso, normalmente no chat ou via ticket, é bem simples e rápida esta ativação.

Em várias hospedagens você mesmo consegue ativar diretamente no gerenciador da hospedagem, no Cpanel ou via Terminal (para quem tem mais experiência).

### Ativando via Cpanel

Acesse seu gerenciador Cpanel e busque por "php" e clique na opção "**Selecionar Versão do PHP**":

![Selecionar Versão do PHP](/files/-Mc-tMa4z6pusOYT5Bub)

Selecione a aba **Extensões** e posteriormente marque a opção **Ioncube Loader**:

![Selecione a Aba Extensões e posteriormente marque a opção Ioncube Loader](/files/-Mc-u3IAGfvGWzcwBKxQ)

Feito isso, basta verificar novamente se o Ioncube Loader foi ativado, seguindos os passos do tópico anterior:

{% content-ref url="/pages/-Mbt3K9nHtWt8tEvK0h4" %}
[Verificando se o ionCube está ativo](/pre-requisitos/hospedagem/verificando-se-o-ioncube-esta-ativo)
{% endcontent-ref %}

### Ativando via terminal Linux

![Baixando Ioncube Loader](/files/-Mbt4L1SwM-yjAXXQzsz)

1. Acesse o site: <https://www.ioncube.com/loaders.php>;
2. Efetue o download do pacote compatível com o sistema operacional do seu servidor;
3. Descompacte o pacote e efetue o upload do arquivo "loader-wizard.php" na raiz de sua hospedagem;
4. Acesse o "loader-wizard.php" através do navegador, **ex**: [www.seudominio.com.br/loader-wizard.php](http://www.seudominio.com.br/loader-wizard.php);
5. Siga as instruções.

{% hint style="info" %}
Todos os módulos da NeoGest são compatíveis com as versões 5.6, 7.0, 7.1, 7.2 e 7.3 do PHP. Para verificar adequadamente, acesse a página do módulo a ser instalado e verifique seus requisitos.
{% endhint %}


# NeoGest Cliente

O NeoGest Cliente é uma solução desenvolvida pela NeoGest. Seu objetivo é gerir o licenciamento dos módulos comercializados e automatizar o processo de atualização dos mesmos.

A instalação deste módulo é um requisito para todos os módulos desenvolvidos pela NeoGest, então não é possível a utilização dos módulos da NeoGest sem o NeoGest Cliente.

### Como funciona?

Quando o cliente adquire um módulo na loja virtual da NeoGest, é gerada uma licença única e exclusiva. Através dela o módulo adquirido conseguirá se autenticar com nossos servidores, liberando a configuração e a utilização do mesmo.

{% content-ref url="/pages/-Mbt4ymHuQmnkZfype4R" %}
[Instalando o módulo](/pre-requisitos/ngcliente/instalando-o-modulo)
{% endcontent-ref %}

{% content-ref url="/pages/-M9yVp0B1ztjmX3rMcOf" %}
[Configurando a tarefa cron](/pre-requisitos/ngcliente/configurando-a-tarefa-cron)
{% endcontent-ref %}


# Instalando o módulo

Neste tópico vamos orientar como baixar o NeoGest Cliente e seguir com sua instalação.

### Fazendo o download

Você pode fazer o download do NeoGest Cliente acessando o menu **Minha Conta > Minhas Licenças > Download > ngcliente**, no painel da NeoGest:

![Download do "ngcliente" na loja da NeoGest](/files/-Mc9TcZayDY3N3IO_p6F)

### Instalando o módulo

Acesse o painel administrativo do seu PrestaShop, no menu Módulos da sua loja. Agora clique em "Adicionar um novo módulos", localizado na toolbar da página, conforme a imagem abaixo:

![](https://gblobscdn.gitbook.com/assets%2F-M16nWJqbvB73vopPchR%2F-M17TbD6qsy5KEik0QD0%2F-M17VC5JwmDcSjQIxCe5%2Fprestashop-instalando-modulo.png?alt=media\&token=016f0a95-6686-47c7-9e44-e0a0924b27c8)

Localize o arquivo baixado na loja da NeoGest e selecione o mesmo e clique em "**Enviar este módulo**" para prosseguir com sua instalação.

Aguarde o módulo ser carregado e logo em seguida clique em Instalar, pronto! =)


# Configurando a tarefa cron

Neste artigo você vai aprender a configurar uma Tarefa Cron. Como exemplo, vamos ensinar a configurar a Tarefa Cron do NeoGest Cliente, mas você pode tirar como base para qualquer outro acionamento.

O processo de criação de uma Cron Job (trabalhos ou tarefas cron) é bastante simples, porém existem muitos painéis de hospedagens e aquelas que não possuem painel. Caso tenha alguma dúvida, recomendamos que consulte o desenvolvedor da sua loja ou o responsável por sua hospedagem. A configuração dessa Tarefa Cron por parte do suporte das hospedagens normalmente é gratuita na grande maioria delas e tem um tempo médio de 2-3 minutos para configuração.

### Configurando no Cpanel

{% hint style="info" %}
Preparamos um vídeo demonstrando como configurar a tarefa cron no Cpanel, assista:
{% endhint %}

{% embed url="<https://youtu.be/yb3ZkwymV8g?t=28>" %}
Configurando a tarefa cron do NeoGest Cliente no Cpanel
{% endembed %}

A linha de comando informada no vídeo acima pode não funcionar em algumas hospedagens, como alternativa, recomendamos o comando abaixo:

```
wget -O - /dev/null URL
```

Na linha de comando, você deve substituir a "**URL**" pelo link **indicado pelo ngcliente**, que deve ser semelhante a <https://www.seudomínio.com.br/module/ngcliente/cron>.

**Observação:** a configuração tempo de acionamento, **deve ser de 15 em 15 minutos necessariamente**, independente da linha de comando utilizada.

### Configurando na Cron-Jobs.org

Indicamos este site para todos os clientes que não possuem um servidor que permite ou possuem limitações na configuração de tarefas crons. No plano gratuito deste é possível configurar várias crons com vários tempos.

{% hint style="info" %}
Preparamos um vídeo demonstrando como configurar a tarefa cron na [cron-jobs.org](https://cron-jobs.org/), assista:
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=aRlTner6sVs>" %}
Configurando uma Tarefa Cron no cron-jobs.org
{% endembed %}


# Configurações extras


# Autenticando as licenças com a loja em manutenção

Neste artigo você vai aprender a configurar seu PrestaShop para que os módulos da NeoGest continuem funcionando mesmo com a loja em manutenção.

Quando colocarmos a loja em manutenção, o PrestaShop faz o bloqueio de todas as rotas utilizadas pelas integrações instaladas em sua loja, quando isso acontece, todos os links "roteados" deixam de funcionar. Este é o caso da tarefa cron que faz a autenticação das licenças dos módulos desenvolvidos pela NeoGest.

Para resolver esta restrição, é necessário que dê permissão ao IP do servidor de autenticação da NeoGest na tela de Manutenção do seu PrestaShop, e caso tenha alguma restrição de geolocalização, que também permita o acesso.&#x20;

### Permitindo o IP na lista de Manutenção

Acessando o menu **Configurações > Geral > Manutenção:**

![](/files/bolFW0evWowgRsaAoTLK)

IPs a serem incluídos:

* 165.227.197.21;
* 108.61.224.92;
* IP do Servidor da sua hospedagem (recomendação).

Inclusa os dois IPs como na imagem acima e salve.

### Permitindo o IP na lista Geolocalização

Acesse o menu **Internacionalização > Definições > Geolocalização > Lista de endereços IP permitidos:**

![](/files/tAQ5MtlpPBnJmNkq9Py7)

IPs a serem incluídos:

* 165.227.197.21;
* 108.61.224.92;
* IP do Servidor da sua hospedagem (recomendação).

Inclusa os dois IPs como na imagem acima e salve.


# Padrão Nacional

Este módulo faz a inserção do campo de "número" no cadastro de endereços e padroniza os campos de "cpf", "razão social", "cnpj" e "inscrição estadual" no cadastro do cliente.


# Documentação


# Instalando o módulo


# Configurações extras


# Correios

A Transportadora Correios disponibiliza a seus clientes os serviços de entrega PAC, Sedex e Carta Resgistrada em sua loja virtual PrestaShop.

## Introdução

Através do módulo dos Correios com a plataforma PrestaShop, sua loja online estará totalmente integrada com as APIs (Interface de Programação de Aplicativos) dos Correios. Você poderá oferecer a seus clientes o serviço de entrega que sempre foi líder no Brasil. Muito mais prático, rápido e totalmente seguro.

![Transportadora Correios para PrestaShop](/files/-MA-Uwy2wZnNUtGE7yGC)

## Definições

Acessando o menu de Módulos > Correios > Configuração:

![Configurações da Transportadora Correios](/files/-M1BRCyoa-J-7Id-9Fvo)

### Medidas Fixas

Caso você não utilize medidas em seus produtos ou ainda não fez o preenchimento desses parâmetros nos produtos de sua loja, você pode utilizar uma medida fixa para todos os produtos. Esta opção é recomendada para lojistas que vendem produtos sem variação de tamanho em sua loja.

Para utiliza, basta ativar a opção e preencher com a medida desejada. Todos os cálculos de frete da loja utilizarão essas medidas como base.

![Ativando as medidas fixas](/files/-M1COHVIx_l22PlxVLrG)

### Métodos de Cálculo

É necessário definirmos qual o método de consulta será utilizado pela integração, para isso vamos explicar abaixo como eles funcionam e indicaremos as vantagens e desvantagens de cada um.

#### Consulta Local (recomendado)

Utiliza o WebService dos Correios para o preenchimento da tabela local de frete.

**Vantagens:**

* O tempo de resposta das consultas tem um tempo de 5 a 20 vezes mais rápido que as outras opções;
* Não é necessário ter contrato com os Correios;
* Não sofre quedas por conta de instabilidade de WebService.

**Desvantagens:**

* É necessário aguardar o preenchimento da tabela local;
* Não obtém o custo atualizado em tempo real do serviço consultado (essa atualização é automática, mas sua atualização é diária).

#### WebService Padrão

Utiliza o WebService padrão dos Correios.

**Vantagens:**

* É possível obter os custos de postagens rapidamente;
* Não é necessário ter contrato com os Correios;
* Obtém o custo atualizado em tempo real do serviço consultado.

**Desvantagens:**

* É muito instável;
* Sofre de quedas constantes no servidor ;
* Latência regular (o tempo de resposta é muito instável).

#### WebService do Sigep Web <a href="#webservice-do-sigep-web" id="webservice-do-sigep-web"></a>

Utiliza o WebService do Sigep Web. Para sua utilização é necessário ter o módulo de integração com o Sigep Web da NeoGest.

**Vantagens:**

* É possível obter os custos de postagens rapidamente;
* Latência regular (o tempo de resposta é bem estável);
* Obtém o custo atualizado em tempo real do serviço consultado.

**Desvantagens:**

* É necessário ter contrato com os Correios;
* Apesar de ser rápido, não é tão rápido quanto uma consulta em um banco de dados local;
* Sofre quedas no servidor (com pouquíssima frequência).

### Atualizar toda a tabela de frete

![Ativando o recurso de "Atualizar toda a tabela de frete"](/files/-M1COhZpzgzou4RobfqU)

Esta opção define se o preenchimento da tabela, que é acionado via cron jobs, deverá recalcular todas as Faixas de CEP cadastradas ou se apenas deverá preencher todas as Faixas de CEP que ainda não foram preenchidas.

**Quando a opção estiver marcada como:**

* **SIM** – ao acionar a URL de preenchimento da faixas de cep, todas as faixas de cep serão recalculadas (ao término do recálculo, esta opção será automaticamente desativada);
* **NÃO** – ao acionar a URL de preenchimento das faixas de cep, todas as faixas de cep que não estiverem preenchidas, serão preenchidas.

### Número de processos

Esta opção define o número de processos simultâneos para o preenchimento da tabela local de fretes. Quando você seleciona 4 processos, quer dizer que serão consultados 4 **faixas de cep** simultaneamente no webservice dos correios, deixando o processo de preenchimento da tabela local mais rápido. Porém elevar este número depende do desempenho do seu servidor de hospedagem.

{% hint style="warning" %}
Atenção! Escolher um número elevado pode trazer impactos severos no desempenho de seu servidor. Não escolha uma opção maior que 2 em servidores compartilhados.
{% endhint %}

## Configurando

Enfim, vamos fazer as configurações dos Serviços e ativar as transportadoras desejadas. Acesse o menu Frete > Correios.

### Serviços

Serviço é o nome utilizado para as opções de transportadoras dos Correios. O PAC e o SEDEX são serviços dos Correios.

É aqui que vamos ativar/desativar/incluir/remover os serviços desejados para obtenção dos custos:

![Aba de Serviços da configuração da Transportadora Correios](/files/-M1BSnFHUSvoqkeMmk6j)

Por padrão, a integração da NeoGest ativa os Serviços de PAC (Varejo) e SEDEX (Varejo), mas é possível adicionar todos os outros serviços disponíveis pelos Correios.

#### Ativando um Serviço

Para adicionarmos um novo serviço, vamos clicar no ícone de (+) localizado na GRID da tela:

![Adicionando um serviço de transportadora](/files/-M1BTPsvzKDcWVjEkstA)

Ao clicar em Adicionar, vamos definir os campos:

* **Serviço:** o serviço dos Correios que essa transportadora utilizará;
* **Nome da Transportadora:** nome da transportadora a ser cadastrada em sua loja;
* **Dias de Tolerância:** é um prazo que será somado ao prazo informado pelos Correios;
* **Ativo:** se esta transportadora estará disponível;
* **Aviso de Recebimento:** se esta transportadora utilizará o serviço de Aviso de Recebimento;
* **Mão Própria:** se esta transportadora utilizará o serviço de Mão Própria;
* **Valor Declarado:** se esta transportadora utilizará o serviço de Seguro.

Com a transportadora adicionada, esta adicionou várias Faixas de CEP com o serviço desejado, podem serem vistas no meni Faixas de CEP.

Caso utilize a opção de **Cálculo Offline**, esse preenchimento **deve ser feito para este serviço funcionar** corretamente em sua loja PrestaShop.

#### Editando um Serviço

Quando necessário alterar alguma configuração para esta transportadora, basta acessar o menu Frete > Correios > Serviços > Editar e fazer os ajustes necessários.

#### Removendo um Serviço

A remoção de um serviço, remove também todas as Faixas de CEP cadastradas para este.

Faça esse procedimento apenas quando não desejar mais utilizar essa transportadora.

### Faixas de CEP

Quando adicionamos um Serviço, automaticamente é criada várias faixas de cep por padrão da integração. Essas faixas foram criadas de acordo com as regiões definidas dos Correios e podem sofrer alterações.

Ao adicionar um serviço, por exemplo o PAC, vemos:

![Faixas de CEP ao adicionar um novo serviço](/files/-M1C2DlNETl6ImLSosE8)

Note que as faixas foram adicionadas, mas ainda não apresentam valores de **Custo de Frete** e **Tempo de Entrega**. Para obtermos os valores, devemos solicitar o preenchimento da tabela offline.

#### Solicitar Preenchimento da Tabela

Na toolbar da tela das Faixas de CEP, temos um ícone chamado Atualizar Faixas:

![Clique em Atualizar Faixas para obter os valores e prazos e preencher a tabela local](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M16nWJqbvB73vopPchR%2Fuploads%2F5xzeBBlpoh1MGsnc9IHk%2Ffile.png?alt=media)

Quando clicamos nele, as faixas de cep começarão a ser preenchidas, dependendo da configuração salva nas Configurações do Módulo.

#### Forçar a Atualização da Tabela

Quando necessário recalcular algumas faixas de cep, é necessário solicitar o recálculo completo das faixas.

Essa ação economiza muito recurso do servidor e o tempo de atualização é proporcional a quantidade de faixas a serem recalculadas, que tende-se a ser bem menor que o recálculo completo das faixas de cep.

Para solicitar o recálculo das faixas de cep, basta selecionarmos todas as faixas que desejamos recalcular e clicarmos em **Forçar Recálculo** que está localizado na **Ação em Massa** da GRID.

![Forçar Recálculo no bloco de ação em massa](/files/-M1C3K4HNWRZBUGmW3JP)

Após clicado na opção de **Forçar Recálculo**, todas essas faixas estarão com a coluna **Forçar Recálculo** checada:

![Verificando faixas de cep que deverão ter seus cálculos atualizados](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M16nWJqbvB73vopPchR%2Fuploads%2FbYYrXblOKVwJhmyNDJ1C%2Ffile.png?alt=media)

Agora basta clicar no botão **Atualizar Faixas** localizado na toolbar da tela para que todas essas faixas sejam atualizadas ou preenchidas.

### Descontos

No exemplo abaixo, vamos demonstrar como configuramos um desconto de 10% para todos os pedidos com valores entre R$ 0,00 e R$ 10.000,00, para todas as Faixas de CEP do Interior do Paraná.

#### Aplicando um desconto

Para aplicarmos descontos, é bastante simples. Vamos acessar a tela de **Faixas de CEP**, selecionar todas as faixas que você quer aplicar este desconto:

![Aplicando um desconto nas faixas de cep](/files/-M1CCOOxpOy_iIFjajie)

Posteriormente, devemos clicar no botão da toolbar chamado “**Aplicar Descontos**“, como vemos abaixo:

![Botões para aplicação do desconto nas faixas de cep](/files/-M1CCVFcO07vSKxjliwF)

Após clicar no mesmo, será aberto um modal (uma janela estilo pop-up, dentro da própria aba) onde você terá as opções para aplicação do desconto:

![Configurando um desconto para faixas de cep](/files/-M1CCaHUy9IzI75hLn2V)

Neste modal, você deverá informar o valor mínimo e máximo do pedido para a aplicação do desconto, além do valor Percentual ou Fixo do próprio desconto.

#### Editando um desconto

Acessando a tela de Descontos, podemos editar faixa a faixa, clicando no Editar da ação individual de cada uma, como vemos abaixo:

![Editando um desconto aplicado](/files/-M1CChi4pSvP-tHArcV1)

Também podemos aplicar uma nova regra de desconto para a mesma Faixa de CEP. Esta ação sobrescreverá o desconto aplicado anteriormente.

#### Removendo um desconto

Para removermos um desconto aplicado em uma faixa de cep, devemos acessar a tela de Descontos, selecionar todas as faixas desejadas, e no botão de ação em massa, clicamos na opção “**Remover Descontos**“:

![Removendo um desconto aplicado](/files/-M1CCoiDz4it89GfpSPq)

Além disso, é possível remover individualmente o desconto de uma faixa de cep através da ação individual.


# Documentação


# Instalando o módulo


# Configurações extras


# Alterando o tipo das Faixas de CEP de Agrupadas por Cidades

Neste artigo você vai aprender a trocar o modo da tabela de Faixas de CEP Agrupadas pelas Faixas de CEP por Cidades.

A tabela de Faixas de CEP por Cidades trará a sua loja um cálculo bem preciso para as transportadoras dos Correios, utilizando o **Método de Cálculo** por **Consulta Local** (opção recomendada na configuração do módulo). Porém a utilização desta tabela, precisa ser feita com atenção, pois exige um servidor bem otimizado para seu PrestaShop (não é recomendado para servidores compartilhados).


# Verificando a integridade da criação da tabela por cidades

Neste artigo você vai aprender a verificar se a tabela de frete por cidades foi criada por completo e caso não tenha sido, vai aprender como corrigir.

### Verificando a integridade

Por ser uma tabela bem extensa, pode ocorrer a interrupção da criação desta tabela por alguma limitação de recurso da hospedagem ou por uma eventual queda da mesma. Para checarmos é simples.

A integração possui um total de 5566 faixas de cep por cidades e 32 faixas de peso para cada serviço configurado no modo de Tipo de Faixas de CEP por Cidades. Então basicamente para verificar se tudo foi criado corretamente, basta verificar se o número de faixas cadastradas é igual a 178112 (5566 faixas de cep x 32 faixas de peso).

Basta acessar o menu **Envios > Correios > Faixas de CEP**, filtrar pelo serviço que estamos checando e conferir se o número de faixas corresponde ao total de 178112.

{% hint style="success" %}
Quando o total de faixas bater com o número de 178112, você checou que o serviço está integro. Parabéns!
{% endhint %}

### Corrigindo criação da tabela local por cidades

Quando o total de faixas não for correspondente a 178112, precisamos checar onde ocorreu a interrupção e solicitar que o módulo continue com a criação das mesmas.

Para isso, devemos acessar o menu **Envios > Correios > Faixas de CEP > filtrar do maior para o menor na coluna de ID e com o nome da transportadora**, desta forma conseguimos identificar qual o Estado das últimas faixas que foram criadas.

![Tabela de Faixas de CEP por Cidades incompleta](/files/-M744_260T4Rot_aw3JN)

No exemplo acima, verificamos que a criação parou no estado do Paraná. Agora basta verificarmos o ID do serviço configurado para solicitarmos a continuação da criação da tabela por faixas de cep por cidades.

Acesse o menu **Envios > Transportadoras > edite o serviço**, na URL vamos verificar o ID do mesmo, como na print abaixo:

![Verificando o ID do serviço configurado](/files/-M745gqs9E2II7PNqpDO)

Com o ID em mãos, basta agora acionar a URL para iniciar o processo de correção:

{% hint style="warning" %}
<https://www.seudominio.com.br/module/ngcorreios/CreateIntervals?uf=**PR**\\&id\\_service=**148>\*\*
{% endhint %}

No caso, substitua os valores dos parâmetros **"uf"** e **"id\_service"** de acordo com os dados verificados em sua loja.

Ao acionar a URL acima, o módulo continuará a criação a partir do estado em que ocorreu a interrupção, nesta ordem:

* RO;
* AC;
* AM;
* RR;
* PA;
* AP;
* TO;
* MA;
* PI;
* CE;
* RN;
* PB;
* PE;
* AL;
* SE;
* BA;
* MG;
* ES;
* RJ;
* SP;
* PR;
* SC;
* RS;
* MS;
* MT;
* GO;
* DF.


# Sigep Web

O Sigep Web dos Correios otimiza a logística interna, eliminando a necessidade de gerenciamento de postagens e alinhamento com serviços de entregas.

## Introdução

O SIGEP WEB é um sistema desenvolvido pelos Correios com a finalidade de facilitar e agilizar a preparação e gerenciamento das postagens de encomendas pelos clientes.

Por meios desse sistema, dentre outras funcionalidades, é possível gerar e imprimir listas de postagens, etiquetas de serviços e listas de destinatários.

Para facilitar a utilização desse sistema, neste artigo você encontrará as informações para instalação e configuração, da integração, em sua plataforma PrestaShop, e orientações de utilização do SIGEP WEB.

<figure><img src="/files/8l8OgS1pY6kWabuK9n00" alt=""><figcaption><p>Sigep Web (Correios) para PrestaShop</p></figcaption></figure>


# Requisitos

Neste artigo você vai conhecer tudo o que precisa para utilizar o Sigep Web em sua loja virtual PrestaShop.


# Simulador de Frete


# Pagar.me

Neste artigo você vai aprender a configurar o módulo "Pagar.me para PrestaShop" desenvolvido pela NeoGest em sua loja virtual PrestaShop.

## Instalação <a href="#instalacao" id="instalacao"></a>

## Configuração <a href="#configuracao" id="configuracao"></a>

Agora que o módulo da Pagar.Me para PrestaShop já está instalado, é hora de fazer as configurações para que tudo funcione de acordo com a realidade do seu negócio.

O primeiro passo é acessar o Menu Pagamentos > Pagar.Me > Configurações, como é mostrado nessa imagem:

Assim que você clicar na aba de Configurações, a tela abaixo é mostrada. Aprenda a seguir o que cada campo representa e como configurá-los para o que você precisa.

Explicando os campos da imagem acima:

### Integração:

Os valores possíveis para esse campo são: Checkout Transparente e Gateway Simples. Quando a opção Checkout Transparente está habilitada, o seguinte modal de pagamento é usado para capturar os dados de Cartão de crédito ou Boleto, e em seguida criar a transação junto à API Pagar.me:

### Chave de API

Neste campo você coloca a sua API Key, que é uma chave utilizada para autenticar o seu negócio junto à API do Pagar.me. Saiba mais sobre a API Key em: Chaves de acesso

### Chave de teste e de produção

{% hint style="warning" %}
Preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.\
Exemplo de API Key de teste: ak\_test\_grXijQ4GicOa2BLGZrDRTR5qNQxJW0\
Exemplo de API Key de produção: ak\_live\_qlSlEXJgsqaCjKohh5AZfnqv7OLP5Q
{% endhint %}

### Chave de Criptografia

Neste campo você deve colocar a sua Encryption Key, que é uma chave essencial para realizar transações com Cartão de crédito usando a API Pagar.me. Saiba mais sobre a Encryption Key em: Chaves de acesso

### Chave de teste e de produção

{% hint style="warning" %}
Da mesma forma que o campo anterior, preste atenção sempre em qual chave você está usando, se é a de teste ou a de produção.\
Exemplo de Encryption Key de teste: ek\_test\_aHGru3d5a7qweiftqXg1bQvbN1c7K0\
Exemplo de Encryption Key de produção: ek\_live\_Wa8CDUuLlFvSQzjxf4YFZIBQvb2l1p
{% endhint %}

### Meio de pagamento

Define quais são os meios de pagamentos mostrados na sua página de finalização de pedido. As opções são: Cartão de Crédito e Boleto, apenas Cartão ou apenas Boleto.

### Autorizar parcelamento

Define se os pedidos feitos no seu site poderão ser parcelados ou não.

### Valor mínimo da parcela

Caso queira, você pode definir um valor mínimo para as parcelas de compras feitas no seu site. O módulo mostra sempre o maior número até que o valor seja atingido. Por exemplo: Um produto A tem um valor de R$100,00, mas foi configurado no módulo que a parcela mínima seria R$70,00, então a única opção disponível é o pagamento à vista. OBS: esse recurso está disponível apenas para integração de Gateway Simples

### Número máximo de parcelas

Este campo define em até quantas vezes será possível parcelar um pedido.

### Parcelamento – Taxa de juros

O módulo Pagar.me oferece a conveniência de calcular (via juros simples) o valor das parcelas de acordo com um valor de juros passado neste campo. Configure este valor usando ponto, e não vírgula. Caso a sua aplicação não cobre juros, é preciso deixar o campo como 0.

### Parcelas sem juros

Alinhado diretamente com o ponto de juros, esta opção define em até quantas parcelas aquele pedido não será cobrado juros. Exemplo: Digamos que o campo esteja configurado com 3, ou seja, caso o cliente opte por comprar em 1x, 2x ou 3x, seu pedido não será cobrado juros, mas caso escolha 4x, todas as parcelas terão juros aplicados.

### Desconto Boleto

Porcentagem de desconto para pedidos por Boleto bancário no seu site.

### Boleto – Prazo

Configure neste campo em até quantos dias o boleto gerado vai vencer. Isto é, quantos dias úteis o seu cliente tem para fazer o pagamento pela sua compra.

### Descrição da fatura

Este parâmetro define o que aparece na fatura do portador do cartão, em relação à compra feita em sua loja. O campo deve ser composto apenas de letras e números, com no máximo 13 caracteres.

### Activate logs

Habilita a opção de que eventos sejam registrados em um arquivo de Log. Isso é essencial para investigar possíveis questões que interfiram no funcionamento do módulo.

### Apresentar lista para data de expiração

Habilita um campo para data de expiração do Cartão de crédito em forma de lista, ao invés de campo aberto.


# Principais códigos de retorno

Veja quais são os principais códigos de retorno (acquirer\_response\_code) dos pagamentos aprovados e não aprovados da Pagar.me.

**O código de retorno** é a resposta obtida de uma requisição de transação de crédito ou débito e\
também contempla os códigos de erro de integração. A maioria dos adquirentes fornece uma lista de códigos que deve seguir um padrão.

A Pagar.me, ilustra os códigos de retorno (parâmetro **"acquirer\_response\_code"** da requisição de retorno do pagamento) conforme abaixo:

#### **Transações Aprovadas**

| Código | Mensagem             | Orientação                                |
| ------ | -------------------- | ----------------------------------------- |
| 0      | Transação autorizada |                                           |
| 1      | Transação autorizada | Verifique a identidade antes de autorizar |

#### **Transações Negadas**

| **Código de Retorno** | **Descrição**                                                 | **Mensagem**                                                                  |
| --------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| 1000                  | Do not honour                                                 | Não aprovado                                                                  |
| 1001                  | Expired card                                                  | Cartão vencido                                                                |
| 1002                  | Suspected fraud                                               | Suspeita de fraude                                                            |
| 1003                  | Card acceptor contact acquirer                                | Estabelecimento entrar em contato com emissor                                 |
| 1004                  | Restricted card                                               | Cartão com restrição                                                          |
| 1005                  | Card acceptor call acquirer's security department             | Estabelecimento entrar em contato com departamento de segurança do adquirente |
| 1006                  | Allowable PIN tries exceeded                                  | Tentativas de senha excedidas                                                 |
| 1007                  | Refer to card issuer                                          | Consultar o emissor                                                           |
| 1008                  | Refer to card issuer's special conditions                     | Consultar as condições especiais do emissor                                   |
| 1009                  | Invalid card acceptor                                         | Estabelecimento inválido                                                      |
| 1010                  | Invalid amount                                                | Valor inválido                                                                |
| 1011                  | Invalid card number                                           | Cartão inválido                                                               |
| 1012                  | PIN data required                                             | Senha necessária                                                              |
| 1014                  | No account of type requested                                  | Nenhuma conta do tipo selecionado                                             |
| 1015                  | Requested function not supported                              | Função selecionada não suportada                                              |
| 1016                  | Not sufficient funds                                          | Saldo insuficiente                                                            |
| 1017                  | Incorrect PIN                                                 | Senha inválida                                                                |
| 1019                  | Transaction not permitted to cardholder                       | Transação não permitida para o portador                                       |
| 1020                  | Transaction not permitted to terminal                         | Transação não permitida para o terminal                                       |
| 1021                  | Exceeds withdrawal amount limit                               | Limite de valor para saque excedido                                           |
| 1022                  | Security violation                                            | Violação de segurança                                                         |
| 1023                  | Exceeds withdrawal frequency limit                            | Limite de quantidade de saques excedido                                       |
| 1024                  | Violation of law                                              | Violação da lei                                                               |
| 1025                  | Card not effective                                            | Cartão bloqueado                                                              |
| 1026                  | Invalid PIN block                                             | Dados de senha inválidos                                                      |
| 1027                  | PIN length error                                              | Erro no tamanho da senha                                                      |
| 1028                  | PIN key sync error                                            | Erro de sincronia de chave de senha                                           |
| 1029                  | Suspected counterfeit card                                    | Suspeita de cartão falso                                                      |
| 1030                  | Currency unacceptable to card issuer                          | Moeda inaceitável para o emissor                                              |
| 1032                  | Lost/stolen card                                              | Cartão perdido ou roubado                                                     |
| 1035                  | Closed account                                                | Conta encerrada                                                               |
| 1036                  | Closed savings account, or restricted for closing             | Conta poupança encerrada ou bloqueada para encerramento                       |
| 1037                  | Closed credit account or restricted for closing               | Conta de crédito encerrada ou bloqueada para encerramento                     |
| 1039                  | Closed cheque account or restricted for closing               | Conta corrente encerrada ou bloquada para encerramento                        |
| 1041                  | From account bad status                                       | Status ruim para conta de origem                                              |
| 1042                  | To account bad status                                         | Status ruim para conta de destino                                             |
| 1045                  | Card verification data failed                                 | Código de segurança inválido                                                  |
| 1047                  | PIN change required                                           | Troca de senha necessária                                                     |
| 1048                  | New PIN invalid                                               | Nova senha inválida                                                           |
| 1057                  | Payment date invalid                                          | Data de pagamento inválida                                                    |
| 1060                  | Transaction did not complete normally at terminal             | Transação não completou normalmente no terminal                               |
| 1061                  | Transaction not supported by the card issuer                  | Transação não suportada pelo emissor                                          |
| 1062                  | Cashback not allowed                                          | Saque fácil não disponível                                                    |
| 1063                  | Cashback amount exceeded                                      | Limite de saque fácil excedido                                                |
| 1064                  | Declined, transaction processed offline by terminal           | Negado offline pelo terminal                                                  |
| 1065                  | Declined, terminal unable to process offline                  | Negado, não foi possível processar offline                                    |
| 2000                  | Do not honour                                                 | Não aprovado                                                                  |
| 2001                  | Expired card                                                  | Cartão vencido                                                                |
| 2002                  | Suspected fraud                                               | Suspeita de fraude                                                            |
| 2003                  | Card acceptor contact acquirer                                | Estabelecimento entrar em contato com emissor                                 |
| 2004                  | Restricted card                                               | Cartão com restrição                                                          |
| 2005                  | Card acceptor call acquirer's security department             | Estabelecimento entrar em contato com departamento de segurança do adquirente |
| 2006                  | Allowable PIN tries exceeded                                  | Tentativas de senha excedidas                                                 |
| 2007                  | Special conditions                                            | Condições especiais                                                           |
| 2008                  | Lost card                                                     | Cartão perdido                                                                |
| 2009                  | Stolen card                                                   | Cartão roubado                                                                |
| 2010                  | Suspected counterfeit card                                    | Suspeita de cartão falso                                                      |
| 2011                  | Daily withdrawal uses exceeded                                | Limite de quantidade de saques excedido                                       |
| 2012                  | Daily withdrawal amount exceeded                              | Limite de valor para saque excedido                                           |
| 9100                  | One or more data element errors (see message error indicator) | Erro no formato da mensagem                                                   |
| 9102                  | Invalid transaction                                           | Transação inválida                                                            |
| 9103                  | Re-enter transaction                                          | Tente novamente                                                               |
| 9105                  | Acquirer not supported by switch                              | Adquirente não suportado pelo switch                                          |
| 9107                  | Card issuer or switch inoperative                             | Emissor fora de operação                                                      |
| 9108                  | Transaction destination cannot be found for routing           | Não foi possível enviar a transação para o destinatário                       |
| 9109                  | System malfunction                                            | Erro no sistema                                                               |
| 9110                  | Card issuer signed off                                        | Emissor se desconectou                                                        |
| 9111                  | Card issuer timed out                                         | Emissor não respondeu em tempo                                                |
| 9112                  | Card issuer unavailable                                       | Emissor indisponível                                                          |
| 9113                  | Duplicate transmission                                        | Transmissão duplicada                                                         |
| 9114                  | Not able to trace back to original transaction                | Não foi possível encontrar a transação original                               |
| 9116                  | MAC incorrect                                                 | MAC incorreto                                                                 |
| 9117                  | MAC key sync error                                            | Erro de sincronização de chave de MAC                                         |
| 9118                  | No communication keys available for use                       | Nenhuma chave de comunicação disponível                                       |
| 9119                  | Encryption key sync error                                     | Erro de sincronização de chave de encriptação                                 |
| 9120                  | Security software/hardware error – try again                  | Erro de segurança de software/hardware, tente novamente                       |
| 9121                  | Security software/hardware error – no action                  | Erro de segurança de software/hardware                                        |
| 9122                  | Message number out of sequence                                | Número da mensagem fora de sequência                                          |
| 9123                  | Request in progress                                           | Requisição em progresso                                                       |
| 9124                  | Invalid security code                                         | Código de segurança inválido                                                  |
| 9125                  | Database error                                                | Erro no banco de dados                                                        |
| 9132                  | Recurring data error                                          | Erro nos dados de recorrência                                                 |
| 9133                  | Update not allowed                                            | Atualização não permitida                                                     |
| 9350                  | Violation of business arrangement                             | Violação de acordo comercial                                                  |
| 9999                  | Other errors                                                  | Erro não especificado                                                         |

{% hint style="warning" %}
&#x20;**Importante:** alguns códigos podem estar desatualizados conforme a dinâmica de envio das informações de atualização das adquirentes para o mercado de pagamentos no Brasil.
{% endhint %}


# PayPal Plus


# Criando uma conta de Lojista em Sandbox

Para testar a solução de PayPal Plus, será necessário uma conta de Lojista Brasileira em Sandbox. Para criar, vá para https\://developer.paypal.com/ e siga os passos abaixo.

## Introdução

PayPal Sandbox é um ambiente de testes disponibilizado pelo PayPal que espelha as funcionalidades do ambiente em produção, para que assim os testes, tanto de produtos quanto de API’s, sejam feitos sem utilizar informações reais ou dinheiro real. Sendo assim, integrando em Sandbox é possível testar ao máximo do início ao fim. Após tudo propriamente testado em Sandbox, será apenas necessário modificar os Endpoints e as Credenciais de API para mudar para produção.

Para ter mais informações sobre Sandbox, [clique aqui](https://www.paypal-brasil.com.br/).

## Criando uma conta de Lojista em Sandbox

No Portal de Desenvolvedores, clique no botão de “Log In” (Conectar-se) no canto superior direito da tela, caso você não esteja conectado.

![Clique em Log In](/files/-M1BC8Y4IvBIpMtqtacq)

Conecte-se com uma conta PayPal real.

![Acesse sua conta do PayPal](/files/-M1BCE0onxDj7ED14idF)

Após conectar-se, clique em “Dashboard” (Painel de Controle):

![Clique em Dashboard](/files/-M1BCKGSic16MKY-c7aD)

Acesse o menu lateral à esquerda e clique em “Accounts” (Contas), logo abaixo de “Sandbox” (Ambiente de Testes):

![Clique no menu Accounts](/files/-M1BCsTCy-3h5HScDcUe)

Na página de “Sandbox Test Accounts” (Contas Teste), clique em “Create Account” (Criar Conta) para criar uma conta.

![Clique no botão Create Account](/files/-M1BD-nIQ05AEDXZ6aYA)

{% hint style="warning" %}
Não utilize as contas Sandbox já existentes, ao invés disso crie uma nova conta com a própria configuração dos passos seguintes.
{% endhint %}

Na página de criação de conta, tenha certeza que o campo “Country” (País) está selecionado como “Brazil” (Brasil) e que o “Account Type” (Tipo de Conta) está selecionado como “Business” (Lojista), assim como mostra as imagens abaixo (Os outros campos são opcionais e podem ser preenchidos como desejar).

![Selecione o Brasil como país e o tipo de conta Business](/files/-M1BDEsKbmR0nf8baARc)

Pronto, agora sua conta está criada! =D


# Gerando as Credenciais de API

Agora será necessário gerar as credenciais de API para Lojista, assim será possível configuração a integração. Continue no Portal de Desenvolvedores e siga os procedimentos abaixo:

1\. Verifique o menu lateral à esquerda e clique em “My Apps & Credentials” (Meus aplicativos e credenciais).

![Clique em My Apps & Credentials](/files/-M1BBJdyWiMBy43IWxa8)

2\. Na página de aplicativos, role a página até a seção REST API apps e clique em “Create App” (Criar Aplicativo).

![Clique em Create App](/files/-M1BBT6OPWzMZL2LlYXU)

3\. Na página de detalhes da aplicação, escolha um nome desejado para a aplicação e tenha certeza que está selecionado a conta Sandbox que acabou de ser criada no menu “Sandbox developer Account” (Conta de desenvolvedor Sandbox). Após esses passos, clique no botão “Create App” (Criar aplicativo).

![Preencha os campos indicados e clique em Create App](/files/-M1BBaeLTfjvImk_Ymos)

4\. Na página de Credenciais de API, será disponibilizado acesso para as Credenciais REST API (Client ID e Secret ID), copie o Client ID o ambiente do Lojista e clique em “Show” (Mostrar) para ter acesso ao Secret ID.

![Copie os campos Client ID e Secret ID](/files/-M1BBjwkgsUAEpax5UNX)

5\. Salve o Client ID e o Secret ID para o ambiente do Lojista, pois estes serão os acessos para configurar a integração.


# Como inserir ou trocar a URL de IPN

Acesse sua conta empresarial do PayPal, clique no menu de **Configurações** e em “**Perfil e Configurações**“:

![Selecione a opção perfil e configurações](/files/-M1B794E_uH1qkQxdUXJ)

Selecione a opção lateral “**Minhas ferramentas de vendas**” e posteriormente, clique em **Atualizar** a “**Notificação instantânea de pagamento**“:

![Selecione a opção Notificações instantâneas de pagamento](/files/-M1B7Mb7i5QbY8tFSAp1)

Na página de Notificações Instantânea de Pagamento (NIP), clique em **Escolher configurações de NIP**:

![Selecione a opção Escolher configurações de NIP](/files/-M1B7UwIFgqjuy3xiMLx)

Agora, basta inserir a URL indicada, selecionar a opção “**Receber mensagens de NIP**“:

![Insira a URL de notificação no campo indicado](/files/-M1B7dDoflk_Ue0wB-IC)

Pronto! =)


# Mercado Pago


# Boleto Bancário


# Cartão de Crédito

Neste artigo você vai aprender a configurar o módulo Mercado Pago - Cartão de Crédito desenvolvido pela NeoGest em sua loja virtual PrestaShop.

## Configurando o Parcelamento

Para configurar o parcelamento sem juros no Mercado Pago, você precisa acessar sua conta, navegar até o menu “**Configurações > Negócio > Oferecer parcelas sem acréscimo**”, como na imagem abaixo:

![](/files/-M1B4zUpZaoLSHeQrvM5)

Após clicar em “**Alterar**”, vamos ajustar a quantidade e parcelas sem juros:

![](/files/-M1B50tTM_fKjQCZKdYD)

Defina a quantidade desejada e clique em “**Alterar**”.

Pronto! Seu cliente poderá comprar em sua loja virtual com a quantidade de parcelas sem juros configurada em sua conta.

O Mercado Pago vai permitir que seu cliente pague em até 12x sempre, então se definir que até 6x é sem juros, as parcelas subsequentes são com juros pagos pelo cliente.


# Transferência Bancária


# Simulador de Pagamento


# MercadoLivre


# Documentação


# Instalando o módulo


# Criar o aplicativo

Você aprenderá como criar o APP do Mercado Livre necessário para a configuração do módulo de integração do Mercado Livre para PrestaShop desenvolvido pela NeoGest.

Acesse o link <https://developers.mercadolivre.com.br/> e clique em "**Criar nova aplicação**":

![Criando uma nova aplicação do Mercado Livre](/files/-Md7xEuPdAAvDR6yiu56)

Serão solicitadas informações básicas para a criação do Aplicativo, preencha e clique em **continuar**:

![Informações básicas do aplicativo](/files/-Md7xpDH3kg6bpW2taU9)

Na tela seguinte, é onde de fato vamos inserir as informações importantes para o APP ser integrado a sua loja PrestaShop.

No campo de **URI de Redirect**, vamos copiar o link indicado na configuração do módulo para o mesmo:

![](/files/-Md8-9i4LA6Xshj18UHx)

Nas opções de **Escopos** e **Tópicos**, vamos selecionar todas as opções disponíveis:

![Selecionando os escopos e tópicos do Aplicativo](/files/-Md8-iV54--AHZFPoAts)

{% hint style="info" %}
Note que ao selecionar o item "**orders\_v2**" ele desativará os itens "**ordens**" e "**created orders**".
{% endhint %}

No campo de **URL de Retornos de Chamada de Notificação**, vamos copiar o link indicado na configuração do módulo para o mesmo:

![](/files/-Md80nvgTpbXWPWL5pOH)

Leia e aceite os **Termos e Condições,** e faça a verificação do reCAPTCHA, teremos:

![Inserindo as informações essenciais da criação do Aplicativo](/files/-Md7ypw4OTYG73yTfDA1)

Com todos os campos preenchidos, clique em **Criar**.

{% hint style="success" %}
**Parabéns!** Seu aplicativo está pronto para ser utilizado.
{% endhint %}

![Aplicativo do Mercado Livre criado](/files/-Md8212qyOUdCd_vfPly)

{% content-ref url="/pages/-Md827qb1FyRo9foAA4p" %}
[Configurar a integração](/marketplace/ngmercadolivre/instalando-o-modulo/configurar-a-integracao)
{% endcontent-ref %}


# Configurar a integração

Você aprenderá a fazer o vínculo do APP do Mercado Livre com a Integração em sua loja PrestaShop.

Após ter o APP do Mercado Livre criado, vamos utiliza-lo para configurar a integração instalada em sua loja PrestaShop.

Para isso, precisamos obter os dados do APP criado, clicando em **Editar**:

![Editando o APP do Mercado Livre](/files/-Md836_7lcEH_0Wi_rkw)

Na tela de edição, vamos encontrar os dados de "**App ID"** e "**Client Secret"**, que precisamos para configurar o módulo de integração:

![Visualizando o App ID e Client Secret do Aplicativo](/files/-Md83ezGWCF2AGgZn9iF)

Copie o **"App ID"** do Aplicativo e cole no campo **"APP\_ID"** na aba de configuração do módulo:

![](/files/-Md849r0irBu02hSqQmT)

Copie o "**Client Secret"** do Aplicativo e cole no campo "**Client Secret**" na aba de configuração do módulo:

![](/files/-Md84_MYsVunLWdMqVgF)

Informe o endereço de "**E-mail da sua conta do Mercado Livre"**, o "**País"**, a "**Moeda"** e o campo **"Mapear para"**, seguindo o exemplo abaixo:

![](/files/-Md88an6BgNoREZNmW3S)

Clique em "**SALVAR"** na tela de configuração do módulo.

### Permitindo o APP do Mercado Livre

Será exibida uma mensagem para você **Permitir** o aplicativo criado a se conectar em sua conta do Mercado Livre, dê a permissão:

![Solicitação da permissão do APP para se conectar a conta do Mercado Livre](/files/-Md85vJDUZAyn-_viqxf)

Após permitir, você será direcionado tela de configuração do módulo, em sua loja virtual.

{% hint style="success" %}
**Parabéns!** A integração do Mercado Livre para PrestaShop está configurada.
{% endhint %}


# Configurações extras


# IPs do MercadoLivre

Adicione os novos IPs nos seus servidores para ter uma conexão bem-sucedida

Revise possíveis erros. Se ao carregar o item a imagem mostrar erro (por exemplo, “Processando imagem…”), você pode realizar algumas das verificações abaixo.

## Formato de imagem <a href="#formato-de-imagem" id="formato-de-imagem"></a>

Comprovar por navegador que a imagem exista e revisar possíveis erros. Se ao carregar o item a imagem mostrar um erro, você poderá identificar o motivo utilizando a chamada anterior.

* JPG;
* JPEG;
* PNG;
* GIF não animados.

## Conexão / bloqueio <a href="#conexao-bloqueio" id="conexao-bloqueio"></a>

Se sua integração utiliza imagens guardadas em seus servidores, lembre-se de adicionar as seguintes IPs em sua whitelist ou lista de permitidas, para que a conexão com Mercado Livre seja exitosa.

* 209.225.49.0/24;
* 216.33.197.0/24;
* 216.33.196.0/24;
* 63.128.82.0/24;
* 63.128.83.0/24;
* 63.128.94.0/24;
* 216.33.196.4;
* 216.33.196.25.

Até 30 de setembro, você deverá adicionar na sua conta os seguintes endereços de IPs na listagem permitida:

* 216.33.196.4;
* 216.33.196.25;
* 54.88.218.97;
* 18.215.140.160;
* 18.213.114.129;
* 18.206.34.84.

Verificar se na sua URL há algum tipo de redirecionamento. O link deve ser igual ao da imagem. Por exemplo, se a URL for HTTP mas ao informá-la no browser muda para HTTPS, isso quer dizer que houve um redirecionamento.

Se o certificado de SSL for compatível com o nosso servidor, sugerimos remover o SSL enviando as URLs com HTTP.

Excelente! Agora, a nova imagem de seu produto será exibida. Você já sabe como adicionar e substituir imagens. E lembre-se: boas imagens atrairão mais compradores!

Link Oficial da obtenção dos IPs: [https://developers.mercadolivre.com.br/](https://developers.mercadolivre.com.br/pt_br/trabalhar-com-imagens#Conex%C3%A3o-bloqueio)


# Ideris

Neste tutorial você aprenderá a instalar, configurar e a como utilizar a integração da Ideris para PrestaShop desenvolvida pela NeoGest.

A Ideris é um hub integrador que permite que você venda em diferentes canais de marketplaces de forma facilitada (sem precisar fazer um contrato próprio com cada canal) e automatizada. Onde você envia os seus produtos uma única vez para o hub, faz a publicação dos mesmos nos canais desejados e visualiza todas as suas vendas em um único local, e a Ideris se encarrega de se comunicar com os canais de venda escolhidos.

![](/files/-MlL0SgH8fDaK2a95RE1)

O módulo da NeoGest integra os produtos da sua loja PrestaShop com o hub da Ideris, permitindo que você publique todo o seu catálogo de forma automatizada e mantendo o estoque e preço dos produtos em sincronia com o produtos da Ideris.<br>

{% content-ref url="/pages/-MlKvBc\_EGjvC2P38hNx" %}
[Documentação](/marketplace/ngideris/documentacao)
{% endcontent-ref %}

{% content-ref url="/pages/-MlKvFoQT6AQHy\_4hFil" %}
[Configurando a integração](/marketplace/ngideris/instalando-o-modulo)
{% endcontent-ref %}

{% hint style="info" %}
Abaixo você pode assistir um breve descrição de como a Ideris pode lhe ajudar no gerenciamento dos canais de marketplace.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=NU0e6jEVpt0>" %}


# Documentação

Neste tutorial vamos aprender as funcionalidades e o modo de funcionamento da integração da Ideris em sua loja PrestaShop.

A Ideris é um hub integrador que permite que você venda em diferentes canais de marketplaces de forma facilitada (sem precisar fazer um contrato próprio com cada canal) e automatizada. Onde você envia os seus produtos uma única vez para o hub, faz a publicação dos mesmos nos canais desejados e visualiza todas as suas vendas em um único local, e a Ideris se encarrega de se comunicar com os canais de venda escolhidos.

O módulo da NeoGest integra os produtos da sua loja PrestaShop com o hub da Ideris, permitindo que você publique todo o seu catálogo de forma automatizada e mantendo o estoque e preço dos produtos em sincronia com o produtos da Ideris.

## Fluxo da Integração

A integração inicialmente vai buscar todos os produtos na Ideris que possuem uma mesma SKU (campo referência dos produtos ou combinações do PrestaShop) em sua loja PrestaShop para fazer o vínculo.

Neste momento, todos os produtos encontrados na Ideris estarão disponíveis no menu **Marketplace > Ideris > Produtos** em sua loja PrestaShop, vinculados e prontos para terem seus Preços e Estoques sincronizados.

Logo na sequência, a integração enviará para a Ideris todos os produtos existentes no PrestaShop que não foram encontrados na Ideris e após a conclusão do envio, todos os produtos enviados estarão também disponíveis no menu de **Produtos** da integração, indicando o estado atual da publicação.

## Fluxo das Sincronizações

### Produtos

A sincronização do produtos é feita de forma automática, de hora em hora, checando se existem SKUs na Ideris que também existem em sua loja PrestaShop.

O envio dos novos produtos do PrestaShop para a Ideris é feito de forma automática, de hora em hora, e a atualização dos estados desses produtos enviados também segue esta mesma frequência.&#x20;

### Preço

A sincronização do preço será feita de forma automática, uma vez que os produtos estejam publicados e vinculados.

A frequência da sincronização pode ser configurada na configuração da integração conforme sua necessidade, acessando o menu: **Módulo > Ideris > Configurações > Sincronizações**.

### Estoque

A sincronização do estoque será feita de forma automática, uma vez que os produtos estejam publicados e vinculados.

A frequência da sincronização pode ser configurada na configuração da integração conforme sua necessidade, acessando o menu: **Módulo > Ideris > Configurações > Sincronizações**.


# Configurando a integração

Neste tutorial vamos aprender a configurar o módulo de integração da Ideris em sua loja PrestaShop.

{% hint style="info" %}
Caso tenha qualquer dificuldade na instalação de um módulo na plataforma, você pode ver um passo a passo [clicando aqui](/prestashop/instalando-um-modulo).
{% endhint %}


# Google Shopping


# PrestaShop com a Bling ERP

Neste artigo vamos orientar em como fazer a integração do PrestaShop utilizando o Padrão Nacional (Módulo de Cadastro da NeoGest) com o ERP da Bling.

## Configurando o PrestaShop <a href="#configurando-o-prestashop" id="configurando-o-prestashop"></a>

É necessário configurar a sua plataforma PrestaShop antes de darmos continuidade no o processo de integração com o ERP da Bling.

### Ativando o WebService <a href="#ativando-o-webservice" id="ativando-o-webservice"></a>

Vamos acessar o menu “Parâmetros Avançados > WebService” do seu PrestaShop e ativarmos o serviço de WebService:

![Clique em SIM para ativar o WebService do PrestaShop](/files/-M1Az63uYusZO4pME0Gn)

### Adicionando uma Chave do WebService <a href="#adicionando-uma-chave-do-webservice" id="adicionando-uma-chave-do-webservice"></a>

Após ativarmos, na mesma tela, vamos criar uma Chave de acesso ao WebService, clicando no (+) da grid:No canto superior direito da tela.

![Botão "Adicionar nova chave do WebService" localizado na toolbar](/files/-M1AyqnHu4BN5c-F3DyI)

Na tela de adição da Chave, vamos clicar em GERAR, inserir uma descrição e selecionar todos as ação de “Ver”, “Modificar”, “Adicionar”, “Apagar” e de “Visualização Rápida”, seguindo o exemplo abaixo:

![Criando uma chave para o WebService do PrestaShop](/files/-M1AzdO2psRwt0K-Xm_g)

Com as configurações salvas, vamos ter algo semelhante a isso:

![Chave do WebService criada com sucesso](/files/-M1AzzxMrUJEG569xnTY)

Neste ponto, o seu PrestaShop estará configurado e pronto para o Bling se conectar a ele.

## Configurando o Bling <a href="#configurando-o-bling" id="configurando-o-bling"></a>

Agora vamos configurar o Bling para capturar as informações da sua loja PrestaShop.

Para configurar sua plataforma PrestaShop no Bling ERP, você deve acessar Preferências -> Integrações -> Configurações de integração com lojas virtuais e marketplaces.

![Selecione a opção "Configurações de integração com lojas virtuais e marketplaces"](/files/-M1B2dkYLgpravLnFYzf)

Em seguida, serão listadas todas integrações disponíveis, clique sobre a integração que deseja configurar, para que seja direcionado à área de cadastro.

![Selecione a plataforma PrestaShop](/files/-M1B2sLZVhQbJnaYecxI)

Informe os dados solicitados, conferindo com atenção a versão do seu PrestaShop, e insira a chave gerada para acesso ao Web Service.

![Preencha os campos corretamente, informando a chave de acesso gerada em seu PrestaShop](/files/-M1B3-dRwTtrI6XFwVZL)

Após completar as informações necessárias, valide se a comunicação entre as plataformas (Bling – Prestashop) esta funcionando corretamente, para isso, basta clicar no botão Testar.

### Mapeamento dos Campos <a href="#mapeamento-dos-campos" id="mapeamento-dos-campos"></a>

Antes de salvar a configuração da integração no Bling, há algumas Regras de operação disponibilizadas pelo Bling, assim basta clicar sobre as mesmas para que seja mostradas tais opções.

Na Aba de Vendas, vamos fazer a configuração de seus campos personalizados de acordo com a tela abaixo:

![Mapeando os campos personalizados de Vendas](/files/-M1B3CCsaL8qMr52fVDu)

Em seguida, vamos acessar a Aba de Produtos para configurarmos o campo NCM:

![Mapeando os campos personalizados de Produtos](/files/-M1B3KgBmk83ckGdNcXx)

E por fim, na Aba de Contatos, vamos configurar os campos personalizados do cliente:

![Mapeando os campos personalizados de Contatos](/files/-M1B3SloS3NV5H15Uzul)

Feito isso, seu PrestaShop (utilizando o Padrão Nacional da NeoGest) estará integrado corretamente com o Bling ERP.

Além dessas configurações, é possível realizar a configuração das aliases dos Meios de Pagamento, desta maneira, quando importado um pedido de venda, serão buscadas as formas de pagamento de acordo com as aliases configuradas no Bling.

{% hint style="info" %}
*O alias é um apelido da forma de pagamento no canal de venda, permitindo que na importação do pedido esta forma de pagamento seja selecionada automaticamente.*
{% endhint %}


# PrestaShop com a Tiny ERP

Tutorial: Como Configurar o Tiny ERP na Plataforma PrestaShop

Este tutorial vai orientá-lo passo a passo na configuração do **Tiny ERP** no **PrestaShop**, para que você possa integrar a gestão do seu e-commerce com um sistema ERP completo. Vamos simplificar ao máximo, dividindo o processo em partes claras.

***

#### **Passo 1: Preparação do Ambiente**

**1.1. Verifique os Requisitos**

Certifique-se de que o **PrestaShop** e o **Tiny ERP** estão instalados corretamente e cumprem os seguintes requisitos:

* PrestaShop versão 1.7 ou superior.
* Tiny ERP com integração habilitada para e-commerce.

**1.2. Acesso ao Painel de Administração do PrestaShop**

Faça login no painel de administração do **PrestaShop** com suas credenciais.

***

#### **Passo 2: Instalação do Módulo Tiny ERP**

**2.1. Obtenha o Módulo de Integração**

Baixe o módulo de integração **Tiny ERP** para **PrestaShop**. Geralmente, esse módulo está disponível no marketplace do PrestaShop ou no site oficial do Tiny ERP.

**2.2. Faça o Upload do Módulo**

No painel de administração do **PrestaShop**:

* Navegue até **Módulos** > **Gerenciar Módulos**.
* Clique em **Carregar um Módulo** no canto superior direito.
* Selecione o arquivo ZIP do módulo Tiny ERP baixado.

**2.3. Instale o Módulo**

* Após o upload, o PrestaShop vai reconhecer o módulo automaticamente.
* Clique no botão **Instalar** ao lado do nome do módulo.

**2.4. Configure as Permissões**

Certifique-se de que as permissões do módulo estão corretamente configuradas para que ele possa acessar e modificar dados de pedidos, clientes e produtos.

***

#### **Passo 3: Configuração do Módulo Tiny ERP**

**3.1. Conecte o Tiny ERP com o PrestaShop**

* Acesse as configurações do módulo **Tiny ERP** no menu **Módulos Instalados**.
* Será solicitada a **API Key** e a **URL do seu Tiny ERP**.
  * No **Tiny ERP**, acesse as configurações da API e gere uma chave de API exclusiva para integração com o PrestaShop.
  * Insira a chave e a URL no campo apropriado no PrestaShop.

**3.2. Mapeamento de Campos**

O módulo permite configurar o **mapeamento de dados** entre o PrestaShop e o Tiny ERP. Aqui você vincula:

* **Produtos**: Sincronize os catálogos de produtos entre as duas plataformas.
* **Pedidos**: Configure para que novos pedidos no PrestaShop sejam automaticamente importados para o Tiny ERP.
* **Clientes**: Sincronize as informações dos clientes.

**3.3. Teste de Conexão**

Clique em **Testar Conexão** para verificar se o PrestaShop está comunicando corretamente com o Tiny ERP. Se o teste falhar, reveja as informações da API e tente novamente.

***

#### **Passo 4: Sincronização de Dados**

**4.1. Sincronizar Manualmente**

* Acesse o módulo **Tiny ERP** no PrestaShop.
* Você encontrará opções para **Sincronizar Produtos**, **Sincronizar Pedidos** e **Sincronizar Clientes**.
* Execute a sincronização inicial para garantir que todas as informações sejam transmitidas corretamente.

**4.2. Configuração de Sincronização Automática**

Para facilitar, configure a sincronização automática:

* Acesse o menu de **Configurações Avançadas** do módulo.
* Ative a sincronização em tempo real ou configure um cronograma de sincronização automática (por exemplo, a cada 30 minutos).

***

#### **Passo 5: Teste e Verificação**

**5.1. Faça um Pedido de Teste**

No frontend da sua loja **PrestaShop**, faça um pedido de teste para garantir que as informações estão sendo transferidas corretamente para o **Tiny ERP**.

**5.2. Verifique no Tiny ERP**

No painel do Tiny ERP, vá até a seção de pedidos e confirme se o pedido foi sincronizado corretamente. Verifique também se os dados dos produtos e dos clientes estão aparecendo conforme o esperado.

***

#### **Passo 6: Ajustes Finais**

**6.1. Personalize as Configurações**

Dependendo da sua operação, você pode querer ajustar algumas configurações do módulo Tiny ERP, como:

* Gerenciamento de estoque automático.
* Atualização de preços em tempo real.
* Gestão de múltiplos armazéns ou lojas.

**6.2. Treine sua Equipe**

É importante garantir que todos os responsáveis pela gestão da loja e pelo ERP estejam familiarizados com o processo de sincronização e saibam como lidar com eventuais problemas.

***

#### **Conclusão**

Agora que você configurou o **Tiny ERP** no **PrestaShop**, sua loja está pronta para operar de maneira mais eficiente, automatizando tarefas importantes como gestão de pedidos, estoque e dados de clientes. Isso permite focar mais em estratégias de crescimento e menos em tarefas manuais.

Sempre que necessário, revisite as configurações para garantir que estão de acordo com as necessidades do seu negócio. E lembre-se de realizar testes periódicos para assegurar que a sincronização entre as duas plataformas continua funcionando corretamente.

***

**Dicas Finais:**

* **Backup**: Faça backups regulares do banco de dados do PrestaShop e do Tiny ERP.
* **Monitoramento**: Verifique periodicamente os logs de sincronização para identificar e corrigir problemas de integração.

Se precisar de mais alguma ajuda na configuração ou ajustes específicos, sinta-se à vontade para consultar a documentação oficial do Tiny ERP ou o suporte da PrestaShop.


# RD Station

Neste tutorial você aprenderá a instalar, configurar e a como utilizar a integração do RD Station para PrestaShop desenvolvida pela NeoGest.

A **RD Station Marketing** é uma plataforma de automação de marketing digital desenvolvida pela Resultados Digitais (RD), uma empresa brasileira. O objetivo da RD Station Marketing é auxiliar empresas a atrair, converter, e nutrir leads (potenciais clientes), transformando-os em clientes e promovendo o crescimento do negócio. A ferramenta centraliza diversas funcionalidades para a gestão de estratégias de marketing digital, facilitando o processo de criação, acompanhamento e análise de campanhas.

<div align="center"><figure><img src="/files/00TX3DZTVXAj1vUlpcIU" alt=""><figcaption><p>RD Station para PrestaShop</p></figcaption></figure></div>


# Configurando a integração

Neste tutorial vamos aprender a configurar o módulo de integração da RD Station em sua loja PrestaShop.

Acessando a configuração do módulo, veremos:

![Tela de configuração da integração com a iSend](/files/-McnxVxj_9zTXKrvznzf)

Nesta tela, basta inserirmos os dados que foram enviados no e-mail de cadastro da conta RD Station, onde devemos copiar o **Client ID** e **Client Secret** que foram recebidos e colarmos eles na nos campos acima.

Com os dados salvos, a configuração foi finalizada e podemos avançar com a configuração dos disparos.

Para configurar o módulo da RD Station no PrestaShop, siga este passo a passo:

#### 1. **Instalar o Módulo RD Station no PrestaShop**

* Acesse o painel administrativo do PrestaShop.
* No menu lateral, vá para **Módulos e Serviços > Módulos e Serviços**.
* No campo de pesquisa, digite **RD Station** para localizar o módulo (caso já o tenha no marketplace do PrestaShop).
* Se o módulo ainda não estiver instalado, você pode baixá-lo da **marketplace do PrestaShop** ou direto do site da RD Station, seguindo as instruções de instalação.

#### 2. **Configurar a Conexão com a RD Station**

* Após a instalação, acesse as configurações do módulo RD Station no painel do PrestaShop.
* Acesse sua conta da RD Station Marketing e vá em **Configurações > Integrações** para gerar uma **Chave de Integração (Token de Acesso)**.
* Copie a chave gerada.

#### 3. **Integrar a Chave de Acesso no Módulo do PrestaShop**

* Volte ao módulo da RD Station no PrestaShop.
* No campo específico para o **Token de Acesso**, cole a chave copiada da RD Station.
* Salve as configurações para que a integração seja concluída.

#### 4. **Configurar Eventos de Conversão**

* Acesse o módulo e vá para a seção de **Eventos de Conversão**. Aqui você define quais ações no PrestaShop serão enviadas para a RD Station.
* Configure eventos de interesse, como **Leads**, **Compra Finalizada**, **Carrinho Abandonado**, e outros, mapeando-os para os eventos na RD Station.
* Defina as tags ou parâmetros específicos para cada evento, permitindo rastreamento detalhado no RD Station.

#### 5. **Teste a Integração**

* Realize uma ação de teste (como uma compra) no site do PrestaShop para verificar se os dados estão sendo enviados para o RD Station.
* Na RD Station, confirme se o evento foi registrado na seção de **Leads** ou **Automação de Marketing**.

#### 6. **Ativar Automação de Marketing**

* Com os eventos integrados, configure as automações na RD Station para nutrir os leads ou enviar campanhas segmentadas de acordo com os eventos configurados.

Pronto! A integração do PrestaShop com o RD Station deve estar funcionando, e agora você pode rastrear e nutrir os leads diretamente a partir das ações realizadas no e-commerce.


# iSend

Neste tutorial você aprenderá a instalar, configurar e a como utilizar a integração do iSend para PrestaShop desenvolvida pela NeoGest.

O iSend é uma ferramenta de Comunicação e Marketing Digital Multicanal que possibilita, entre outras funcionalidades, a segmentação de contatos, envio de informativos, envio de mensagens de textos por celular (SMS) através da integração com sites, lojas virtuais, blogs e redes sociais, realizando o monitoramento completo de todas as ações.

![iSend para PrestaShop](/files/-Mcnt7ugSGRJxfIZgL0x)

{% content-ref url="/pages/-Mcns1d8o7F-C7Fx1ZqC" %}
[Configurando a integração](/marketing/isend/configurando-a-integracao)
{% endcontent-ref %}

{% content-ref url="/pages/-Mcns8o415Ew2VQSf1N7" %}
[Configurando os disparos](/marketing/isend/configurando-os-disparos)
{% endcontent-ref %}


# Configurando a integração

Neste tutorial vamos aprender a configurar o módulo de integração da iSend em sua loja PrestaShop.

{% hint style="info" %}
Caso tenha qualquer dificuldade na instalação de um módulo na plataforma, você pode ver um passo a passo [clicando aqui](/prestashop/instalando-um-modulo).
{% endhint %}

Acessando a configuração do módulo, veremos:

![Tela de configuração da integração com a iSend](/files/-McnxVxj_9zTXKrvznzf)

Nesta tela, basta inserirmos os dados que foram enviados no e-mail de cadastro da conta iSend, onde devemos copiar o **Usuário** e **Senha** que foram recebidos e colarmos eles na nos campos acima.

Com os dados salvos, a configuração foi finalizada e podemos avançar com a configuração dos disparos.

{% content-ref url="/pages/-Mcns8o415Ew2VQSf1N7" %}
[Configurando os disparos](/marketing/isend/configurando-os-disparos)
{% endcontent-ref %}


# Configurando os disparos

Neste tutorial você vai aprender a configurar as mensagens a serem disparadas pela iSend.

Com a integração instalada, vamos acessar o menu **Módulos > iSend**, para iniciarmos a configuração dos disparos dos SMS:

![Tela de Formatos das Mensagens](/files/-Mcnzj7KEkfLblVSbhRv)

Na grid desta tela, temos um botão **(+)** para **Adicionar uma nova mensagem**, vamos clicar nele:

![Clicando em Adicionar uma nova mensagem](/files/-Mco-Oy0JioarTfiSEHB)

Agora, basta configurarmos a mensagem desejada e definirmos quando a mesma será enviada:

![Tela de configuração do Formato de Mensagem a ser disparado](/files/-Mco0CNPaMghjyx6MasS)

Nesta tela, vamos configurar o momento que o disparo será feito, o tempo desejado para que o disparo seja feito e a mensagem do mesmo, nos campos:

* **estado do pedido** -> vamos selecionar o estado que vai ativar o disparo da mensagem;
* **enviar após** -> vamos configurar o tempo que o pedido deve estar neste estado para que a mensagem seja disparada;
* **mensagem** -> vamos configurar a mensagem em si que o cliente receberá quando atender a configuração acima.

Neste ponto é possível configurar uma série de mensagens para diferentes estados dos pedidos e com tempos diversos, permitindo assim a configuração de SMSs para:

* aviso de pedido finalizado;
* atualização dos estados do pedido;
* envio do rastreador do pedido;
* recuperação de pedidos não pagos;
* solicitação de avaliação da compra.

{% hint style="success" %}
Os exemplos acima são apenas algumas possibilidades que esta integração pode proporcionar a você lojista.
{% endhint %}


# Actionpay

Confira abaixo as instruções para integrar seu PrestaShop com a rede de afiliados Actionpay através do Google Tag Manager.

## Verificado os dados necessários para a configuração

Antes de começar a integração tenha certeza que você tem:

* **PARTNER\_ID e ID DA META** – eles são obtidos com o gerente de contas do Actionpay;
* **Link para sua campanha** – ele é obtido com o gerente de contas do Actionpay;
* **Marcas Analíticas UTM e Informações sobre as ações alvo** – esses dados obtidos com o responsável pela conta por parte do anunciante (você) ou no apêndix do contrato;
* **Janela de Comissão (Post-Click Period)** – esses dados são obtidos com o responsável pela conta (contrato);
* Informações sobre como é realizada o rastreamento sobre a última fonte de tráfego pago (ultimo cookie vence).

## Configurando a TAG da Actionpay

A configuração consiste em três partes e é aceitável para a maioria das campanhas. Contudo as campanhas podem ter peculiaridades individuais ou técnicas e específicas, que demandem customizações.

{% hint style="info" %}
Caso não seja possível utilizar o procedimento padrão outras alternativas de integração são possíveis, entre em contato com a nossa equipe para verificar essas alternativas.
{% endhint %}

### A integração padrão consiste em três etapas principais:

* Processar a transição entre a rede da Actionpay e sua loja virtual em PrestaShop (anunciante);
* Notificação da rede da Actionpay sobre a ação executada (pixel);
* Notificação da rede da Actionpay sobre a mudança do status da ação previamente executada (opcional) – Executada fora do GTM. Cada parte é descrita em detalhe daqui por diante.

Cada uma das etapas descritas acima serão detalhadas abaixo.

## 1. Processando a transição da rede Actionpay na loja virtual

Para identificar que a transação foi feita através da rede da Actionpay ao invés de uma outra fonte. Existem duas formas alternativas para identificação: a forma completa e a compacta. Fica a critério do anunciante decidir quais das duas formas utilizar, depois é necessário informar ao gerente de contas, ou gerente de integração, a decisão para que seja feita a configuração no sistema.

Links desse tipo serão utilizados para as suas campanhas por nossos afiliados:

<https://www.dominio.com/click/53b29c288b30a8c0598b458b/81092/67345/>

O usuário que seguir esse link, verá, por exemplo, na barra de endereço do browser o URL a seguir, no formato completo:

[https://www.dominio.com/?**actionpay**=27606ca9-b7ee-c96f-ef18-01493ec212cf.67345&**utm\_source**=actionpay](https://www.dominio.com/?actionpay=27606ca9-b7ee-c96f-ef18-01493ec212cf.67345\&utm_source=actionpay)

Essas variáveis são:

* **utm\_source:** origem do tráfego;
* **actionpay:** identificador da fonte de origem da transação.

Os identificadores da fonte de origem da transação, que são indicados no exemplo como “0”, são representados por sequências alfanuméricas. A extensão máxima é de 50 caracteres.

É possível adicionar diversos parâmetros UTM para o seu monitoramento e rastreamento interno. Favor informar a equipe de integração quais parâmetros devem ser adicionados.

**Por exemplo:** **utm\_source**=actionpay&**utm\_medium**=cpa&**utm\_campaign**=actionpay

### 1.1. Adicionar os parâmetros URL nos Cookies

É necessário armazenar os valores dos parâmetros GET nos cookies dos usuários para ser possível identificar o usuário quando retornar e também para o correto funcionamento do rastreamento.

O tempo de vida do acesso ao “cookie” deve corresponder ao período do **“Post-Click”** ou janela de comissão da campanha, valor especificado no anexo ao contrato (por exemplo, se a janela de comissão for igual a 30 dias, o cookie será ativo até o momento que é uma soma da data da transação somado de  30 dias).

A rede da Actionpay irá testar automaticamente o ajuste correto dos cookies (nome correto, significado e validade) periodicamente. Junto com o cookie, a loja virtual anunciante pode salvar os parâmetros recebidos durante a transição da rede da Actionpay com seus sistemas internos (base de dados, perfil do usuário e outros). Entretanto, o ajuste do cookie é fundamental.

Existem algumas formas de configurar um cookie no Google Tag Manager. O Exemplo abaixo é apenas uma sugestão. Neste exemplo estamos utilizando o link compacto, caso deseje utilizar o completo, não esqueça de informar a equipe da Actionpay responsável pela integração para alterar o link.&#x20;

A próxima etapa é criar uma **TAG HTML personalizada** para criar o **cookie actionpay**, para identificarmos quando o tráfego vier dos afiliados da Actionpay. Acesse o Google Tag Manager:

1. Vá em TAG e selecione uma NOVA;
2. Dê um nome para a TAG, por exemplo: tag\_actionpay;
3. Escolha o tipo de TAG: HTML personalizado;
4. No HTML, cole o seguinte código javascript:

```javascript
<script language="JavaScript" type="text/javascript">
	var sourcevar = getQueryVariable("utm_source");
	var apclickvar = getQueryVariable("actionpay");
	var postclick = 30;         // alterar pelo número de dias de sua janela de comissão
	var domain = "dominio.com"; // alterar pelo seu domínio, sem o www.
	var partnerId = "12345";    // alterar pelo seu partnerId, obtido com seu gerente de contas da Actionpay

	function getQueryVariable(variable) {
		var query = window.location.search.substring(1);
		var vars = query.split("&");
		for (var i = 0; i < vars.length; i++) {
			var pair = vars[i].split("=");
			if (pair[0] == variable) {
				return pair[1];
			}
		}
	}

	function setCookie(cname, cvalue, exdays) {
		var d = new Date();
		d.setTime(d.getTime() + (exdays * 24 * 60 * 60 * 1000));
		var expires = "expires=" + d.toUTCString();
		document.cookie = cname + "=" + cvalue + "; path=/;" + expires + "; domain=" +domain;
		return cookieap;
	}

	if (sourcevar == "actionpay") {
		var cookieap = setCookie("Actionpay", apclickvar, postclick);
		var cookieap = setCookie("Origem", "actionpay", postclick);
	} else if (sourcevar != undefined) {
		var cookieap = setCookie("Origem", sourcevar, postclick);;
	}

	(function() {
		var s = document.createElement('script');
		s.type = 'text/javascript';
		s.async = s.defer = true;
		s.src = '//aprtn.com/code/' + partnerId + '/';
		var p = document.getElementsByTagName('body')[0] ||
		document.getElementsByTagName('head')[0];
		if (p) p.appendChild(s);
	})();
</script>
```

Você precisa obter o **PARTER\_ID** com o seu gerente de contas e lembre-se de alterar o domínio **"dominio.com.br"** pelo seu domínio **sem o [www](http://www).** Ou seja, se o seu site é “[www.exemplo.com.br”](http://www.exemplo.com.br”) o domínio será “exemplo.com.br”.

Você deve alterar o valor do **POSTCLICK** marcados de 30, para o número de dias da sua janela de comissão, (período de postclick), esse valor está definido no contrato com a Actionpay.

O código JavaScript acima irá criar esses dois cookies diferentes:

* Cookie Actionpay=**0000-0000-0000-0000.0000000;**
* Cookie Origem=**actionpay.**

Além de realizar uma verificação no tráfego evitando fraudes e otimizando as campanhas da Actionpay.

1. Marque Suporte para document.write;
2. Escolha o acionador para disparar essa tag.

A próxima etapa é definir uma regra de acionamento da TAG dentro da "**tag\_actionpay"** recém-criada.

Selecione todas as páginas (All Pages), uma regra que já vem pré-configurada no TAG Manager.

### 1.2. Gerenciamento da última fonte paga

O segundo cookie criado (Origem) é quem permite rastrear a última fonte paga. Caso você utilize outro cookie para gerenciar isso é só alterar no código a palavra Origem para o nome do cookie utilizado, alterando também o valor “actionpay” pelo código que representa a nossa rede. Se já tem outra Tag para gerenciar o último clique, você pode ignorar essa etapa.

### 1.3. Testando os cookies criados

Com a TAG criada com suas respectivas regras e variáveis, publique o contêiner para realizar o teste. Utilizando o navegador Google Chrome, entre em Visualizar e selecione Visualizar e depurar como mostra na figura 4.&#x20;

Esse comando irá simular a TAG dentro do seu site. Acesse o seu site, abaixo vai abrir o depurador do tagmanager. A TAG tag\_actionpay deve ser disparada, em todas as páginas. Caso não tenha sido disparada verifique as regras de disparo da TAG.

Depois, na mesma janela criada pelo comando depurar, copie e cole o link gerado pelo seu gerente de contas. O link deve ser similar ao link abaixo, direcionado para o seu site. Verifique se a TAG foi disparada.

Exemplo: [https:](https://www.dominio.com/click/54501e6b8b30b837748b4567/00000/70505/subaccount)[//www.dominio.com/click/54501e6b8b30b837748b4567/00000/70505/subaccount](https://www.dominio.com/click/54501e6b8b30b837748b4567/00000/70505/subaccounthttps://www.dominio.com/click/54501e6b8b30b837748b4567/00000/70505/subaccount) (esse link exemplo não funciona!!)

Selecione o modo de desenvolvimento do Chrome (f12) no campo Application / Cookies / (seu site)

Vá em Application/(seu domínio) e verifique se o cookie Actionpay foi criado corretamente, copiando os dados do apclick e apsource para o cookie. Além disso verifique se o cookie Origem é igual a “Actionpay”. Ambos os cookies devem expirar conforme definido na Janela de Comissão da Campanha.

## 2. Notificação sobre a execução da ação (pixel)

O Tracking-pixel, ou pixel de rastreamento, (daqui por diante somente “pixel”) é usado para informar a rede da Actionpay sobre a ação executada no Site do anunciante. Em outras palavras, no momento em que a ação está sendo executada; um código que carrega uma imagem transparente no tamanho de 1x1 pixel do servidor do Actionpay será substituído no código mostrado ao usuário da página.

Esta imagem não é mostrada ao usuário mas serve como uma forma de solicitar que o servidor do Actionpay guarde os parâmetros da ação. Existem outras formas de integração que podem ser usadas caso a instalação do pixel não seja viável para saber mais favor entrar em contato com a nossa equipe de suporte. Veja nossos contatos no item 2 desse manual.

O código pixel com a transmissão dos parâmetros, é similar a:

```javascript
<img src="https://apretailer.com.br/ok/0000.png?actionpay={{cookie_actionpay}}&apid={{ID_Transacao}}&price={{Valor_Transacao}}&width=1&height=1" width= "1" height= "1"/>
```

Onde:

* **0000** – É o identificador da ação na rede da Actionpay (Id da Meta);
* **actionpay= 0000-0000-0000-0000.0000000** é o identificador da transição;
* **apid=NNNN** Se existir um identificador único atribuído a cada ação executada no lado do anunciante, este identificador deve ser transmitido ao pixel com a ajuda do parâmetro “apid”.

O identificador único pode ser, por exemplo:

* Número de ordem;
* Número de pedido;
* Identificador do usuário;
* Número do pagamento;
* Identificador da ação criada no sistema do anunciante;
* Etc.

Qualquer a sequência de símbolos alfanumérica com marcas de pontuação, mas sem espaços pode ser um identificador.

Um identificador é importante para que as ações sejam comparadas futuramente e nomedas como aprovadas ou canceladas.

**price= 000.0000** - Se alguma quantia de dinheiro for atribuída a cada ação executada no lado do anunciante, esta quantia deve ser transmitida ao pixel com a ajuda do parâmetro “apprice”.

Esta quantidade pode ser, por exemplo:

* Uma quantia de ordem/compra;
* Uma quantia de pagamento;
* Uma quantia de reabastecimento (recarga);
* Etc.&#x20;

Neste caso, a unidade da quantia trocada pode ser em qualquer moeda incluindo moeda virtual (por exemplo, paypal).

Em um número com parte fracionária, o símbolo decimal deve ser um ponto. (Modelo americano). A quantidade máxima de caracteres depois do ponto é 4.

Caso não exista um VALOR atribuído a ação, como no exemplo de um cadastro, esse parâmetro pode ser excluído do pixel.

É importante que o pixel só seja chamado quando a ação tiver origem da Actionpay por isso o controle do último clique é fundamental. Caso seja impossível o rastreamento do último clique é possível trabalhar sem, contudo, sua oferta vai ficar pior classificada perante os afiliados devido a taxa de rejeição das ações.


# Google Tag Manager


# Instalando um módulo

Neste tutorial vamos aprender a instalar um módulo "qualquer" em sua loja PrestaShop.

Acesse o menu de Módulos da sua loja, no canto superior, clique no botão "**Enviar um módulo**", busque pelo arquivo baixado e faça a seleção do mesmo:

![Acesse o menu de Módulos, clique em "Enviar um módulo"](/files/-McnvL08CeGnHJaNl9_P)

Aguarde pela instalação:

![Após selecionar o arquivo, aguarde pela instalação](/files/-Mcnw1T2129k3YKAGRE6)

Quando finalizada, será exibida uma confirmação em sua tela:

![Instalação concluída e pronta para ser configurada](/files/-McnwpFoFjhivsciood3)

Com a integração instalada, vamos avançar com sua configuração, clicando em "**Configurar**".&#x20;


# CloudFlare

Neste tutorial vamos ensinar a como configurar o CloudFlare como gerenciador de DNS do seu domínio.

### Criando uma conta <a href="#cloudflare-criandoumaconta" id="cloudflare-criandoumaconta"></a>

Vamos acessar o link <https://www.cloudflare.com/pt-br/> e posteriormente clicar em **Cadastre-se.**

Será solicitado um **e-mail** e uma **senha**, insira os mesmos e clique em **Criar conta**.

Caso esteja com qualquer dificuldade em criar sua conta, você pode verificar como cria-la aqui:

{% embed url="<https://www.youtube.com/watch?v=nqMhr8qdcrI>" %}
Criando uma conta na CloudFlare e adicionando o domínio
{% endembed %}

### Adicionar outro usuário como membro <a href="#cloudflare-adicionaroutrousuariocomomembro" id="cloudflare-adicionaroutrousuariocomomembro"></a>

Para adicionarmos um usuário como membro da sua conta, inicialmente é necessário já ter feito o cadastro e ter escolhido um plano.

Superado os procedimentos acima, basta clicar em seu Perfil (1) e depois acessar a Página inicial da conta (2) como vemos na imagem abaixo:

![Acessando a conta para adicionar um novo usuário como membro](/files/dWq7gxZEdUH8WRFEHRg7)

Ao acessar a nova tela, vamos clicar no sub-menu chamado Membros (3), adicionar o e-mail do usuário a administrar em conjunto sua conta do CloudFlare (4) e enviar o convite para este usuário (5):&#x20;

![Enviando convite para um usuário ser administrador da sua conta CloudFlare](/files/kjxDCllGNogJyc0vm1l6)

Lembrando que você só conseguirá fazer essas etapas após ter verificado seu e-mail cadastrado na CloudFlare.


# Registro.br

Neste tutorial você vai aprender a administrar seu domínio no Registro.br.

Acesse o site do [Registro.br](https://registro.br/) e clique em "Acessar conta".

### Alterando o ID Técnico <a href="#registro.br-alterandooidtecnico" id="registro.br-alterandooidtecnico"></a>

Informe o nome de usuário, CPF, CNPJ ou domínio cujo provedor de serviços deseja alterar e a senha. Caso não lembre de alguma informação, clique no link correspondente para fazer a recuperação da senha.

Clique no domínio cujo ID Técnico deseja alterar.

Na seção "Contatos", clique no link "Alterar contatos".

* Se o link não existir, verifique se o domínio tem um provedor de serviços.
* Se tiver, então não é possível trocar o ID Técnico diretamente. Neste caso, troque o provedor para "NENHUM".

Informe o ID Técnico "RIMJA" ou outro que desejar. Clique em "Salvar".

* Aparecerá uma mensagem logo abaixo confirmando que a alteração foi feita com sucesso.

### Alterando o Gerenciador do DNS para o CloudFlare <a href="#registro.br-alterandoogerenciadordodnsparaocloudflare" id="registro.br-alterandoogerenciadordodnsparaocloudflare"></a>

{% embed url="<https://www.youtube.com/watch?v=SvecSwtO9Ck>" %}
Como alterar o gerenciador de DNS para o CloudFlare
{% endembed %}