As duas telas que toda loja acaba pedindo são a que calcula o frete pelo CEP e a que mostra onde está a encomenda, e as duas dá para montar no Base44 descrevendo em português o que você quer, sem escrever uma linha de código. Nós montamos as nossas assim.
O que muda de uma tela para a outra é a credencial que cada uma usa, porque a cotação de frete pode ser consultada pela própria página, enquanto o rastreio precisa ser consultado pelo servidor do aplicativo, com a chave guardada fora do alcance do visitante. É a única parte que você precisa dizer ao construtor com todas as letras, e o resto ele resolve sozinho.
Vale saber antes de começar que conectar o nosso MCP ao chat do editor serve para você conversar enquanto constrói, e não instala nada no aplicativo publicado. Quem atende o seu cliente final é a nossa API, chamada pelo aplicativo que você acabou de montar.
O que ter em mãos antes de abrir o construtor
São três coisas, e nenhuma leva mais que alguns minutos.
A loja precisa estar configurada no painel do meu ecommerce, com o CEP de origem, os serviços de envio que você quer comparar e o acesso ao plano, porque é dessa configuração que sai a cotação. No mesmo painel ficam as duas credenciais, uma pública e uma secreta, que é o que o construtor vai usar. E se você for montar também a página de rastreio, é preciso ter contrato faturado próprio com os Correios, já que desde 2025 a consulta de rastreamento é restrita aos objetos vinculados ao contrato de quem enviou.
A diferença entre as duas credenciais cabe em duas linhas.
| Credencial | Onde ela pode ficar | O que ela permite |
|---|---|---|
| Pública | Na própria página, porque foi desenhada para isso | Só cotação de frete |
| Secreta | Só no servidor do aplicativo, nunca na página | Cotação e rastreio |
A tela de cálculo de frete
Essa é a mais simples das duas, porque a cotação pode ser consultada direto da página.
No chat do Base44, descreva a tela dizendo o que ela faz e o que ela mostra, em vez de pedir genericamente um cálculo de frete.
Crie uma tela com um campo de CEP e um botão de calcular frete. Ao clicar, consulte a API de cotação do meu ecommerce usando a minha chave pública e mostre, para cada opção que voltar, o nome do serviço, o preço em reais e o prazo em dias úteis. Enquanto a consulta estiver rodando, mostre carregando. Se nenhuma opção voltar, mostre uma mensagem de indisponibilidade em vez de frete grátis. Recalcule sempre que o CEP ou o carrinho mudar.
Três detalhes separam a tela que funciona da que irrita. O primeiro é que lista vazia não significa frete grátis, já que a resposta pode voltar sem opção nenhuma quando o CEP não tem cobertura ou quando falta configuração na loja, e a tela precisa dizer isso em vez de mostrar zero. O segundo é recalcular quando algo muda, porque uma cotação feita para o CEP anterior não vale mais depois que a pessoa corrige o endereço. O terceiro é mostrar o preço em real, com vírgula, porque o valor chega como número e sem formatação aparece na tela como 28.9.
Se essa tela faz parte de um checkout de verdade, vale a regra que todo mundo esquece, de que a cotação apresenta opções e não fecha preço, então o valor escolhido precisa ser conferido pelo servidor antes de a compra terminar.
A página de rastreio
Aqui a conversa com o construtor muda um pouco, porque a consulta não pode sair da página.
Primeiro guarde a chave secreta como segredo do projeto, com um nome claro, e não como uma configuração comum dentro da tela, já que configurações comuns viajam junto do site e qualquer visitante consegue lê-las. Depois peça as duas partes separadas.
Guarde a minha chave secreta do meu ecommerce como segredo do projeto. Crie uma função no servidor que receba uma lista de códigos de rastreio e consulte a API de rastreio do meu ecommerce usando esse segredo, devolvendo o resultado para a tela. Depois crie uma página com um campo de código que chama essa função e mostra o histórico da entrega, do evento mais recente para o mais antigo, com data e cidade.
Cada resultado traz se o objeto foi encontrado, se a entrega já terminou, o histórico de eventos e o status atual, e uma consulta aceita até 50 códigos de uma vez, o que é bem mais do que uma tela de cliente precisa.
O erro mais comum na apresentação é tratar a ausência de eventos como problema, porque um objeto recém-postado ainda não tem movimentação e a tela precisa dizer isso com todas as letras, que é justamente o momento em que o cliente desconfia que o pedido sumiu. Vale também escrever, ao lado do termo dos Correios, o que ele significa em português de gente, já que "objeto encaminhado para unidade de tratamento" não diz nada a quem está esperando uma caixa. E se a página for pública, peça ao construtor que limite consultas repetidas, para ela não virar uma ferramenta aberta de consulta que você sustenta sem receber nada por isso.
O erro que engana, e o teste de dez segundos
Esse vale conhecer porque ele não aparece como erro.
Enquanto você constrói, o assistente do editor tem as ferramentas conectadas e consegue cotar e rastrear de verdade, então, se você não disser de onde vem o dado depois de publicado, ele faz o mais plausível, que é usar o resultado obtido durante a construção e escrever esse resultado dentro da página. No editor fica perfeito, publicado mostra o mesmo histórico para sempre.
Para descobrir, consulte na página publicada um código diferente do que foi usado na construção, e se o resultado for o mesmo o dado está fixo. O motivo disso está explicado no guia sobre o que funciona no Lovable e no Base44.
Quatro testes antes de publicar
São rápidos e cada um pega uma falha diferente. Teste um CEP válido, para ver preço e prazo chegando, um CEP inválido, para ver a mensagem de erro em vez de tela quebrada, uma cotação que volta sem opção, para confirmar que a tela não mostra frete grátis, e uma credencial errada, para ver o aplicativo tratar a falha sem despejar detalhe interno na cara do cliente.
Fica faltando uma conferência, que é abrir o código que o navegador carrega e procurar pela chave secreta. Se ela aparecer ali, a chave vazou para a página e precisa ser substituída pelo suporte antes de o aplicativo ir ao ar.
Quando a resposta vier com um aviso
Existem três respostas que não são defeito do que você montou, e a tela fica melhor se souber tratá-las.
A primeira é o limite por minuto, que vale por loja e permite 60 cotações e 30 rastreios, com a resposta dizendo quantos segundos esperar, então o certo é aguardar em vez de insistir. A segunda é a cota grátis do mês, que avisa quando acabou. A terceira é a falta de plano ativo. Nessas duas últimas a resposta costuma vir com um endereço para onde mandar o lojista concluir a configuração, e usar esse endereço é bem melhor do que mostrar um erro genérico.
A referência completa das duas APIs, com todos os campos, está no portal em dev.meuecommerce.com.br, e serve tanto para você conferir o que o construtor gerou quanto para colar como contexto no próprio chat dele.
O que é o meu ecommerce MCP
O meu ecommerce MCP é o servidor MCP dos Correios, que entrega cotação de frete, emissão de etiqueta e rastreio de pedidos como ferramentas prontas para o assistente ou a automação que você já usa, seja ChatGPT, Claude, Gemini, n8n, Lovable ou Base44. A cotação de frete funciona sem contrato próprio, porque roda pelo nosso contrato, como parceiro homologado dos Correios, enquanto o rastreio e a emissão de etiqueta usam o seu contrato faturado.
Para o aplicativo publicado, as mesmas operações de cotação e rastreio estão disponíveis na nossa API, que é o que a sua tela chama quando alguém clica. A emissão de etiqueta continua acontecendo pelo MCP, na conversa ou numa automação, porque é operação de quem envia e não de quem compra.
Leia também
- Frete dos Correios no Lovable e no Base44: o que funciona e onde
- Como criar uma página de rastreio própria para a sua loja
- Correios no n8n: cotação, etiqueta e rastreio nas suas automações
- Como automatizar os envios pelos Correios sem ser programador
Perguntas frequentes
Dá para calcular frete dos Correios num aplicativo feito no Base44?
Dá, e sem escrever código. Você descreve a tela no chat do construtor, pedindo o campo de CEP, a consulta à nossa API de cotação com a sua chave pública e o que mostrar de cada opção, e ele monta. A chave pública foi desenhada para ser usada na própria página.
Posso deixar a chave no aplicativo publicado?
A pública sim, porque ela só cota frete e foi feita para isso. A secreta não, em nenhuma hipótese, porque é ela que permite rastrear e precisa ficar guardada como segredo do projeto, lida por uma função no servidor, já que tudo que a página carrega o visitante consegue ler.
Por que o rastreio não funciona direto na tela?
Porque a consulta de rastreio exige a chave secreta, de propósito, para que ninguém possa rastrear os seus envios a partir do código da sua página. A tela pede, o servidor consulta e devolve só o resultado.
Por que meu aplicativo publicado mostra sempre o mesmo rastreio?
Porque o dado foi escrito dentro da tela durante a construção, em vez de ser buscado quando alguém abre a página. Para confirmar, consulte na página publicada um código diferente do que você usou enquanto montava.
Preciso de contrato com os Correios para a página de rastreio?
Para rastrear precisa, e precisa ser um contrato faturado seu, porque desde 2025 a consulta é restrita aos objetos vinculados ao contrato de quem enviou, então a sua página acompanha os envios que saíram no seu contrato. Para a tela de cotação não é necessário.
O que a tela deve mostrar quando a cotação volta sem opções?
Uma mensagem de indisponibilidade, nunca frete grátis, porque a resposta pode voltar sem opção quando o CEP não tem cobertura ou quando falta configuração na loja, e nesses casos ela vem acompanhada do motivo.
Dá para começar sem pagar?
Dá, porque sem assinar plano nenhum a loja faz 10 cotações, 10 rastreios e 10 emissões de etiqueta por mês, sem cartão de crédito, e passando disso a resposta avisa que a cota grátis acabou, enquanto os planos pagos tiram o limite mensal. Existe ainda um limite por minuto em todos os planos, para segurar picos, com 60 cotações, 30 rastreios e 20 emissões de etiqueta.
Duas telas, duas credenciais, e o dado chegando de verdade. Conheça o meu ecommerce MCP e veja como funciona.