A integração entre o Envio Ecom e a Shoppub traz os pedidos da sua loja para o painel, sem digitar endereço. Você gera as etiquetas no Envio Ecom e o código de rastreio volta para o pedido na Shoppub, junto com o status que você escolher. A integração está disponível em versão Beta.
Com a integração ativa, você poderá:
- Importar os pedidos da loja, já com destinatário, endereço e produtos.
- Gravar o código e o link de rastreio no pedido da Shoppub.
- Atualizar o status do pedido ao gerar o envio (o padrão é Despachado).
- Marcar o pedido como Entregue quando a transportadora confirma a entrega.
Antes de começar
Você vai precisar de acesso ao painel administrativo da sua loja Shoppub e do endereço da loja (ex.: https://minhaloja.com.br). Esta integração cuida dos pedidos, das etiquetas e do rastreio. O frete mostrado no checkout continua sendo o configurado na sua loja Shoppub.
Passo 1: Crie o Usuário API na Shoppub
- No painel da Shoppub, abra Integrações > APIs e Webhooks > Usuários API. Se preferir, acesse o endereço da sua loja seguido de /shoppub-v2/clientes/clienteapiproxy/.
- Clique em Adicionar Usuário API e dê o nome Envio Ecom.
- Libere as permissões de pedidos, incluindo Obter Pedidos, e as de alterar o pedido e cadastrar o rastreio. Clique em Salvar.
- Copie o token gerado. Guarde com cuidado e não compartilhe com terceiros.
Passo 2: Conecte no Envio Ecom
- No menu lateral, clique em Integrações (ou Integrar plataforma) e, em Lojas virtuais, no cartão Shoppub. Se você já tem outra integração, clique antes em Conectar outra integração.
- Informe o endereço da loja no campo URL da loja Shoppub.
- Cole o token no campo Token da API.
- Clique em Conectar com a Shoppub. O token é conferido na hora e a tela mostra o selo Conectada.
- Se você já tinha outra integração, no cartão da Shoppub em Integrações, clique em Usar esta integração para os pedidos da Shoppub aparecerem em Pedidos.
Passo 3: Escolha o status e os pedidos listados
- Em Status do pedido após gerar o envio, escolha o status que o pedido recebe na Shoppub. O padrão é Despachado. Você também pode escolher Preparando para envio, Em Separação, Em faturamento ou Nota Fiscal Emitida, ou deixar Não alterar o status (só gravar o rastreio).
- Em Listar apenas pedidos com status, recomendamos escolher Pago. Com Todos, a lista também mostra pedidos em aberto (aguardando pagamento) e cancelados.
- Clique em Salvar.
Como usar no dia a dia
- Importar pedidos: em Pedidos, ajuste o período em De e Até e clique em Filtrar, ou busque pelo número do pedido na Shoppub. Cada consulta traz até 1.000 pedidos: se você vende muito, use períodos menores.
- Peso e medidas: a Shoppub envia o peso total do pedido, mas não as medidas de cada produto. Na primeira vez, a lista mostra Sem peso/medidas: clique e preencha peso e medidas do produto uma vez. O cadastro vale para os próximos pedidos com esse produto.
- Gerar o envio: marque os pedidos, clique em Gerar cotação, escolha a transportadora e clique em Criar. Em seguida, em Meus envios, clique em Pagar: o valor sai do saldo da carteira e a etiqueta fica disponível ali.
- Rastreio e entrega: o código e o link de rastreio são gravados no pedido da Shoppub, com o status escolhido. Na entrega, o pedido passa para Entregue automaticamente.
Dúvidas comuns
Apareceu um aviso ao conectar. Confira se o endereço é o da sua loja (ex.: https://minhaloja.com.br), se você copiou o token inteiro e se o Usuário API tem a permissão Obter Pedidos.
Um pedido não aparece. Entram os pedidos criados dentro do período escolhido e com o status escolhido em Listar apenas pedidos com status. Busque pelo número do pedido na Shoppub para conferir. Se você tem outra integração, confira se a Shoppub está Em uso.
O rastreio não apareceu no pedido da Shoppub. Confira se o Usuário API tem as permissões de alterar o pedido e cadastrar o rastreio.
Um produto do pedido ficou fora do envio. Itens que a Shoppub marca como não entregáveis, como serviços e seguros, não entram no envio.
⚠️ Importante:
A Envio Ecom é uma plataforma de intermediação logística que conecta usuários às transportadoras parceiras para cotação, emissão de etiquetas e gerenciamento de envios. A execução do transporte, incluindo coleta, movimentação, armazenagem, entrega e devolução das encomendas, é realizada exclusivamente pela transportadora escolhida.
