VibeFox Jadlog for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 5.0 ou superior, instalado e ativo. O plugin não é ativado sem ele.
PHP: 8.0 ou superior.
Contrato com a Jadlog (para preços em tempo real e pontos Pickup): os preços em tempo real e a lista de pontos Pickup vêm da API Embarcador da Jadlog. A sua franquia Jadlog emite o acesso depois que o contrato é assinado. Você precisa do token da API Embarcador, do CNPJ (ou CPF) do remetente cadastrado no contrato, da conta corrente e, se tiver, do número do contrato. Se você usar apenas preços fixos, não precisa de contrato com a Jadlog.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No WordPress, acesse Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_jadlog para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Jadlog, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Digite sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Cole o token da API, informe o CNPJ, a conta corrente, o número do contrato e o CEP de origem, escolha o serviço da Jadlog e, se a moeda da sua loja não for BRL, informe a taxa de câmbio BRL. Adicione preços fixos ou um custo de contingência, se quiser (veja Configuração).
6. Adicione VibeFox Jadlog a uma zona de envio para o Brasil em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones e escolha os países. Para oferecer também os pontos Jadlog Pickup, adicione o método uma segunda vez à zona e escolha Pickup (40) como serviço.
Configuração
Todas as configurações ficam em uma só página: WooCommerce > Settings > Shipping > VibeFox Jadlog. Elas valem para todas as zonas de envio. Quando você adiciona o método a uma zona, a janela da zona tem dois campos:
Title (zone): o nome que os clientes veem nesta zona. Deixe vazio para usar o Method title global.
Jadlog service (zone): o serviço deste método de zona. Same as the global setting usa o serviço da página principal de configurações. Adicione o método duas vezes para oferecer, por exemplo, entrega em domicílio (.Package) e pontos Jadlog Pickup na mesma zona.
Quando o título da zona está vazio e o serviço é Pickup, a palavra "Pickup" é acrescentada ao título global, para que os dois métodos tenham nomes diferentes.
No topo da página de configurações, o plugin mostra avisos de configuração incompleta: sem token da API, sem CNPJ ou conta corrente, sem CEP de origem, ou sem taxa de câmbio BRL para uma loja que não vende em BRL. Sempre que você salva as configurações, os preços da Jadlog e as listas de pontos Pickup em cache são apagados.
Geral
Enable/Disable: ativa ou desativa o método em todas as zonas de uma vez.
Method title: o nome do método de envio exibido no carrinho e na finalização de compra. Padrão: Jadlog. Uma zona pode substituí-lo.
Preços da Jadlog em tempo real
Os preços em tempo real são solicitados somente para endereços no Brasil com CEP completo de 8 dígitos.
API token: o token Embarcador da Jadlog. Você pode colar com ou sem a palavra "Bearer". Deixe vazio para usar somente preços fixos.
CNPJ: o CNPJ (14 dígitos) ou o CPF (11 dígitos) do remetente cadastrado no contrato da Jadlog. Pontos, barras e traços são aceitos. O plugin avisa se a quantidade de dígitos estiver errada.
Current account (conta corrente): o número da sua conta corrente na Jadlog. Sem ela e sem o CNPJ, a Jadlog não consegue cotar e só são usados preços fixos.
Contract number: o número do seu contrato com a Jadlog, se a sua franquia tiver fornecido um.
Origin CEP: o CEP de onde as encomendas são enviadas, com 8 dígitos. Ele é salvo no formato 00000-000. Deixe vazio para usar o CEP da loja em WooCommerce > Settings > General, se o endereço da loja estiver no Brasil.
Jadlog service: o serviço (modalidade) do seu contrato: .Package (3, padrão), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12), Emergencial (14) ou Pickup (40). Pickup oferece os pontos Jadlog Pickup próximos ao cliente. Um método de zona pode usar outro serviço.
Insurance type: Normal (N) (padrão) ou Own insurance policy (A — apólice), conforme acordado no seu contrato com a Jadlog.
Volumetric weight: a Jadlog cobra o maior entre o peso real e o peso cubado.
BRL exchange rate: a Jadlog cota em reais. Se a moeda da sua loja for o BRL, este campo não é necessário. Caso contrário, informe quanto vale 1 BRL na moeda da sua loja, por exemplo 0.16. O preço da Jadlog é multiplicado por essa taxa, e o valor declarado do pedido enviado à Jadlog é convertido de volta para BRL. Sem a taxa, os preços em tempo real não são usados e só valem os preços fixos. Tanto ponto quanto vírgula são aceitos como separador decimal.
Delivery time: exibe o prazo de entrega retornado pela Jadlog ao lado do título do método, por exemplo "Jadlog (3 dias úteis)". Ativado por padrão. O prazo de entrega é sempre salvo no pedido.
Pontos Jadlog Pickup (usados pelo serviço Pickup (40); precisam do token da API)
Points to show: quantos pontos Pickup oferecer, de 1 a 10. Padrão: 5.
Preços fixos (usados quando não há token da API, para países que a Jadlog não atende e sempre que a Jadlog não retorna preço)
Price per country: uma tabela com as colunas Country, Price, XS, S, M, L e XL, na moeda da sua loja. Clique em + Add country para adicionar uma linha e no X para remover uma. A coluna de tamanho é escolhida pelo peso do carrinho: XS até 1 kg, S até 2 kg, M até 3 kg, L até 5 kg, XL acima de 5 kg. Price é usado quando a coluna de tamanho está vazia. Preço 0 significa frete grátis para esse país. Use * Default como país para todos os demais. Linhas sem nenhum preço são removidas ao salvar.
Fallback cost: usado quando nem a Jadlog nem a tabela fornecem um preço. Deixe vazio para ocultar o método nesse caso.
Fixed price applies: Per order cobra o preço uma vez. Per item (price × quantity) multiplica pelo número de itens no carrinho. Isso vale apenas para preços fixos e para o custo de contingência. Os preços da Jadlog já cobrem o carrinho inteiro.
Condições
Minimum weight (kg): oculta o método quando o carrinho pesa menos. 0 significa sem limite.
Maximum weight (kg): oculta o método quando o carrinho pesa mais. Padrão: 150. 0 significa sem limite.
Minimum order amount: mostra o método somente quando o subtotal do carrinho (após descontos, antes de impostos) atinge este valor. Deixe vazio para mostrar sempre.
Excluded shipping classes: oculta o método quando o carrinho contém um produto de qualquer uma destas classes de envio do WooCommerce.
Free shipping from: o subtotal do carrinho (após descontos, antes de impostos) a partir do qual a entrega é grátis. Deixe vazio para não ter frete grátis.
Tax status: Taxable adiciona o imposto do WooCommerce ao frete, None não adiciona. Os preços da Jadlog são tarifas finais da transportadora. Escolha None se o WooCommerce não deve cobrar imposto sobre eles.
Disponibilidade sem zonas de envio
Ignore shipping zones: oferece a Jadlog para os países abaixo mesmo que o método não esteja adicionado a nenhuma zona de envio. Neste modo, usa-se o Jadlog service global.
Countries: os países de destino para este modo. Deixe vazio para usar todos os países para os quais você envia. Este campo só é usado quando Ignore shipping zones está ativado.
Avançado
Debug log: registra cada requisição e resposta da Jadlog em WooCommerce > Status > Logs, origem vfd-jadlog. Erros da API são sempre registrados, mesmo com esta opção desativada. O token, o CNPJ e a conta nunca são registrados, e o CEP do cliente é abreviado. Desative o log quando terminar.
Remove data on uninstall: quando ativado, excluir o plugin remove todas as configurações da Jadlog e os métodos de zona. Desativar o plugin nunca apaga as configurações. Os preços em cache são sempre removidos.
Como funciona na finalização de compra
Quando o cliente informa um endereço de entrega, o WooCommerce pede um preço ao plugin. O plugin verifica primeiro as condições: peso do carrinho, valor mínimo do pedido e classes de envio excluídas. Se o subtotal do carrinho atingir Free shipping from, a entrega é grátis e nenhuma consulta de preço é enviada à Jadlog.
Para um endereço de entrega no Brasil com CEP completo de 8 dígitos, o plugin envia à Jadlog o CEP de origem e de destino, o peso, o seu CNPJ, a conta corrente, o contrato, o serviço, o tipo de seguro e o valor declarado do pedido, e exibe o preço retornado na moeda da sua loja. Carrinhos sem peso são cotados como 0,1 kg. Se não houver preço em tempo real (sem token, endereço fora do Brasil, CEP incompleto, sem taxa de câmbio BRL, erro da Jadlog), o plugin usa a tabela Price per country e depois o Fallback cost. Se nenhum deles fornecer um preço, o método fica oculto para aquele carrinho.
Cada preço fica em cache por 1 hora, para que o mesmo carrinho não gere uma nova consulta. Uma consulta com falha fica em cache por 10 minutos. Se a Jadlog não responder, retornar erro de servidor ou rejeitar o token, a API não é chamada de novo por 10 minutos. O tempo limite da API é de 10 segundos. O cliente nunca vê um erro da API. O motivo é registrado no log.
O método funciona na finalização de compra clássica e nos blocos de Carrinho e de Finalização de compra. É compatível com o High-Performance Order Storage (HPOS) do WooCommerce.
O plugin apenas calcula preços e lista pontos Pickup. Ele não cria envios na Jadlog, não imprime etiquetas, não solicita coletas, não cancela envios nem rastreia encomendas. Não mostra um mapa dos pontos Pickup e não solicita cotações internacionais à Jadlog. Para outros países, use preços fixos.
Pontos Pickup
Um método com o serviço Pickup (40) é oferecido somente para endereços no Brasil. Quando o cliente informa um CEP completo de 8 dígitos, o plugin consulta na Jadlog os pontos Pickup ativos mais próximos e oferece até Points to show pontos. Cada ponto é uma opção de envio própria, com seu preço, por exemplo "Jadlog Pickup: nome do ponto — endereço". O cliente escolhe um ponto ao selecionar a opção de envio, tanto na finalização de compra clássica quanto nos blocos de Carrinho e de Finalização de compra.
O preço para cada ponto é solicitado à Jadlog. Se a Jadlog não informar preço para um ponto, usa-se o preço fixo, e um ponto sem nenhum preço fica de fora. As listas de pontos ficam em cache por 12 horas.
Sem token da API, sem CEP de 8 dígitos, quando a Jadlog está indisponível ou quando não há pontos ativos por perto, o método Pickup fica oculto. Um pedido sem ponto não poderia ser enviado.
Pedidos
A linha de envio do pedido mantém o serviço da Jadlog e, quando a Jadlog o retornou, o prazo de entrega em dias úteis. Em um pedido Pickup, o nome da linha de envio contém o nome e o endereço do ponto, e o pedido também guarda o nome, o endereço e o ID do ponto Pickup. Você vê esses dados abaixo da linha de envio na tela de pedido do admin. O cliente vê o ponto escolhido na página de agradecimento e nos e-mails do pedido.
Registre o envio no sistema da Jadlog você mesmo. O pedido mostra o serviço e o ID do ponto Pickup de que você precisa para isso.
Chave de licença
O plugin funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença fica no topo de WooCommerce > Settings > Shipping > VibeFox Jadlog. Cole a chave em License key e clique em Activate. O bloco mostra o status, por exemplo a data até a qual a licença está ativa e o seu domínio. Use Check now para verificar o status novamente, Change key para informar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre a sua conta na vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera a vaga do domínio. Libere a vaga na sua conta da vibefox.net.
Sem uma chave ativa, a Jadlog não é exibida aos clientes na finalização de compra. Os gerentes da loja logados continuam a vê-la, marcada como (unlicensed — visible to admins only), para que você possa configurar e testar o plugin antes de comprar uma chave. Um lembrete aparece na página Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado de novo automaticamente em segundo plano.
Solução de problemas
A Jadlog não aparece na finalização de compra: confira se a licença está ativa, se Enable/Disable está ligado e se o método foi adicionado à zona do país do cliente (ou se Ignore shipping zones está ligado e o país está permitido). Veja os avisos no topo da página de configurações, os limites de peso, Minimum order amount e Excluded shipping classes. Se o cliente ainda não informou um CEP completo de 8 dígitos, só é possível usar preços fixos, então adicione uma linha em Price per country ou um Fallback cost.
Só aparecem preços fixos: ative o Debug log, recarregue a finalização de compra e abra WooCommerce > Status > Logs, origem vfd-jadlog. O log mostra o motivo: sem CNPJ ou conta corrente, sem CEP de origem, CEP de destino incompleto, sem taxa de câmbio BRL, ou a mensagem de erro da Jadlog.
HTTP 401 ou 403 no log: a Jadlog rejeitou o token da API. Confirme com a sua franquia da Jadlog. A API fica pausada por 10 minutos após esse erro. Salvar as configurações cancela a pausa, então você pode tentar de novo imediatamente.
Os pontos Pickup não aparecem: o método Pickup precisa do token da API e de um CEP completo de 8 dígitos no Brasil. Se a Jadlog não tiver pontos ativos perto do CEP, o método fica oculto. Verifique o log para ver o motivo.
Os preços aparecem em reais em vez de na minha moeda: informe a BRL exchange rate (quanto vale 1 BRL na moeda da sua loja).
Os preços parecem baixos ou altos demais: preencha os pesos e as dimensões dos produtos. Carrinhos sem peso são cotados como 0,1 kg, e o peso cubado precisa das dimensões.
Os preços parecem desatualizados depois de uma mudança: salve a página de configurações. Isso limpa o cache dos preços da Jadlog e das listas de pontos Pickup.
O bloco de licença mostra um erro: siga a mensagem exibida no bloco. Por exemplo, se a chave já estiver em uso em outro domínio, libere uma vaga na sua conta da vibefox.net e clique em Check now. Se o endereço do site mudou, clique em Check now para ativar a chave no novo domínio. Se o servidor de licenças não puder ser acessado, o plugin continua funcionando com o último status conhecido.
Desinstalação
Desativar o plugin mantém todas as configurações e os métodos de zona. Apenas os preços em cache e as listas de pontos Pickup são apagados. Para remover o plugin, desative-o e exclua-o na página Plugins. A chave de licença, o status da licença deste plugin e os preços em cache são sempre removidos. As configurações e os métodos de zona só são removidos se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação posterior. Os pedidos existentes mantêm suas linhas de envio com o serviço da Jadlog e o ponto Pickup.
Jadlog é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela Jadlog.