Introdução

Esta extensão permite gerenciar configurações relacionadas à envios com peso e medidas dos produtos para fazer cálculos de fretes. Divisão das configurações e possibilidades:

Pré-requisitos

• Catálogo de produtos (#5);
• SEO (#5) para preenchimento das coordenadas;

Configurações gerais:

• CEP da loja: CEP oficial de onde irá sair os produtos;
• Frete grátis para toda a loja: configuração global que desabilita todas as formas de envio;
• Frete acima de um valor: Configuração global para oferecer frete grátis assim que o total da compra ultrapassa determinado valor;
• Frete grátis até determinado preço: Valor máximo em kilos para habilitar frete grátis em compras até determinado peso;
• Frete grátis por distância: Valor em quilometros para frete grátis; ⚠️ pode ter limitações caso não encontre o CEP no OpenStreet;
• Limite de entrega: Valor em quilometros para limitar a entrega;⚠️ pode ter limitações caso não encontre o CEP no OpenStreet;
• Tabela de estados: Ao habilitar essa opção o usuário terá o cálculo baseado no preenchimento da tabela de Estados no Painel da extensão;
• peso e medidas padrão: Dados essenciais para o funcionamento. Sempre que um produto não tiver medidas ou peso cadastrados, será utilizado este valor padrão;

🚨 É importante que a loja utilize OU Fretnet OU Correios OU Controle por estados. Não é possível utilizar mais de um.

🚨 Em ordem, a loja busca primeiro A configuração global (frete grátis e distâncias), depois Fretnet, depois Correios, depois Controle por estados, entretanto, é importante desabilitar os não utilizados.

🚚 FRETNET

É a integração recomendada, basta adicionar o token e fazer as configurações na plataforma da Fretnet. É o mais preciso. 

Veja como pegar o token da Fretnet

Veja o site oficial da Fretnet

⚠️ Tempo adicional em dias para as entregas: Valor em dias para somar à estimativa, por exemplo, ao colocar o valor 3 será somado 3 dias em todas as opções. Pode ser utilizado como tempo de fabricação.

✉️ CORREIOS (simplificado)

A integração com o Correios fornece cálculos para SEDEX e PAC. Funciona bem para 1 produto mas pode ser impreciso para mais produtos. 

⚠️ As dimensões dos produtos e pesos são somados para gerar o cálculo. Há uma chance grande do valor ser maior que o real pago. 

🛣️ CONTROLE POR ESTADOS

Permite controlar por estado se o frete é grátis e seu respectivo valor fixo. ⚡ Por ser uma tabela simples, esse cálculo é muito rápido.

Onde é exibido?

Página do produto: Na página do produto é necessário  colocar o script e elementos do DOM para fazer o cálculo de estimativa individual.

No carrinho/sacola de compras: Os cálculos estão incorporados no cart2.js para estimar o frete para múltiplos produtos. Utiliza o localStorage:products para coletar os produtos (assim como o carrinho de compras).

Como utilizar no site

As configurações podem ser invocadas no Layout do catálogo a qualquer momento, com as funções:

objeto com as configurações globais:

$shippingData = shippingData();

$shippindData['cep'];$shippindData['allFree'];$shippindData['allFreeMessage'];$shippindData['allFreePrice'];$shippindData['allFreePriceValue'];$shippindData['allFreeWeight'];$shippindData['allFreeWeightValue'];$shippindData['allFreeForRange'];$shippindData['allFreeRangeValue'];$shippindData['limitRange'];$shippindData['limitRangeValue'];$shippindData['useBRStates'];$shippindData['defaultWeight'];$shippindData['defaultWidth'];$shippindData['defaultHeight'];$shippindData['defaultLenght '];

objeto com os dados por estado

$shippingBRStates = shippingBRStatesData();

$shippingBRStates['SP']['configbrstatesAllFree'];$shippingBRStates['SP']['configbrstatesMinvalueForFree'];$shippingBRStates['SP']['configbrstatesFixedPrice'];$shippingBRStates['SP']['configbrstatesDeliveryTime'];

Ps.: equivalente para todos os UFs

objeto com os dados da Fretnet

$fretnetData = shippingThirdPartyData('Fretnet');$fretnetData['useFretnet'];$fretnetData['fretnetDeliveryTime'];

objeto com os dados dos Correios

$correiosData = shippingThirdPartyData('Correios');$correiosData['useCorreios'];$correiosData['PAC'];$correiosData['SEDEX'];$correiosData['showService'];$correiosData['correiosDeliveryTime'];

objeto para trazer as medidas e + dados de cada produto

$productMeasures = shippingEachProductData($productData['productId']);$productMeasures['width'];$productMeasures['height'];$productMeasures['length'];$productMeasures['fragile'];

objeto e script que traz todas as informações necessárias para o script de cálculos funcionar

$shippingDataForScript = shippingDataSet();

$item .= '<script id="shippingScriptTag" '.$shippingDataForScript.' src="https://www.interago.com.br/App/Extensions/9/tag/shipping.js" data-t="'.$mainData['siteDomainToken'].'" data-w="'.$mainData['siteId'].'" loading="lazy"></script><script> shippingForProduct();</script>';

DOM necessário na página de produto

//shipping $shippingData = shippingData(); $shippingProductData = shippingEachProductData($productData['productId']); $shippingWeight = ''; //to get weight from shipping settings if productData is equal to zero if($productData['productWeight'] == '0.0') { $shippingWeight = $shippingData['defaultWeight']; } else { $shippingWeight = $productData['productWeight']; }

$item .= '<div id="shippingEstimativeContent" data-product-width="'.$shippingProductData['width'].'" data-product-height="'.$shippingProductData['height'].'" data-product-length="'.$shippingProductData['length'].'" data-product-fragile="'.$shippingProductData['fragile'].'" data-product-weight="'.$shippingWeight.'" data-sku="'.$productData['productSKU'].'" data-category="'.$productData['categoryId'].'" data-price="'.$productData['productPrice'].'" data-internal-id="'.$productData['productId'].'"></div>';

☝️ Todo o esquema de cálculo será carregado dentro do #shippingEstimativeContent

Estilo padrão necessário para exibição dos cálculos

/*shipping*/

 #shippingEstimativeContent { margin-top:30px; }

 #shippingEstimativesInput { width: 50%; font-size: 15px; display: inline-block; border: 1px solid #dedede; border-radius: 5px; padding: 4px; } #shippingEstimativesInputButton { background-color: #055ed0; color: #fff; padding: 5px 5px; box-shadow: 0 2px 2px #dedede; border-radius: 5px; font-size: 14px; cursor: pointer; transition: 0.3s ease; text-align: center; width: 45%; display: inline-block; max-width: 100px; } #shippingEstimativesGeoLocation { cursor:pointer; font-size: 12px; color: #055ed0; display:block; }

 .shippingResultWireFrame { width: 100%; height: 10px; background-color: #dfdfdf; border-radius: 5px; margin-top: 10px; } .shippingResultHalfWireFrame { width:30%; height: 10px; background-color: #dfdfdf; border-radius: 5px; margin-top: 10px; } .shippingEstimativeResultContent { font-size: 13px; color: #666; margin-bottom: 10px; } #shippingEstimativesResult { margin-top:10px; } .shippingEstimativeResultPrice strong{ display:inline-block; }

🛒 O estilo para o carrinho de compras já vem por padrão no cart2.js. Para alterar basta chamar o atributo style.