Manual de Integração Versão 1.0
Índice 1.0 Apresentação 1.1 Como adquirir a integração com o Bling 1.2 Cadastro de API 1.3 Configurações 1.4 Mapeamento de status dos pedidos 1.5 Nota Fiscal 2.0 Sincronização 2.1 Produtos 2.1.1 Visão Geral: Produto Simples Vs Produto com Variações 2.1.2 Envio de produto simples 2.1.3 Envio de produto com variações 2.1.4 Regras de sincronização 2.2 Pedidos 2.2.1 Considerações gerais 2.2.2 Regras de sincronização
2.3 Nota Fiscal 2.3.1 Regras de sincronização
1.0 Apresentação 1.1 Como adquirir a integração com o Bling Acesse seu painel Anyshop e clique no menu: Loja de Aplicativos, Módulos (Imagem 1). Solicite a integração e nosso departamento comercial entrará em contato para instalar o módulo. Imagem 1 1.2 Cadastro de API Passo 1: Acesse sua conta Bling e clique em: Preferências, Integrações, API para Web Services; Gere a API Key, guarde-a para uso posterior e salve; Passo 2: Ainda na sua conta Bling clique em: Preferências, Integrações, Configurações de integração com Lojas Virtuais e Marketplaces; Habilite suas configurações do seguinte modo:
Tipo de Integração: API; Configurações opcionais: Tipo de retorno no callback: JSON; Callbacks: - URL de callback para alterações de estoque; - URL de callback para alterações de situação dos pedidos de venda; - URL de callback para alterações de situação das notas fiscais; (INSERIR URLS RESPECTIVAS LOCALIZADAS NO PAINEL ANYSHOP NO MENU: Integrações, Bling, Cadastro API (Imagem 2)) Demais opções podem ser configuradas da maneira que desejar. Imagem 2 Passo 3: Adicione a API KEY da sua conta Bling e nomeie sua integração conforme descreve a Imagem 2. Ative e salve; Observação: Verifique através do botão Testar Conexão se sua integração está funcionando de forma correta. Uma mensagem de sucesso ou falha será mostrada. 1.3 Configurações Acesse seu painel Anyshop e clique no menu: Integrações, Bling, Configurações (Imagem 3).
Nesta tela encontram-se as configurações gerais de sincronização de produtos, pedidos e NFes em um formulário. Imagem 3 Descrição dos itens do formulário: Unidade do Produto: Peça, Unidade ou Caixa; Localização: Sede ou Filial; Importar pedidos automaticamente: Sim / Não; A partir de: data a qual será considerada a importação dos dados dos pedidos; Gerar NFe: Sim / Não. Considera a geração de NFe ao enviar os pedidos para o Bling; Formatação de dados do produto: Enviar produtos ao Bling como sendo simples ou com suas respectivas variações; 1.4 Mapeamento de status dos pedidos Acesse seu painel Anyshop e clique no menu: Integrações, Bling, Status Pedidos (Imagem 4).
Imagem 4 Nesta tela devem ser mapeados os status de pedido do Bling com os status de pedido no Anyshop. 1.5 Nota Fiscal Acesse seu painel Anyshop e clique no menu: Integrações, Bling, NFe (Imagem 5). Imagem 5
Nesta tela encontra-se uma listagem das notas fiscais importadas do Bling. Observação: as informações importadas são as mais sucintas e deverão ser consultadas mais detalhamente no próprio ERP. A listagem tem o propósito de indicar os dados básicos da nota vinculados ao pedido e informar se o e-mail do pedido faturado com o token de acesso da Receita Federal foi enviado ao cliente para posterior consulta caso deseje. 2.0 Sincronização 2.1 Produtos 2.1.1 Visão Geral: Produto Simples Vs Produto com Variações A plataforma Anyshop possui o conceito de produto simples e produto com variações. Acesse seu painel Anyshop e clique no menu: Produtos, Todos Produtos (Imagem 6). Imagem 6
O processo de cadastro de produto funciona basicamente em duas etapas: Passo 1: Cadastro Geral (Botão Azul na imagem 6) Representado pela Imagem 7 Passo 2: Cadastro de Variações (Botão Verde na imagem 6, item Variações) Representado pela Imagem 8 Imagem 7
Imagem 8 Observação: Produtos simples são representados na plataforma Anyshop como tendo uma única variação, já que dados de estoque, preços e outras informações do produto se encontram no cadastro da variação, podendo sobrescrever as informações cadastradas no formulário geral de produtos (Imagem 7), como é o caso por exemplo, dos campos: largura, altura e comprimento. Ao habilitar o módulo do Bling a Plataforma Anyshop dispõe de dados adicionais no cadastro de produto e variação que serão utilizados para sincronização: Flag Sincronizar Bling : Sim / Não; Classificação Fiscal: campo texto opcional; GTIN: campo texto obrigatório; GTIN Embalagem: campo texto opcional; CEST: campo opcional; Observação: Os campos acima estarão disponíveis no cadastro geral de produtos caso o usuário configure a formatação de envio de produtos para Produto com Variações (vide item 1.2). Os campos acima estarão disponíveis no cadastro de variações caso o usuário configure a formatação de envio de produtos para Produto Simples (vide item 1.2). O primeiro caso afeta todas a variações do produto, aplicando os campos Classificação Fiscal, GTIN, GTIN Embalagem e CEST a todas a variações do produto. O segundo caso afeta cada variação individualmente, podendo os campos acima citados serem aplicados de forma independente a cada variação.
2.1.2 Envio de produto simples Para que ocorra o envio como sendo um produto simples, é preciso primeiramente acessar as configurações do módulo Bling (vide item 1.2) e escolher a formatação de envio correta dos produtos. Após configurado, a plataforma Anyshop considerará cada par (informações gerais do produto informações da variação) de forma independente e enviará ao Bling um produto simples, sem considerar variações no envio. Observação 1: Informações contidas no cadastro geral de produtos serão sobrescristas por aquelas correspondentes no cadastro de variação, por exemplo: comprimento, largura e altura. Observação 2: Somente variações ativas e com a flag Sincronizar Bling igual a Sincronizado serão enviadas, independente do estoque. Campos exclusivos do Bling (Classificação Fiscal, GTIN, GTIN Embalagem e CEST) estarão disponíveis para cadastro em cada variação (Imagem 9). Imagem 9
2.1.2 Envio de produto com variações Para que ocorra o envio como sendo um produto com variações, é preciso primeiramente acessar as configurações do módulo Bling (vide item 1.2) e escolher a formatação de envio correta dos produtos. Após configurado, a plataforma Anyshop considerará cada produto tendo suas variações conforme a naturalidade dos cadastros, isto é, as informações gerais de cada produto serão mais relevantes e somente algumas informações de variação serão consideradas para envio. São elas: Descrição Estoque Valor Cor Informação Extra Observação: Somente variações ativas e com a flag Sincronizar Bling igual a Sincronizado serão enviadas, independente do estoque. Campos exclusivos do Bling (Classificação Fiscal, GTIN, GTIN Embalagem e CEST) estarão disponíveis para cadastro no formulário geral do produto (Imagem 7). 2.1.4 Regras de sincronização Produtos são somente enviados e sobrescritos em caso de edição. Sua sincronização com o Bling é indicada pela coluna Sincronizado na listagem de produtos (Imagem 6). Envio em lote é possível através do botão superior direito [Marketplaces], também indicado na Imagem 6, senguindo estritamente as regras dispostas nas observações dos itens 2.1.2 e 2.1.3.
2.2 Pedidos 2.2.1 Considerações gerais Acesse seu painel Anyshop e clique no menu: Vendas, Listagem Vendas (Imagem 10). Imagem 10 2.2.2 Regras de sincronização Pedidos são sincronizados de forma automática pelo sistema. Essa sincronização ocorre cada vez que usuário acessar seu painel administrativo. A sincronização de pedidos é bidirecional (Anyshop para Bling / Bling para Anyshop). Somente pedidos que contém produtos já enviados ao Bling e que respeitarem as condições de importação relativas a pedidos dispostas no item 1.2 serão importados.
Já para o envio, basta que o pedido não tenha como origem o Bling (ver coluna Origem disposta na Imagem 10). 2.3 Nota Fiscal 2.3.1 Regras de sincronização NFes são capturadas de forma automática pelo sistema. Essa sincronização ocorre cada vez que usuário acessar seu painel administrativo. A sincronização de NFes é unidirecional (Bling para Anyshop). Sua captura consiste em detectar a NFe gerada e enviar ao cliente um e-mail com informações da nota para consulta posterior no site da Receita Federal. Notas fiscais serão proccessadas somente se houver pedido já importado e se o pedido tiver o status Entrega Efetuada.