| Índice |
|---|
Integração via API
Configurações Gerais
Para que ocorra a integração via API, devem ser enviados alguns dados para a Datacake:
...
*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);
| Nota |
|---|
IMPORTANTENecessário usar o seguinte padrão para usuário. 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, é necessario 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
...
Em parâmetros vá em integração e habilite essa opção: “integração” (click no botão para ativar)
...
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Para que o fluxo de pedido funcione é necessário:No Voalle - Cadastrar e configurar a campanha e lista de preços. TUTORIAL AQUI |
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.
...
| Nota |
|---|
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.
| Informações |
|---|
Sobre o envio das negociações via API, o processo que deve ser feito no ERP é o seguinte:
|
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
| Informações |
|---|
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.
| Informações |
|---|
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:
...