VOALLE + Datacake - Setup da Integração
Integração via API
Configurações Gerais
Para que ocorra a integração via API, devem ser enviados alguns dados para a Datacake:
São eles:
-> Endpoint - Link da API da Voalle
-> Usuário
-> Senha
-> Segredo
-> Syndata
*Tela de configuração do Voalle no sistema Datacake.
Algumas informações úteis:
Criar um usuário e senha para a Datacake (saiba mais em Login de Acesso);
IMPORTANTE
Necessário usar o seguinte padrão para usuário.
integracao.NOMEPROVEDOR.datacake
A Voalle compartilha tabela de usuários então é necessário criar um usuário novo próprio para o provedor para evitar problemas de autenticação.
Por conta disto, este usuário pode ser criado com um CNPJ aleatório a para não dar conflito na Voalle
O usuário do ERP com perfil de "Administrador" deve acessar a rotina Suíte
/ Configurações / Parâmetros > Integração / Mapa.Caso não possua este módulo habilitado, abrir um protocolo para a Voalle solicitando a ativação deste módulo em seu ERP;
Em Dados para Acesso selecionar o usuário cadastrado no passo anterior e enviar os seguintes dados para a Datacake:
Host: URL do ERP do cliente. Ex.: https://erp.cliente.com.br
Usuário: Usuário cadastrado
Senha: Senha criptografada
Token: Token SynData
Caso queira que seja gerado Leads dentro da voalle através do sistema, é necessário fornecer também um token de autorização:
no painél da voalle, ir no caminho Configurações → Parâmetros → Suite, copiar o campo de Token e enviar para a Datacake junto com as outras informações.
Caso sejam realizados pedidos informando o mesmo e-mail de pedido anterior ainda não finalizado no ERP, a API pode retornar erro.
Será necessário habilitar os contratos que irão fazer parte das vendas do site dentro da voalle na api
Vá em: faturamento / tipo de contrato
Escolhe o(s) contrato(s) que irão ser vinculado as vendas do site
Em parâmetros vá em integração e habilite essa opção: “integração” (click no botão para ativar)
Para que o fluxo de pedido funcione é necessário:
No Voalle - Cadastrar e configurar a campanha e lista de preços. TUTORIAL AQUI
No Voalle - Vincular os produtos de assinatura a essa campanha.
No Datacake - Mapear no sistema Datacake os IDs dos produtos no campo Produto ERP de cada produto cadastrado, o produto deve pertencer a uma campanha no voalle
Para que a campanha funcione na API de pedidos é necessário definir o uso da campanha como:
“E-Commerce-integração”
Como mostrado no print a baixo. É obrigatório essa opção para que a campanha funcione. A Opção TODOS não funciona para API.
É necessário que a mesma equipe esteja configurada na campanha seja a mesma em Geração de Leads por Sistema de Terceiros e Geração de Negociações por Sistema de Terceiros em parâmetros gerais e parâmetros da campanha como mostra nos prints a baixo.
Também é necessário configurar o vendedor com o CNPJ da DATACAKE SERVICOS EM TECNOLOGIA LTDA 30.273.146/0001-71 no primeiro print em parâmetros gerais.
No caso de existir a necessidade de usar outro cadastro de vendedor esse deve ser cadastrado no sistema datacake no campo CPF/CNPJ do Revendedor, como mostra no print a baixo.
IMPORTANT
Verificar se as configurações a Integrações > Integrações ERP > Métodos clique no lápis para editar e verifique se estão definidas como Criar Pedido/Prospect e “Ignorar checagem de usuário na integração” está como SIM como no 3º print a baixo.
Pronto os pedidos podem ser enviados do sistema DataCake para o Voalle.
Configurações de Pagamento
Valores complementares ao método de pagamento. Devem ser preenchidos quando houver baixa de boletos via PIX ou via TEF, realizados pela Datacake.
ID da empresa: ID da empresa padrão para baixa de boleto, poderá ser preenchido individualmente para cada método de pagamento, no campo ID de pagamento na integração.
ID da Conta Padrão: ID da carteira de cobrança padrão para baixa de boleto, poderá ser preenchido individualmente para cada método de pagamento, no campo ID de pagamento na integração.
Configuração de LEAD VOALLE
Para criar pedido de lead ativar e preencher os seguires campos:
Precisa do Alias (nome) do integrador e do Código (ID) da origem de contato cadastrado no ERP
O switch “Criar Lead para usuário existente” força os pedidos de usuários já existentes no ERP sejam criados pela API de Lead.
Produtos: Campanha e Lista de Preço
Quando houverem múltiplas campanhas cadastradas no ERP Voalle se faz necessário indicar a qual campanha o produto pertence.
Para tal basta realizar a criação de um novo Atributo do Produto
O atributo deverá conter o seguinte Internal Code: remote_campaign_code
, como mostra a imagem abaixo:
Por fim deverá vincular esse atributo com o Tipo de Produto
De forma análoga, a Lista de Preço a qual o produto pertence poderá ser preenchida da mesma forma, utilizando o Internal Code: remote_price_list_code
.
Ao realizar estes passos, o atributo ficará disponível para preenchimento na página de edição do produto, na aba Atributos: