Integração Conta Azul V2 [Interno]

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)

Para a nova integração com Conta azul, acessar esse portal: Developers Conta Azul .
Login e senha de acesso disponível no Keeper.

Nesse painel, clique em "Criar uma aplicação" > "Produção", e preencha os campos conforme:

Nome da aplicação: Nome da loja
Objetivo: Integração Olist - Nome da loja:
URL de redirecionamento: https://url_da_loja (aqui cuide para não ter "/" no final)
Cnpj:
Funcionalidades: E-commerce e Marketplace

Após a criação da aplicação no developers do Conta Azul, acesse o admin da loja em configurações > sistemas de ERP. Clique no botão "Adicionar nova integração" e preencha os campos conforme abaixo:

Integração: Conta Azul V2
Ativa?: Sim
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).

Enviar para o seller a "URL para obtenção do código de autorização" gerada no developers do CA após a criação do App. Solicitar para o seller fazer o processo de autenticação por essa URL, haverá um redirecionamento automático para a URL configurada, contendo um code:

https://SUA_URL_REDIRECIONAMENTO?code=CODIGO_AUTORIZACAO&state=ESTADO

Exemplo de URL com o code:

Solicitar para o seller lhe enviar a URL completa gerada após a etapa de autenticação.

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:

Autenticação Conta Azul | Central de Ajuda Vnda

OBS.: Essa etapa também pode ser feita pela Vnda, porém, para isso, precisamos dos dados de acesso do cliente na Conta Azul

Mapeamentos:

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: