VibeFox SMSA Express for WooCommerce — Ajuda

Requisitos

WordPress: 5.8 ou superior.

WooCommerce: 5.0 ou superior, instalado e ativo. O plugin não ativa sem ele.

PHP: 8.0 ou superior.

Tabela de tarifas SMSA Express: os preços da tabela de preços vêm da sua conta SMSA ou da equipe comercial da SMSA. Informe-os na moeda da sua loja. Se a sua tabela estiver em SAR, AED ou outra moeda, converta-a antes.

passKey da SMSA (somente para valores em tempo real): os valores em tempo real usam o serviço web da SMSA (SECOM, operação getShipCharges). A SMSA emite o passKey sob solicitação: peça ao seu gerente de conta na SMSA ou escreva para info@smsaexpress.com e solicite acesso ao serviço web da SMSA informando o número da sua conta. O passKey pode ser diferente da chave de API do portal de e-commerce da SMSA. A SMSA não tem servidor de testes (sandbox) para este serviço.

Licença VibeFox: comprada em vibefox.net. Uma chave funciona em um único 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_smsa_express para /wp-content/plugins/ por FTP.

2. Clique em Activate.

3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox SMSA Express, ou clique em Settings abaixo do nome do plugin na página de Plugins.

4. Informe a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.

5. Informe os seus preços SMSA Express na tabela de preços.

6. Opcional: em Live rates (API), ative Live charges, informe o seu passKey da SMSA, a cidade e o país de origem e, se a moeda da sua loja não for SAR, a taxa de câmbio.

7. Adicione VibeFox SMSA Express a uma zona de envio em WooCommerce > Settings > Shipping > Shipping zones (por exemplo, "Arábia Saudita"), ou ative Ignore shipping zones e escolha os países.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Shipping > VibeFox SMSA Express. 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 para esta zona. Deixe em branco para usar o Method title global.

Sempre que você salva as configurações, os valores da SMSA em cache são apagados. Quando os valores em tempo real estão ativados, avisos acima das configurações informam sobre um passKey, uma cidade de origem ou uma taxa de câmbio ausentes, ou uma tabela de preços vazia.

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. Uma zona pode substituí-lo. Padrão: SMSA Express.

Tarifas em tempo real (API) (opcional; se a SMSA não retornar um valor, a tabela de preços é usada)

Live charges: obtém o valor do frete do SMSA Express. Padrão: desativado.

SMSA passKey: a chave do serviço web da SMSA (SECOM). Se o log mostrar "Invalid Passkey", este serviço não aceita a chave. Peça à SMSA um passKey do serviço web.

Ship-from city: a cidade de onde seus pacotes são enviados, escrita como a SMSA a escreve, por exemplo Riyadh, Jeddah ou Dammam. Deixe em branco para usar a cidade da loja em WooCommerce > Settings > General.

Ship-from country: o país de onde seus pacotes são enviados. Por padrão, é o país da sua loja.

Shipment type: enviado à SMSA como tipo de envio. DLV (o padrão) é a entrega padrão. Altere-o somente se a SMSA tiver fornecido outro código.

Currency of SMSA charges: a SMSA retorna cada valor com o código da moeda, normalmente SAR (padrão). Um valor em qualquer moeda diferente desta ou da moeda da sua loja não é usado.

Exchange rate: o preço de 1 unidade da moeda da SMSA na moeda da sua loja, por exemplo 0.24. Não é necessário quando as duas moedas são iguais. Sem ele, valores em outra moeda não são usados e a tabela de preços se aplica. Tanto o ponto quanto a vírgula são aceitos como separador decimal.

Preços (sua tabela de tarifas SMSA Express na moeda da loja; usada quando os valores em tempo real estão desativados e como alternativa quando a SMSA não retorna um valor)

Price table: uma linha por país de destino. Clique em + Add country para adicionar uma linha e no X para remover uma. A linha * All other countries se aplica aos países sem linha própria. Cada linha tem um preço base e colunas de peso: XS até 1 kg, S até 2 kg, M até 3 kg, L até 5 kg e XL acima de 5 kg. Uma coluna de peso vazia ou com 0 usa o preço base. Um preço base de 0 significa frete grátis. Linhas sem nenhum preço são removidas ao salvar. Tanto "9.99" quanto "9,99" são aceitos.

Price for countries not in the table: usado quando a tabela não tem linha para o país de destino (e não há linha *) ou quando a linha não tem preço para este peso. Deixe em branco para ocultar o método nesse caso.

Price applies: como o preço é calculado.

Os pesos dos produtos são convertidos da unidade de peso da sua loja para quilogramas.

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: 30. 0 significa sem limite.

Minimum order amount: exibe o método somente quando o subtotal do carrinho (após descontos, antes dos impostos) atinge este valor. Deixe em branco para exibi-lo sempre.

Free shipping from: o subtotal do carrinho (após descontos, antes dos impostos) a partir do qual o envio pelo SMSA Express é grátis. O frete grátis só é oferecido onde o método tem preço para o destino: um valor da SMSA, uma linha da tabela ou o preço para países fora da tabela. Se a tabela tiver preço, nenhuma solicitação é enviada à SMSA. Deixe em branco para nunca oferecer frete grátis.

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

