Integração com Ajili – Bling!
Integração com Ajili
12 de agosto de 2020 12:45
O Bling oferece integração com a Ajili, através da sincronização e importação de dados entre a plataforma e o Bling.
A Integração entre a Ajili e o Bling possui as seguintes funcionalidades.
Para a leitura e entendimento deste documento, é necessário já possuir acesso a um servidor do ÁJILI (Força de vendas e CRM) e um servidor do BLING disponíveis para acesso e configuração, através de um usuário com permissões gerenciais ou administrativas. Caso não possua, entre em contato com ​comercial@mobart.com.br​ e solicite seu servidor de acesso.
A integração entre o ​ÁJILI e o ​Bling foi desenvolvida pela​ Mobart​, utilizando a​ API v2 fornecida pelo Bling e permite, além de sincronizar dados entre as aplicações, que pedidos cadastrados no ÁJILI sejam recebidos no Bling para a emissão de notas fiscais e realização de outros procedimentos posteriores ao cadastro do pedido.
A​ API v2 do Bling não oferece uma consulta completa à base do Bling, trata-se de um conjunto mínimo de dados que permitem que Produtos, Contatos e Pedidos do Bling sejam consultados e inseridos/atualizados no ÁJILI com algumas limitações.
Algumas convenções no uso do ÁJILI e do BLING devem ser obedecidas enquanto integrados:
1. Os ​vendedores ​cadastrados no Bling devem possuir ​EXATAMENTE o mesmo nome ​cadastrado no ÁJILI, sem espaços antes ou depois dos nomes. Ou seja, sempre que alterar o nome de um vendedor em um dos sistema, altere também no outro, mantendo exatamente iguais. Faça o mesmo quando cadastrar um novo vendedor em um dos sistemas.
O Bling não permite que o ÁJILI consulte a lista de vendedores. Portanto, mesmo após a integração, a lista de usuários do ÁJILI ​pode não incluir os vendedores cadastrados no Bling. Eles aparecerão à medida que os pedidos forem importados do Bling para o ÁJILI.
3. A API do Bling não permite a consulta das ​condições e formas de pagamento​, pois no Bling estas entidades estão diretamente relacionadas às parcelas de pagamento. Portanto, as condições de pagamento cadastradas no ÁJILI devem ter seu nome exatamente iguais às geradas pelo Bling ao definir as parcelas de pagamento.
4. O Bling ​NÃO PERMITE ​que o ÁJILI envie a ​forma de pagamento.
5. Todo produto cadastrado no Bling deve ter o​Código(SKU)obrigatoriamente preenchido, pois é ele que é utilizado para identificar o produto no ÁJILI. Produtos sem SKU serão ​ignorados ​pelo ÁJILI ou terão o SKU gerado pelo ÁJILI.
6. Uma vez definido um ​SKU ​de um produto, ele​ não poderá ser alterado​. Caso isso ocorra, ele será tratado como um novo produto na base de dados do ÁJILI.
7. O Bling não permite que o pedido seja atualizado através da API de integração. Portanto, pedidos alterados no AJILI serão cancelados no Bling e um novo pedido será criado com os dados do pedido.
8. Prevalece o estoque de produtos do Bling. ​Em alguns momentos o ÁJILI efetuará alterações no estoque de acordo com as vendas feitas, para tentar diminuir a possibilidade de vendas cruzadas de um mesmo estoque de um produto. Mas, tão logo o Bling tenha o estoque atualizado, ele será copiado para o ÁJILI, sobrepondo o controle feito pelo ÁJILI.
9. Os produtos cadastrados no Bling só são enviados para o ÁJILI ​se possuírem estoque​.
10. Produtos que possuem ​data de validade ​devem ser tratados ​somente no Bling​. A API do Bling não alimenta o ÁJILI com essa informação.
11. Enquanto integrado ao Bling, todos os ​clientes ​cadastrados no AJILI ​devem possuir CNPJ/CPF para que sejam enviados e aceitos pelo Bling.
Passo 1 - Usuário API
Clique em 'Gerar', uma nova API key será gerada, copie e guarde-a, pois ela será usada nos próximos passos no Ajili.
Você poderá copiar a chave API e fornecê-la para seu desenvolvedor ou colar na plataforma que irá integrar.
Em Permissões habilite as opções de vendas e Salve.
Passo 2 - Integração
Em seguida, ainda no Bling, o menu Preferências ( ) > Integrações > Configurações de integração com lojas virtuais e Marketplaces
Pesquise pela integração da Ajili e clique em para adicioná-la.
Em Autenticação, crie um nome para localizar a integração desta plataforma.
Em Callbacks, configure as permissões e URL de callbacks:
Em "​Tipo de retorno no callback​", selecione "​JSON​".
Preencha o campo "​URL de callback para alterações de estoque​" com a URL do seu servidor ÁJILI acrescida do sufixo "​/callback/bling/estoque​".
Por exemplo, no caso do servidor de "demo" o valor a ser digitado seria "http://demo.ajili.com.br/callback/bling/estoque".
Preencha o campo "​URL de callback para alterações de situação dos pedidos de venda​" com a URL do seu servidor ÁJILI acrescida do sufixo "​/callback/bling/pedidos​".
Por exemplo, no caso do servidor de "demo" o valor a ser digitado seria "http://demo.ajili.com.br/callback/bling/pedidos".
Não preencher o campo ​"URL de callback para alterações de situação das notas fiscais".
Clique no botão Salvar​.
Após estes passos, a loja AJILI estará criada. Clique nela para acessar os detalhes e copie o número do campo "​Código da Loja API Bling​" loja que foi gerado pelo Bling.
Configuração na Ájili
Acesse o painel da ÁJILI. e clique em na tela de configurações do ÁJILI (ícone no canto superior direito da tela).
Acesse a aba "Integração​, na área "​Sistemas integrados​" selecione BLING​.
No campo API Key​, digite o valor da API Key gerado no Bling, no passo 1 no Bling.
E no campo Identificador da loja​, digite o valor do Código da Loja gerado no Bling, no passo 2.
Para finalizar, clique em Aplicar​.
Replicar vendedores manualmente
Cadastre no ÁJILI todos os vendedores já cadastrados no BLING, com o nome exatamente igual.
Cadastre no BLING todos os vendedores já cadastrados no ÁJILI, com o nome exatamente igual.
Veja como cadastrar vendedores no Bling
ATENÇÃO​: Muito cuidado com caracteres especiais ou espaços em duplicidade no nome dos vendedores. Eles devem estar exatamente iguais em ambos os sistemas para que as vendas sejam associadas adequadamente.
Configurar condições de pagamento do ÁJILI
O Bling aceita somente condições de pagamento seguindo uma regra de nomenclatura própria. Por isso você deve remover todas as formas de pagamento previamente apresentadas no AJILI e adicionar somente condições de pagamento aceitas pelo Bling.
Acesse a tela de configuração do ÁJILI e clique em "​Condições de pagamento​".
Remova as condições previamente cadastradas e cadastre novas seguindo a regra do Bling:
Configure o ÁJILI para não aceitar clientes sem CNPJ
O Bling não aceita cadastro de clientes sem CPF ou CNPJ. Portanto, você terá que configurar o ÁJILI para não aceitar clientes sem CNPJ ou CPF. Na tela de configuração do ÁJILI, acesse a aba "​Geral​".
Desmarque a opção "​Permitir cadastro de novos clientes sem CNPJ/CPF​".
Realize a Sincronização Manual para alimentar todos os dados previamente existentes
Para que os cadastros previamente realizados no Bling possam ser alimentados no ÁJILI.
No menu Configurações do ÁJILI, clique no ícone de sincronização indicado na imagem.
Lembretes Regras de Cadastros:
VENDEDORES: Devem ser cadastrados no ÁJILI e no BLING com os dados idênticos. Não será sincronizado pela integração.
a. Devem ser cadastrados somente no ÁJILI. Todos os clientes devem ter CNPJ e CPF para que sejam alimentados no Bling.
b. Alterações de cadastro de clientes devem ser feitos nos dois sistemas, pois a API não lê alterações de cadastros já existentes.
a. Devem ser cadastrados somente no BLING. Os produtos só serão enviados para o ÁJILI após cadastrar quantidade que o produto possiu de estoque.
b. Exclusão e alteração do Produto deve ser feito no Bling.
c. Todo produto deve conter OBRIGATORIAMENTE o campo SKU preenchido e não pode se repetir na base de cadastros.
3. ESTOQUE: a. Devem ser cadastrados somente no BLING e nunca alterados no ÁJILI.
4. ESTOQUE DE PRODUTOS PERECÍVEIS:
a. Não é uma funcionalidade tratada na integração. Não deve ser utilizado por clientes que utilizam ÁJILI e BLING.
a. Os descontos não são enviados separadamente. É acrescido o desconto no preço final. Se necessário preencher o valor ou % do desconto dado em observações.