VibeFox Sameday Easybox for WooCommerce — Ajuda

Requisitos

WordPress: 5.8 ou superior.

WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não é ativado sem ele.

PHP: 8.0 ou superior.

Nome de usuário e senha da API Sameday: o acesso à API faz parte de uma conta empresarial da Sameday na Romênia, Hungria ou Bulgária. Pergunte ao seu gerente de conta Sameday ou à equipe de integração da Sameday. As credenciais costumam ser as mesmas do portal eAWB (eawb.sameday.ro, .hu ou .bg). Para a API de demonstração, a Sameday fornece credenciais de teste separadas. Sem nome de usuário e senha da API, o método não é oferecido, porque o cliente não conseguiria escolher um locker.

Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.

Instalação

1. No WordPress, vá em Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_sameday_easybox para /wp-content/plugins/ por FTP.

2. Clique em Activate.

3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox, 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. Digite seu API username e sua API password da Sameday, escolha o Sameday country e salve. A página deve mostrar "Connected to Sameday ... easybox lockers". Pickup point e Easybox service são preenchidos a partir da sua conta.

6. Defina seus preços: Exchange rate of the estimate se a moeda da sua loja for diferente da moeda da Sameday, e uma linha de Country prices (por exemplo * Default) ou um Fallback cost.

7. Adicione VibeFox Sameday Easybox à zona de envio do seu país Sameday em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox. Elas valem para todas as zonas de envio. Quando você adiciona o método a uma zona, a janela da zona tem apenas um campo:

Title (zone): o nome que os clientes veem nesta zona. Deixe em branco para usar o Name global.

Acima das configurações, a página mostra o status da conexão: o host da Sameday, o número de lockers easybox e quando a lista foi atualizada, ou que a Sameday recusou o nome de usuário ou a senha. Ela também lista problemas de configuração, por exemplo credenciais ausentes, preço ausente ou taxa de câmbio ausente para a estimativa.

Todos os preços e limites aceitam vírgula ou ponto como separador decimal (4,99 ou 4.99). Um número inválido é recusado com uma mensagem.

Geral

Enable/Disable: ativa ou desativa o método em todas as zonas de uma vez.

Name: o nome do método de envio exibido ao cliente. Uma zona pode substituí-lo pelo próprio Title. Default: Sameday easybox.

Tax status: Taxable adiciona o imposto do WooCommerce ao custo do envio; None não adiciona.

Conta Sameday (API)

Ao salvar, o plugin faz login na Sameday e carrega seus serviços, pontos de coleta e a lista de lockers easybox. A lista é atualizada diariamente.

API username: seu nome de usuário da API Sameday.

API password: sua senha da API Sameday. Se a Sameday a recusar, ela não é testada novamente por 10 minutos.

Sameday country: o país da sua conta Sameday: Romania (api.sameday.ro) (padrão), Hungary (api.sameday.hu) ou Bulgaria (api.sameday.bg). Os lockers desse país são oferecidos, e o método só aparece para este país de destino.

Test mode: usa a API de demonstração da Sameday com credenciais de demonstração.

Preços

A ordem de uso é: a estimativa da Sameday (quando Pickup point e Easybox service estão definidos), depois a tabela de preços por país e, por fim, o custo de reserva. Os preços da tabela são informados na moeda da loja.

Pickup point: seu ponto de coleta da Sameday, onde a Sameday retira as encomendas. Depois de um login bem-sucedido, é uma lista dos pontos de coleta da sua conta, e o ponto padrão é escolhido automaticamente. Necessário para a estimativa da Sameday. Escolha - not set (price table only) - para usar somente a tabela de preços.

Easybox service: o serviço da Sameday para entrega easybox, normalmente "Locker NextDay" (código LN), escolhido automaticamente. Necessário para a estimativa da Sameday.

Exchange rate of the estimate: a Sameday calcula as estimativas na moeda do seu país Sameday: RON, HUF ou BGN (EUR para lojas búlgaras que vendem em euro). Se sua loja vende em outra moeda, informe o valor de 1 unidade da moeda Sameday na moeda da sua loja, por exemplo 0.20. Sem isso, a estimativa não é usada e vale a tabela de preços. Lev e euro são convertidos automaticamente pela taxa fixa.

