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”.