Tax status: Taxable adiciona o imposto do WooCommerce ao custo do envio; None não adiciona. Escolha None se seus preços (a tabela e os valores da SMSA) já incluírem impostos, por exemplo o IVA saudita.

Disponibilidade sem zonas de envio

Ignore shipping zones: oferece o SMSA Express para os países abaixo, mesmo que o método não esteja adicionado a nenhuma zona de envio.

Countries: os países de destino para esse modo. Deixe em branco para usar todos os países para os quais você envia. Este campo só é usado quando Ignore shipping zones está ativado. Um método adicionado a uma zona de envio sempre funciona para os países da sua zona.

Avançado

Debug log: registra cada cálculo de tarifa em WooCommerce > Status > Logs, origem vfd_smsa_express. Nenhum endereço de cliente e nenhuma chave é registrado. Erros dos valores em tempo real são sempre registrados, mesmo com esta opção desativada. Desative o log quando terminar.

Remove data on uninstall: quando ativado, excluir o plugin remove todas as configurações do SMSA Express e os métodos das zonas. Desativar o plugin nunca apaga nada.

Como funciona na finalização de compra

Quando o cliente informa um endereço de entrega, o WooCommerce pede ao plugin um preço. O plugin verifica primeiro as condições: país de entrega, peso do carrinho, valor mínimo do pedido e classes de envio excluídas. Se o frete grátis se aplicar e o destino tiver preço, o método é exibido com preço 0.

Com os valores em tempo real ativados, o plugin envia à SMSA a cidade e o país de origem, a cidade e o país do cliente, o tipo de envio, o peso do pacote em kg e um valor de pagamento na entrega de 0. A SMSA responde com o valor e a moeda. O plugin o converte para a moeda da sua loja e o exibe. Um valor em tempo real só é solicitado depois que o cliente informa uma cidade.

Cada valor fica em cache por uma hora, para que o mesmo carrinho não gere uma nova solicitação. Uma solicitação com falha fica em cache por 5 minutos. Após um timeout ou erro de servidor, a SMSA não é consultada por 2 minutos. Após uma chave rejeitada, não é consultada por 5 minutos. Assim, a finalização de compra nunca espera por um serviço com falha a cada atualização. O timeout da solicitação é de 12 segundos.

Sempre que a SMSA não retornar um valor utilizável (sem passKey, cidade ainda não informada, pesos de produto ausentes, chave inválida, timeout, erro, nenhum serviço para a cidade ou moeda desconhecida), a tabela de preços é usada. Se a tabela e Price for countries not in the table não derem preço, o método é ocultado. O cliente nunca vê um erro. O motivo é gravado no log.

O método funciona na finalização de compra clássica e nos blocos de Carrinho e Finalização de compra. É compatível com o armazenamento de pedidos de alto desempenho do WooCommerce (HPOS). Uma tradução para árabe está incluída.

O plugin apenas calcula o valor do frete. Ele não cria envios SMSA, não imprime etiquetas AWB, não cuida de devoluções nem rastreia pacotes. O pagamento na entrega e a sua taxa não estão incluídos no valor em tempo real. Não há seletor de ponto de varejo da SMSA: o método é entrega porta a porta.

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 SMSA Express. 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 único domínio. Remover a chave de um site não libera a vaga do domínio. Libere-a na sua conta vibefox.net.

Sem uma chave ativa, o SMSA Express não é exibido aos clientes na finalização de compra. Os gerentes da loja conectados 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 de Plugins e nas páginas do WooCommerce. 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 em segundo plano, automaticamente.

Solução de problemas

O SMSA Express não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado e se o método foi adicionado à zona do país do cliente (ou se Ignore shipping zones está ativado e o país é permitido). Confira os limites de peso, Minimum order amount e Excluded shipping classes. Verifique se o país ou * tem preço, ou se Price for countries not in the table está definido.

Os clientes veem o preço da tabela em vez do valor da SMSA: a SMSA precisa da cidade do cliente, então até que ela seja informada, o preço da tabela é exibido. A tabela também é usada quando a SMSA não responde, rejeita a chave ou a cidade, ou retorna o valor em uma moeda sem taxa de câmbio. Abra WooCommerce > Status > Logs, origem vfd_smsa_express, para ver o motivo.

"Invalid Passkey" no log: a chave não é aceita pelo serviço web da SMSA. Peça à SMSA um passKey do serviço web.

A cidade do cliente não é aceita: a SMSA espera a grafia própria das cidades. Desenvolvedores podem ajustar a solicitação, por exemplo o nome da cidade, com o filtro vfd_smsa_express_live_request_fields.

O imposto é cobrado duas vezes sobre o envio: sua tabela ou os valores da SMSA podem já incluir o IVA. Defina Tax status como None.

Os valores parecem desatualizados após uma mudança: salve a página de configurações. Isso limpa os valores da SMSA em cache.

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. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença e o status de licença deste plugin são sempre removidos. Configurações, métodos das zonas e valores em cache são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação posterior. Pedidos existentes mantêm suas linhas de envio.

SMSA Express é marca registrada de seu respectivo titular. Este plugin não é afiliado nem endossado pelo SMSA Express.