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:

Ā