Integração BaseLinker

Importe e sincronize produtos do seu catálogo BaseLinker

Guia de Configuração — Como ligar a integração completa
Siga os passos abaixo para configurar o fluxo bidirecional: BaseLinker controla estoque/preço, recebe pedidos e envia produtos.

Fluxo da integração

BaseLinker
Envia produtos (Shop API)
Site HigiPack
Cliente faz pedido
BaseLinker recebe pedido
BaseLinker
Atualiza preço/estoque
Site atualizado automaticamente
1

Registrar a loja no BaseLinker (Shop API)

No painel do BaseLinker, acesse Integrações → Lojas On-line e clique em "Adicionar loja".

Escolha o tipo "Loja própria (API)" e cole a URL abaixo no campo de endereço:

O BaseLinker vai verificar a conexão automaticamente. Se der erro, clique em "Testar Shop API" abaixo.

2

Enviar produtos do BaseLinker para o site

Após registrar a loja, no BaseLinker acesse Catálogo de Produtos:

  1. Selecione os produtos que deseja enviar (ou selecione todos com Ctrl+A).
  2. Clique em "Criar/atualizar produtos na loja on-line".
  3. Escolha a loja HigiPack que você acabou de registrar.
  4. Confirme — os produtos aparecerão automaticamente no site.
Dica: Use filtros de tag no BaseLinker para enviar apenas produtos de uma linha específica (ex: BIDUBOX, JSN).
3

Configurar atualização automática de preço e estoque

Para manter preços e estoque sempre atualizados, configure uma Ação Automática no BaseLinker:

  1. Vá em Catálogo → Ações Automáticas no BaseLinker.
  2. Crie uma ação com gatilho "Produto atualizado" ou "Mudança de estoque".
  3. Escolha a ação "Criar/atualizar produtos na loja on-line".
  4. Selecione a loja HigiPack — o BaseLinker enviará atualizações automaticamente.

Alternativamente, use o botão "Sincronizar Preços e Estoque" nesta página para sincronização manual.

4

Receber pedidos do site no BaseLinker

Os pedidos são enviados automaticamente ao BaseLinker quando o pagamento é confirmado (PIX, cartão ou boleto).

Fluxo automático de pedidos:

Cliente pagaAsaas confirmaWebhook disparaPedido criado no BaseLinker

No BaseLinker, os pedidos aparecerão em Pedidos → Todos os pedidos com status Confirmado, incluindo dados do cliente, endereço e itens.

Nota: O envio de pedidos ao BaseLinker é automático — não requer configuração adicional. Funciona assim que o pagamento for aprovado.
5

Configurar webhook para atualizações em tempo real (opcional)

Para receber atualizações de produtos em tempo real (sem precisar importar manualmente), configure o webhook:

Cadastre esta URL em BaseLinker → Catálogo → Ações Automáticas com o corpo: {"product_id": {product_id}, "action": "upsert"}

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://higipac.com/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.