VibeFox Australia Post 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.
Chave PAC API do Australia Post (somente para tarifas em tempo real): as tarifas em tempo real usam a API Postage Assessment Calculator (PAC) do Australia Post. A chave é gratuita: cadastre-se no Australia Post Developer Centre (developers.auspost.com.au) para obter uma chave PAC API. Você também precisa do código postal australiano de 4 dígitos de onde envia os pacotes. Se usar apenas preços fixos por país, não precisa de chave de API.
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_australia_post para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Australia Post, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Insira a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Escolha a Rate source. Para tarifas em tempo real, informe a chave PAC API, o código postal de envio e, se a moeda da loja não for AUD, a taxa de conversão para AUD (veja Configuração).
6. Adicione o VibeFox Australia Post a uma zona de envio em WooCommerce > Settings > Shipping > Shipping zones, 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 Australia Post. 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 exibido ao cliente nesta zona. Deixe em branco para usar o Method title geral.
Sempre que você salva as configurações, as tarifas em cache do Australia Post são apagadas. Se as tarifas em tempo real estiverem selecionadas, mas faltar a chave de API, o código postal de envio ou a taxa AUD, um aviso é exibido após salvar.
General
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 ao cliente no checkout. Uma zona pode substituí-lo por um título próprio. Padrão: Australia Post.
Tax status: Taxable adiciona o imposto do WooCommerce ao valor do frete, None não adiciona.
Rate source: como o preço é calculado.
Os detalhes dos erros vão para o log, nunca para o cliente.
API do Australia Post (tarifas em tempo real) (não é necessária para preços fixos)
PAC API key: a sua chave gratuita PAC API do Australia Post. Ela é enviada ao Australia Post no cabeçalho AUTH-KEY.
Ship-from postcode: o código postal australiano de 4 dígitos de onde os pacotes são enviados, por exemplo 2000.
Domestic service: usado para entregas dentro da Austrália (até 22 kg, 105 cm por lado): Parcel Post (padrão) ou Express Post.
International service: usado para entregas fora da Austrália (até 20 kg): International Standard (padrão), International Express ou International Courier.
Remove GST: divide os preços nacionais da API por 1,1. Os preços nacionais do Australia Post incluem 10% de GST. Ative esta opção quando o WooCommerce adicionar o imposto ao frete (Tax status = Taxable), para que a GST não seja cobrada duas vezes. O porte internacional não tem GST e nunca é alterado.
AUD → (your currency) rate: os preços do Australia Post estão em AUD. Se a moeda da sua loja não for AUD, informe quantas unidades da sua moeda equivalem a 1 AUD, por exemplo 0.61. Sem isso, as tarifas em tempo real não são usadas. Se a moeda da loja for AUD, deixe o campo em branco. Tanto o ponto quanto a vírgula são aceitos como separador decimal.
Pacote para tarifas em tempo real
O carrinho é enviado como um único pacote. Os pesos e as dimensões dos produtos são convertidos das unidades da sua loja para kg e cm. Os valores abaixo são usados para produtos sem peso ou dimensões.
Default product weight (kg): usado para cada produto sem peso, na solicitação ao Australia Post e na verificação de Min cart weight / Max cart weight. Padrão: 1.
Default parcel length (cm): usado quando nenhum produto do carrinho tem dimensões. Padrão: 22.
Default parcel width (cm): usado quando nenhum produto do carrinho tem dimensões. Padrão: 16.
Default parcel height (cm): usado quando nenhum produto do carrinho tem dimensões. Padrão: 8.
Preços fixos (usados com preços fixos e como alternativa das tarifas em tempo real)
Country prices: uma tabela com códigos de país de 2 letras (AU, NZ, US etc.) e preços na moeda da sua loja. Clique em + Add row para adicionar um país e no botão de remoção para excluir um. Use * para todos os outros países. Um país sem preço (e sem linha *) não recebe tarifa fixa, então o método fica oculto para ele. A tabela fica vazia até você adicionar preços.
Fixed price per: Order cobra o preço uma vez. Item (price × quantity) multiplica o preço pelo número de itens no carrinho. Isso se aplica somente a preços fixos. As tarifas em tempo real são sempre calculadas para o pacote inteiro.
Condições
Min cart weight (kg): oculta o método abaixo deste peso do carrinho. 0 significa sem limite.
Max cart weight (kg): oculta o método acima deste peso do carrinho. Padrão: 22. 0 significa sem limite. Pacotes do Australia Post: 22 kg no país, 20 kg internacional.
Minimum order amount: exibe o método somente quando o subtotal do carrinho atinge este valor. Deixe em branco para exibi-lo sempre.
Excluded shipping classes: oculta o método se algum item do carrinho tiver uma destas classes de envio do WooCommerce.
Free shipping: ativa o frete grátis a partir do valor indicado abaixo.
Free shipping from: o subtotal do carrinho a partir do qual o frete é grátis. Nesse caso, nenhuma solicitação é feita à API.
Disponibilidade sem zonas de envio
Ignore shipping zones: oferece o método para os países indicados abaixo, qualquer que seja a zona correspondente.
Countries: os países de destino para esse modo. Deixe em branco para usar todos os países para os quais a loja envia. Usado somente com Ignore shipping zones.
Avançado
Debug log: registra os cálculos de tarifas em WooCommerce > Status > Logs, origem «vfd-australia-post». Erros da API são sempre registrados. A chave de API e os códigos postais dos clientes não são registrados.
Remove data on uninstall: quando ativada, ao excluir o plugin são removidas as suas configurações, os métodos das zonas e as tarifas em cache. 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 uma tarifa ao plugin. O plugin verifica primeiro o peso do carrinho, o Minimum order amount e as Excluded shipping classes. Se o frete grátis se aplicar, a tarifa é 0 e nenhuma solicitação é enviada ao Australia Post.
No modo de preços fixos, o preço vem da tabela. Nos modos de tarifas em tempo real, o plugin envia ao Australia Post o peso do pacote e, em entregas nacionais, os códigos postais de envio e de entrega e o tamanho do pacote; em entregas internacionais, o país de destino. Uma tarifa em tempo real nacional só é solicitada depois que o cliente informa um código postal de 4 dígitos. Nenhuma solicitação é enviada se o pacote estiver acima dos limites do Australia Post (22 kg ou 105 cm no país, 20 kg internacional). O preço em AUD é convertido com a sua taxa, e a GST é removida dos preços nacionais se Remove GST estiver ativado.
Cada resposta bem-sucedida fica em cache por 1 hora, para que o mesmo carrinho não gere uma nova solicitação. Uma solicitação com falha fica em cache por 10 minutos, para que a finalização de compra não espere o Australia Post a cada atualização. Erros da API nunca são mostrados ao cliente: o método é ocultado ou, no modo de alternativa, o preço fixo é usado.
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 High-Performance Order Storage (HPOS) do WooCommerce.
O plugin calcula apenas tarifas. Ele não cria etiquetas de envio, envios eParcel ou MyPost Business nem manifestos, não rastreia pacotes e não permite que os clientes escolham armários de retirada ou agências dos Correios. O carrinho é sempre calculado como um único pacote. Cartas, satchels e tarifas contratuais (eParcel) não estão incluídas.
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 Australia Post. 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 em 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 em vibefox.net.
Sem uma chave ativa, o Australia Post não é exibido aos clientes na finalização de compra. Os gerentes da loja conectados ainda o veem, marcado com (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 Australia Post não aparece na finalização de compra: verifique 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á ativo e o país é permitido). Confira os limites de peso do carrinho, o Minimum order amount e as Excluded shipping classes. No modo de preços fixos, confira se o país ou o * tem um preço.
As tarifas em tempo real não aparecem: ative o Debug log, recarregue a finalização de compra e abra WooCommerce > Status > Logs (origem «vfd-australia-post»). Ali aparece o motivo: falta a chave de API ou o código postal de envio, ainda não há código postal de entrega de 4 dígitos, o pacote está acima dos limites, falta a taxa AUD ou aparece a mensagem de erro do Australia Post. Com Live rates, fixed price if the API gives no rate, os clientes continuam vendo o preço fixo enquanto você resolve o problema.
Minha loja não está em AUD: informe a taxa de conversão (quantas unidades da sua moeda equivalem a 1 AUD) em AUD → (your currency) rate. Os preços fixos sempre são na moeda da loja.
A GST está sendo cobrada duas vezes no frete: os preços nacionais do Australia Post incluem 10% de GST. Se Tax status estiver como Taxable, ative Remove GST.
O preço está alto ou baixo demais: confira os pesos e as dimensões dos produtos e os valores padrão em Parcel for live rates. Com Item (price × quantity), os preços fixos são multiplicados pelo número de itens.
As tarifas parecem desatualizadas após uma mudança: salve a página de configurações. Isso limpa as tarifas do Australia Post 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 em 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. As configurações, os métodos de zona e as tarifas em cache são removidos somente se Remove data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação futura. Os pedidos existentes mantêm as suas linhas de frete.
Australia Post é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pelo Australia Post.