Table price: Per order cobra o preço uma vez. Per item (price x quantity) multiplica pelo número de itens enviáveis. Isso vale para o preço da tabela e para o custo de reserva. A estimativa da Sameday é sempre para o pacote inteiro.

Country prices: um preço por país de destino e peso da encomenda. Clique em + Add country para adicionar uma linha e no X para remover uma. Cada linha tem uma coluna Price e colunas de peso: XS até 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg e XL acima de 5 kg. Uma coluna de peso deixada em 0 usa a coluna Price. A linha * Default é usada para países sem linha própria. Uma nova linha começa como * Default com todos os preços em 0, o que significa envio grátis. Escolha o país e informe os preços antes de salvar, ou remova a linha. Se o mesmo país estiver em duas linhas, ao salvar só a primeira é mantida. Se uma célula não for um número válido, a tabela não é salva.

Fallback cost: usado quando não há estimativa da Sameday e a tabela de países não tem linha para o destino. Deixe em branco para não oferecer o método nesse caso.

Free shipping from: o subtotal do carrinho (após descontos, sem imposto) a partir do qual a entrega easybox é grátis. Vale somente onde um preço é encontrado: uma linha de país, a linha * Default ou o custo de reserva (então nenhuma estimativa é solicitada), ou a estimativa da Sameday. Deixe em branco para nunca oferecer envio grátis.

Disponibilidade

Minimum weight (kg): oculta o método quando o carrinho pesa menos. O peso é convertido da unidade de peso da sua loja. Vazio ou 0 significa sem limite.

Maximum weight (kg): encomendas mais pesadas que isso não recebem a entrega easybox. Default: 30. Confira o limite do seu contrato com a Sameday e os tamanhos das caixas easybox. Vazio ou 0 significa sem limite.

Minimum cart subtotal: oferece o método somente quando o subtotal do carrinho (após descontos, sem imposto) atinge este valor.

Excluded shipping classes: oculta o método quando o carrinho contém um produto de qualquer uma dessas classes de envio do WooCommerce.

Ignore shipping zones: quando ativado, o método é oferecido para os países selecionados abaixo, mesmo que não esteja adicionado à zona de envio correspondente. Quando desativado, é oferecido somente nas zonas às quais foi adicionado.

Countries (ignore zones mode): os países de destino para esse modo. Deixe em branco para usar o país da Sameday. Países diferentes do país da Sameday são ignorados. Este campo só é usado quando Ignore shipping zones está ativado.

Avançado

Debug log: grava os cálculos de tarifas, as chamadas à API e as escolhas de locker em WooCommerce > Status > Logs (origem "vfd-sameday-easybox"). Erros da API são sempre registrados. Nenhuma senha, token ou dado pessoal do cliente é registrado. Desative o log quando terminar.

Remove data on uninstall: quando ativado, excluir o plugin remove as configurações e as instâncias deste método nas zonas. Desativar o plugin nunca apaga nada. O locker salvo nos pedidos é sempre mantido.

Como funciona na finalização de compra

Quando o cliente informa um endereço de entrega, o WooCommerce pede uma tarifa ao plugin. O plugin verifica as condições: país de entrega da sua conta Sameday, credenciais da API e uma lista de lockers utilizável, peso do carrinho, subtotal mínimo do carrinho e classes de envio excluídas. Em seguida, procura um preço: a estimativa da Sameday, a tabela de países, o custo de reserva. Se não houver preço, o método fica oculto. Se o envio grátis se aplicar, o cliente vê o método sem custo.

Caso contrário, o plugin pede uma estimativa à Sameday, assim que o cliente informa uma cidade e um estado. Ele envia o seu ponto de coleta e serviço, o peso da encomenda e o endereço do cliente: rua, cidade, estado e CEP. Nenhum nome, e-mail ou telefone é enviado. Bucareste é enviada como "Sector 1", como no plugin oficial da Sameday. A estimativa é convertida para a moeda da sua loja. Se não houver estimativa (não configurada, sem cidade ou estado ainda, erro, sem taxa de câmbio), o preço vem da tabela de países e, depois, do custo de reserva. Se não houver preço, o método fica oculto.

Problemas da Sameday nunca interrompem a finalização de compra. A estimativa fica em cache por 1 hora. Um erro fica em cache por 10 minutos. Após um tempo limite ou erro do servidor, nenhuma estimativa é solicitada por 5 minutos. As requisições expiram após 15 segundos. A lista de lockers é lida do seu servidor, e não da Sameday, durante a finalização de compra.

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 WooCommerce High-Performance Order Storage (HPOS).

