Frete, etiquetas e comunicação dos pedidos

A Rapido usa o ambiente de produção. Cada lojista autoriza sua própria conta do Melhor Envio em Integrações. O aplicativo é único da plataforma; os lojistas não precisam criar aplicativos nem informar senhas ou Client Secret.

1. Escolha o uso na sua loja

• Só calcular frete: autorize esta opção para consultar valores e prazos no checkout. A Rapido não compra etiquetas. Organize a postagem por conta própria e informe o rastreamento no pedido.
• Calcular frete e acompanhar etiquetas: além da cotação, permite buscar etiquetas da conta, vincular ao pedido, abrir a impressão privada e consultar postagem/entrega. Neste MVP, a criação e o pagamento da etiqueta acontecem no site do Melhor Envio.

Clique em Autorizar no Melhor Envio, entre na conta que pertence à loja e autorize. Você retorna ao painel sem perder o acesso à Rapido. Para trocar o uso ou reconectar, repita a autorização. Uma autorização cancelada não encerra sua sessão na Rapido.

Na conta Melhor Envio, abra as configurações do aplicativo autorizado e habilite as transportadoras e serviços que deseja oferecer. Escolha a agência de postagem quando solicitada pelo provedor.

2. Prepare o cálculo

1. Em Locais de operação, informe o endereço e o CEP de origem.
2. Em Produtos, preencha peso em gramas e largura, altura e comprimento em milímetros, considerando a embalagem de transporte.
3. Cadastre as quantidades reais em estoque no local de origem. O checkout só oferece origens capazes de atender todos os itens.
4. O comprador informa o endereço de destino no checkout. A Rapido consulta o Melhor Envio e mostra opções disponíveis. O valor é conferido novamente antes do pagamento.

Conectar o provedor não inventa estoque, endereço, medidas nem serviços. Se não houver opção de transporte disponível, não é aplicado frete grátis automaticamente. Retirada e entrega própria podem ser oferecidas separadamente.

3. Prepare o pedido e a etiqueta

1. Abra Pedidos → Abrir pedido. Confira o comprador, os itens, o endereço e o pagamento confirmado.
2. Escolha Em separação e confirme. O comprador recebe um e-mail.
3. Para envio por transportadora, avance para Pronto para postagem.
4. Abra o Melhor Envio, crie o envio com os dados do pedido, confira o custo, documentos e volumes, pague e gere a etiqueta na sua conta.
5. Volte ao pedido na Rapido e clique em Buscar minhas etiquetas. Selecione pelo destinatário e protocolo, confira se corresponde ao pedido e clique em Vincular etiqueta selecionada.
6. Use Abrir impressão da etiqueta. O link é privado: entre na conta Melhor Envio que gerou a etiqueta quando solicitado.

O pagamento e a emissão automática de uma nova etiqueta dentro da Rapido ainda não estão disponíveis. Essa etapa manual no provedor é parte do fluxo deste MVP. A consulta de etiquetas recentes mostra a primeira página devolvida pelo Melhor Envio; se a etiqueta não aparecer, confira sua conta e a geração no provedor.

Se você usar outra transportadora, avance para Postado e informe código de rastreamento, transportadora e, se desejar, link HTTPS. Para retirada há etapas Pronto para retirada e Retirado; na entrega própria há Em entrega e Entregue.

4. Acompanhe as atualizações

As etiquetas vinculadas são consultadas em segundo plano, normalmente a cada hora. Atualizar rastreio agora permite consultar sob demanda. Um webhook assinado também agenda a confirmação da situação na API da conta vinculada. A Rapido não considera a emissão ou o pagamento de uma etiqueta como prova de postagem.

O webhook do Melhor Envio só notifica etiquetas criadas pelo aplicativo que o cadastrou. Etiquetas criadas no site do Melhor Envio usam a consulta periódica e o botão de atualização. A integração atual importa postagem, entrega e ocorrência do ciclo da etiqueta; movimentos detalhados intermediários dependem da transportadora e podem ser acompanhados pelo link de rastreamento. O código pode levar algum tempo para ser disponibilizado pelo provedor.

No histórico do pedido aparecem as etapas e a situação do e-mail: aguardando, enviando, aceito pelo servidor ou falhou. Aceitação SMTP não comprova leitura ou chegada à caixa de entrada. Repetir uma notificação não cria outro e-mail da mesma transição.

5. O que o comprador recebe

Os e-mails identificam a loja no nome e no assunto, usando a cor e o logotipo publicados. São enviados no pedido recebido, confirmação de pagamento, separação, preparação, postagem, disponibilização do rastreio, entrega, ocorrência e etapas de retirada ou entrega própria.

O comprador acompanha pela Minha conta → Meus pedidos, quando cadastrado. Quem comprou sem cadastro pode solicitar acesso em Acompanhar pedido, com e-mail original e referência da compra. O link de e-mail vale por 15 minutos, tem uso único e abre um acesso ao pedido por até sete dias. Depois de expirar, pode ser solicitado outro.

Aplicativo e webhook — equipe Rapido

As credenciais de produção são salvas cifradas em Superadmin → Aplicativos da plataforma. O segredo não é exibido depois de salvo.

O cadastro do webhook é feito em Integrações → Área Dev. → seu aplicativo → Novo Webhook. A recepção verifica a assinatura X-ME-Signature com HMAC-SHA256 do corpo original e salva a notificação cifrada antes de responder. A verificação assinada de cadastro também é aceita, sem criar pedidos. Não é necessário colocar senha ou Client Secret na URL.

Referências oficiais: Criar aplicativo, Webhooks, Listar etiquetas, Status da etiqueta, Impressão.

Como começar · Manual do lojista