Integrações da loja virtual: ERP Bling, API e webhooks

Integração com o ERP Bling

Quem emite nota fiscal e controla o financeiro no Bling não precisa digitar os pedidos da loja de novo. A conexão é feita no painel, em Configurações, ERP Bling: você clica para conectar, entra na sua conta do Bling e autoriza o acesso, sem copiar chaves.

Pedidos

Com o envio ligado, cada pedido pago vira um pedido de venda no Bling, com cliente, itens, frete e descontos. Você escolhe a loja, a natureza de operação, o depósito e a forma de pagamento do Bling que serão usados. Se um envio falhar por instabilidade, a UnaShop tenta de novo; se o Bling recusar algum dado, o pedido aparece com o erro e um botão para reenviar depois da correção. O mesmo pedido não é criado duas vezes no Bling.

• Vendas do PDV também podem ir para o Bling, para o financeiro ficar completo
• Pedidos importados do Mercado Livre, da Shopee e da Amazon só vão se você ligar, para não duplicar com uma integração direta do Bling com o marketplace
• Lista dos últimos pedidos enviados e registro (log) da integração no painel

Nota fiscal (NF-e)

A nota é emitida pelo seu Bling, com o seu certificado digital e as suas regras fiscais. A UnaShop pede a geração, acompanha a situação na SEFAZ e guarda número, chave, DANFE e XML. Você escolhe uma de três formas:

• Manual: você emite pelo botão Emitir NF-e, na tela do pedido
• Gerar automaticamente: a nota fica pendente no Bling para você revisar e transmitir
• Emitir automaticamente: a nota é gerada e transmitida à SEFAZ assim que o pedido chega ao Bling

Com a nota autorizada, o cliente pode receber o e-mail de nota fiscal disponível, enviado pelo e-mail da sua loja, e encontra o DANFE e o XML em Meus pedidos.

Estoque e produtos

• A loja manda: cada mudança de estoque na loja vira um balanço no depósito do Bling
• O Bling manda: a loja copia o saldo do Bling a cada 15 minutos e quando o estoque muda lá
• Não sincronizar: os dois estoques ficam independentes

A ligação entre os produtos é pelo SKU da loja, que precisa ser igual ao código do produto no Bling. Você também pode importar os produtos ativos do Bling: os que já existem na loja são vinculados, com opção de atualizar o preço, e os que não existem podem ser criados como rascunho, para você revisar fotos, descrição e categoria antes de publicar.

Apps e integrações num só lugar

A tela Apps e integrações reúne o que a sua loja pode conectar, com a situação de cada item (conectado ou não) e o atalho para a tela de configuração:

• Pagamentos: Mercado Pago, Stripe, PayPal e InfinitePay
• Frete: Melhor Envio e SuperFrete
• Gestão (ERP): Bling
• Marketplaces: Mercado Livre, Shopee e Amazon
• Atendimento: WhatsApp com a API oficial e o e-mail da loja (SMTP)
• Marketing e vendas: pixels e tags, catálogo de produtos, vitrine para IAs e app da loja
• Desenvolvedores: API e webhooks

API REST para conectar outros sistemas

Para ligar a loja a um hub de marketplaces, uma planilha, uma automação ou um sistema próprio, use a API da UnaShop. Ela responde no domínio da sua loja e usa chaves criadas no painel, em Configurações, API e webhooks. Cada chave tem só as permissões que você marcar:

• Produtos: ler, criar e alterar preço e status
• Estoque: consultar e ajustar (somar, subtrair ou definir o saldo)
• Pedidos: ler e alterar o status e o rastreio, com as mesmas regras do painel
• Clientes: ler dados agregados e, só com uma permissão própria, os dados pessoais

A chave aparece uma vez só, na criação, e pode ser revogada a qualquer momento. As listas vêm em páginas de até 100 itens, e a documentação fica no próprio painel, com exemplos e a especificação OpenAPI para importar em ferramentas de teste de API.

Webhooks: avisos automáticos para o seu sistema

Webhook é um aviso que a loja manda para um endereço seu quando algo acontece. Você cadastra o endereço (https), escolhe os eventos e o seu sistema recebe os dados na hora, sem ficar consultando a API.

• Pedido criado, pago, com status alterado e cancelado
• Produto criado e atualizado
• Estoque alterado
• Cliente criado

Cada endereço tem um segredo próprio e cada aviso vai assinado (HMAC-SHA256, com data e hora), para o seu sistema conferir que veio da sua loja. Se o seu servidor não responder, a UnaShop tenta de novo por cerca de 17 horas, com intervalos crescentes. No painel você vê cada entrega, envia um teste e reenvia o que falhou. Dados pessoais de clientes só vão nos avisos se você ligar essa opção.

Para vender também nos marketplaces, veja Mercado Livre, Shopee e Amazon. Para cuidar do estoque pela loja, conheça o controle de estoque, e para acompanhar cada venda, a gestão de pedidos.