O plugin não cria AWBs (envios), não imprime etiquetas, não rastreia encomendas e não trata pagamento na entrega. Não há entrega domiciliar por courier nem widget de mapa da Sameday. Crie o AWB no portal eAWB da Sameday ou na sua ferramenta habitual, com o ID do locker exibido no pedido.

Escolha do locker

Quando o cliente seleciona o método, aparece abaixo dele um bloco easybox locker com duas listas: - Select city - e - Select easybox locker -. A cidade do cliente é pré-selecionada quando tem lockers. Cada locker mostra seu nome e endereço. A escolha é lembrada quando a finalização de compra é atualizada ou a página é recarregada.

O locker é obrigatório. Sem ele, a finalização de compra para com a mensagem "Please choose a Sameday easybox locker.". O servidor verifica se o locker escolhido está na lista, tanto na finalização de compra clássica quanto na de blocos. Um ID de locker forjado ou removido é recusado com a mensagem "The selected easybox locker is not available any more. Please choose another easybox locker.". O nome e o endereço salvos com o pedido vêm da lista, e não do navegador.

Tela de pedido do administrador: Sameday easybox locker com o nome e o endereço e o Locker ID para o AWB da Sameday, abaixo do endereço de entrega. Se um pedido easybox não tiver locker, a tela mostra "No easybox locker was selected for this order.".

Página de agradecimento e visualização do pedido: Sameday easybox locker: com o nome e o endereço.

E-mails de pedido: o nome e o endereço do locker nos e-mails em HTML e em texto simples. Os e-mails para o administrador também incluem o Locker ID.

No banco de dados, o locker é gravado nos metadados do pedido _vfd_sdeb_locker_id (o ID do locker da Sameday para o AWB) e _vfd_sdeb_locker_name (nome e endereço).

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 Sameday Easybox. 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 vibefox.net.

Sem uma chave ativa, o Sameday easybox não é mostrado aos clientes na finalização de compra. Os gerentes da loja que estão logados ainda o veem, marcado 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 novamente de forma automática em segundo plano.

Solução de problemas

O Sameday easybox não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado, se o nome de usuário e a senha da API foram informados e se a página de configurações diz "Connected to Sameday", e se o país de destino é o país da sua conta Sameday. Verifique se há um preço disponível (estimativa da Sameday, linha do país, linha * Default ou Fallback cost), os limites de peso e subtotal, Excluded shipping classes, e se o método foi adicionado à zona correspondente (ou se Ignore shipping zones está ativado). Ative o Debug log para ver o motivo em WooCommerce > Status > Logs.

A Sameday recusou o nome de usuário ou a senha da API: confira os dados e salve novamente. As credenciais de demonstração só funcionam com Test mode ativado, e as de produção só com ele desativado. Até lá, a lista de lockers salva é oferecida, se existir, e a estimativa da Sameday não é usada.

O preço vem da minha tabela, não da Sameday: a estimativa exige um Pickup point, o Easybox service e, quando a moeda da sua loja é diferente da moeda da Sameday, o Exchange rate of the estimate. Ela só é solicitada depois que o cliente informa uma cidade e um estado. Quando a Sameday está inacessível ou retorna um erro, a tabela ou o custo de reserva é usado; o motivo fica no log.

A lista de lockers está desatualizada ou ausente: salve as configurações. A lista é carregada novamente quando está vazia, tem mais de uma hora ou a última carga falhou. Se uma atualização falhar, a lista anterior é usada e o status informa isso.

O envio está grátis por engano: confira em Country prices as linhas com Price igual a 0, principalmente uma linha * Default adicionada com + Add country e deixada sem preencher.

Lockers transfronteiriços: desenvolvedores podem adicionar países de destino com o filtro vfd_sdeb_countries. A lista de lockers é sempre a da sua conta.

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 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 todos os dados e apenas interrompe a atualização diária da lista de lockers. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença e o status da licença deste plugin são sempre removidos, junto com a lista de lockers salva, o resultado da verificação da conta e todos os caches. Configurações e 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 e o locker salvo.

Sameday e easybox são marcas comerciais de seus respectivos proprietários. Este plugin não é afiliado nem endossado pela Sameday.