Integração BaseLinker

Importe e sincronize produtos do seu catálogo BaseLinker

Status da Conexão
Verificando conexão...
Configuração de Importação
Configure quais dados serão importados do BaseLinker para a loja

Padrão recomendado: "Padrão"

Apenas produtos com as tags selecionadas serão importados. Ex: BIDUBOX

Se ativado, produtos já importados serão atualizados com os dados mais recentes do BaseLinker

Importação Completa
Importa todos os produtos do inventário para a loja, incluindo nomes, descrições, imagens e preços.
Sincronizar Preços e Estoque
Atualiza apenas os preços e quantidades em estoque dos produtos já importados, sem alterar nomes ou descrições.
Loja On-line — Enviar Produtos pelo Painel do BaseLinker
Registre este site como uma Loja On-line no BaseLinker e use a aba "Criar/atualizar produtos na loja on-line" para enviar produtos diretamente do catálogo.

Como registrar a loja no BaseLinker:

  1. Acesse o painel do BaseLinker e vá em Integrações → Lojas On-line.
  2. Clique em "Adicionar loja" e escolha o tipo "Loja própria (API)" ou "Arquivo de integração".
  3. No campo de URL, cole a URL da API da Loja acima: https://balaoshop-3psatwje.manus.space/api/baselinker/shop
  4. Salve a configuração — o BaseLinker irá verificar a conexão automaticamente.
  5. Após conectar, vá em Catálogo de Produtos, selecione os produtos desejados.
  6. Clique em "Criar/atualizar produtos na loja on-line" para enviá-los ao site.

Funcionalidades suportadas pela Shop API:

Criar produto

ProductAdd

Criar categoria

CategoryAdd

Listar produtos

ProductsList

Atualizar preços

ProductsPriceUpdate

Atualizar estoque

ProductsQuantityUpdate

Dados detalhados

ProductsData

Webhook — Receber Produtos do BaseLinker
Configure o BaseLinker para enviar produtos automaticamente para este site usando o endpoint abaixo.

Como configurar no BaseLinker:

  1. Acesse Catálogo de Produtos → Ações Automáticas no painel do BaseLinker.
  2. Crie uma nova ação e selecione o gatilho desejado (ex: "Produto adicionado", "Produto atualizado").
  3. Na ação, escolha "Enviar requisição HTTP (webhook)".
  4. Cole a URL acima no campo de destino.
  5. Defina o método como POST e o Content-Type como application/json.
  6. No corpo da requisição, inclua: {"product_id": {product_id}, "action": "upsert"}
  7. Salve e ative a ação automática.

Ações suportadas pelo webhook:

upsert (padrão)

Cria ou atualiza o produto completo (nome, preço, estoque, imagens, descrição).

sync_price_stock

Atualiza apenas preço e estoque de um produto já importado.

delete

Remove o produto da loja quando excluído no BaseLinker.

Segurança (opcional)

Para proteger o webhook, configure a variável de ambiente BASELINKER_WEBHOOK_SECRET e adicione o header X-BL-Secret: <valor> nas requisições do BaseLinker.

Informações importantes sobre a importação:

  • A importação completa pode levar vários minutos dependendo da quantidade de produtos.
  • Produtos sem preço no grupo selecionado serão importados com preço R$ 0,00 — revise-os depois.
  • As imagens são importadas diretamente das URLs do BaseLinker.
  • Use "Sincronizar Preços e Estoque" regularmente para manter os dados atualizados.
  • O grupo de preço "Padrão" (ID: 25744) é o preço de varejo recomendado para a loja.