O Frete para Marketplace integra com os métodos de envio mais usados no WooCommerce brasileiro. Esta página resume como cada um se conecta ao split e o que esperar do cálculo.
Visão geral
A integração funciona assim: cada método de envio nativo expõe um filtro pra modificar o CEP de origem. O plugin se engata nesse filtro e troca o CEP da loja pelo CEP do vendedor do pacote sendo calculado.
| Método | Filtro usado | Plugin necessário |
|---|---|---|
| Correios | woocommerce_correios_origin_postcode |
Correios WooCommerce (oficial) |
| Melhor Envio | wc_melhor_envio_origin_postcode |
Melhor Envio |
| Distance Rate | wc_distance_rate_origin |
Distance Rate Shipping |
| Frete Grátis | woocommerce_shipping_free_shipping_is_available |
Nativo do WooCommerce |
Correios
A integração mais usada. Funciona com qualquer modalidade dos Correios (PAC, SEDEX, Mini Envios) configurada via plugin oficial.
O que muda:
- Sem o plugin: Correios calcula tudo a partir do CEP da loja.
- Com o plugin: Correios calcula cada pacote a partir do CEP do vendedor responsável por aquele pacote.
Pré-requisitos:
- Plugin Correios WooCommerce instalado e ativo.
- Modalidades dos Correios configuradas em WooCommerce → Configurações → Entrega.
- Vendedores com CEP de origem preenchido.
Não precisa de configuração adicional — assim que o plugin Frete para Marketplace está ativo, a integração com Correios entra em ação.
Melhor Envio
A integração com Melhor Envio funciona pra todas as transportadoras que ele intermedia (Correios via Melhor Envio, Jadlog, Latam Cargo, etc.).
Pré-requisitos:
- Plugin Melhor Envio instalado e ativo.
- Credenciais de API do Melhor Envio configuradas no plugin.
- Vendedores com CEP de origem preenchido.
O token da API Melhor Envio é um só pra loja. O plugin não substitui o token por vendedor — só o CEP de origem do cálculo. Isso significa que o frete sai cotado pela conta da loja, mas com a origem correta.
Distance Rate Shipping
Pra lojas que usam frete por distância em km (não por CEP/região), via plugin Distance Rate Shipping.
O que muda:
- O plugin entrega o endereço completo do vendedor (não só o CEP) pro Distance Rate calcular a distância correta.
- A taxa cobrada é a faixa de distância correspondente — calculada da origem do vendedor até o destino do cliente.
Pré-requisitos:
- Plugin Distance Rate Shipping instalado.
- Tabelas de distância configuradas no método de envio.
- Vendedores com CEP de origem que possa ser convertido em coordenadas.
Frete Grátis (nativo WooCommerce)
A integração com Frete Grátis é mais sutil — e mais importante. Sem o plugin, o Frete Grátis nativo do WooCommerce avalia os requisitos (cupom, valor mínimo) olhando o carrinho inteiro. Em marketplace, isso quebra: um pacote pode bater o mínimo mas outro não.
O que o plugin faz: avalia os requisitos por pacote, não por carrinho. Cada vendedor tem sua própria avaliação de Frete Grátis.
Detalhado em Frete grátis por pacote.
E os outros métodos?
Métodos de envio que não usam um CEP de origem (frete fixo, frete por classe, métodos custom que cobram um valor independente de origem) funcionam normalmente no split. Eles continuam aparecendo no checkout pra cada pacote — só não têm "ajuste de origem" porque não dependem de CEP.
Se você quer integrar um método de envio custom não listado aqui, é possível: o plugin expõe os campos wcsp_vendor_id e wcsp_vendor_postcode em todo pacote, e qualquer código pode ler esses dados. Veja Filtros dos métodos de envio na seção dev.