Escopo da Integração
Sincronização de pedidos;
Sincronização de estoque;
Como integrar?
Primeiro é necessário criar a aplicação da loja pelo link Portal do Desenvolvedor - ContaAzul
Login: equipe@vnda.com.br (login social Google)
Nome da aplicação: Nome da loja
Descrição da aplicação: Integração Nome da loja:
URL de redirecionamento: https://url_da_loja (aqui cuide para não ter "/" no final)
Tipo do software: Online/Nuvem
Segmento: E-commerce
Após a criação da aplicação, cadastrar a loja no https://hub.vnda.com.br/ (login no Keeper)
Status inicial da venda: Autorizado
Encontrar produto: Código de produto
Link para redirect: https://url_da_loja (aqui cuide para não ter "/" no final)
Client ID (encontrado na aplicação criada)
Client Secret (encontrado na aplicação criada)
Usar Mapeamento: (somente se o match dos produtos for por mapeamento marcar sim).
Realizar o mapeamento de todos os métodos e tipos de pagamento oferecidos pela loja no HUB conforme os exemplos:
MEIO DE PAGAMENTO (Tipo de pagamento)
De (Vnda) | Para (Integração) |
Visa - Crédito | TIMES |
Boleto | CASH |
CONDIÇÃO DE PAGAMENTO (Método de pagamento)
De (Vnda) | Para (Integração) |
Visa - Crédito | CREDIT_CARD |
Boleto | CASH |
Os campos "DE" podem ser obtidos no pedido admin:
O mapeamento ficará neste modelo:
Autenticação da Integração:
Após instalar a integração, configurar os mapeamentos e ajustar é necessário efetuar a autenticação do APP com o Conta Azul.
Para isso abra o Hub, clique na seta para expandir o menu a direita e clique em Autorização.
Após clicar em Autorização irá exibir uma tela com botão para "Gerar Link":
Clique no link "clique aqui para dar permissão a aplicação":
Irá levar para uma tela de autorização da Conta Azul:
Após efetuar o login vai redirecionar para a Home da loja, copie da URL o campo Code e preencha
Após preencher o code copiado da URL precisa clicar em Salvar para reautenticar a integração.
Caso tenham pedidos com erro para integrar com erros desconhecidos realizar o processo de autenticação.
Exemplo do erro:
"undefined method `to_time' for nil:NilClass"
Com um e-mail @vnda você deverá acessar Admin > Configurações > Extras, marcar a opção "Habilitar HUB?" e salvar.
Feito isso solicite ao cliente que faça a autorização da aplicação seguindo o artigo:
OBS.: Essa etapa também pode ser feita pela Vnda, porém, para isso, precisamos dos dados de acesso do cliente na Conta Azul