Escopo da Integração
Sincronização de pedidos;
Sincronização de estoque;
Como integrar?
Para a nova integração com Conta azul v2, acessar esse portal: Developers Conta Azul , com o 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
Apenas para manter a informação na base de conhecimento, esse é o acesso ao portar developers do CA para integração da versão anterior: Portal do Desenvolvedor - ContaAzul - Login: equipe@vnda.com.br (login social Google)
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 V2Ativa?: 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).
Autenticação:
Opção 1:
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", conforme exemplo:
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.
Copie o "code" dessa URL e acesse a interface do Hub do respectivo seller. No menu "configurações" no canto superior direito, clique na opção Autorização. Em seguida, clique no botão "gerar link" e copie o "code" no campo disponível.
Dessa forma, a integração será autenticada. Para validar o processo basta acessar novamente as configurações da integração e visualizar o preenchimento dos campos que estavam em branco até então (Acess token, Refresh Token e Expires in).
Opção 2:
Solicitar o login e senha de acesso a conta do CA para realizar a etapa de autenticação. Essa alternativa deve ser feita apenas em casos em que o seller tiver dificuldade na autenticação descrita na opção 1.
Mapeamentos - Fluxo de pedido:
Realizar o mapeamento no HUB de todos os meios de condições de pagamento oferecidos pelo seller, conforme os exemplos abaixo:
MEIO DE PAGAMENTO
Campo no json: condicao_pagamento.tipo_pagamento
De (Vnda) | Para (Integração) |
Pix | PIX_PAGAMENTO_INSTANTANEO |
Boleto | BOLETO_BANCARIO |
Visa - Crédito | CARTAO_CREDITO |
Mastercard - Crédito | CARTAO_CREDITO |
paypalplus | CARTAO_CREDITO |
Lista de opções nessa sessão da documentação do CA: https://developers.contaazul.com/docs/sales-apis-openapi/v1/editsale
CONDIÇÃO DE PAGAMENTO:
Campo no json: condicao_pagamento.opcao_condicao_pagamento
De (Vnda) | Para (Integração) |
Pix | À vista |
Boleto | À vista |
Visa - Crédito | À vista |
Mastercard - Crédito | À vista |
paypalplus | À vista |