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:
Ā