VibeFox USPS for PrestaShop

Visão geral

O VibeFox USPS adiciona a transportadora USPS ao PrestaShop. Ele obtém tarifas em tempo real das APIs atuais da USPS com OAuth 2.0, para encomendas nacionais e internacionais, e mostra ao cliente uma única opção da USPS com a mais barata entre os serviços que você selecionou. Quando a USPS não fornece uma tarifa, valem os preços fixos.

Ele é indicado para lojas que enviam encomendas dos Estados Unidos pela USPS. A API Web Tools antiga, desativada pela USPS em janeiro de 2026, não é usada. O módulo apenas calcula tarifas. Não compra franquia postal nem etiquetas, não agenda coletas, não rastreia encomendas, não oferece a escolha de uma agência postal ou de um ponto de retirada, e não adiciona seguro nem outros serviços extras.

Principais recursos

APIs atuais da USPS: OAuth 2.0 com Domestic Prices 3.0 e International Prices 3.0. Ambiente de produção e USPS Testing Environment for Mailers.

Escolha de serviços: USPS Ground Advantage, Priority Mail, Priority Mail Express, First-Class Package International Service, Priority Mail (Express) International, Media Mail e Library Mail. O serviço selecionado mais barato é exibido e salvo com o pedido.

Preços honestos: apenas as tarifas regulares de peça única para a sua encomenda. Os preços Flat Rate, Cubic, Hold for Pickup e Sunday nunca são escolhidos só por serem mais baratos. Preços Retail ou Commercial.

Tratamento de moeda: os preços da USPS são em USD. Em outras moedas da loja, eles são convertidos pela sua taxa de câmbio do USD e nunca são exibidos em euros.

Encomenda correta: peso e dimensões convertidos das unidades da loja para libras e polegadas, um peso padrão para produtos sem peso e o tamanho da embalagem a partir de um tamanho de caixa ou das dimensões do produto.

Preços fixos como alternativa: uma tabela de preços por país com faixas de peso e um preço de reserva, por pedido ou por item, usada sem chaves de API e quando a USPS não responde.

Finalização de compra rápida: as tarifas ficam em cache por 1 hora. Após erros, a USPS é pausada por 5 minutos, para que uma falha não atrase cada atualização da finalização de compra.

Transportadora padrão do PrestaShop: zonas e grupos de clientes em Shipping > Carriers ou uma lista de países; entrega grátis a partir de um subtotal, subtotal mínimo, limites de peso, regra de imposto e log de depuração.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Um aplicativo no USPS Developer Portal (Consumer Key e Consumer Secret) e um código ZIP de 5 dígitos dos EUA de onde as encomendas são enviadas. Os preços fixos funcionam sem chaves. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).