Quando um cliente realiza uma compra na sua loja, ele pode receber automaticamente as atualizações de entrega do pedido, como coleta, envio e entrega. Porém, para isso funcionar corretamente, é necessário que a transportadora possua integração completa com a plataforma.
Este tutorial é especialmente útil para lojistas que não utilizam um ERP para intermediar esse processo. Aqui vamos explicar, de forma simples e didática, como funciona o fluxo de integração e quais pontos devem ser observados.
Fluxo da integração entre wBuy e transportadoras
O fluxo da integração é relativamente simples e pode acontecer de duas formas:
- Integração completa
- Integração parcial
Vamos começar pelo fluxo completo:
- O cliente acessa a loja e realiza a cotação do frete
- O cliente escolhe a opção de entrega
- O cliente finaliza o pagamento do pedido
- O meio de pagamento aprova o pagamento e o pedido é atualizado no painel wBuy
- O lojista envia o pedido para a transportadora
- A transportadora recebe os dados do pedido
- O lojista realiza o despacho físico da encomenda
- O pedido recebe atualizações de rastreamento e entrega
Esse é o fluxo mais comum e completo.
Claro que, dependendo da operação da loja, podem existir etapas adicionais como:
- emissão de nota fiscal
- separação e empacotamento
- coleta no centro de distribuição
- retirada pela transportadora
- entre outros processos internos
Já no fluxo parcial, normalmente existe apenas a cotação do frete, sem o envio do pedido para a transportadora. Isso depende diretamente do nível de integração disponível para cada empresa.
Em alguns casos, a própria transportadora não disponibiliza integração para geração de etiquetas ou acompanhamento automático.
Como funciona a integração com transportadoras
Todas as integrações com transportadoras na wBuy funcionam via API.
API é uma conexão automática entre sistemas, onde enviamos informações para a transportadora e recebemos uma resposta dela.
Por exemplo:
Temos um produto com:
- dimensões de 10x15x20 cm
- peso de 0,5 kg
- origem no CEP 01102-000 (São Paulo/SP)
- destino no CEP 80530-908 (Curitiba/PR)
Essas informações são enviadas automaticamente para a API da transportadora. Em resposta, ela retorna opções de entrega, como:
- Correios Sedex: entrega em 10 dias úteis por R$ 45,50
- Correios PAC: entrega em 15 dias úteis por R$ 32,90
- Loggi: entrega em 8 dias úteis por R$ 48,90
Ou seja, a plataforma sempre exibirá o retorno recebido diretamente da transportadora.
A exceção são métodos de entrega nativos da loja, que são:
- Frete grátis
- Frete avançado
- Frete fixo
- Balcão de retirada
- Delivery por bairros
- Delivery por ditância
- Faixas de cep
- Frete à cobrar
- Retirada na loja
Como funciona o envio do pedido para a transportadora
Após a cotação do frete, a transportadora espera receber os dados finais do pedido para concluir o processo de integração.
Nesse momento, enviamos novamente informações como:
- produtos
- dimensões
- peso
- CEP de origem
- CEP de destino
- modalidade de frete escolhida
Dependendo da transportadora, também podem ser exigidos:
- nota fiscal
- declaração de conteúdo
- dados fiscais adicionais
- documentos de envio
Cada empresa possui suas próprias regras e exigências.
Envio manual ou em massa
Atualmente, o envio de pedidos para transportadoras pode acontecer:
- manualmente
- em massa (em algumas integrações)
Isso acontece porque o lojista pode desejar alterar a forma de envio após a compra.
Em muitos casos, o valor ou prazo do frete pode mudar entre:
- a data da compra
- a separação do pedido
- a expedição
Com isso, o lojista tem liberdade para escolher uma opção mais econômica ou mais rápida antes do despacho. O envio para transportadora só ocorrerá quando o pedido estiver com status de pago, no envio individual você pode clicar em mais detalhes e na lista escolher qual transportadora irá fazer o disparo
Cada transportadora terá os campos que são obrigatários na sua integração, isso vai variar de acordo com cada uma delas
Atenção: alguns planos da wBuy não possuem recurso de envio em massa. Consulte a lista de recursos do seu plano ou fale com nosso time de suporte.
Importante sobre rastreamento e atualizações
O ciclo completo de integração só acontece após o envio do pedido para a transportadora. Ou seja, sem o envio do pedido, não é possível receber automaticamente:
- rastreamento
- atualizações de status
- confirmação de entrega
É esse envio que cria o vínculo entre a plataforma e a transportador
Quais transportadoras possuem envio de pedido
Abaixo você pode consultar quais integrações realizam cotação e envio:
| Transportadora | Faz cotação? | Envia pedido (etiqueta)? |
| Stone Entrega | Sim | Sim |
| ASAP Log | Sim | Não |
| Braspress | Sim | Não |
| Carriers | Sim | Não |
| Central do Frete | Sim | Sim |
| Correios | Sim | Sim |
| Correios Log+ | Sim | Sim |
| Envie Agora | Sim | Sim |
| Alfa Transportes | Sim | Não |
| Azul Cargo | Sim | Sim |
| Frete Barato | Sim | Não |
| BRCommerce | Sim | Sim |
| Clube Envios | Sim | Sim |
| Dimona | Sim | Não |
| DLog | Sim | Não |
| Frenet | Sim | Sim |
| Generoso | Sim | Não |
| Intelipost | Sim | Sim |
| IS Entrega | Sim | Sim |
| Jadlog | Sim | Sim |
| J&T Express | Sim | Sim |
| Kangu | Sim | Não |
| Loggi | Sim | Sim |
| Manda Bem | Sim | Sim |
| Mandae | Sim | Sim |
| Melhor Envio | Sim | Sim |
| Onlog | Sim | Sim |
| Otimize Frete | Sim | Sim |
| Rodoe | Sim | Sim |
| Shippy | Sim | Não |
| Smart Envios | Sim | Sim |
| SuperFrete | Sim | Sim |
| TNT | Sim | Não |
| Zapex | Sim | Não |
| Go Fretes | Sim | Sim |
| Rede Sul Log | Sim | Não |
| Total Express | Sim | Não |
| Jamef | Sim | Não |
| Jet Log Rio | Sim | Não |
| Mandar | Sim | Sim |
| Mercocamp | Não | Sim |
| Sisfrete | Sim | Não |
| Transfolha | Sim | Não |
Tabela atualizada em 15/05/2026.
Caso a transportadora que você utiliza não possua integração completa, entre em contato com nosso time para análise. Em alguns casos:
- a transportadora não disponibiliza API
- a integração não é viável tecnicamente
- a funcionalidade ainda não está disponível
Se houver viabilidade, nossa equipe poderá analisar a documentação e avaliar comercialmente a integração.
Você pode falar com um especialista ou enviar sua solicitação para: comercial@wbuy.com.br
Erros comuns
Meu pedido não atualiza automaticamente
Primeiro, confira na tabela acima se a transportadora possui integração completa com envio de pedido.
Depois, verifique no histórico do pedido se o envio para a transportadora foi realizado corretamente.
Em algumas integrações, as atualizações acontecem apenas em eventos específicos, como:
- pedido enviado
- pedido entregue
- Isso varia conforme a transportadora.
Em caso de dúvidas, nosso time de suporte poderá ajudar na análise.
Existe cotação, mas o valor está muito alto ou o prazo muito longo
O valor e o prazo exibidos na loja sempre são baseados no retorno da API da transportadora.
Alguns exemplos comuns:
- contratos próprios dos Correios
- integração via intermediadores como Melhor Envio
- regras comerciais específicas da transportadora
Além disso, diversas configurações da própria loja podem influenciar no cálculo do frete.
Confira os seguintes pontos no painel da wBuy:
- Configurações > CEP da loja
Verifique o CEP de origem utilizado para despacho - Configurações > Frete e logística > Opções
Confira:- adicionar mais um dia automaticamente
- considerar sábado como dia útil
- Configurações > Frete e logística > Prazo adicional
Veja se existe prazo extra configurado - Configurações > Frete e logística > Desconto e acréscimo no frete
Confira possíveis taxas extras - Configurações > Frete e logística > Subsídio de frete
Veja se existe alguma regra ativa - Configurações > Frete e logística > Bloqueio/liberação de vendas
Confira restrições por faixa de CEP - Configurações > Frete e logística > Prazo adicional por quantidade
Verifique regras por quantidade de itens - Configurações > Frete e logística > Sua transportadora > Prazo e valores extras
Algumas integrações possuem ajustes próprios - Configurações > Frete e logística > Sua transportadora > Bloqueio por estados
Confira restrições regionais - Produto > Prazo de produção
Pode adicionar dias ao prazo final - Produto > Data de lançamento
Também pode impactar o prazo exibido
Todos esses fatores influenciam diretamente na cotação e no envio do pedido.
Nome da etiqueta incorreto
A wBuy possui um local específico para configurar os dados e a logo utilizados nas etiquetas. Acesse: Configurações > Frete e logística > Endereço para etiquetas e fretes e também: Configurações > Logo para etiquetas
Preencha todos os dados corretamente. Caso essas informações não estejam configuradas, a plataforma utilizará automaticamente:
- os dados cadastrais da loja
- a logo principal da plataforma
Valor do envio diferente da cotação
Em algumas transportadoras, o valor exibido na cotação pode sofrer alterações no momento da geração da etiqueta. Isso pode ocorrer por diversos fatores, como:
- atualização tarifária
- regras contratuais
- validações adicionais da transportadora
Nesses casos, recomendamos acionar nosso time de suporte para análise dos logs de:
- cotação
- envio do pedido
Com essas informações, também é possível abrir uma análise diretamente com a transportadora.
Importante: a wBuy não realiza cálculos próprios de frete. Todo o processo depende exclusivamente da resposta enviada pela API da transportadora.
Mesmo configurado corretamente, não aparece cotação ou envio do pedido
Algumas integrações possuem um botão de teste de conexão/token. Acesse o aplicativo da transportadora e procure opções como:
- Testar token
- Testar conexão
- Validar credenciais
Se houver algum erro, a mensagem normalmente será exibida na própria tela. Caso a integração não possua esse recurso, entre em contato com nosso time para análise dos registros de integração.
Auditoria de cotação e envio de pedidos
Toda cotação, envio de pedido e rastreamento realizado pela plataforma wBuy é registrado em logs internos. Esses logs armazenam informações importantes, como:
- retorno da API
- valores
- prazos
- códigos de integração
- movimentações do pedido
- respostas da transportadora
Esses registros ficam armazenados de forma segura em nossos servidores e podem ser utilizados para auditoria e análise técnica. O acesso aos logs é realizado apenas pelo nosso time de especialistas. Caso necessário, nossa equipe poderá compartilhar as informações relevantes para análise junto à transportadora.
Link de rastreio está errado ou não mostra o pedido
Por padrão, toda loja na plataforma wBuy já possui uma URL padrão de rastreamento configurada. Essa URL será utilizada principalmente quando a transportadora integrada não retornar automaticamente um link próprio de rastreio.
O lojista também pode configurar:
- uma URL padrão
- múltiplas URLs adicionais
- escolher manualmente qual link utilizar no disparo do pedido (em massa, individual ou não integrado)
Porém, é importante lembrar:
Caso a transportadora retorne automaticamente uma URL de rastreio pela API, ela terá prioridade e será exibida no detalhe do pedido.
Para alterar a URL padrão de rastreamento, acesse: Configurações > Frete e logística > URL padrão para rastreio dos pedidos
Neste campo, é obrigatório utilizar o texto: [codigo] (exatamente desta forma escrita)
Ele será automaticamente substituído pelo código de rastreamento do pedido. Exemplo: https://rastreamento.correios.com.br/app/index.php?objetos=[codigo]
Além disso, no botão + URLs, é possível cadastrar várias URLs adicionais.
Basta adicionar:
- uma URL por linha
- sempre contendo o texto [codigo]
Assim, você poderá utilizar diferentes links de rastreamento conforme a transportadora ou necessidade da operação.
