Integrador Zoppy - Shop

A integração entre o Alterdata Shop e a Zoppy foi desenvolvida para potencializar a gestão de relacionamento com o cliente (CRM). O foco principal é a fidelização e o aumento das vendas através da recorrência e automação de marketing voltada ao varejo, permitindo que as lojas estimulem o retorno do consumidor de forma inteligente e integrada ao PDV. Para viabilizar esse processo, a integração utiliza um serviço em nuvem que automatiza o envio de dados via API.

Pré-requisitos e Compatibilidade

Para garantir o funcionamento correto da integração, verifique os seguintes requisitos:

• Contrato: O cliente deve possuir um contrato ativo com a Zoppy.

• Versão do Sistema: O sistema Wshop/IShop deve estar, no mínimo, na versão 1508.

• Dados Cadastrais:

  • Clientes: Serão enviados apenas os que possuam telefone celular cadastrado no campo "Celular".

  • Vendedores: Devem possuir e-mail e telefone celular cadastrados para serem integrados.

    
    

Para configurar a integração, você precisa:

1. Aquisição e Obtenção de Token (Painel Zoppy)

Antes da parte técnica, você deve garantir o acesso à plataforma:

1. Caso ainda não possua, realize a contratação através do site oficial ou acesse o Painel Zoppy.

2. Após o login, acesse as configurações de conta/integrações para gerar o seu Token de Integração.

3. Guarde este Token; ele será essencial.

2. Instalação do Serviço

O integrador é um serviço do Windows e não possui interface visual.

1. Certifique-se de que o executável (AltShopProc_IntegradorZoppy.exe) e o arquivo de configuração (AltShopProc_IntegradorZoppy.ini) estão na pasta SHOP.

   • Caminho padrão: C:\Program Files (x86)\Alterdata\Shop.

     
     

2. Abra o Prompt de Comando (CMD) como administrador no caminho mencionado acima.

3. Digite o comando abaixo e pressione Enter:

   • AltShopProc_IntegradorZoppy.exe /install.

     
     

3. Configuração de Chaves no Banco de Dados

Para que o integrador direcione as informações corretamente, é necessário configurar os parâmetros na tabela integracao_zoppy (dentro do schema integrado Wshop/Ishop):

• token_integracao: Insira o token gerado no site de produção da Zoppy.

• maquina_integradora: Informe o nome da máquina que executará o serviço.

• empresas: Informe os códigos das empresas (cdempresas) separados por vírgula e entre aspas simples (ex: '001','002').

• url_integracao: Inclua a URL de produção fornecida pela Zoppy.

• datainicio: Informe a data para início do envio das vendas.
  

Observação: Se a chave datainicio não for criada, o sistema enviará automaticamente os últimos 5 meses de vendas.

4. Funcionamento e Validações

A integração automatiza o envio dos seguintes dados diretamente para a nuvem da Zoppy:

• Vendedores, Empresas, Clientes e Produtos.

• Vendas fiscais e não fiscais.

Atenção às Vendas: As vendas são filtradas pelos clientes cadastrados. Se um cliente não estiver devidamente cadastrado (ex: falta de celular), as vendas vinculadas a ele não serão enviadas até que o cadastro seja regularizado.

5. Logs e Arquivos

Os registros de atividades são essenciais para monitoramento e são divididos em dois arquivos:

1. Inconsistência: Registra erros ou dados faltantes, como cadastros incompletos.

2. Log Completo: Registra todo o histórico de transações realizadas pelo serviço.

Exemplos de diretórios de log:

• C:\LogZoppy\Inconsistencia\

• C:\LogZoppy\LogCompleto\