# Bling no Saara Online

Integração do painel do lojista com o **Bling ERP**, permitindo conectar a conta Bling do lojista ao Saara Online.

## Como conectar

[Clique aqui para integrar](https://lojista.saaraonline.com.br/seller/configuracoes/integracoes) — abre a tela de Integrações do seu painel. Lá:

- Clique no card **Bling ERP** pra abrir.
- Clique em **"Conectar com o Bling"**.
- Você será redirecionado pro Bling — faça login (ou já estará logado) e autorize o aplicativo **"Saara Online"**.
- O Bling te traz de volta pro painel já com o status "Conectado".

*Importante:* use sempre o botão dentro do seu painel, não um link avulso — é isso que garante que a conexão fica vinculada à sua loja.

## Importando produtos

- Com a conta conectada, clique em **"Ver produtos para importar"**.
- A lista mostra todos os produtos do Bling, com filtro por nome/código, e o estoque de cada um (soma de todas as variações, quando tiver).
- Marque os produtos desejados (ou use "Marcar todos" nos filtrados).
- Categoria: o sistema tenta casar automaticamente com uma categoria do Saara pelo nome; se não achar, escolha manualmente no seletor ao lado do produto — ou use **"Categorizar em massa"** pra aplicar uma categoria a todos os produtos filtrados de uma vez (ex.: filtra "camisa", marca todos, aplica a categoria "Camisetas").
- Produtos com **variação** no Bling (ex.: tamanhos P/M/G) importam como um produto único com as variações agrupadas — cada variação aparece indentada na lista, com seu próprio código, preço e estoque.
- Clique em **Importar**.

## Campos obrigatórios pro frete

Pra calcular o frete corretamente, todo produto precisa ter no Bling: **peso**, **altura**, **largura**, **profundidade**, **descrição** e pelo menos **uma foto**. Na lista de importação, cada produto mostra o que falta:

> Vai como rascunho — informações a completar: peso, altura, ...

Produto completo importa direto como **ativo** (publicado na loja). Produto incompleto importa como **rascunho** — complete os dados que faltam no Bling e reimporte, ou edite o produto direto no painel do Saara.

## Fotos

A galeria do produto no Saara vem das fotos cadastradas no **produto principal** do Bling. Se cada variação (P, M...) tiver sua própria foto, ela é usada como miniatura da variação — mas essa parte visual no site (mostrar a foto certa quando o cliente escolhe o tamanho) ainda está em construção.

## Depois de uma venda

Quando um pedido é pago no Saara, o sistema automaticamente no Bling: cria o cliente (se ainda não existir), registra o pedido de venda, e dá baixa no estoque do produto vendido. Isso já foi testado ponta a ponta na API — falta só confirmar com uma compra real no site.

## Status atual (28/08/2026)

<table id="bkmrk-conex%C3%A3o-oauth2-%28cone"><tbody><tr><td>**Conexão OAuth2 (conectar/desconectar)**</td><td>Pronta e testada</td></tr><tr><td>**Importação de produtos (foto, categoria, variação, frete)**</td><td>Pronta e testada</td></tr><tr><td>**Homologação do app junto ao Bling**</td><td>Solicitada — aplicativo em análise pela equipe do Bling</td></tr><tr><td>**Envio de pedido pago (cliente + venda + baixa de estoque)**</td><td>Implementado, validado na API</td></tr><tr><td>**Webhook de estoque/produto (Bling → Saara, tempo real)**</td><td>Servidor cadastrado no Bling</td></tr></tbody></table>