Ir para o final dos metadados
Ir para o início dos metadados

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Próxima »

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:

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 proprio pro provedor para evitar problemas de autenticação.

  • 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, é necessario 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 parametros gerais e parametros 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.

Sobre o envio das negociações via API, o processo que deve ser feito no ERP é o seguinte:

  1. Ir até a rotina "CRM - Voalle / Operações / Dashboard - Vendedor"

  2. Ir até o menu "Meus Leads"

  3. Clicar no botão para puxar negociações/Leads aguardando atendimento (Ícone de seta pra baixo)

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

NO VOALLE

Alias do integrador - Para a informação - "integratorAlias" Em Manutenções / Integrações / Integradores você vai criar um integrador. E pode criar um.

Origem do contato lead - Para o "crmContactOriginCode" você consegue pegar na rotina: CRM - Voalle / Cadastros / Origens de Contato, copiar o código.

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.

Se a lista de preço não for informada, ao montar a requisição de pedido o Datacake consultará a API da Voalle utilizará a primeira lista de preços pertencente à campanha informada em que o produto for encontrado.

Ao realizar estes passos, o atributo ficará disponível para preenchimento na página de edição do produto, na aba Atributos:

  • Sem rótulos